本地路由的转换链路

当 CC Switch 接管 Codex 配置后，完整的请求路径会经历四个阶段：

1. 配置文件改写：CC Switch 将 Codex 的 live 配置指向 http://127.0.0.1:15721/v1，并强制锁定 wire_api = "responses"，确保 Codex 发出的所有请求均使用 Responses 协议。
2. 格式标记：Provider 配置中的 meta.apiFormat = "openai_chat" 告知路由层该上游的真实接口形态是 Chat Completions。
3. 请求转发与改写：路由拦截 /responses 或 /v1/responses 路径，将其映射为 /chat/completions，同时将 Responses 格式的请求体转换为 Chat Completions 格式。
4. 响应回译：上游返回的 Chat 格式响应——无论是 JSON 还是 SSE 流——由路由层重新组装为 Codex 能够解析的 Responses 格式，再返回给客户端。

前置条件

开始配置之前需要确认三件事：

• CC Switch 已安装可正常运行并且CC Switch 3.16.0 及以上版本。
• Codex CLI 已安装，且至少启动过一次——这会生成 ~/.codex/config.toml 所需的目录骨架，否则接管操作无法写入配置。
• 手头已有 DeepSeek（或其他目标供应商）的 API Key。

补充一点：DeepSeek 官方文档标明的 OpenAI 兼容 base URL 为 https://api.deepseek.com，Chat 接口路径为 /chat/completions。CC Switch 的 DeepSeek 预设已经封装了这些信息，建议直接使用预设而非手工拼接 URL，避免路径错误。

操作步骤

在 Codex 标签下添加供应商

打开 CC Switch，切换到顶部的「Codex」标签页，点击右上角加号新建供应商。
 

在预设列表中选择「DeepSeek」，选择之后往下拉然后需完成两项输入：

• 填入你的 DeepSeek API Key。
• 保存该供应商配置。

预设已经自动填入了接口地址、默认模型、可选模型列表以及 thinking/reasoning 相关参数，并且默认开启了「需要本地路由映射」。如果需要调整默认模型或模型展示名称，可以按需修改，协议层的转换则完全交给路由处理。

启动本地路由并接管 Codex 配置

进入设置的「路由」页面
 

展开「本地路由」区域，依次完成两个开关：

• 打开路由总开关，本地代理服务随即在 127.0.0.1:15721 上启动。
• 在「路由启用」中打开 Codex 选项。如果路由仅服务于 Codex，可以保持 Claude、Gemini 等开关处于关闭状态。

接管生效后，CC Switch 会将 Codex 的 live 配置改写为指向本地路由地址，并使用占位符替代真实的 API Key。实际的 DeepSeek Key 始终保存在 CC Switch 的 Provider 配置中，由本地路由在转发请求时动态注入——Codex 的 live 配置中不会暴露真实的密钥。

启用供应商并重启 Codex

回到 Codex 供应商列表，点击 DeepSeek 供应商上的「启用」。
 

如果看到「需要路由」标记，说明该供应商依赖本地路由运行；此时若路由服务未启动，CC Switch 会弹出提示。

切换到新供应商后，建议重启当前的 Codex 终端会话，原因有两点：

• Codex 进程可能已经缓存了旧的 config.toml 内容。
• modelcatalogjson 生成后，/model 菜单通常需要进程重启才能加载新的模型目录。