Node.js 环境准备
部分 CLI 通过 npm 安装，需要先准备 Node.js 环境。
哪些需要 Node.js
| 客户端 | 需要 Node.js | 最低版本 |
|---|---|---|
| Claude Code CLI | 是 | Node.js 22+ |
| Codex CLI | 是 | Node.js 16+（建议直接装 LTS） |
| Gemini / Antigravity CLI | 否 | 官方安装脚本 |
| Grok Build | 否 | 官方安装脚本 |
| Kimi Code CLI | 否 | 官方安装脚本 |
| 各类桌面版 | 否 | — |
| VS Code 插件 | 否 | — |
第一步：安装 Node.js
优先安装当前 LTS 版本。
Windows
- 按
Win+R，输入powershell，回车 - 打开 nodejs.org 下载 Windows 的 LTS
.msi安装包 - 双击安装包，按向导完成安装（不确定就保持默认）
macOS
打开终端（Command+Space 搜索「终端」），二选一：
# 方式一：Homebrew（推荐）
brew install node
# 方式二：官网下载 .pkg 安装包
# https://nodejs.org
Linux
# Debian / Ubuntu
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 或使用 nvm 管理多版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts
第二步：验证安装
关闭并重新打开终端，然后：
node --version
npm --version
两条命令都能输出版本号，说明环境准备完成。
:::tip 版本太低怎么办
如果 node --version 显示低于上表要求，请升级到 LTS。Node 版本过低会导致
claude / codex 启动报语法错误。
:::
第三步：npm 全局安装权限
如果执行 npm install -g 报权限错误：
# macOS / Linux
sudo npm install -g <包名>
# 或配置用户级全局目录，避免每次 sudo
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
Windows 用管理员身份打开 PowerShell 即可。