环境检查（通用步骤）

适用于 Windows、macOS（Linux 同理，路径将 ~ 换为你的 home 目录）。

（1）确认 Node.js 已安装

在终端执行：

npm list -g --depth=0

• 正常：有输出或空白列表均可。
• 异常：提示「命令未找到」→ 需先安装 Node.js LTS（建议 18+），安装后重新打开终端再执行上述命令。

也可单独检查：

node -v
npm -v

（2）全局安装 CLI

一次性安装本教程涉及的三个 CLI（可按需只装其中一个）：

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

国内网络慢时可加镜像，例如：

npm i -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

（3）测试安装并生成配置目录

重要：请务必各运行一次下面的命令，用户目录下才会生成 ~/.claude、~/.codex、~/.gemini 等文件夹，后续配置才有着落。

Claude Code

claude

若出现交互界面或引导选项，说明安装成功。按 Ctrl+C 或按提示退出即可。

Codex

codex

出现界面或配置向导即成功。

Gemini

gemini

出现界面或配置向导即成功。

（4）下一步

• 已有 API Key → 进入对应教程：
  • Claude Code 配置
  • Codex 配置
  • Gemini 配置

常见安装问题

现象	处理
EACCES 权限错误	macOS/Linux 勿用 sudo npm -g；用 nvm 或修复 npm 全局目录权限
公司代理	配置 npm config set proxy / HTTPS_PROXY
版本过旧	npm i -g 包名@latest 强制升级