环境检查

在配置 Claude Code、Codex 或 Gemini CLI 之前，请先确认本机已经正确安装 Node.js。

检查 Node.js

在 Windows、macOS 或 Linux 终端中执行：

node -v
npm -v

如果输出版本号（例如 v20.10.0、10.2.3），说明 Node.js 与 npm 已经可用。

进一步可以执行：

npm list -g --depth=0

来查看已经全局安装的包。即使输出中没有安装任何全局包，也不影响后续配置。

必须先完成环境检查

CLI 工具依赖 Node.js 和 npm。环境没有准备好时，后续安装 Claude Code、Codex、Gemini CLI 都可能失败。

没有安装 Node.js？

如果提示"命令未找到"或类似错误，说明当前环境还没有安装 Node.js，或安装后没有正确加入系统环境变量。

Windows

1. 访问 Node.js 官网 下载 LTS 版本（推荐 v20 或 v22）
2. 运行安装程序，全程默认即可
3. 安装完成后重启终端
4. 重新执行 node -v

macOS

推荐使用 Homebrew：

brew install node

或者去 Node.js 官网 下载安装包。

Linux

使用包管理器：

# Debian / Ubuntu
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# CentOS / RHEL
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

配置 npm 镜像（中国大陆用户推荐）

为了加速 npm 安装，可以使用国内镜像：

npm config set registry https://registry.npmmirror.com

恢复官方源：

npm config set registry https://registry.npmjs.org

版本要求

工具	最低版本	推荐版本
Node.js	v18	v20 LTS / v22 LTS
npm	v9	v10+

完成环境检查后，进入下一步：配置 CLI 工具。