Codex Router 是一个由社区驱动的本地模型路由工具，旨在打破 Codex 对 OpenAI 模型的限制，让用户能在 Codex App 和 CLI 中无缝使用 Anthropic、Kimi、DeepSeek、xAI、GitHub Copilot 等外部模型。
核心功能与价值
它的核心价值在于将外部模型深度整合进 Codex 的原生工作流，同时确保安全与便捷。
- 统一的模型选择器：通过生成本地模型目录，将外部模型与原生 GPT 模型并列显示在 Codex 的标准模型选择器中，无需切换工具即可调用。
- 本地凭据隔离：所有提供商的 API 密钥或 OAuth 凭证都加密或隔离存储在本地，不会上传到任何第三方服务器，保障了账户安全。
- 一键式引导安装：提供 --guided 引导安装模式，自动完成提供商选择、凭据安全录入、后台服务安装和 Codex 集成，大幅降低了配置门槛。
- 多客户端共享：一次安装可以同时服务于 Codex App、CLI、DeepSeek Harness、Gemini CLI 等多个客户端，共享一套提供商配置。
工作原理
其架构设计巧妙地在不干扰原生 Codex 功能的前提下，实现了外部模型的接入。
- 协议转换：路由器通过本地的 LiteLLM 网关，将 Codex 使用的 Responses API 请求转换为各外部提供商（如 Anthropic、DeepSeek）所需的 API 格式。
- 流量分发：一个调度器会根据模型 ID 的命名空间，决定是将请求路由到原生的 ChatGPT 后端，还是转发到外部提供商。
- 配置合并：安装程序会安全地向用户的 ~/.codex/config.toml 文件中添加一个受管理的配置块，将路由器的本地端点设置为 OpenAI 的基础 URL，并合并模型目录，同时完整保留用户原有的 OpenAI 提供商、ChatGPT 登录、配置文件和 MCP 设置。
不用换客户端，就能让OpenAI Codex跑DeepSeek！
绝大多数人都以为OpenAI Codex只能用GPT系列模型，这完全是错的！
很多AI工具用户都被固有认知困住，默认每款AI客户端只能绑定自家专属模型，想要用不同大模型，就必须下载对应软件、重新登录账号、配置全新密钥，操作繁琐又浪费时间。
codex-router（代码路由工具）彻底打破了这个行业定式，它能让原生OpenAI Codex软件兼容市面上几十款主流第三方大模型，全程不改动原有配置、不替换官方登录账号，是目前最实用的本地模型路由工具！
路由工具颠覆传统AI使用逻辑
普通用户对AI客户端的认知，一直停留在“一客户端一模型”的固定模式，大家默认OpenAI Codex只能适配GPT系列模型，无法接入其他品牌大模型。
但codex-router从底层改写了这个运行规则，它不修改Codex的软件本体、不篡改官方核心代码，只在本地搭建一层独立的中转路由，实现跨品牌模型兼容运行。
这款工具的核心定位是本地凭证隔离式路由，全程运行在用户私人电脑上，所有配置、密钥、使用数据都储存在本地设备，不会上传到公共服务器，从根源杜绝隐私泄露风险。
它可以完美适配Codex桌面端和命令行端两种使用场景，不管是日常可视化操作，还是代码批量运行任务，都能稳定实现第三方模型接入，适配绝大多数用户的使用习惯。
打通多模型协议壁垒
市面上的大模型都有专属的接口协议，不同品牌的接口标准完全不互通，这也是跨模型兼容的最大难题！
OpenAI Codex原生适配Responses API协议，而Kimi、DeepSeek、Claude、通义千问等主流模型，大多采用通用的对话补全协议、消息协议，双方无法直接对接。
codex-router内置LiteLLM协议翻译模块，这是它区别于普通代理工具的核心优势，它能自动完成协议转换，把Codex的请求格式翻译成第三方模型可识别的格式，同时反向转换返回结果。
不管是普通对话、代码生成、流式输出，还是智能体工具调用，所有核心功能都能完整保留，不会因为协议转换出现功能缺失、卡顿、乱码等问题。
更关键的是，协议转换全程自动完成，用户不需要手动修改任何代码、配置文件，安装工具后即可无感使用，零学习门槛适配所有第三方模型。
原生界面统一展示所有模型
很多跨模型工具接入第三方模型后，需要单独打开新面板、新窗口查看和切换模型，完全失去了Codex原生的使用体验！
codex-router不会新增独立操作界面，它会把所有接入的第三方模型，直接合并到Codex原生的模型选择器中，和官方GPT模型并列展示。
用户日常切换模型时，不用跳转页面、不用重启软件，直接在熟悉的原生下拉菜单中切换，操作逻辑和使用官方模型完全一致，上手零成本。
它支持的模型覆盖全网主流品类，包含Kimi全系列编码模型、DeepSeek高速与专业模型、Claude高端模型、通义千问全版本、GLM大模型、Grok模型等数十款主流大模型。
同时工具区分两种登录认证方式，分别是OAuth授权登录和API密钥登录，用户可以根据自身账号类型自由选择，两种方式都能稳定解锁对应模型的全部功能。
本地加密守护账号密钥安全
绝大多数AI路由工具会明文保存用户API密钥，极易出现密钥泄露、被盗用、超额扣费等风险！
codex-router采用极致安全的凭证管理机制，全程杜绝密钥泄露问题，用户的所有密钥、授权信息，都不会在聊天窗口、命令行界面明文展示。
在Windows系统中，工具会为密钥配置专属用户权限锁，禁止权限继承，杜绝本地其他用户读取密钥；在Mac、Linux系统中，密钥文件锁定最高安全权限，仅本人账号可访问。
工具的诊断、状态查询功能，只会显示密钥是否配置成功、是否有效，永远不会展示密钥具体内容，从展示层面杜绝隐私泄露隐患。
同时它完全隔离不同服务商的凭证体系，Kimi的OAuth授权、DeepSeek的API密钥、通义千问的计划密钥相互独立，不会混用、不会互相干扰，避免账号异常。
无侵入兼容原有Codex配置
很多插件工具安装后会覆盖原有软件配置，导致用户自定义设置、登录信息全部丢失，翻车概率极高！
codex-router拥有无损兼容机制，安装、运行、更新、卸载全过程，都不会修改、覆盖、删除用户原本的Codex配置文件、GPT模型数据、ChatGPT登录状态。
用户自定义的模型分组、对话模板、使用偏好、智能体设置，全部可以完整保留，安装工具前后的使用习惯完全一致，不会出现配置重置的情况。
工具采用独立配置目录存储自身数据，和Codex原生配置完全隔离，两套配置独立运行、互不干扰，既实现了多模型拓展，又守住了原生软件的稳定性。
就算工具运行出现异常，也不会影响Codex本体运行，用户随时可以关闭路由功能，一键恢复纯官方使用状态，全程无后遗症。
跨平台适配全系统使用场景
多数AI拓展工具仅支持单一系统，无法兼顾Windows、Mac、Linux多设备用户，适配性极差！
codex-router实现全平台全覆盖，完美适配macOS、Linux、Windows三大主流操作系统，同时兼容桌面端可视化操作和命令行批量运维。
Mac和Linux用户可以通过一行脚本完成引导式安装，全程自动检测系统环境、适配依赖、配置路由服务，新手也能一键部署成功。
Windows用户专属PowerShell安装脚本，自动规避系统权限限制、执行策略拦截，无需手动修改系统设置，快速完成工具部署与启动。
针对Windows系统搭配WSL子系统的特殊场景，工具提供专属路径适配方案，用户可以手动指定Codex配置目录，精准匹配桌面端软件配置，避免跨系统配置错位。
同时工具自带跨系统托盘控制面板，Mac原生菜单栏面板、Windows和Linux通用Tauri桌面面板，实现全系统可视化管理。
可视化面板实时监控模型状态
普通路由工具只有基础转发功能，用户无法查看模型运行状态、token消耗、额度剩余情况，使用完全盲目！
codex-router搭载专属桌面托盘控制面板，提供全方位可视化监控能力，不用打开命令行，就能直观掌握所有模型的运行数据。
面板会实时展示路由运行健康状态、当前启用的服务商、实时请求活跃度、当日token消耗数据，同时支持查看7天、30天、90天的长期使用统计。
针对各大模型服务商的限流、配额规则，工具会自动解析官方响应头数据，实时同步剩余额度、访问频次、限流时间，让用户精准把控使用节奏。
部分无公开余额查询接口的服务商，工具会统计本地全部请求流量，清晰记录每一次模型调用的消耗，帮助用户精准核算使用成本，避免超额扣费。
除此之外，面板支持一键启停路由、开关服务商、切换运行模式，所有复杂配置都能可视化操作，彻底告别繁琐命令行指令。
自定义拓展任意第三方模型
固定模型列表的路由工具，永远跟不上大模型迭代速度，新模型上线后只能等待工具更新，灵活性极低！
codex-router自带模型自定义拓展功能，用户可以手动抓取各大服务商的最新模型，自主添加到Codex模型列表中，不用等待工具版本更新。
用户通过专属指令，即可读取服务商官方全部在线模型，自主筛选需要启用的模型，同时手动配置模型上下文窗口、图片识别能力、推理精度等核心参数。
自定义添加的模型会保存在用户本地设备，不受工具版本更新、重装操作的影响，永久保留配置，随时可以二次编辑、删除、启停。
工具默认保守配置模型参数，用户可以根据自身需求调整推理档位，从最低极简推理到超高精度推理，适配代码编写、逻辑推演、文案创作等不同场景。
同时工具支持批量管理第三方服务商，Groq、OpenRouter、谷歌 Gemini、硅基流动等数十个兼容OpenAI协议的平台，都可以一键接入拓展。
支持无OpenAI账号独立使用
绝大多数Codex拓展工具，必须依赖OpenAI账号登录才能运行，断网或无账号场景直接报废！
codex-router打破账号绑定限制，自带免OpenAI登录运行模式，用户不用登录ChatGPT、不用绑定OpenAI账号，也能正常使用所有第三方模型。
开启该模式后，工具会接管Codex的模型调度逻辑，直接通过用户配置的第三方服务商密钥、OAuth授权完成模型调用，完全脱离OpenAI官方服务。
这个功能彻底解锁了离线本地化使用场景，用户可以纯本地运行AI模型任务，不用依赖境外账号、不用受限于OpenAI服务器稳定性，使用自由度大幅提升。
同时模式切换全程无损，开启免登录模式不会清空任何配置，关闭后可以一键恢复原生GPT模型使用状态，双向切换灵活无门槛。
安全更新与故障回滚机制
多数开源工具更新后极易出现兼容故障，且没有回滚方案，一旦出错只能重装系统、清空配置，成本极高！
codex-router搭建了成熟的版本迭代与故障修复体系，支持一键更新最新版本、一键回滚历史稳定版本，全程自动备份数据。
工具更新前会自动检测本地代码完整性、仓库源头合法性，确保更新包无篡改、无缺失，更新过程中自动保留用户所有自定义模型、密钥、配置数据。
如果更新过程出现网络中断、环境异常、适配失败等问题，工具会自动触发回滚机制，一键恢复更新前的稳定状态，不会导致工具报废。
搭配内置的医生诊断指令，用户可以随时扫描路由运行故障，自动修复配置错位、服务异常、模型加载失败等常见问题，大幅降低运维成本。
工具区分禁用和卸载两种模式，禁用仅关闭路由服务、取消Codex适配，卸载不会删除用户密钥、日志、备份数据，避免误操作丢失核心配置。
多架构适配多服务商计费体系
市面上所有路由工具，基本都只能适配单一计费模式，无法区分不同服务商的订阅和按量计费规则！
codex-router精准适配各大平台的差异化计费体系，针对不同服务商的计费规则，做了专属适配优化，完美兼容订阅包、按量计费、专属计划三种模式。
针对通义千问系列模型，工具适配阿里云模型工作室订阅计划密钥，支持用户自定义海外接口地址，适配按量计费和订阅计费双场景。
针对opencode平台，工具同时兼容订阅制Go套餐和按量计费Zen套餐，一套密钥即可调用平台全部模型，自动区分两套计费体系，不会错乱扣费。
针对Command Code平台，工具适配专属创作者计划，兼容对话补全、消息协议两类模型，统一计费统计，精准记录每类模型的消耗数据。
所有服务商的计费数据相互独立，工具不会合并统计、不会错乱归类，用户可以清晰区分每个平台的使用成本，精准管控AI使用开销。
工具核心落地使用结论
你可以借助codex-router，让单一OpenAI Codex客户端兼容全网主流大模型，彻底告别多软件切换的繁琐操作！
你可以全程本地加密存储密钥，杜绝AI工具常见的密钥泄露、盗用风险，安全稳定使用各类第三方模型服务！
你可以自主拓展最新大模型、自定义模型参数，不受工具版本限制，永久适配大模型行业的快速迭代！
未解的技术适配矛盾
这款工具目前存在一个无法彻底解决的适配短板，也是所有本地路由工具的共性问题！
部分头部模型服务商不会公开官方余额、配额查询接口，codex-router只能通过本地请求记录统计流量，无法精准同步平台官方剩余额度。
用户只能通过工具查看本地使用数据，想要核对精准账单、剩余配额，必须跳转对应服务商官方控制台查看，暂时没有彻底完美的解决方案，这也是后续版本迭代的核心优化方向。