CC Switch
CC Switch 是跨平台配置管理工具，可在图形界面中管理 Claude Code、Codex、Gemini CLI、OpenCode、Grok Build 等客户端。需要同时使用多个 CLI 时，它比手工维护多份 JSON、TOML 和 .env 更方便。
安装
从 CC Switch 官方 Releases 下载对应系统版本。
macOS 也可使用 Homebrew：
bash
brew install --cask cc-switch添加猫咖啡 API
- 打开 CC Switch，在顶部选择要配置的工具，例如 Codex。
- 点击 添加供应商，选择自定义供应商。
- 名称填写
猫咖啡 API。 - 粘贴在控制台创建的独立令牌。
- 按目标工具填写请求地址和模型。
- 添加后回到主界面，选择该供应商并点击 启用。
- 退出并重新打开对应 CLI 做测试。
各工具地址
| 工具 | 请求地址 | 协议/后端 |
|---|---|---|
| Codex | https://coffeecatbox.cc/v1 | Responses |
| Claude Code | https://coffeecatbox.cc | Anthropic Messages |
| Gemini CLI | https://coffeecatbox.cc | Gemini 原生 |
| OpenCode | https://coffeecatbox.cc/v1 | OpenAI Compatible |
| Grok Build | https://coffeecatbox.cc/v1 | Responses |
模型名从控制台复制，不要使用 CC Switch 模板中其他服务商的预设模型名。
通用供应商
新版 CC Switch 支持将一份通用供应商配置同步到多个工具。同步后仍需逐项检查地址和协议，因为 Claude、Codex 与 Gemini 使用的接口格式不同。
配置不生效
- 确认主界面中“当前使用”的供应商确实是猫咖啡 API；
- 切换后重启终端或 CLI；
- 检查 CC Switch 是否写入了正确的用户配置目录；
- 不要同时让另一个配置管理工具覆盖相同文件；
- 先备份已有配置，再使用导入或同步功能。
安全建议
CC Switch 会集中管理多个工具的密钥。启用云同步前确认同步服务可信，并避免把包含真实令牌的导出文件发送到公开位置。