用 cc-switch 管理多模型：开启路由

Codex 的特殊性：Responses API 与 Chat Completions

上一节你学会了按任务选模型。但把国内模型接进 Codex，还有一道协议门槛：

• 新版 Codex CLI 面向 OpenAI 的 Responses API 发请求
• 而 DeepSeek、Kimi、智谱 GLM、SiliconFlow 等大量供应商只提供 Chat Completions 格式（/chat/completions）

这两种协议的请求体、流式事件、返回结构都不同。直接把 Chat 接口地址填进 Codex 配置，常见结果是：

• 模型列表不对
• 请求 404 / 400
• 流式响应无法被 Codex 正确解析

这就是「为什么需要路由」。

---

cc-switch 的本地路由怎么工作

cc-switch 的做法：让 Codex 始终连接本机的一个路由服务（默认 127.0.0.1:15721），Codex 仍按 Responses API 发请求；路由在内部识别当前供应商是不是 Chat 格式，把 Responses 请求改写成 Chat Completions 发给上游，再把上游的 Chat 响应转换回 Responses 返回给 Codex。Codex 全程无感，真实 API Key 也留在 cc-switch 里、由路由在转发时注入。

链路四步：

1. 切换供应商时，Codex 的 live 配置被指向 http://127.0.0.1:15721/v1
2. 供应商的「上游格式」标记（如 openai_chat）告诉路由：真实上游是 Chat
3. 路由把 /responses 请求改写成 /chat/completions
4. 上游返回后，路由把 Chat 的 JSON/SSE 转回 Responses 格式

---

开启路由：三步

第一步：添加供应商。 打开 cc-switch 切到 Codex 标签，点加号：

• 用预设（推荐）：选中 DeepSeek、Kimi 等，填 API Key 保存。Chat 格式的预设保存后，卡片上会出现 「需要路由」 徽章
• 自定义配置：填 base URL 后，展开表单底部「高级选项」，把「上游格式」选为 Chat Completions（需开启路由）

上游格式下拉只有 Responses（原生） 不需要路由，另外两个（Chat Completions、Anthropic Messages）都需要。

第二步：开启本地路由。 进入设置 → 路由 → 本地路由：

1. 打开 路由总开关，启动本地服务（默认 127.0.0.1:15721）
2. 在「路由启用」中打开 Codex（Claude、Gemini 保持关闭即可）

第三步：切换并重启 Codex。 回到供应商列表点「启用」，然后重启当前 Codex 终端会话——它可能已读过旧的 config.toml，且模型菜单要新进程才刷新。进入后用 /model 确认模型来源，再发一个小问题验证。

---

例外：原生直连，不需要路由

cc-switch 3.19.1 起，DeepSeek 预设已改为原生 Responses 直连，不再需要路由；但 deepseek-v4-pro、Kimi、智谱 GLM 等仍是 Chat 格式，必须走路由。

判断方法只有一条：看供应商卡片上有没有「需要路由」徽章。带徽章 → 走路由；没徽章 → 直连，本文的路由步骤对它没有意义；带「不支持路由」→ 官方供应商，cc-switch 会阻止它走本地路由。

---

落地练习：接一个需要路由的国内模型

1. 装好 cc-switch 和 Codex CLI（至少运行过一次，让 ~/.codex/config.toml 存在）
2. 用预设添加一个 Chat 格式的供应商（如 Kimi 或智谱 GLM），确认卡片出现「需要路由」徽章
3. 打开设置开启路由总开关 + Codex 接管
4. 启用该供应商，重启 Codex 会话，/model 确认模型，发一个任务验证

怎么判断做对了？——/model 里能看到该供应商的模型；发请求后路由面板的请求数在增长；模型回答正常、无 404/400。

卡住了怎么办？ 请求报错 → 确认路由总开关已开、Codex 在「路由启用」列表里。模型列表空 → 重启会话让 model_catalog_json 刷新。切换时被提示「需要路由服务」→ 说明路由没启动，回第二步检查。

---

常见坑：把「需要路由」的供应商当直连用

最常见的坑是：供应商卡片明明带「需要路由」徽章，却跳过路由直接连上游，结果 404 / 400 / 模型列表错，然后怀疑 Key 有问题。

先看徽章再排错：带徽章 → 查路由是否开启；没徽章 → 才去查 Key 和网络。另外注意：改走直连后，该供应商的请求不再经过本地路由，用量统计里会归入 Codex (Session) 一类——想按供应商精确统计，就保留路由路径。

---

小结

1. Codex 面向 Responses API，多数国内供应商是 Chat 格式，直接填会 404 / 模型列表错
2. cc-switch 本地路由（默认 127.0.0.1:15721）做格式转换，Codex 无感
3. 三步开启：加供应商（选 Chat 格式）→ 开路由总开关 + 启用 Codex → 切换并重启会话
4. 判断方法看「需要路由」徽章；DeepSeek 3.19.1 后预设直连，其余多数仍要路由
5. Key 由路由在转发时注入，不暴露给 Codex live 配置

下一模块，用你配好的模型完成第一个完整任务。