准备说明

目标

完成本快速开始后,本机应具备以下能力:

• 使用 nvm 管理 Node.js 版本
• 没有项目特殊要求时使用 Node.js 24 LTS;老项目按要求使用 22 LTS
• 需要 Python 工具、MCP、脚本和自动化时,再安装 Python 3.12.x
• 网络较慢时可选用国内 npm 镜像,不强制修改默认源
• 安装 codex 或 claude（可以只选择其中一个）
• 可选:安装 CC Switch 管理多个 CLI 配置
• 可选:在 IDEA 中通过 CC GUI 使用 Codex 或 Claude Code

平台选择

Windows 11 原生 PowerShell 与 macOS 的 nvm 实现不同:

• Windows 11 原生 PowerShell: 使用 nvm-windows
• macOS: 使用 nvm-sh/nvm
• Windows 11 + WSL2: 在 WSL2 中按 macOS / Linux 方式安装 nvm-sh/nvm

不要在 Windows 原生 PowerShell 中直接使用 nvm-sh/nvm 的安装脚本。

版本选择和项目配置优先级见版本选择说明。

镜像说明

以下镜像是可选的,仅在官方源访问较慢时使用。npm 的镜像设置必须在安装 Node.js 后执行:

Node.js 镜像: https://npmmirror.com/mirrors/node/
npm 镜像: https://registry.npmmirror.com

nvm-windows 还可以单独设置 npm 安装包镜像:

https://npmmirror.com/mirrors/npm/

可选增强工具

Windows 11 建议额外安装:

• ripgrep:高速全文搜索工具,AI Agent 读代码和定位内容时很常用
• PowerShell 7:比系统自带 Windows PowerShell 更新,终端体验和跨平台兼容性更好