CC Switch 配置 Codex 中转/直连：一个 baseUrl 搞定接入

CC Switch 接 Claude Code 的教程满天飞，但在 CC Switch 里配置 Codex——无论是走中转还是直连——却几乎没人讲清。Codex 和 Claude Code 用的协议不一样，填法、坑点都不同，照搬 Claude 的配置常常一接就报 400 / 404。本文聚焦 CC Switch 内配置 Codex：讲清 /v1/responses 协议为何是直连的关键，给出完整步骤与中转 vs 直连对比，最后用 TeamoRouter 一个 baseUrl 收口。

先搞懂：Codex 和 Claude Code 的协议不一样

CC Switch 能一站式管理多个 Agent，但它转发请求时必须用对应工具的协议格式。三大主流工具的协议差异：

• Claude Code → 走 Anthropic Messages 协议（/v1/messages）；
• Codex → 走 OpenAI Responses 协议（/v1/responses）；
• 其他 OpenAI 兼容 CLI → 多走 Chat Completions（/v1/chat/completions）。

很多人把 Claude 的供应商配置直接复制给 Codex，结果 baseUrl、协议格式都不对，于是报 400（请求格式错误）或 404（路径不存在）。配置 Codex 的第一原则：协议选对、路径填对。

关键点：/v1/responses 决定 Codex 能不能直连

Codex 较新版本默认使用 Responses API（/v1/responses），这是它支持工具调用、推理流程的核心端点。一个供应商能否让 Codex 直连，本质就看它支不支持透传 /v1/responses：

• 支持 /v1/responses 的网关： Codex 可以直接把 baseUrl 指过去，工具调用、流式输出、推理特性都完整可用——这就是「直连」。
• 只支持 /v1/chat/completions 的中转： 需要在中间做一层协议转换（responses → chat completions），部分高级特性会丢失或行为不一致，稳定性打折——这是「中转」常见的妥协。

所以选 Codex 供应商时，务必确认它原生支持 Responses 协议。不支持的，要么只能用旧协议降级，要么需要额外的转换层，体验都不如直连。

在 CC Switch 里新增 Codex 供应商的步骤

1. 打开 CC Switch，顶部导航切换到 Codex 工具页（不是 Claude Code 页）。
2. 进入 Provider Management（供应商管理） → Add Provider（添加供应商）。
3. 协议格式选 OpenAI 兼容 / Responses 格式（确保走 /v1/responses，而非 Anthropic 格式）。
4. 填入参数：
   • Name： 例如 TeamoRouter-Codex
   • Base URL： 供应商的网关地址（确认其支持 /v1/responses）
   • API Key： 你的专属密钥
5. 保存，等待 CC Switch 的健康检查通过。
6. 回到 Codex 工具页，把默认 Provider 切换为刚添加的供应商。
7. 完全重启 Codex CLI（多数 CLI 不热加载环境变量），让新配置生效。

避坑提示： 如果接入后报 404，先检查 baseUrl 是否漏了 /v1，以及协议格式是否误选成了 Anthropic；报 400 多半是 Codex 版本与协议端点不匹配，升级 Codex 到支持 Responses 的版本即可。

CC Switch 内：中转 vs 直连有什么差别

维度	中转（协议转换层）	直连（原生 /v1/responses）
协议路径	responses → chat completions 转换	原生透传 /v1/responses
工具调用 / 推理特性	可能丢失或行为不一致	完整保留
稳定性	多一层转换，故障面更大	链路更短、更稳
配置复杂度	需注意转换兼容性	填一个 baseUrl 即可
适用场景	上游只支持旧协议时的妥协	首选

结论： 能直连就直连。只要供应商原生支持 /v1/responses，在 CC Switch 里填一个 baseUrl 就能让 Codex 完整发挥能力，不必忍受中转转换层带来的特性丢失和额外故障。

用 TeamoRouter 一个 baseUrl 接入 Codex

TeamoRouter 作为为 Agent 原生设计的 LLM 统一网关，原生支持 Codex 的 Responses 协议，可以直连：

• 100% Agent 协议兼容： 完整支持 Codex 的 /v1/responses、Tool Calling 及各类 Beta 特性，不做有损转换。
• 一个 baseUrl 直连： 在 CC Switch 里填上 Base URL + API Key 即可，也可以跳过 CC Switch 直接 export 给 Codex——少一层本地路由，就少一类和梯子打架、reconnecting 的故障。
• 缓存命中率 >99%，不降智： 不走号池轮转，结合 1-2 折实时浮动费率，Codex 通宵跑任务账单也可控。
• 企业级高可用： SLA 99.6%、高达 5000 QPM 并发，首字延迟接近直采级别。

完整图文步骤见 CC Switch 安装与 TeamoRouter 配置教程；想知道怎么挑一个不掺水的供应商，看 CC Switch 中转 API 推荐供应商；被 reconnecting 困扰则看 reconnecting 排错全攻略。

常见问题（FAQ）

CC Switch 配 Codex 要选什么协议格式？

选 OpenAI 兼容 / Responses 格式，确保走 /v1/responses，不要误选成接 Claude Code 的 Anthropic 格式。协议选错是 Codex 接入报 400 / 404 的最常见原因。

Codex 中转和直连哪个好？

能直连就直连。直连原生透传 /v1/responses，工具调用和推理特性完整、链路更短更稳；中转要做协议转换，可能丢特性、多故障。前提是供应商原生支持 Responses 协议。

一个 baseUrl 能同时接 Claude Code 和 Codex 吗？

可以——只要网关同时兼容 Anthropic 和 OpenAI Responses 两套协议。TeamoRouter 两套都支持，所以你可以在 CC Switch 里用同一套凭证、分别给 Claude Code 和 Codex 各配一个供应商，按工具选对协议格式即可。