跳转到内容

Windows 平台安装 Node.js

AI 编程工具的常用运行环境。

重要说明

Claude Code 和 Codex CLI 都需要 Node.js 18+ 运行环境。如果您已安装 Node.js 18 或更高版本,可跳过本章节。

验证命令:node -v

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

  1. 访问 Node.js 官网:https://nodejs.org/zh-cn/download
  2. 下载 LTS(长期支持)版本的 Windows Installer(.msi)。
  3. 运行安装包,采用默认配置完成安装。
  4. 安装程序会自动配置系统 PATH 环境变量。

Node.js 下载页面

Node.js Windows 下载页面

方法二:包管理器安装

使用 Winget

Windows 11 或 Windows 10 最新版可以使用:

powershell
winget install OpenJS.NodeJS.LTS

使用 Chocolatey

需先安装 Chocolatey:

powershell
choco install nodejs-lts

使用 Scoop

powershell
scoop install nodejs-lts

验证安装

打开命令提示符或 PowerShell,执行:

powershell
node --version
npm --version

如果显示版本号(如 v18.x.x 或更高),说明安装成功。

常见问题

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

  1. 重新打开终端窗口。
  2. 检查 PATH 环境变量是否包含 Node.js 路径。
  3. 重启电脑后再试。

安装失败

  1. 以管理员身份运行安装程序。
  2. 关闭杀毒软件后重试。
  3. 检查系统盘空间是否充足。

下一步

✅ 环境准备完成!

现在您可以继续安装 Claude Code、Codex CLI、Codex Desktop 或 OpenCode 了。