快速开始

面向 Windows 11 与 macOS 的 AI 编程工具链安装示例。不熟悉终端可先安装 ChatGPT 桌面端；需要 CLI 时再配置相应开发环境。

安装路径

图形界面入门：直接按ChatGPT 桌面端（Codex）安装与权限设置下载安装、登录并打开项目。仅安装桌面应用不要求先安装 Node.js / Python；运行具体项目时再按项目要求准备工具链。

终端入门：按下列步骤选择适合自己操作系统的 CLI 安装路径。

先完成准备和版本选择，再只选自己的操作系统完成环境安装。想尽快运行 CLI 时,可以直接跳到第 4 步；Python、CC Switch 与 IDEA 插件是可选增强,不是运行两个 CLI 的必需条件。

1. 准备说明
2. 版本选择说明
3. 按系统选择：Windows 11 环境 或 macOS 环境
4. 安装 Codex 与 Claude Code（两者可以只选一个）

可选增强:

• 安装 Python 3.12.x：需要 Python 脚本、MCP 或自动化时再安装。
• 安装 CC Switch：需要管理多个 CLI 配置时再安装。
• IDEA 开启 MCP：需要让 AI 使用 IDE 的索引、检查或调试能力时再配置。
• IDEA 安装 CC GUI：希望在 IDEA 窗口内使用 CLI 时再安装。

版本约定

• Node.js:没有项目特殊要求时推荐 24 LTS;老项目明确要求时可使用 22 LTS
• Python:仅在需要 Python 工具时安装 3.12.x,不必指定固定补丁号
• npm 镜像: 默认使用官方源,仅在网络较慢时可选 https://registry.npmmirror.com
• Windows 11 原生 PowerShell: 使用 nvm-windows
• macOS: 使用 nvm-sh/nvm
• Windows WSL2: 可在 WSL2 内按 macOS / Linux 的 nvm 安装方式处理

如果项目中存在 .nvmrc、.node-version、package.json 的 engines.node 或 CI 版本配置,请优先遵循项目要求。具体选择见版本选择说明。

参考文档

• nvm 官方 README: https://github.com/nvm-sh/nvm/blob/master/README.md
• nvm-windows: https://github.com/coreybutler/nvm-windows
• Codex CLI: Codex
• Claude Code: Claude Code
• CC Switch: CC Switch
• IDEA MCP: IDEA MCP