跳到主要内容

安装 Node.js

Claude Code、Codex CLI 的部分安装方式依赖 Node.js / npm。
建议安装 Node.js 20 LTS 或更高。

检查是否已安装​

node --version
npm --version

两行都能输出版本号即表示环境可用。

Windows​

方法一：官方安装包（推荐）​

  1. 打开 https://nodejs.org
  2. 下载 LTS 的 Windows Installer（.msi）
  3. 一路下一步完成安装
  4. 重新打开 PowerShell / 终端后再执行 node --version

方法二：winget​

winget install OpenJS.NodeJS.LTS

方法三：Chocolatey​

choco install nodejs-lts

macOS​

Homebrew（推荐）​

brew install node@20

官网 pkg​

从 nodejs.org 下载 macOS LTS 安装包。

Linux​

Ubuntu / Debian​

# 使用 NodeSource 获取较新 LTS（示例：20.x）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora​

sudo dnf install nodejs npm

验证​

node -v   # 期望 v20.x 或更高
npm -v
提示

若命令找不到，通常是终端没重启，或安装时未勾选「Add to PATH」。关掉终端重开再试。