前言
这篇记录一个很实际的折腾：怎么让 codex 同时挂上好几家模型，随时切换。
现在绝大多数人用 codex，都是接正价或者中转的 GPT。GPT 能力是没得说，但最近这一段时间——高峰期限流、中转断流、官方响应慢——被坑过的兄弟应该不少。
解决办法其实很简单：给 codex 配多个“供应商”，随时切换。手动改配置文件也能做，但切来切去太麻烦，这时候就轮到 CC Switch 出场了。
本文操作基于 CC Switch v3.20.2，建议版本不低于这个，低版本有些界面和字段对不上。
一、先搞懂协议：codex 只认两种
这是接第三方模型最容易踩的坑，90% 的“接入失败”都是协议没搞对，所以放在最前面。
CC Switch 里能选的协议是这几种。注意：它们对应的是不同工具、不同供应商的原生协议，不是“codex 的可选项”：
| 协议 | 端点 | 对应场景 |
|---|---|---|
| OpenAI （Chat Completions） | /v1/chat/completions | codex 支持；也是绝大多数第三方模型和网关的原生协议 |
| OpenAI Responses | /v1/responses | codex 支持（原生直连，不转换格式）；OpenAI 官方主推 |
| Anthropic （Messages） | /v1/messages | Claude 的原生协议，给走 Anthropic 协议的工具/供应商用 |
| Gemini（原生） | /v1beta/models/{model}:generateContent | Gemini 的原生协议，给 Gemini 系工具/供应商用 |
二、ccswitch：装哪个版本、点哪个图标
这是接第三方模型最容易踩的坑，90% 的“接入失败”都是协议没搞对，所以放在最前面。
CC Switch 是个聚合式的切换器，它管的不只是 codex，Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi 这些都在它的“本地环境检查”里，能直接帮你安装或升级。
几点提醒：
版本要不低于 v3.20.2——本文截图就是 v3.20.2。版本低了界面字段可能不一样，照本文配会找不到地方。
“本地环境检查”里可以直接点安装 / 升级，不用自己去各自官网折腾。
想省事可以点右上角的「全部升级」，但装之前建议先看清每个工具的版本号。
接 codex，就点第三个图标
这排图标从左到右依次是 Claude Code、Claude、Codex（第三个，OpenAI 图标）、Gemini、Grok、OpenCode、OpenClaw、Hermes、Pi。别点错，点错了配的是别的工具。
三、添加供应商：四个核心字段
点「添加供应商」之后，真正要填的核心就是四个：
| 核心字段 | 填什么 |
|---|---|
| API Key | 渠道给你的 key。只需要填这一处，下面的 auth.json 会自动填充 |
| API 请求地址 | 服务端点地址，要填兼容 OpenAI Response 格式的地址；旁边有「完整 URL」开关和「管理与测速」 |
| 协议（上游格式） | 就是上一节那张表——Responses 原生 / Chat Completions / Anthropic Messages…… 按渠道的实际情况选 |
| 模型列表 | 先在「默认模型」填一个，后面再拉取和逐个配置 |
1）API 请求地址要的是服务端点，不是官网链接——官网链接是上面那个可选的输入框；
2）上游格式在「高级选项」里展开才能看到，不在第一屏，很多人找不着；
3）地址结尾要不要带
/v1，以渠道文档为准，填错就是 404。四、拉模型列表，再逐项配置
核心字段填完之后，最省事的一步来了：点「获取模型列表」，它会把你这个 key 实际能用的模型拉出来。
然后按需往「模型映射」里加条目，每一行要填四样东西：
| 列 | 作用 |
|---|---|
| 菜单显示名 | 你在 /model 里看到的名字 |
| 实际请求模型 | 真正发给上游的模型 id，可比显示名更具体（比如 gemini-3.8-flash-high） |
| 上下文窗口 | 手动填，比如 1050000 |
| 思考等级 | 手动勾选该模型支持的档位，比如 none, low, medium, high, xhigh, max |
同一页还有两个关于“思考”的开关，别搞混了：
支持思考模式：上游 Chat Completions 接口支持“开启或关闭思考”时启用（Kimi、GLM、Qwen 等通常属于这一类）；
支持思考等级：上游支持 low / high / max 这类深度控制时启用。开启后它会自动启用思考模式，并把 codex 的
reasoning_effort转成上游的参数。
model_catalog.json」就是让 /model 命令能显示这些第三方模型名。所以这里改完，必须重启 codex 才会刷新模型列表，改了没生效多半是没重启。五、重启 codex，开始用
上面配置改完，重启 codex，再输 /model，就能看到你刚配的那些第三方模型了：
到这一步，“一个客户端用多家模型”就成了——想用哪个直接切，不用改配置文件。
六、多渠道、多 key 和协议转换
1、多个渠道：配多个 key，切换使用
每个渠道加一个供应商、填各自的 key 就行。用的时候切换一下，但要注意：切换后同样需要重启 codex 才生效。
2、想用一个 key 用所有模型？有条件
如果你不想来回切，想一个 key 打天下，需要同时满足两点：
接入的渠道本身要支持多个模型（不是只卖一个模型的那种）；
这些模型在渠道侧要统一成同一种协议。
3、关键：渠道是可以转换协议的
这是最有用的一条。举个例子：
也就是说，你不需要为了用 Gemini 单独装一套东西——只要渠道支持转换就行。
4、路由、整流器和故障转移
设置里还有一个「路由」页，跟协议转换直接相关：
本地路由：
Chat和Anthropic Messages协议必须开启它才能用（前面说过要“转换为 Responses”）。我的截图里显示“已停止”，用这类协议时要记得打开。自动故障转移：配置故障转移队列和熔断策略——这个对“某家不稳”的场景特别有用。
整流器：自动修复 API 请求里的兼容性问题。第三方网关多多少少有点不规范，这个开关能省不少事。
全局出站代理：CC Switch 访问外部 API 时走什么代理。
七、各家模型兼容性实测
按“能不能拿来当 codex 备胎”排了个序：
| 模型 | 兼容性 | 怎么接 | 备注 |
|---|---|---|---|
| Grok | ★★★★★ 极强 | 直接选 Chat / Responses | 塞进去就能用，几乎零折腾，最佳备胎 |
| Claude | ★★★★ 不错 | 原生是 /v1/messages，靠路由或渠道转成 OpenAI 格式 | 工具调用正常 |
| GLM | ★★★★ 可以 | OpenAI 兼容端点 | 属于“可开关思考”那一类；速度一般 |
| DeepSeek | ★★★★ 可以 | OpenAI 兼容 | 思考内容在 reasoning_content 字段；不支持分级思考、也不能关思考 |
| Gemini | ★★★ 有条件可用 | 原生协议 → 转成 OpenAI Responses | 工具调用、MCP 的质量取决于渠道的转换做得好不好 |
八、常见报错排查
| 现象 | 大概率原因 | 解决 |
|---|---|---|
| 401 Unauthorized | key 填错 / 与分组不匹配 | 回渠道确认 key 和分组 |
| 404 Not Found | API 请求地址多了或少了一层 /v1 | 对照渠道文档，或用「管理与测速」测一下 |
配好了但 /model 里没有 | 没重启 codex；或没生成 model_catalog.json | 先点「获取模型列表」配置好，再重启 codex |
| 切了渠道不生效 | 同样需要重启 | 重启 codex |
| 用 Chat / Anthropic 协议报错 | 没开启本地路由 | 去「设置 → 路由」把本地路由打开 |
| 400 参数错误 | 上游不认某些字段（比如思考等级） | 关掉「支持思考等级」，或只勾该模型真正支持的档位 |
| 工具调用异常、死循环 | 网关的 function call 支持不完整 | 换个渠道，或打开「整流器」试试 |
| 上下文超限 | 模型映射里上下文窗口填小了 | 按渠道文档改大 |
排查顺序还是那句：key → 地址 → 协议 → 路由 → 重启，从外往里一层层试，比瞎改快得多。
九、小结
协议不止两种：OpenAI Chat / OpenAI Responses / Anthropic Messages / Gemini 原生；codex 只认前两种，其余靠路由转换；
CC Switch 版本建议 ≥ v3.20.2；接 codex 选第三个图标；
加供应商就四个核心字段：API Key、API 请求地址、协议、模型列表；
填完点「获取模型列表」，上下文窗口和思考等级手动配；
改完一定要重启 codex，模型列表才刷新；
Chat/Anthropic Messages协议必须开启路由才能用；多渠道就配多个 key 切换；想一个 key 通吃，渠道要支持多模型且协议统一——渠道能把 Gemini 原生协议转成 Responses，所以 Gemini 也能进 codex。
还没有评论，来说两句吧...