外观
Windows 平台安装 Node.js
Claude Code、Codex CLI、Gemini CLI 都是基于 Node.js 的命令行工具,必须先装好 Node.js 才能运行。
需要什么版本
Node.js 18 或更高版本,推荐直接用当前 LTS 版本(20 或 22)。
方法一:官网安装包(推荐新手)
- 打开 https://nodejs.org/zh-cn
- 下载标着 LTS 的那个版本(Windows Installer,
.msi) - 双击安装,一路下一步即可
- 安装向导里如果看到「Add to PATH」选项,确保它是勾选状态
安装完成后验证:
powershell
node -v
npm -v两条命令都能打印出版本号(如 v22.11.0)就说明成功了。
方法二:nvm-windows(推荐进阶用户)
如果你需要在多个 Node 版本之间切换,用 nvm 更省事。
- 到 nvm-windows 发布页 下载
nvm-setup.exe - 安装完成后以管理员身份打开 PowerShell
- 执行:
powershell
nvm install lts
nvm use lts
node -v方法三:包管理器
如果你已经装了 winget 或 Scoop:
powershell
# winget
winget install OpenJS.NodeJS.LTS
# Scoop
scoop install nodejs-lts安装客户端工具
Node.js 装好后,用 npm 全局安装需要的 CLI:
powershell
npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex
npm install -g @google/gemini-cli按需安装即可,不必全装。
常见问题
node 不是内部或外部命令
说明 PATH 没配好。解决方式:
- 关掉当前终端窗口,重新打开一个(PATH 变更需要新窗口才生效)
- 还不行就重启电脑
- 仍然不行,手动添加:
设置 → 系统 → 系统信息 → 高级系统设置 → 环境变量,在用户变量的Path里加入 Node.js 安装目录
npm 安装很慢或超时
换成国内镜像源:
powershell
npm config set registry https://registry.npmmirror.com全局安装报权限错误
用管理员身份重新打开 PowerShell 再执行安装命令。或者把 npm 的全局目录改到用户目录下:
powershell
npm config set prefix "%APPDATA%\npm"