外观
Windows 平台安装 Node.js
Claude Code、CodeX、Gemini CLI 这类工具基本都依赖 Node.js。建议直接安装 18+ 或 20 LTS,避免版本过低导致命令无法运行。
推荐安装方式
方式一:官方安装包
- 访问 https://nodejs.org/zh-cn/download
- 下载 LTS 版本的 Windows Installer(
.msi) - 一路默认安装
- 安装完成后重新打开终端
方式二: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 优先级混乱。