CC Switch 怎么配置中转站：Claude Code 与 Codex 一键切换

CC Switch 配置中转站，就是给 Claude Code 和 Codex 各加一个自定义供应商，再点切换。最容易填错的是地址：Claude Code 不带 /v1，Codex 要带 /v1。

CC Switch 只改配置文件，不含 Claude Code 和 Codex 本体。下文的界面名称和文件路径取自 CC Switch 官方仓库的 README 和用户手册，对应 v4.0.6。

先看答案：CC Switch 配中转站 4 步

1. 在 GPTZZZ 控制台 /keys 页面建 Key。Claude Code 用 Claude官key 分组的 Key，Codex 用含 GPT 模型的分组（如 opai puls）的 Key。
2. 打开 CC Switch，侧栏选 Claude Code，点右上角「+」，选「自定义配置」。请求地址填 https://gptzzz.ai，再填 Key 和模型，点「添加」。
3. 侧栏换到 Codex，同样新建。请求地址填 https://gptzzz.ai/v1，上游格式保持 Responses（原生），模型映射里填 gpt-6-sol。
4. 点卡片上的切换按钮。Claude Code 立即生效；Codex 要退出后重新运行。

项目	Claude Code	Codex
请求地址	https://gptzzz.ai（不带 /v1）	https://gptzzz.ai/v1
Key 分组	Claude官key	opai puls、opai pro、pro200-500不降智或 GPT官key
模型示例	claude-sonnet-5	gpt-6-sol
上游格式	Anthropic Messages（原生）	Responses（原生）
CC Switch 写入的文件	~/.claude/settings.json	~/.codex/config.toml
切换后	即时生效	重启 Codex

切回官方：在同一个列表里切到 Claude Official 或 OpenAI Official，再按工具自己的流程登录。

Claude Code 常用模型（Claude官key 分组，0.39x；分组内完整模型见价格页分组一览）：

Codex 常用模型（单元格为“输入 / 输出”，“—”表示该分组没有这个模型）：

opai puls、opai pro、pro200-500不降智 在价格页标为“GPT 订阅号池”，GPT官key 和 Claude官key 标为“官方 Key”。Claude 模型还有缓存写入价，例如 claude-sonnet-5 缓存写入 ¥1.95（1 小时 ¥3.22）。价格页注明 claude-haiku-4.5 最早于 2026-10-15 退役。实际扣费以 GPTZZZ 模型价格页和控制台为准。

CC Switch 是什么，会改哪些文件

CC Switch 是 MIT 许可的开源桌面应用，支持 Windows、macOS 和 Linux。它管理 Claude Code、Codex、Gemini CLI、OpenCode 等 10 个工具的供应商，切换时不用手改 JSON 或 TOML。README 写明唯一官网是 ccswitch.io。

切换时，它只替换配置文件里的关键字段：请求地址、Key、模型名和接口协议。插件、Hook、权限、MCP、你自己加的设置和注释都原样保留。

第一次改写某个配置文件前，CC Switch 会把原文件备份到 ~/.cc-switch/backups/live-first-write/，每个文件只备份这一次。Windows 上的数据目录是 C:\Users\<用户名>\.cc-switch。

应用页顶部有「直连 / 路由 / 聚合」三种模式。GPTZZZ 同时提供 Anthropic Messages 和 Responses 接口，用默认的直连就行。路由和聚合要 CC Switch 一直开着，本文不涉及。

安装 CC Switch：macOS、Windows、Linux

只从 ccswitch.io 或 GitHub Releases 下载。官方手册提醒：要求付费、充值或索取登录凭据的“CC Switch”都不是官方渠道。截至 2026-10-10，Releases 上的最新版是 v4.0.6。

# macOS 安装与升级
brew install --cask cc-switch
brew upgrade --cask cc-switch

Windows 双击安装包没反应时，右键文件 → 属性 → 常规，勾选“解除锁定”。装好后打不开，先安装 Microsoft Edge WebView2。macOS 版已通过 Apple 签名和公证，可以直接打开。RHEL、Rocky、Alma 8–9 的系统库太旧，暂不支持。

首次启动时，CC Switch 会把 Claude Code、Codex 现有的配置导入成名为 default 的供应商，并添加官方供应商 Claude Official 和 OpenAI Official。原配置不会丢。还没装 Claude Code 或 Codex 的，可以在 CC Switch 侧栏底部的「应用」页一键安装。

添加 Claude Code 供应商：地址不带 /v1

1. 侧栏选 Claude Code，点页头右侧的「添加供应商」（+ 号）。
2. 第 1 步选「自定义配置」，它固定在「全部」分类的最上面。
3. 名称填 GPTZZZ；请求地址填 https://gptzzz.ai；API Key 填 Claude官key 分组的 Key。请求地址旁的「完整 URL」开关保持关闭。
4. 高级选项里的上游格式保持默认的 Anthropic Messages（原生），不用开本地路由。
5. 在页面下方的 JSON 编辑框核对 env，补上模型变量，然后点页脚的「添加」。

