ACORG docs

主题

安装 Python 3.12.x ​

Python 是本地 AI 工具链的重要基础能力。很多 MCP Server、自动化脚本、数据处理工具、Playwright 辅助脚本和本地 Agent 扩展都会依赖 Python 环境。

本文用 Python 3.12.x 演示。如果项目配置要求其他版本,优先遵循项目要求；如团队需要完全一致的补丁版本,再由项目单独指定,不必照抄文档中的旧补丁号。

Windows 11 ​

方式一:winget 安装 ​

powershell
winget install --id Python.Python.3.12

安装后重新打开 PowerShell,验证:

powershell
py -3.12 --version
python --version
pip --version

如果 python 命令不可用,检查安装时是否勾选 Add python.exe to PATH,或重新打开终端。

方式二:官方安装包 ​

也可以从 Python 官网下载 Python 3.12 系列的 Windows installer:

https://www.python.org/downloads/

安装时建议勾选:

  • Add python.exe to PATH
  • pip
  • py launcher

macOS ​

方式一:pyenv 安装 ​

如果需要固定到精确补丁版本,推荐用 pyenv。下面以 3.12.13 为例:

bash
brew install pyenv
pyenv install 3.12.13
pyenv global 3.12.13
python --version
pip --version

如果 shell 还没有加载 pyenv,按提示把初始化配置写入 ~/.zshrc 后重新打开终端。

方式二:官方安装包 ​

也可以从 Python 官网下载 macOS installer:

https://www.python.org/downloads/

安装后验证:

bash
python3 --version
pip3 --version

pip 基础配置 ​

如需使用国内镜像:

bash
python -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
python -m pip config list

Windows 如果 python 命令不可用,可使用:

powershell
py -3.12 -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
py -3.12 -m pip config list

这里只配置包索引地址,不默认设置 trusted-host。trusted-host 会改变 HTTPS 主机的证书校验行为；只有在明确理解网络环境和风险、并按组织要求处理证书问题时才单独配置。

建议验证 ​

bash
python --version
python -m pip --version
python -m venv .venv

Windows 可替换为:

powershell
py -3.12 --version
py -3.12 -m pip --version
py -3.12 -m venv .venv

下一步 ​

继续安装 Codex 与 Claude Code。