OpenCodex：通用 LLM 供應商代理

1. 專案概述

OpenCodex 是一個輕量級本機代理，讓開發者可以將任何大型語言模型 — Claude、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen、Ollama 等 — 路由到 Codex、Claude Code、Claude Desktop 和 Grok Build 等程式設計輔助工具，而這些工具原本僅鎖定單一供應商。

2. 背景與定位

專有程式設計輔助工具通常與單一模型供應商綁定，迫使開發者為整個工作流程選擇單一廠商，即使其他模型可能更適合特定任務。OpenCodex 的設計目的就是消除這種鎖定效應：它作為一個通用轉接器，在供應商格式之間轉換 API 請求，同時保留串流回應、工具呼叫、推理 token 和影像輸入的功能對等性。

與簡單的 API 金鑰切換器或單一供應商包裝器不同，OpenCodex 專注於協定層級的轉換（與 Responses API 格式之間的雙向轉換）、具配額感知的多帳戶池化，以及營運工具（網頁儀表板、背景服務管理、健康檢查）— 使其更接近一個小型自架閘道，而非一次性腳本。

3. 功能分類

🔀 模型路由 — 40+ 供應商，無限模型
使用簡單的 provider/model 語法路由任何已設定的供應商和模型。代表性範例：anthropic/claude-opus-5、OpenAI、Google、xAI 以及自訂的 OpenAI 相容端點。目的：讓單一程式設計輔助工具無需修改程式碼即可呼叫任何後端模型。

👥 帳戶管理 — 跨 ChatGPT/Codex 帳戶池化
將多個 ChatGPT/Codex 帳戶池化，追蹤配額使用量，並保持對話親和性，使對話不會在中途切換帳戶。包含最低使用量、輪詢和優先填滿等自動路由策略。目的：最大化吞吐量並避免跨帳戶的速率限制中斷。

🛡️ 可靠性功能 — 故障轉移與冗餘
加權輪詢「組合」和跨模型自動故障轉移，加上繼承相同路由規則的子代理支援。目的：即使某個供應商或帳戶不可用，也能保持程式設計工作階段持續運行。

🔑 驗證與擴充 — OAuth 和 sidecar 功能
為 xAI、Anthropic 和 Kimi 提供原生 OAuth 整合，並透過 ChatGPT sidecar 為非 OpenAI 模型提供網頁搜尋和視覺支援。目的：將 OpenAI 獨家功能（如視覺或網頁瀏覽）帶給其他供應商。

⚙️ 營運 — 儀表板與服務管理
位於 localhost:10100 的網頁儀表板、systemd/launchd/工作排程器服務整合，以及健康/就緒端點。目的：將 OpenCodex 作為持久、可監控的本機服務運行，而非一次性 CLI 呼叫。

4. 主要亮點

供應商無關路由 — 使用 provider/model 字串交換底層模型，無需重新設定輔助端。
功能對等轉換 — 串流、工具呼叫、推理 token 和影像在供應商格式轉換中均被保留，而非僅限純文字。
配額感知帳戶池化 — 使用可設定的路由策略自動將負載分散到多個 ChatGPT/Codex 帳戶。
記憶體受限的狀態管理 — 具備驅逐策略的位元組計量儲存、60 秒過期清理，以及基於世代的協調以避免過期資料。
跨平台原生服務 — 在 macOS、Linux 和 Windows 上安裝為適當的背景服務，而非僅是前景程序。
內建網頁儀表板 — 透過本機 UI 設定供應商、帳戶和組合，而非手動編輯設定檔。

5. 依角色劃分的使用案例

一般開發者 — 在相同的程式設計輔助工具中使用適合任務的模型（例如，用較便宜的模型處理樣板程式碼，用較強的模型處理困難的錯誤），無需切換工具。

DevOps/SRE — 將 OpenCodex 作為受管理的背景服務運行，具備健康/就緒端點以供監控，並使用故障轉移組合在供應商中斷期間保持程式設計輔助工具可用。