编辑框里的 env 最后应包含这些键：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gptzzz.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_GPTZZZ_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

Key 变量。CC Switch 手册的示例用 ANTHROPIC_API_KEY，ANTHROPIC_AUTH_TOKEN 是替代写法。GPTZZZ 两种都接受：前者发 x-api-key 头，后者发 Authorization: Bearer 头。保留一个就行。用 ANTHROPIC_API_KEY 时，交互模式下 Claude Code 会先让你确认一次是否使用这个 Key。

模型变量。改了 ANTHROPIC_BASE_URL，Claude Code 的 opus、sonnet、haiku 别名仍按 Anthropic API 解析，和 GPTZZZ 价格页对不上。opus 对应 claude-opus-5-5，价格页写作 claude-opus-5.5；sonnet、haiku 对应 Sonnet 5.5、Haiku 5.5，价格页上没有这两个型号。所以用 ANTHROPIC_MODEL 指定主模型，再用三个 ANTHROPIC_DEFAULT_*_MODEL 把别名指到价格页上的 ID。haiku 别名还用于后台任务；claude-haiku-4.5 即将退役，示例把它也指到 claude-sonnet-5。opus 则指到价格更低的 claude-opus-4.8；想用 claude-opus-5.5，改这一行即可。用到 fable 别名的，同样设置 ANTHROPIC_DEFAULT_FABLE_MODEL。

按手册，env 里的 ANTHROPIC_* 等变量属于关键字段，跟着这个供应商走，切到别家时会被换掉。编辑框里其余内容是全局设置，对所有供应商生效。

验证。切换到 GPTZZZ 后，运行 claude，输入 /status 看模型和连接信息，再发一句话测试。想让 VS Code 里的 Claude Code 插件也跟着切换，在「设置 → 应用配置」打开「应用到 Claude Code 插件」。手动配置的写法和验证细节见 Claude Code 中转站配置。

添加 Codex 供应商：地址带 /v1，用 Responses

1. 侧栏选 Codex，点「添加供应商」，选「自定义配置」。
2. 名称填 GPTZZZ；请求地址填 https://gptzzz.ai/v1；API Key 填 GPT 分组的 Key。「完整 URL」保持关闭。
3. 上游格式保持 Responses（原生）。Codex 只用 Responses 协议，GPTZZZ 的 /v1/responses 可以直连。
4. 在「模型映射」表加一行：「实际请求模型」填 gpt-6-sol，「菜单显示名」可以写同一个名字。默认模型留空时，用表里第一行。
5. 点「添加」。

切到这个供应商后，~/.codex/config.toml 里的关键部分类似下面这样（结构按 CC Switch 手册示例）：

model_provider = "custom"
model = "gpt-6-sol"

[model_providers.custom]
name = "custom"
base_url = "https://gptzzz.ai/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_GPTZZZ_API_KEY"

Codex 会自己请求 https://gptzzz.ai/v1/responses，所以地址只填到 /v1。截至 2026-10-10，Codex 官方配置参考写明 wire_api 只支持 responses。

模型映射。映射表会生成 ~/.codex/cc-switch-model-catalog.json，并在 config.toml 里多写一行 model_catalog_json 指向它，让 Codex 的 /model 列出这些模型。Codex 只在启动时读这个列表，改完要重启。所有终端里的 codex 共用一个后台守护进程，只重开 codex 可能还是旧列表。这时在终端运行 codex app-server daemon restart，重启守护进程。重启可能中断正在运行的任务。CC Switch 只在聚合模式下提示模型列表过期，直连模式下要自己重启。桌面版要彻底退出再打开，macOS 按 ⌘Q。模型输入框旁的「获取模型列表」按钮调用 /v1/models，取不到就从价格页复制 ID 手动填。

Key 是明文。Key 写在 config.toml 的 experimental_bearer_token 里。Codex 官方配置参考把这个字段标为不推荐，建议改用 env_key。别把这个文件提交到仓库或贴进工单。想让 Key 只放在环境变量里，按 Codex 配置中转 API 手动配置。

验证。退出 Codex 后重新运行 codex，发一句话测试。桌面版要彻底退出再打开，macOS 按 ⌘Q。

切换供应商：哪些要重启

在应用页点目标卡片的「切换」按钮（README 里写作「启用」），卡片会显示「使用中」。也可以右键系统托盘图标，在 Claude Code 或 Codex 子菜单里直接点供应商名称。

在工具里用 /model 临时换的模型，不会存回 CC Switch。下次切换会换回供应商里保存的模型；想长期改，就在 CC Switch 里编辑这个供应商。

正在使用的供应商不能删除，先切到别家再删。

用了中转怎么切回官方

