Windows 平台安装 Node.js
Windows 平台安装 Node.js
Claude Code、Codex、Gemini CLI 的必备运行环境
Node.js 是许多 AI 编程工具的基础运行环境。
在 Windows 上使用 Claude Code、Codex 或 Gemini CLI 前，建议先安装 Node.js 18 或更高版本。
Claude Code、Codex 和 Gemini CLI 都需要 Node.js 18+ 运行环境。
如果您已经安装 Node.js 18 或更高版本，可以直接跳过安装步骤。
验证命令：node -v
一、检查是否已安装 Node.js
打开 命令提示符 或 PowerShell，输入以下命令：
node -v如果显示类似下面的版本号，说明已经安装：
v18.x.x只要版本号是 v18.x.x 或更高，一般就可以满足 Claude Code、Codex、Gemini CLI 的运行要求。
二、方法一：官方安装包安装（推荐）
这是最适合新手用户的安装方式。
1. 访问 Node.js 官网
打开 Node.js 官方下载页面：
2. 下载 Windows 安装包
选择 LTS（长期支持）版本，下载：
点击 复制到剪贴板；将内容粘贴到 powershell
3. 运行安装程序
双击下载好的 .msi 安装包。
安装过程中保持默认选项即可，一路点击：
Next → Next → Install → Finish4. 自动配置环境变量
官方安装包通常会自动配置系统 PATH 环境变量。
安装完成后，重新打开 PowerShell 或命令提示符即可使用。
官方安装包稳定、简单，适合大多数 Windows 用户。
如果您不熟悉命令行工具，建议优先使用这种方式。
三、方法二：包管理器安装
如果您习惯使用命令行，也可以通过包管理器安装 Node.js。
使用 Winget 安装
适用于 Windows 11 或较新的 Windows 10 系统。
winget install OpenJS.NodeJS.LTS安装完成后，重新打开终端窗口。
Winget 是 Windows 自带的包管理器，适合经常使用命令行安装软件的用户。
使用 Chocolatey 安装
如果您已经安装 Chocolatey，可以执行：
choco install nodejs-lts使用 Chocolatey 前，需要先确保您的电脑已经正确安装 Chocolatey。
如果您没有安装过 Chocolatey，建议直接使用官方安装包方式。
使用 Scoop 安装
如果您已经安装 Scoop，可以执行：
scoop install nodejs-ltsScoop 更适合有一定命令行基础的用户。
普通用户不建议为了安装 Node.js 单独折腾 Scoop。
四、验证安装是否成功
安装完成后，重新打开 PowerShell 或 命令提示符，依次执行：
node --versionnpm --version如果都能显示版本号，例如：
v20.x.x10.x.x说明 Node.js 和 npm 已安装成功。
当 node --version 和 npm --version 都能正常显示版本号时，说明环境已经准备完成。
五、常见问题
提示“不是内部或外部命令”
如果输入 node -v 后提示：
node 不是内部或外部命令，也不是可运行的程序可以尝试以下方法：
- 关闭当前终端窗口，重新打开 PowerShell 或命令提示符；
- 重启电脑后再次尝试；
- 检查系统 PATH 环境变量是否包含 Node.js 安装路径；
- 重新运行 Node.js 官方安装包，并保持默认安装选项。
通常是因为终端还没有读取到新的环境变量，或者 Node.js 没有正确写入 PATH。
安装失败怎么办？
如果安装过程中失败，可以尝试：
- 右键安装包，选择 以管理员身份运行；
- 检查系统盘空间是否充足；
- 暂时关闭杀毒软件或安全软件后重试；
- 重新下载官方 LTS 安装包；
- 重启电脑后再次安装。
请尽量从 Node.js 官网下载安装包，不建议使用来路不明的第三方安装包。
npm 命令无法使用
如果 node -v 正常，但 npm -v 不正常，可以尝试重新安装 Node.js LTS 版本。
官方安装包默认会同时安装：
Node.jsnpmnpxnpm 是 Node.js 常用的包管理工具，很多 AI 编程工具安装时都可能会用到它。
六、安装完成后可以做什么？
Node.js 安装完成后，您就可以继续安装和使用以下工具：
- Claude Code
- Codex
- Gemini CLI
安装 AI 编程工具前，请先确认 node --version 显示的是 v18 或更高版本。
现在您可以继续安装 Claude Code、Codex 或 Gemini CLI 了。
支持与分享
如果这篇文章对你有帮助，欢迎分享给更多人或赞助支持！