專案經理 — 將團隊的 ChatGPT/Codex 帳戶池化並追蹤配額，以控制團隊的使用量和成本，無需手動協調。

6. 開始使用

尋找所需內容
瀏覽文件網站以取得供應商設定指南和設定參考：

https://opencodex.me/

安裝／整合

npm install -g @bitkyc08/opencodex
ocx start        # 啟動代理 + 儀表板

需要 Node 18+（Bun 執行環境會自動捆綁）。然後透過程式設計輔助工具路由請求：

codex -m "anthropic/claude-opus-5" "您的提示詞"

貢獻
閱讀儲存庫中的 CONTRIBUTING.md，然後開啟拉取請求：

https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md

7. 專案結構

opencodex/
├── bin/            # 二進位可執行檔
├── dist/bin/        # 發佈的二進位檔
├── docs/            # 文件檔案
├── docs-site/        # 公開文件網站原始碼
├── gui/             # 網頁儀表板介面
├── readme/          # 本地化 README 檔案
├── src/             # 原始碼
├── structure/        # 維護者筆記與架構
└── tests/           # 測試套件

src/ 包含核心代理和轉換邏輯；gui/ 實作本機網頁儀表板；docs-site/ 驅動 opencodex.me 上的公開文件。

8. 相關生態系

OpenCodex 位於程式設計輔助工具（Codex、Claude Code、Claude Desktop、Grok Build）和 LLM 供應商（OpenAI、Anthropic、Google、xAI，以及 Ollama、DeepSeek、Qwen、GLM 和 Kimi 等開源／自架選項）之間。它在精神上與 OpenRouter 等工具互補 — 兩者都旨在抽象化供應商差異 — 但 OpenCodex 特別針對與程式設計輔助工具 CLI 和桌面應用程式的本機整合，而非作為託管 API 閘道。

9. 授權

✅ 使用、複製、修改、合併、發佈、散佈和再授權本軟體（MIT 授權）
✅ 可用於商業和私人專案
❌ 持有者不對因使用本軟體而產生的損害負責
ℹ️ OpenCodex 是一個獨立專案，與 OpenAI、Anthropic 或其他模型供應商無關；透過第三方代理路由 API 流量可能違反某些供應商的服務條款，因此使用前請檢視各供應商的政策

10. 常見問題

問：OpenCodex 支援哪些程式設計輔助工具？
答：Codex、Claude Code、Claude Desktop 和 Grok Build，透過 ocx start 啟動的本機代理。

問：我可以使用非 OpenAI 的模型嗎？
答：可以 — OpenCodex 支援 40+ 供應商，包括 Anthropic、Google、xAI，以及 DeepSeek、Qwen、GLM、Kimi 和 Ollama 等開源模型，使用 provider/model 語法選擇（例如 anthropic/claude-opus-5）。

問：透過 OpenCodex 路由我的供應商帳戶安全嗎？
答：功能上安全，但某些供應商可能會限制透過第三方代理路由流量的帳戶 — 連接帳戶前請檢視各供應商的服務條款。

問：如何管理多個 ChatGPT/Codex 帳戶？
答：使用 ocx account <...> 將帳戶池化；OpenCodex 會追蹤每個帳戶的配額，並可使用最低使用量、輪詢或優先填滿策略自動路由。

問：支援哪些平台？
答：macOS（arm64/x64）、Linux（x64/arm64）和 Windows（x64），每個平台都有原生背景服務整合（launchd、systemd、工作排程器）。

11. 快速連結

儲存庫：https://github.com/lidge-jun/opencodex
官方網站／文件：https://opencodex.me/
貢獻指南：https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md
npm 套件：https://www.npmjs.com/package/@bitkyc08/opencodex

12. 總結

OpenCodex 透過作為一個本機、協定轉換的代理，支援 40+ LLM 供應商並具備完整功能對等性，消除了熱門程式設計輔助工具的單一供應商鎖定。對於希望在不同任務間靈活混用模型、有效池化多個帳戶，並讓程式設計工作流程免受供應商特定中斷或配額限制影響的開發者和團隊而言，它最具價值。