1. 先回到直连。开过路由或聚合的，先在应用页点「回到直连」。路由模式下切不到官方供应商，Codex 的 OpenAI Official 例外。
2. 切到官方供应商。Claude Code 选 Claude Official，Codex 选 OpenAI Official，点切换。删掉了的，可以从预设里重新添加。
3. 重启并登录。Claude Code 在会话里用 /login 登录官方账号。Codex 重启后运行 codex login status 看当前登录方式；没登录就运行 codex login，在浏览器里完成登录。
4. 清掉冲突变量。以前在 ~/.zshrc 等文件里 export 过 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 的，删掉这几行再开新终端，否则 Claude Code 仍会连到中转。

Codex 的官方登录。默认设置下，切到第三方供应商时 CC Switch 会删除 ~/.codex/auth.json。删除前它把登录暂存到 ~/.cc-switch/codex-login-stash.json，切回 OpenAI Official 时原样还原，一般不用重新登录。想在用中转时保留官方登录，在「设置 → 应用配置」打开「非接管切换时保留官方登录」。

不再用 CC Switch 时，先切回官方供应商再退出或卸载。要找回 CC Switch 第一次改写前的原文件，看 ~/.cc-switch/backups/live-first-write/。

常见报错与排查

用 curl 绕开 CC Switch，能分清是 Key、模型的问题还是配置的问题。macOS / Linux 终端，Claude Code 那把 Key（Claude官key 分组）：

export GPTZZZ_API_KEY="YOUR_GPTZZZ_API_KEY"
curl -sS https://gptzzz.ai/v1/messages \
  -H "x-api-key: $GPTZZZ_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"Reply with exactly: CLAUDE_OK"}]}'

Codex 那把 Key（GPT 分组）：

export GPTZZZ_API_KEY="YOUR_GPTZZZ_API_KEY"
curl -sS https://gptzzz.ai/v1/responses \
  -H "Authorization: Bearer $GPTZZZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-sol","input":"Reply with exactly: CODEX_OK"}'

curl 正常而工具报错，问题在 CC Switch 或工具配置；curl 也报错，按 GPTZZZ 错误码速查手册和 中转 API 报错速查对照处理。Key 的保管见 API Key 安全指南。

不装 CC Switch：用 GPTZZZ 客户端

也可以用 GPTZZZ 桌面客户端。当前版本 v3.21.0（2026-09-12 发布），有 macOS（.dmg）和 Windows（.msi 与便携版 .zip，各有 x64 和 ARM64）。按更新说明：客户端只开放 Claude Code、Codex、小龙虾、爱马仕、Grok；登录后只写入列表，不再自动切换；原配置可一键恢复。

它和 CC Switch 都会改 Claude Code、Codex 的配置。同一台电脑上，建议只用其中一个来切换。

官方资料

• CC Switch 仓库与 README
• CC Switch GitHub Releases
• CC Switch 用户手册：安装指南
• CC Switch 用户手册：添加供应商
• CC Switch 用户手册：切换供应商
• CC Switch 用户手册：配置文件说明
• CC Switch 用户手册：常见问题
• Claude Code 环境变量（ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN）
• Claude Code 模型配置（模型别名与 ANTHROPIC_DEFAULT_*_MODEL）
• OpenAI Codex Configuration reference（wire_api、experimental_bearer_token）
• OpenAI Codex Authentication（codex login、auth.json）

常见问题

中转站怎么用 CC Switch？

先在中转站控制台建 Key，再在 CC Switch 侧栏选 Claude Code 或 Codex，点「+」选自定义配置，填请求地址、Key 和模型，最后点切换。以 GPTZZZ 为例，Claude Code 填 https://gptzzz.ai，Codex 填 https://gptzzz.ai/v1。

CC Switch 里 Claude Code 的请求地址要带 /v1 吗？

不带。填 https://gptzzz.ai，Claude Code 会自己请求 /v1/messages；多写 /v1 会让路径重复，请求失败。Codex 相反，要填到 /v1。

CC Switch 把 Codex 的 API Key 存在哪里？

切到第三方供应商时，Key 写进 ~/.codex/config.toml 里 [model_providers.custom] 表的 experimental_bearer_token，不写 auth.json。这是明文，不要提交或外发这个文件。

切换供应商后要重启 Claude Code 或 Codex 吗？

Claude Code 支持热重载，一般不用重启。Codex 要退出后重新运行 codex；桌面版要彻底退出再打开，macOS 按 ⌘Q。

用 CC Switch 切到中转后，怎么切回官方？

在列表里切到 Claude Official 或 OpenAI Official，开过路由的先点「回到直连」。然后重启工具，按官方流程登录：Claude Code 用 /login，Codex 用 codex login。Codex 默认会还原切走前暂存的官方登录。

「检测连通」通过了，为什么请求还是失败？

检测连通只看地址能不能连上，不发真实的模型请求，所以验证不了 Key 和模型名。请检查 Key 的分组、模型 ID 和上游格式，或直接用 curl 发一条请求。

能用一个统一供应商同时配 Claude Code 和 Codex 吗？

用 GPTZZZ 时不适合。统一供应商共用一个 Key，而 GPTZZZ 的一个 Key 只属于一个分组，Claude 模型和 GPT 模型不在同一个分组。所以要建两个 Key，分别添加两个供应商。