环境检查
配置任何 CLI 之前，先确认 Node.js、CLI 和配置目录都没问题
强烈建议先做这一步
有经验、能确认 Node.js 环境和各 CLI 都装好、配置目录也已存在的话，可以跳过，直接去 CC Switch 或各工具的配置页。其他情况请一步步做完，后面大部分「配置了不生效」都出在这里。
1. 确认 Node.js 已安装
Claude Code、Codex、Gemini CLI、Kimi Code 都通过 npm 安装，需要先装 Node.js（建议 20 以上，Kimi Code 要求 22.19.0 以上）。在终端运行：
npm list -g --depth=0- 能正常输出（哪怕下面一个包都没有）说明 Node.js 和 npm 可用；
- 提示「命令未找到」/
'npm' 不是内部或外部命令，说明还没装 Node.js，或装了但没加进环境变量。
没装的话到 Node.js 官网 下载 LTS 版本安装，装完重新打开终端，再运行一次上面的命令确认。
Windows 还需要 Git
Claude Code 在 Windows 上依赖 Git 环境，启动时提示缺少 Git 的话，先安装 Git for Windows。也可以直接在 WSL 里运行，体验通常更好。
2. 安装 CLI
按需安装，用不到的可以跳过：
npm i -g @anthropic-ai/claude-code@latest3. 运行一次，生成配置目录
这一步一定要做
CLI 第一次运行时才会在用户目录下生成配置目录（.claude、.codex、.gemini、.grok、.kimi-code），后面的配置都写在这些目录里。
claude出现欢迎界面或让你选择主题等选项，说明安装成功，按 Ctrl + C 退出即可。
如果提示 Unable to connect to Anthropic services，或一直要求登录 Anthropic 账号，先按 跳过 Claude Code 初次登录 处理，再继续配置。
4. 确认配置目录存在
| 工具 | Windows | macOS / Linux / WSL |
|---|---|---|
| Claude Code | %USERPROFILE%\.claude | ~/.claude |
| Codex | %USERPROFILE%\.codex | ~/.codex |
| Gemini CLI | %USERPROFILE%\.gemini | ~/.gemini |
| Grok Build | %USERPROFILE%\.grok | ~/.grok |
| Kimi Code | %USERPROFILE%\.kimi-code | ~/.kimi-code |
打开方式：
- Windows：按
Win + R，粘贴上表里的路径后回车； - macOS：在访达里按
Command + Shift + G，粘贴路径后回车； - Linux / WSL：
cd ~/.claude这样直接进入。
目录不存在就手动新建一个同名文件夹。
