主题
CLI 配置教程
本节用于手动配置 Claude Code、Codex、Gemini CLI。
如果你是第一次配置，推荐优先使用 CC Switch；如果你熟悉配置文件，或者需要在服务器、远程环境中手动维护配置，可以继续阅读本节。
教程目录
| 教程 | 适合场景 | 入口 |
|---|---|---|
| 环境检查 | 确认 Node.js、CLI 命令和配置目录是否正常 | 查看教程 |
| Claude Code 配置 | 手动配置 Claude Code 的 API Key 和请求地址 | 查看教程 |
| Codex 配置 | 手动配置 Codex 的 config.toml 和 API Key | 查看教程 |
| Gemini 配置 | 手动配置 Gemini CLI 的 .env 文件 | 查看教程 |
推荐阅读顺序
- 先阅读 环境检查，确认本机环境可用。
- 根据你要使用的 CLI 选择对应教程：
- Claude Code：阅读 Claude Code 配置
- Codex：阅读 Codex 配置
- Gemini：阅读 Gemini 配置
- 配置完成后，运行对应命令测试是否能正常对话。
使用前准备
开始手动配置前，请先准备好：
- 已创建对应分组的 API Key
- 已安装对应 CLI 命令
- 账户有可用额度
- 知道当前系统的配置目录位置
TIP
如果你不确定 API Key 应该选择哪个分组，请先阅读 分组介绍。
WARNING
手动配置需要直接修改本机配置文件。复制命令和配置内容时，请注意不要多复制空格、换行或引号。