duolahypercho/codex-router

Codex Router – Codex 应用的多提供商 LLM 网关

是什么

• 一个社区维护的工具，允许 Codex 桌面/CLI 应用程序与多个外部大型语言模型（LLM）提供商（Anthropic、Kimi、DeepSeek、xAI/Grok、Gemini、GitHub Copilot、Ollama Cloud 等）通信，而无需将您的 API 密钥暴露给 Codex 应用本身。
• 安装后台服务、可选的 Electron 控制中心（带 macOS Dynamic Island 小部件的托盘/菜单栏应用），以及命令行助手，用于管理提供商凭据、模型目录和可选的搜索侧车（side-car）。

如何获取

• 推荐的一键安装程序（macOS/Linux/Windows）——运行一个 shell/PowerShell 脚本，本地构建 Electron UI，提示您选择提供商，并将凭据存储在私有、隐藏的提示中。
• Homebrew 公式——仅安装 CLI（codex-router 命令）及其 Node/Python 依赖项；您必须在之后运行 codex-router setup --guided 以完成提供商选择。
• 引导式安装程序——与推荐安装程序相同的脚本，但不包含托盘/小部件（仅 --guided）。

核心功能

功能	说明
提供商路由	设置后，您可以启动一个 Codex 任务并从选择器中选择一个 路由模型。路由器将请求转发到所选的外部 API，并添加所需的 OAuth 或 API 密钥头。
凭据安全	API 密钥和 OAuth 令牌不会在聊天界面中输入；它们通过隐藏的终端提示输入一次，并存储在每个用户的、仅限所有者访问的状态目录中。
模型目录	路由器会构建一个动态模型列表（参见 README 中的详细表格），仅在对应凭据存在时才显示。原生 OpenAI 模型仅在 codex login 成功后才出现。
搜索侧车	对于不支持内置网络搜索的模型，您可以绑定一个 Perplexity Search 提供商，该提供商实现原始的 POST /search API。侧车是模型特定的，其凭据也保持私有。
跨平台 UI	在 macOS 上，控制中心位于菜单栏中，可显示可移动的“Dynamic Island”桌面小部件。Linux 仅提供 CLI；Windows 提供 PowerShell 包装器（codex-router.ps1）。
可扩展的提供商系统	您可以通过 model-router codex providers generic add … 添加通用提供商（例如 Perplexity），然后将其绑定到特定模型。
安全检查	安装程序可以以 无凭据模式 运行（--no-provider --no-discovery），安装服务但从不读取任何密钥，允许您先验证安装/卸载生命周期。

支持的提供商及认证方式

• 基于 OAuth（Kimi、Grok、Antigravity）——重用官方 CLI 的 OAuth 会话。
• 基于 API 密钥（DeepSeek、MiniMax、Qwen、ClinePass、Xiaomi MiMo 等）——密钥安全存储，从不在命令行上传递。
• Ollama Cloud——使用 Ollama Cloud API 密钥。
• GitHub Copilot——需要具有 Copilot Requests 权限的细粒度 GitHub PAT；路由器不会读取官方 Copilot CLI 存储。
• Antigravity（Google Gemini 内部）——可选，需要由运营商提供的私有客户端密钥；在公共构建中不可用。

典型工作流程

1. 运行安装程序（curl … | sh -s -- --target codex --guided --with-tray）。
2. 选择您想要的提供商；安装程序将提示您进行任何必要的 OAuth 登录或 API 密钥输入。
3. 退出并重新打开 Codex 应用。
4. 创建新任务，从下拉菜单中选择一个 路由模型。
5. （可选）从菜单栏打开 Codex Router 以查看状态、更改提供商或管理搜索侧车。

限制/备注

• 该项目与所列提供商（OpenAI、Anthropic、Google 等）无任何关联。
• macOS 尚未提供预构建的 .dmg；安装程序会本地编译 Electron 应用。
• Homebrew 公式不包含 Electron UI；仅提供 codex-router CLI。
• 某些提供商（例如 Antigravity）需要未公开的私有客户端密钥。
• 搜索侧车是按模型的；无法启用全局回退搜索。
• 路由器不会修改底层 Codex 客户端的原生 GPT 模型——这些模型继续通过现有的 OpenAI 登录直接访问。

了解更多

• 完整安装指南：docs/INSTALL.md
• Homebrew 贡献指南：docs/HOMEBREW_CORE.md
• 提供商特定说明嵌入在 README 的大型模型/凭据表中。

---

以上所有细节均直接取自仓库的 README；未推断任何额外功能。