准备说明

目标

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

使用 nvm 管理 Node.js 版本
使用 Node.js 22.x LTS,示例版本为 22.22.2
安装 Python 3.12.x,增强本地 AI 工具、MCP、脚本和自动化能力
npm 使用淘宝镜像
全局安装 codex 与 claude
安装 CC Switch 管理 Codex、Claude Code 等 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 的安装脚本。

镜像说明

本文使用以下镜像地址:

text

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

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

text

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

可选增强工具

Windows 11 建议额外安装:

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