cc-switch

cc-switch 是开源的 Claude/Codex 多供应商配置管理桌面工具(Tauri 跨平台),把多个 API 配置存成一组「provider」,在系统托盘里一键切换当前生效的供应商,免去手动改 ~/.claude/settings.json / 环境变量的麻烦。

适合谁:同时在用 Anthropic 官方 + 第三方中转 + 自部署网关,或在「省钱」「主力」「兜底」之间频繁切换的开发者。

本教程:把 claude-api.org 加进 cc-switch,既能给 Claude Code 用 Anthropic 协议,也能给 Codex CLI / opencode 用 OpenAI 协议。

推荐渠道

按要切换到的客户端选:

• Claude Code / Claude Code IDE 插件 → Claude 官方(全模型)或 Claude sonnet 折扣(只 Sonnet,0.5x)
• Codex CLI / opencode / Cursor / Cline / Chatbox → OpenAI
• Gemini CLI → Gemini 官方

安装

去 farion1231/cc-switch releases 下你系统对应的安装包:

• Windows:*.msi / *.exe
• macOS:*.dmg(Intel 选 x64,Apple Silicon 选 aarch64)
• Linux:*.AppImage / *.deb

首次启动会在 ~/.cc-switch/ 建配置目录。

添加 claude-api.org 为 provider

cc-switch 主界面 → 左侧选要切的客户端(Claude Code / Codex / opencode / Gemini)→ 右上「添加」。

给 Claude Code(Anthropic 协议)

字段	值
名称	claude-api.org(随便起,方便辨识)
Base URL	https://claude-api.org
API Key	sk-你的key(后台 → API Keys 里的)

写「根」就够了,不要写 /v1

cc-switch 默认会自动给 base_url 加协议路径(如 /v1/messages)。所以只填根域名,不要带 /v1。如果你版本是 ≥ v3.13.0 且开了「Full URL Mode」,才需要写完整 endpoint。

cc-switch 会把这套配置写进 ~/.claude/settings.json 的 env 字段,等价于:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude-api.org",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的key"
  }
}

给 Codex CLI / opencode(OpenAI 协议)

字段	值
名称	claude-api.org
Base URL	https://claude-api.org(同上,不带 /v1)
API Key	sk-你的key

Codex 用 Anthropic 协议或 OpenAI 协议都行,但我们 OpenAI 渠道同时支持 ChatCompletions + Responses 两套协议,把 Codex 指过去最省心。

切换 + 生效

cc-switch 主面板点新建的 provider → 「应用」/「切换为当前」。

Claude Code 不会自动重载

切换后必须重启 Claude Code CLI(Ctrl+C 退出再重开),环境变量才会读到新值。Codex CLI 同理。

切完去托盘图标看,会显示当前生效的 provider 名,确认是你刚选的。

验证

任意终端跑(替换 sk-):

curl -sS https://claude-api.org/v1/messages \
  -H "x-api-key: sk-你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

回 200 + JSON = 接入成功。Claude Code 内部直接发一句 Hello 看回复也行。

常见问题

切换了但 Claude Code 还在用旧 provider

• 没重启:Claude Code 进程启动时读一次 env / settings.json,运行中改不会热生效,Ctrl+C 退出重开
• 系统级环境变量覆盖:如果你 shell rc(~/.zshrc / ~/.bashrc / Windows PowerShell $PROFILE)里早就写过 ANTHROPIC_AUTH_TOKEN,会优先于 cc-switch 的 settings.json。处理:把 rc 里的删掉,或者只留 cc-switch 一种来源

报 401

• key 复制时带空格了 → 重新复制
• key 绑的渠道跟客户端不匹配 → Claude Code 必须绑 Claude 官方 或 Claude sonnet 折扣;Codex CLI 必须绑 OpenAI
• 后台把 key 删了/重生成了 → 创个新的填回

报 503 No available accounts

模型名写错。我们没做短名兜底 — gpt-5 不会自动 fallback 到 gpt-5.4,直接 503。各渠道支持的精确模型名见 渠道与价格。

模型下拉里没有 claude-sonnet-4-6 / gpt-5.4

cc-switch 的模型字段是 free-text,直接打字填精确名即可,不用挑下拉项。

Base URL 写成 https://claude-api.org/v1 后 404

cc-switch 默认行为会再追加协议路径,变成 /v1/v1/messages。两个修法:

• 把 Base URL 改回根 https://claude-api.org(推荐)
• 在 cc-switch v3.13.0+ 开「Full URL Mode」,然后写完整 endpoint(不推荐,容易写错)

进阶

同时管几个不同身份/钱包的 key

cc-switch 的强项之一。后台多创几个 key(比如「我的 Cursor」「公司 Claude Code」「省钱测试」),每个 key 绑不同渠道,在 cc-switch 各建一个 provider,几秒钟切。比直接改环境变量优雅得多。

配合一键安装脚本

如果你只想跑 Claude Code 不想用 cc-switch,直接走我们的一键脚本:

curl -fsSL https://claude-api.org/install.sh | bash -s -- "sk-你的key"

写完 shell rc 重开终端即可。后续若想加多 provider,再装 cc-switch。

参考

• 项目主页:https://github.com/farion1231/cc-switch
• 用户手册:https://github.com/farion1231/cc-switch/tree/main/docs/user-manual

更多接入报错见 FAQ。