Skip to content

Windows 平台安装 Node.js

Claude Code、CodeX、Gemini CLI 这类工具基本都依赖 Node.js。建议直接安装 18+ 或 20 LTS,避免版本过低导致命令无法运行。

推荐安装方式

方式一:官方安装包

  1. 访问 https://nodejs.org/zh-cn/download
  2. 下载 LTS 版本的 Windows Installer(.msi
  3. 一路默认安装
  4. 安装完成后重新打开终端

方式二:Winget

适合已经启用 Windows 包管理器的系统:

powershell
winget install OpenJS.NodeJS.LTS

方式三:Chocolatey

如果你本机已经使用 Chocolatey:

powershell
choco install nodejs-lts

方式四:Scoop

powershell
scoop install nodejs-lts

验证安装

打开 PowerShell 或 CMD,执行:

powershell
node -v
npm -v

只要 node 输出 18 或更高版本,基本就能继续往下配置。

常见问题

提示“不是内部或外部命令”

  • 先关闭当前终端再重新打开
  • 检查 PATH 是否已包含 Node.js 安装目录
  • 仍不行就重启系统

安装成功但 npm 很慢

可以先切换镜像源:

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

多个版本冲突

如果你之前装过旧版 Node,建议卸载旧版本后再装新版本,避免 PATH 优先级混乱。

下一步

真诚、稳定、好用