主题
CC Switch
CC Switch 是一个开源桌面小工具,用来在 Claude Code / Codex CLI 的多个供应商配置之间一键切换——不用每次手改 ~/.claude/settings.json 或 ~/.codex/config.toml,也不怕改错。
适用场景:
- 同时有官方账号和一个或多个中转商,想按任务切
- 有多把令牌(不同分组、不同项目),想快速换
- 团队里给不同人发不同令牌,配置要经常改
安装
到 CC Switch 的 GitHub Releases 下载对应平台安装包。
- macOS:
.dmg(首次打开若提示「已损坏」,执行xattr -cr /Applications/CC\ Switch.app) - Windows:
.exe - Linux:
.AppImage/.deb
添加快米兔 API 配置
打开 CC Switch → 切到 Claude 标签页 → 点 添加供应商。
| 字段 | 值 |
|---|---|
| 名称 | 快米兔 API |
| API 地址 / Base URL | https://api.52pay.com |
| 密钥 / Token | <您的令牌> |
保存后在列表里点一下这条配置,它就会被写进 ~/.claude/settings.json 的 env 段:
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.52pay.com",
"ANTHROPIC_AUTH_TOKEN": "<您的令牌>"
}
}切换后要重启 Claude Code
CC Switch 改的是配置文件,已经开着的 claude 进程不会重新读。切完记得退出再开。
添加 Codex 配置
切到 Codex 标签页 → 添加供应商:
| 字段 | 值 |
|---|---|
| 名称 | 快米兔 API |
| Base URL | https://api.52pay.com/v1 |
| 密钥 | <您的令牌> |
它会写进 ~/.codex/config.toml 的 [model_providers.*] 段和 ~/.codex/auth.json。
两边的地址不一样,别复制串了
- Claude 侧:
https://api.52pay.com(不带/v1) - Codex 侧:
https://api.52pay.com/v1(带/v1)
把协议改成 Chat
Claude Code 默认打 /v1/messages,Codex 默认打 /v1/responses。这两条到本站还会再转一层。要改成 /v1/chat/completions,用 CC Switch 的本地路由,不要自己把 Codex 的 wire_api 改成 chat,改了客户端起不来。
Claude Code
- 打开 CC Switch → 设置 → 路由。打开路由总开关,在路由启用里打开 Claude。
- 回到 Claude 标签,编辑已有的快米兔供应商,或点 + 新建自定义供应商。不要用会写成根域名的 Anthropic 预设。
- 按下表填写,保存后点启用。
- 退出并重新打开 Claude Code,再发一条短消息试一次。
| 项 | 填写 |
|---|---|
| 请求地址 | https://api.52pay.com/v1。必须带 /v1,末尾不要斜杠 |
| API Key | 控制台令牌,sk- 整段复制 |
| API 格式 | 高级选项里选 Chat Completions(需开启路由)。不要选 Anthropic Messages |
| 认证字段 | 保持 ANTHROPIC_AUTH_TOKEN |
和上面的直连地址不一样
直连 Messages 时,Claude 地址是 https://api.52pay.com,不带 /v1。改成 Chat 之后,CC Switch 里的请求地址要带 /v1。接管后,Claude Code 自己的地址会变成本机路由,真实地址留在 CC Switch 里。
Codex
- 仍在路由页,路由启用里打开 Codex。路由总开关保持打开。
- 切到 Codex 标签,编辑快米兔供应商,或新建自定义供应商。
- 按下表填写,保存后点启用。卡片上应出现「需要路由」。
- 关掉当前 Codex 终端,重新打开再试。
| 项 | 填写 |
|---|---|
| Base URL | https://api.52pay.com/v1。不要写成带 /chat/completions 或 /responses 的完整路径 |
| API Key | 同一把令牌 |
| 上游格式 | 高级选项里选 Chat Completions(需开启路由)。不要选 Responses(原生) |
Codex 本地仍显示 responses
接管之后,~/.codex/config.toml 里的地址应是 http://127.0.0.1:15721/v1,wire_api 仍是 responses。这是正常的:Codex 对本机仍说 Responses,CC Switch 再转成 Chat 发给本站。
多套令牌的实用配法
推荐按分组建多条配置,随时切:
| 配置名 | 令牌分组 | 什么时候用 |
|---|---|---|
快米兔-默认 | default | 日常,覆盖全部模型,0.7 倍率最便宜 |
快米兔-CCMax | Claude Code Max | 长任务、大上下文,走专线 |
快米兔-Gemini | Gemini | 需要 Gemini 专线时 |
官方账号 | — | 需要用官方订阅额度时 |
常见问题
| 现象 | 原因 / 处理 |
|---|---|
| 切换了但 Claude Code 还是走旧配置 | 没重启 claude 进程 |
| macOS 打不开,提示「已损坏」 | xattr -cr /Applications/CC\ Switch.app |
| 切换后报 404 | Claude 侧地址多加了 /v1 |
| 切换后报 401 | 令牌复制时带了空格/换行 |
原来手写的 settings.json 被覆盖 | CC Switch 会接管 env 段,其它字段(model、hooks 等)保留;重要配置先备份 |
