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；未推斷任何額外功能。