211API

Windows 安装 Node.js ​

Claude Code、CodeX 和 Gemini CLI 都依赖 Node.js 18+ 运行环境。已安装过的话可跳过本页，用 node -v 确认版本即可。

方法一：官方安装包（推荐） ​

  1. 访问 Node.js 官网下载页：nodejs.org/zh-cn/download。
  2. 下载 LTS（长期支持）版本的 Windows Installer（.msi）。
  3. 运行安装包，按默认配置完成安装 —— 安装程序会自动配置 PATH 环境变量。

方法二：包管理器 ​

Winget（Windows 11 / Windows 10 最新版自带）：

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey：

powershell
choco install nodejs-lts

Scoop：

powershell
scoop install nodejs-lts

验证安装 ​

打开新的命令提示符或 PowerShell 窗口，执行：

powershell
node --version
npm --version

输出版本号（v18.x.x 或更高）即安装成功。

npm 下载慢？

可将 npm registry 切换为国内镜像：npm config set registry https://registry.npmmirror.com

常见问题 ​

提示"不是内部或外部命令" — 重开终端窗口；检查 PATH 是否包含 Node.js 安装路径；仍不行重启电脑后再试。

安装失败 — 以管理员身份运行安装程序，临时关闭杀毒软件，确认系统盘空间充足。

下一步 ​

环境就绪，选择要接入的工具：