环境检查

不同 CLI 的安装方式对环境的要求不同，配置前先了解一下。

Claude Code：无需 Node.js

Claude Code 官方现已首推原生安装脚本，安装的是独立二进制，不依赖 Node.js。直接看 配置 Claude Code 即可，无需本节的 Node 检查。

Codex / Gemini CLI：需要 Node.js

Codex 与 Gemini CLI 通过 npm 安装，依赖 Node.js（18+）。在终端执行：

node -v
npm -v

如果都能输出版本号，说明环境就绪。

如果提示「命令未找到」，说明还没安装 Node.js 或未正确加入环境变量。请先完成 Node.js 安装，再重新执行确认。

也可以用 Homebrew / cc-switch

• macOS 上 Codex / Gemini 可用 Homebrew 安装，无需手动管 npm。
• 或用 cc-switch（v3.16.0+）在应用内一键安装 / 升级所有 CLI，自动处理来源与冲突。

安装后生成配置目录

无论用哪种方式安装，装好后请各运行一次 claude / codex / gemini，用户目录下才会生成对应的配置目录（.claude / .codex / .gemini），方便后续配置。

下一步 → 配置 Claude Code