Skip to content

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 URLhttps://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 URLhttps://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 ​

  1. 打开 CC Switch → 设置 → 路由。打开路由总开关,在路由启用里打开 Claude。
  2. 回到 Claude 标签,编辑已有的快米兔供应商,或点 + 新建自定义供应商。不要用会写成根域名的 Anthropic 预设。
  3. 按下表填写,保存后点启用。
  4. 退出并重新打开 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 ​

  1. 仍在路由页,路由启用里打开 Codex。路由总开关保持打开。
  2. 切到 Codex 标签,编辑快米兔供应商,或新建自定义供应商。
  3. 按下表填写,保存后点启用。卡片上应出现「需要路由」。
  4. 关掉当前 Codex 终端,重新打开再试。
项填写
Base URLhttps://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 倍率最便宜
快米兔-CCMaxClaude Code Max长任务、大上下文,走专线
快米兔-GeminiGemini需要 Gemini 专线时
官方账号—需要用官方订阅额度时

常见问题 ​

现象原因 / 处理
切换了但 Claude Code 还是走旧配置没重启 claude 进程
macOS 打不开,提示「已损坏」xattr -cr /Applications/CC\ Switch.app
切换后报 404Claude 侧地址多加了 /v1
切换后报 401令牌复制时带了空格/换行
原来手写的 settings.json 被覆盖CC Switch 会接管 env 段,其它字段(model、hooks 等)保留;重要配置先备份

配套阅读 ​

文档持续更新 · 以 模型广场 公示为准