多工具切换
用 CC Switch 统一管理
本教程里说的 CC Switch，是一个桌面管理工具，不是模型服务。它自己不发模型请求，只替 Codex、Claude Code、Claude Desktop 与 Gemini CLI 写配置。适合你经常换供应商，不想在每个工具里改一遍文件。
安装并添加供应商
- 1
安装 CC Switch
从 CC Switch 官方网站或其 GitHub Releases 下载 macOS / Windows 版本。首次启动时允许它管理对应客户端配置。
- 2
按应用添加「自定义」供应商
不要只保存供应商；保存后还要点击「启用」，确认供应商卡片变为当前状态。
- 3
填写端点、Key 与模型
按下表填写。模型字段以控制台「使用密钥」或 选模型 中的 ID 为准。
- 4
看清实际路由
若开启「代理接管」，客户端里的 live Base URL 会变成本机
127.0.0.1地址，这是正常现象；由 CC Switch 再转发到本站。
| 应用 | Base URL | 协议 / 关键字段 |
|---|---|---|
| Codex | https://sub.geiliapi.com/v1 | Responses；wire_api = responses |
| Claude Code | https://sub.geiliapi.com | Anthropic；Key 字段选 ANTHROPIC_AUTH_TOKEN |
| Claude Desktop | https://sub.geiliapi.com | Anthropic Gateway；也可直接使用应用内 Third-Party Inference |
| Gemini CLI | https://sub.geiliapi.com | Gemini；GOOGLE_GEMINI_BASE_URL |
验证第一次请求
- 1
确认已启用
供应商卡片必须是当前状态。保存了但没点「启用」，客户端仍会走旧配置。
- 2
用被接管的客户端发一句
在 Codex / Claude / Gemini 里发送
只回复 OK，再到控制台「使用记录」核对 Key 和模型。
这个工具的故障
保存了但客户端没变
还要点击「启用」。只保存供应商不会切换当前路由。
live URL 变成 127.0.0.1
开启「代理接管」时这是正常现象：客户端打本机，由 CC Switch 再转发到本站。以当前 Provider、绿色状态和请求计数为准。
错误正文仍出现 api.openai.com
客户端还在走官方或旧进程。暂时关闭自动故障转移，确认当前 Provider 是 GeiliAPI，然后完全退出被接管的客户端再重开。