OpenAI 为 Codex CLI 指定的后端协议是 Responses API/responses而国内主流模型厂商——DeepSeek、Kimi、MiniMax、SiliconFlow 等——对外统一提供的是 Chat Completions 接口/chat/completions。两种协议的差异贯穿整个请求-响应链路请求体的字段结构与语义不同流式传输中的 SSE 事件命名和数据结构也不同。如果直接把某个 Chat 格式的 base URL 写入 Codex 配置常见的症状包括模型列表加载异常、接口返回 404 或 400以及流式响应无法被 Codex 侧正确反序列化。CC Switch的本地路由正是为了解决这一协议断层而设计的。它的工作模型可以概括为Codex 始终认为自己在与一个标准的 Responses API 端点通信而本地路由在中间完成协议识别、请求改写和响应还原。本地路由的转换链路当 CC Switch 接管 Codex 配置后完整的请求路径会经历四个阶段配置文件改写CC Switch 将 Codex 的 live 配置指向http://127.0.0.1:15721/v1并强制锁定wire_api responses确保 Codex 发出的所有请求均使用 Responses 协议。格式标记Provider 配置中的meta.apiFormat openai_chat告知路由层该上游的真实接口形态是 Chat Completions。请求转发与改写路由拦截/responses或/v1/responses路径将其映射为/chat/completions同时将 Responses 格式的请求体转换为 Chat Completions 格式。响应回译上游返回的 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.comChat 接口路径为/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菜单通常需要进程重启才能加载新的模型目录。重启后进入 Codex使用/model命令确认当前模型是否来自 DeepSeek 预设例如 DeepSeek V4 Flash。需要注意目前 Codex app 尚未支持多模型自由切换它将默认使用配置中的第一个模型。其他 Chat 格式供应商的配置规律DeepSeek、Kimi、MiniMax、SiliconFlow 等常见 Chat 格式供应商在 CC Switch 中均已提供预设优先选用预设即可减少手工配置出错的可能性。只有当供应商不在预设列表中时才需要走自定义配置路径按照供应商文档填入 API Key、base URL 和模型信息并将「API 格式」选为「OpenAI Chat Completions需开启路由」。反过来如果某个上游本身已经原生支持 OpenAI Responses API则无需开启「需要本地路由映射」——此时 CC Switch 可以直连 Responses 端点不做任何协议转换。常见问题排查如果问他是什么模型提示是 GPT-5 是没有问题的。因为有系统内置提示词。具体使用消耗可以到[设置] 里面使用统计看到如下图Codex 端报 404 或/responses不存在通常意味着 Codex 接管未生效或者手动将上游 Chat 格式的 base URL 直接写入了 Codex 配置。检查~/.codex/config.toml中的地址是否为http://127.0.0.1:15721/v1以及相应开关是否已开启。DeepSeek 上游返回 404如果使用的是内置 DeepSeek 预设先确认供应商确实来自预设列表且 Codex 路由已开启。只有在自定义供应商场景下才需要额外核查 base URL它应当指向服务的根地址而不是包含/chat/completions后缀的完整接口路径。/model中看不到 DeepSeek 模型保存供应商配置后重启 Codex 终端。CC Switch 会生成cc-switch-model-catalog.json并把路径写入modelcatalogjson但正在运行的 Codex 进程不会热加载该目录。此外Codex app 目前仅使用配置中的首个模型不提供多模型选择界面。路由已开但请求仍走到了错误供应商同时确认三处状态Codex 标签下当前供应商为 DeepSeek本地路由服务处于运行状态「路由启用」中 Codex 开关为开启。能否用官方 OpenAI Codex 账号走本地路由不建议这样做。CC Switch 在本地路由接管模式下会阻止切换到官方供应商因为通过代理访问官方 API 存在账号安全风险。本地路由的设计目标场景是第三方供应商接入、聚合调度以及协议转换。通过 CC Switch 本地路由让 Codex CLI 接入 DeepSeek 等第三方模型