Skip to content

Windows 平台安装 Node.js

Claude Code、Codex CLI、Gemini CLI 都是基于 Node.js 的命令行工具,必须先装好 Node.js 才能运行。

需要什么版本

Node.js 18 或更高版本,推荐直接用当前 LTS 版本(20 或 22)。

方法一:官网安装包(推荐新手)

  1. 打开 https://nodejs.org/zh-cn
  2. 下载标着 LTS 的那个版本(Windows Installer,.msi
  3. 双击安装,一路下一步即可
  4. 安装向导里如果看到「Add to PATH」选项,确保它是勾选状态

安装完成后验证:

powershell
node -v
npm -v

两条命令都能打印出版本号(如 v22.11.0)就说明成功了。

方法二:nvm-windows(推荐进阶用户)

如果你需要在多个 Node 版本之间切换,用 nvm 更省事。

  1. nvm-windows 发布页 下载 nvm-setup.exe
  2. 安装完成后以管理员身份打开 PowerShell
  3. 执行:
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 没配好。解决方式:

  1. 关掉当前终端窗口,重新打开一个(PATH 变更需要新窗口才生效)
  2. 还不行就重启电脑
  3. 仍然不行,手动添加:设置 → 系统 → 系统信息 → 高级系统设置 → 环境变量,在用户变量的 Path 里加入 Node.js 安装目录

npm 安装很慢或超时

换成国内镜像源:

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

全局安装报权限错误

用管理员身份重新打开 PowerShell 再执行安装命令。或者把 npm 的全局目录改到用户目录下:

powershell
npm config set prefix "%APPDATA%\npm"

下一步

Aivisx Link · AI API 网关平台