Windows 11 环境

1. 安装 nvm

Windows 原生环境使用 nvm-windows。进入 Releases 下载并安装最新的 nvm-setup.exe:

https://github.com/coreybutler/nvm-windows/releases

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

nvm version

2. 可选：设置 nvm 下载镜像

如果访问 Node.js 官方下载源较慢，可先配置 nvm 镜像；网络正常时直接跳到下一步。此时还没有安装 Node.js，不要运行 npm config。

nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

3. 安装 Node.js 24 LTS

nvm install 24
nvm use 24
node -v
npm -v

如果项目明确要求 Node.js 22,把命令中的 24 替换为 22。如果项目有 .nvmrc、.node-version 或 engines.node,请优先遵循项目配置,详见版本选择说明。

只有 Node.js 和 npm 都安装成功、且访问默认 npm registry 较慢时，再按需设置 npm 镜像：

npm config set registry https://registry.npmmirror.com
npm config get registry

需要恢复官方源时运行 npm config set registry https://registry.npmjs.org。

如果 node 或 npm 命令不可用,关闭当前终端并重新打开 PowerShell。

4. 可选安装:增强 AI 工具能力

安装 ripgrep:

winget install BurntSushi.ripgrep.MSVC

安装 PowerShell 7:

winget install --id Microsoft.PowerShell

验证:

rg --version
pwsh --version

ripgrep 可提升本地代码搜索效率,PowerShell 7 可提供更现代的终端环境,对 Codex、Claude Code、MCP 工具和本地脚本协作更友好。

下一步

继续安装 Codex 与 Claude Code。需要 Python 脚本、MCP 或自动化时,再参考安装 Python 3.12.x。