CC Switch
选择模型与匹配密钥，通过 CC Switch 配置五种 CLI。
CC Switch 是一个用于管理 AI 编程工具供应商配置的桌面应用。它适合同时使用 Claude Code、Codex 或其他支持自定义供应商的工具：你可以在一个界面中保存服务商、模型和密钥，再将配置应用到目标工具。
第 1 步：下载安装
前往 GitHub Releases 下载对应系统的安装包（Windows / macOS / Linux）。安装后启动一次，让系统注册 ccswitch:// 协议。
第 2 步：一键导入
点击下方 打开统一配置引导，选择目标应用和模型，再选择或创建匹配密钥。也可以在弹窗内选择分组，快捷创建一枚无限额度、不过期且只属于该分组的密钥；需要额度、期限或 IP 限制时，到 API 密钥 页调整。浏览器唤起 CC Switch 后，确认导入即可。
通过 CC Switch 配置 CLI
选择目标应用和模型，再选择或创建匹配密钥。支持 Claude Code、Codex、Gemini CLI、Grok Build 和 OpenCode。
打开统一配置引导支持 Claude Code、Codex、Gemini CLI、Grok Build 和 OpenCode。地址会按目标工具自动填写，无需手动增删 /v1。模型建议按密钥分组、模型限制和协议能力筛选；手动输入时会提示已知协议。模型需使用令牌所属分组支持的完整 ID。
Codex 使用仅支持 OpenAI Chat Completions 的模型时：导入后打开 CC Switch 中对应 Codex 供应商的「高级选项」，将「上游格式」设为 Chat Completions；再到「设置 → 路由 → 本地路由」开启总开关和 Codex。CC Switch 导入链接目前会给 Codex 写入 Responses 配置，不能通过链接指定上游 Chat 格式；本地路由负责把 Codex 的 Responses 请求转换为上游 Chat 请求。支持原生 Responses 的模型无需该步骤。参见 CC Switch 官方路由指南。
也可以从 API 密钥 页的令牌操作菜单打开 CC Switch 导入入口。
第 3 步：开始使用
在 CC Switch 中启用刚导入的供应商，重启对应 CLI 后发送一条消息。可在 调用日志 中确认请求结果。
方式二：手动添加服务商
在 CC Switch 中新建服务商，名称可以填写 Toodoo AI。下表只列出协议和地址差异，具体字段名称随 CC Switch 版本和目标应用变化：
| 目标工具 | 协议方向 | Base URL / Endpoint | 模型填写方式 |
|---|---|---|---|
| Claude Code | Anthropic Messages | https://toodooai.com | 填写支持 Messages 的完整模型 ID。 |
| Codex CLI | Responses；Chat-only 模型须启用 CC Switch 本地路由 | https://toodooai.com/v1 | 填写完整模型 ID，并按上方说明设置上游格式。 |
| OpenCode | OpenAI Compatible | https://toodooai.com/v1 | 保留完整模型 ID；服务商前缀由 OpenCode 自己管理。 |
| Gemini CLI | Gemini | https://toodooai.com | 选择支持 Gemini 协议的完整模型 ID。 |
| Grok Build | Responses | https://toodooai.com/v1 | 填写支持 Responses 的完整模型 ID。 |
不要为了“统一格式”给所有工具都加上 /v1：Claude Code 使用根地址，Codex、OpenCode 和多数 OpenAI 兼容客户端使用 /v1。保存后查看 CC Switch 或目标工具显示的最终请求地址。
模型与分组检查
导入成功只代表配置写入本地，不代表模型一定能调用。逐项检查：
- 模型 ID 是否完整，是否仍保留渠道前缀。
- 当前 API 密钥的分组是否包含该模型。
- Claude Code 是否使用支持 Anthropic Messages 的模型；Codex 的 Chat-only 模型是否配置了上游格式与本地路由。
- 工具是否已把导入的服务商设置为当前活动配置。
- 密钥是否启用、未过期，并且额度或 IP 限制没有阻止当前电脑。
验证与排障
建议按以下顺序验证：
- 在目标 CLI 中发送一句短消息。
- 在 Toodoo AI 的日志功能中查找刚才的时间和模型。
- 基础文本成功后，再测试文件读取、工具调用和长上下文。
| 现象 | 优先检查 |
|---|---|
| 点击导入没有打开应用 | CC Switch 是否启动过、浏览器是否阻止 ccswitch://、默认协议关联是否存在。 |
| 导入后工具仍访问旧地址 | 目标工具已有环境变量、配置文件或登录状态覆盖了 CC Switch 配置；重启工具后重新检查。 |
| 返回 401 / 403 | 密钥状态、分组、模型限制、IP 白名单和目标工具发送的认证头。 |
| 返回 404 | Base URL 是否多写或漏写 /v1，以及客户端是否再次自动拼接路径。 |
| 请求到达但模型失败 | 目标模型是否支持对应协议、工具调用或其他高级参数。 |
更多状态码说明见错误码与排障。
凭据安全
- 为不同工具或设备创建不同密钥；一个密钥泄露时可以单独撤销。
- 不要把密钥写进公开的 CC Switch 导出文件、dotfiles 仓库或截图。
- 分享配置前删除密钥、Cookie、登录信息和完整导入链接。
- 怀疑泄露时先停用旧密钥，再创建新密钥并检查近期日志。