环境检查（通用步骤）

所有 CLI 工具都依赖 Node.js 环境，配置前请先完成以下检查。

1. 检查 Node.js

node -v
npm -v

要求：

• Node.js >= v18（推荐 v20 LTS 或 v22 LTS）
• npm >= v9

未安装请参考 快速开始 → 环境检查。

2. 安装 CLI

Claude Code

npm install -g @anthropic-ai/claude-code

Codex

npm install -g @openai/codex

Gemini CLI

npm install -g @google/gemini-cli

3. 验证安装

claude --version   # Claude Code
codex --version    # Codex
gemini --version   # Gemini CLI

输出版本号即说明安装成功。

Windows 用户

如果在 PowerShell 中执行 claude 提示 "无法加载文件，因为在此系统上禁止运行脚本"，请以管理员身份运行 PowerShell 并执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后输入 Y 确认。

4. 配置 npm 镜像（可选）

中国大陆用户建议配置国内镜像加速：

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

如果使用代理，配置好后取消镜像，避免代理与镜像冲突：

npm config delete registry

环境就绪后，请前往对应 CLI 的配置教程。