# Windows 平台安装 Node.js 

**三大 AI 编程工具的必备运行环境**

💡 重要说明

Claude Code、CodeX 和 Gemini 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 环境变量

![NodeJS下载页面](https://docs.ikuncode.cc/images/tu4.png)

## 方法二：包管理器安装 

### 使用 Winget 

Windows 11 或 Windows 10 最新版：

powershell
    
    
    winget install OpenJS.NodeJS.LTS

1  

### 使用 Chocolatey 

需先安装 Chocolatey：

powershell
    
    
    choco install nodejs-lts

1  

### 使用 Scoop 

powershell
    
    
    scoop install nodejs-lts

1  

## 验证安装 

打开命令提示符或 PowerShell，执行：

powershell
    
    
    node --version
    npm --version

1  
2  

如果显示版本号（如 v18.x.x 或更高），说明安装成功。

## 常见问题 

### 提示"不是内部或外部命令"

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

### 安装失败 

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

## 下一步 

✅ 环境准备完成！

现在您可以继续安装 Claude Code、CodeX 或 Gemini CLI 了。

  * [返回环境安装总览](</node/windows>)
  * [安装 Claude Code](</deploy/claude-code>)
  * [使用 CC-Switch 工具](</tools/cc-switch>)