博主前言作为一名 AI 开发者和工具狂热者OpenAI 推出的Codex Desktop凭借其强大的本地工作区管理和丰富的插件生态如 Documents、Spreadsheets 等极大地提升了我的代码编写效率。然而Codex 官方默认仅支持 OpenAI 官方的模型接口。如果想接入第三方 API 聚合服务或者在 Codex 中无缝使用 DeepSeek-V4、Claude-3.5-Sonnet 等模型应该怎么做直接在config.toml中配置第三方 API 的官方端点是行不通的因为 Codex 会校验身份接口协议。在经历了多次调试、502 报错、模型列表空白等问题后我终于通过CC Switch 本地路由方案打通了这一通道。今天这篇教程我将分享我的完整配置指南希望能帮助你快速完成配置。为什么选择 CC Switch OpenRouterOpenRouter支持全球数百种顶尖大模型按需计费免去了在各个平台分别充值的烦恼。CC Switch一个专为 AI 命令行/桌面工具设计的配置管理与本地代理网关。它能在本地127.0.0.1:15721启动一个转发代理将 Codex 发出的 OpenAI 格式请求完美翻译并中转给 OpenRouter同时提供图形化界面。核心步骤一网络配置解决 502 错误很多同学配置好后一发送消息就会遇到502 Bad Gateway报错。这是由于本地网络配置问题导致的。【病因分析】当 Codex 请求本地的127.0.0.1:15721CC Switch 网关时如果本地网络环境存在代理拦截可能导致连接中断抛出 502 错误。【解决方案】方法 A推荐确保本地网络环境允许127.0.0.1的流量直连同时 CC Switch 转发给 OpenRouter 的外网请求能正常通过。方法 B备用在系统环境变量中新建用户变量变量名NO_PROXY变量值127.0.0.1,localhost核心步骤二CC Switch 图形界面配置 重要避坑提示关于模型目录加载失败CC Switch 保存设置时会在.codex目录下自动生成cc-switch-model-catalog.json文件。痛点CC Switch 默认拉取的目录文件可能高达 140KB包含大量冗余提示词容易引起 Codex 在启动时超时导致最终界面里只剩下一个“自定义”模型或空白。解决办法在 CC Switch 的映射中剔除不用的模型保持映射列表精简或者手动用编辑器精简该 JSON 文件的层级保留我们所需的模型名称。3. 确认插件安装打开 Codex 的插件面板确保您勾选并启用了需要的核心插件如 Documents 等核心步骤三重启客户端与对话测试故障快捷排查速查表常见故障现象根本原因分析黄金解决办法请求报错502 Bad Gateway系统代理拦截并接管了发往本地127.0.0.1:15721端口的流量。在环境变量中设置NO_PROXY127.0.0.1,localhost。模型列表中只显示一个模型1. 缓存未成功刷新2.cc-switch-model-catalog.json语法错误或文件臃肿。在 CC Switch 重新编辑并保存模型映射以刷新缓存在config.toml中使用相对路径指定文件。请求超时 / 无任何响应网络连接异常导致 CC Switch 无法连接 OpenRouter。确保本地网络能正常访问openrouter.ai。