开源codex-router：多模型路由器在Codex中跑DeepSeek
内容提要
codex-router 是社区开源的本地模型路由工具，让 OpenAI Codex 无需更换客户端即可接入 DeepSeek、Kimi、Claude 等外部模型。它通过 LiteLLM 转换协议将外部模型并入 Codex 原生选择器，密钥本地加密隔离，支持一键安装、多客户端共享、可视化监控与自定义模型，不覆盖原有配置，可免 OpenAI 账号使用。
延伸解读
本地路由如何做到不干扰原生 Codex
codex-router 通过向 ~/.codex/config.toml 添加受管理的配置块，将本地端点设为 OpenAI 基础 URL，并合并模型目录，同时完整保留用户原有的 OpenAI 提供商、ChatGPT 登录、配置文件和 MCP 设置。它采用独立配置目录存储自身数据，与 Codex 原生配置隔离，因此安装、更新或卸载都不会覆盖原有配置，即使路由异常也不影响 Codex 本体运行。
协议转换与流量分发机制
Codex 原生使用 Responses API，而 DeepSeek、Kimi、Claude 等外部模型多采用不同的对话补全或消息协议。codex-router 内置 LiteLLM 网关，自动完成请求与响应的格式转换，并由调度器根据模型 ID 命名空间决定路由到原生 ChatGPT 后端还是外部提供商。这一过程对用户透明，无需手动修改代码或配置文件。
密钥安全与多客户端共享
所有提供商的 API 密钥或 OAuth 凭证都加密或隔离存储在本地，不会上传到第三方服务器。Windows 下为密钥配置专属用户权限锁并禁止权限继承，Mac/Linux 下锁定最高安全权限。诊断功能只显示密钥是否有效，不展示具体内容。一次安装可同时服务 Codex App、CLI、DeepSeek Harness、Gemini CLI 等多个客户端，共享一套提供商配置。
已知限制：余额查询依赖本地统计
部分头部模型服务商不公开官方余额或配额查询接口，codex-router 只能通过本地请求记录统计流量，无法精准同步平台官方剩余额度。用户若需核对精准账单或剩余配额，必须跳转对应服务商官方控制台查看。这是所有本地路由工具面临的共性问题，也是后续版本迭代的核心优化方向。
Q&A
codex-router 是什么？它主要解决什么问题？
codex-router 是一个社区驱动的本地模型路由工具，旨在打破 Codex 对 OpenAI 模型的限制，让用户能在 Codex App 和 CLI 中无缝使用 Anthropic、Kimi、DeepSeek、xAI、GitHub Copilot 等外部模型。
codex-router 如何在不修改 Codex 原有配置的情况下接入外部模型？
它通过本地 LiteLLM 网关将 Codex 的 Responses API 请求转换为外部提供商的 API 格式，调度器根据模型 ID 命名空间分发请求，安装程序向 ~/.codex/config.toml 添加受管理的配置块，将路由器本地端点设为 OpenAI 基础 URL 并合并模型目录，同时完整保留用户原有的 OpenAI 提供商、ChatGPT 登录、配置文件和 MCP 设置。
codex-router 支持哪些外部模型和客户端？
支持 Kimi 全系列编码模型、DeepSeek 高速与专业模型、Claude 高端模型、通义千问全版本、GLM 大模型、Grok 模型等数十款主流大模型，以及 Groq、OpenRouter、谷歌 Gemini、硅基流动等兼容 OpenAI 协议的平台。一次安装可同时服务于 Codex App、CLI、DeepSeek Harness、Gemini CLI 等多个客户端。
codex-router 如何保证 API 密钥和账号安全？
所有提供商的 API 密钥或 OAuth 凭证都加密或隔离存储在本地，不会上传到任何第三方服务器。Windows 系统为密钥配置专属用户权限锁，禁止权限继承；Mac、Linux 系统锁定最高安全权限。诊断和状态查询只显示密钥是否配置成功，永不展示具体内容，且不同服务商的凭证相互独立。
codex-router 提供哪些可视化监控和管理功能？
它搭载桌面托盘控制面板，实时展示路由运行健康状态、当前启用的服务商、实时请求活跃度、当日 token 消耗数据，支持查看 7 天、30 天、90 天的长期使用统计。针对限流和配额规则，自动解析官方响应头同步剩余额度、访问频次、限流时间。面板还支持一键启停路由、开关服务商、切换运行模式。
codex-router 是否必须登录 OpenAI 账号才能使用？
不是。它自带免 OpenAI 登录运行模式，用户不用登录 ChatGPT、不用绑定 OpenAI 账号，也能正常使用所有第三方模型。开启该模式后，工具会接管 Codex 的模型调度逻辑，直接通过用户配置的第三方服务商密钥或 OAuth 授权完成模型调用，完全脱离 OpenAI 官方服务。
codex-router 目前存在哪些技术限制或不足？
部分头部模型服务商不公开官方余额、配额查询接口，codex-router 只能通过本地请求记录统计流量，无法精准同步平台官方剩余额度。用户想要核对精准账单、剩余配额，必须跳转对应服务商官方控制台查看，这是所有本地路由工具的共性问题，也是后续版本迭代的核心优化方向。
