CC Switch 本地路由失效的 3 步自查：Codex 请求 404 或请求数为 0 怎么办
CC Switch 本地路由失效的 3 步自查Codex 请求 404 或请求数为 0 怎么办【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switchCC Switch 是一款在 Claude Code、Codex 等 AI 编码工具之间切换供应商的桌面工具其中「本地路由」负责把工具发出的请求转发给第三方供应商并完成协议转换。当你保存好第三方供应商、打开本地路由之后Codex 里发请求却照样 404或者路由面板的总请求数停在 0——问题基本只在三个环节本机开关没开全、Codex 进程没重新读配置、供应商的上游格式与真实端点对不上。下面按「看什么、改什么、怎么确认修好」推进三步每一步都有明确的通过判据前一步通过再进下一步。先认对症状三种失败长得不一样动手之前先判断你现在处于哪一种状态后文三步的侧重点不同点启用时弹出「需要路由服务才能正常使用」提示供应商没切换过去Codex 里发消息直接报 404 或「端点找不到」像是请求打到了不存在的接口路由面板显示总请求数为 0或者计数在涨但请求全部失败、成功率偏低。先确认一下一次请求实际怎么走心里有底再排查。接管生效后Codex 的配置被改写成指向http://127.0.0.1:15721/v1Key 位置写占位符PROXY_MANAGED真实 Key 由路由在转发时注入每次请求的完整路径是Codex 发到本机路由 → 路由注入真实 Key 并按上游格式告诉路由真实供应商说哪种协议转换协议 → 发往真实端点 → 响应原路返回给 Codex。所以断点只可能出在三处路由服务没真正跑起来总开关或应用开关缺一、Codex 进程没重启仍拿着旧配置、上游格式与真实端点协议对不上。第一步确认三处开关都已打开可能原因路由服务没启动或 Codex 的应用级路由开关没打开接管流程根本没开始。操作进入设置 → 路由 → 本地路由打开路由总开关启动本地服务再在路由启用区域打开Codex开关。页面布局可对照用户手册 4.1 本地路由服务里面写清了开关位置、默认端口与面板各字段的含义。完成判据主界面顶部路由标识变绿目标供应商卡片出现「路由活跃」绿色边框回到供应商卡片重新点启用不再弹提示且切换成功。第二步让新进程读到本机路由地址可能原因接管没写进配置或正在运行的 Codex 进程仍按启动时的旧配置发请求。操作打开~/.codex/config.toml确认当前供应商段的base_url已是http://127.0.0.1:15721/v1。若文件里还是原直连地址回到供应商卡片重新点一次启用让 CC Switch 重写配置。Codex 只在启动时读一次配置改完配置或改完模型映射后关闭当前终端窗口并重新打开让新进程加载新配置——这一步放在改完所有配置之后做避免白重启一次。完成判据新开的终端里发一个小问题Codex 能收到正常回复同时路由面板的总请求数开始增长。第三步上游格式与供应商端点协议对齐可能原因供应商的上游格式选错路由不知道该不该做协议转换把请求打到了对方端点不存在的路径上请求地址填成带完整接口路径的 URL 也会触发同类 404。操作编辑该供应商先检查请求地址——填对方文档给出的端点前缀例如带/v1的地址不要包含/chat/completions这类完整路径。再展开高级选项按供应商实际提供的接口选择上游格式上游格式选项适用场景Responses原生上游原生支持 Responses API请求直连不做转换Chat Completions需开启路由上游只提供/chat/completions由路由完成双向协议转换Anthropic Messages需开启路由上游只提供 Anthropic 协议端点由路由完成转换改完保存供应商再重启一次 Codex。端到端的接入示例可参考 codex-deepseek-routing-guide-zh它演示了把 Chat 格式供应商完整接入 Codex 的全过程。完成判据发一条测试请求后路由面板总请求数增长、成功率变绿大于 90% 显示绿色「设置 → 使用统计」的请求日志里出现对应的 Codex 条目目标供应商后台也能查到这条请求。补充核对如果请求能发出但计费记在旧供应商名下依次核对三处状态——Codex 标签页里当前启用的供应商、路由总开关、路由启用里的Codex。三处不一致时路由可能仍按另一个供应商转发补齐后再重启 Codex面板显示的当前供应商名称应与目标一致。四类设计如此的现象不用修以下情况看起来像故障实际是 CC Switch 或 Codex 的预期行为不需要动手改完配置不立即生效。Codex 只在启动时读一次config.toml改配置或改模型映射后要重启终端只有「路由模式下切换供应商且不改变模型」才会即时作用于后续请求。切官方供应商被拦截。路由接管模式下CC Switch 会阻止切换到官方供应商因为经代理访问官方 API 存在账号风险。看到拦截提示时不要强行绕过。关闭路由后请求行为变了。关闭时 CC Switch 会把配置回写到开启路由前那个标「直连」的供应商这是回写不是数据丢失行为异常时先确认回写的是哪一家。⚠️桌面 GUI 里看不到自定义模型。Codex 桌面应用检测不到官方登录态时会隐藏config.toml里的自定义模型这是上游闭源客户端的行为CC Switch 无法从 GUI 层面根治命令行codex不受此限制可执行codex debug models验证配置本身没问题。另外路由会为请求增加一点开销官方口径是通常小于 10ms个别请求慢几毫秒不用当故障。收尾按这份清单逐条过一遍供应商已保存且看清卡片徽章——带需要路由徽章的必须走本地路由「设置 → 路由 → 本地路由」里路由总开关已打开路由启用区域的Codex开关已打开终端已关闭并重新打开Codex 以新进程读取了配置~/.codex/config.toml中当前供应商base_url指向http://127.0.0.1:15721/v1供应商请求地址是端点前缀不含/chat/completions这类完整接口路径高级选项 → 上游格式与供应商真实端点的协议一致Codex 当前供应商、路由总开关、Codex 路由开关三处状态一致发一条测试请求后路由面板总请求数增长且成功率变绿请求日志与目标供应商后台都出现了这条请求的记录延伸阅读4.2 应用路由路由与各应用开关如何配合生效、关闭路由后配置如何回写直连供应商4.4 用量统计请求日志字段与成功率口径的说明用于核对面板数字源码目录 src-tauri/src/proxy/本地路由的转发、协议转换与故障转移实现源码 codex_config.rsCodex 配置改写规则含base_url指向本机路由的判定逻辑【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考