opencodex 正確安裝教學:讓 Codex CLI 一次串接 Grok、Kimi、Claude、Gemini(原貼文漏了這一步)

最近 X 上一篇貼文引起不少開發者注意:一個叫 opencodex 的開源工具,號稱能把 Grok、Kimi、Claude、Gemini、DeepSeek 等各家 AI 訂閱通通塞進 Codex 的原生模型選單裡,不用再忍受官方客戶端的陽春體驗。查證了官方文件與 npm 套件資訊後,發現原貼文的步驟有一個關鍵環節被省略了,這篇把正確、完整的安裝流程整理出來,並附上原始貼文連結。

opencodex 是什麼

opencodex(npm 套件名 @bitkyc08/opencodex)是一個輕量級本地代理伺服器,把 Codex 的 Responses API 轉譯成各家 LLM provider 所使用的協議。簡單說,它讓你在 Codex CLI/App/SDK,甚至 Claude Code 裡,直接切換使用 Anthropic Claude、Google Gemini、xAI Grok、Kimi(月之暗面)、DeepSeek、Ollama 等 40 多家 provider 的模型,而不必等官方原生支援。目前支援 macOS、Linux、Windows,且已上架 npm,安裝方式跟一般全域套件一樣簡單。

開發者終端機與程式碼示意圖

原貼文的步驟少了什麼?

原始貼文列出的步驟是:安裝 → ocx init 交互配置 → OAuth 登入 → 直接打開 Codex 使用。查證官方文件後發現,這裡漏掉了一個關鍵指令——ocx start。ocx init 只負責寫入設定檔並把 opencodex 注入 Codex 的設定,真正讓代理伺服器「跑起來」接收請求的是 ocx start;沒有執行這一步,Codex 呼叫時代理不會回應,模型選單也可能顯示不出來。以下是官方文件驗證過的完整正確流程。

正確安裝與使用步驟(已驗證)

Step 1:安裝套件(需要 Node 18 以上,Bun 執行環境會在安裝時自動打包,不需另外安裝)

npm install -g @bitkyc08/opencodex

Step 2:互動式初始化(寫入設定檔並注入 Codex)

ocx init

Step 3:啟動代理伺服器(原貼文遺漏的關鍵步驟)

ocx start

Step 4:正常使用 Codex,請求會自動透過 opencodex 路由

codex "Write a hello world in Rust"

如果想手動指定要用哪個 provider 的模型,可以在指令加上 -m 參數,例如:

codex -m "anthropic/claude-opus-5" "解釋這段 stack trace"
codex -m "google/gemini-3-pro" "幫 auth.ts 寫單元測試"

多個 AI 模型並列切換示意圖

🎯 想要更個人化的建議?

每個人的狀況不一樣,文章只能給通用方向。
如果你想針對自己的情況聊聊,歡迎預約免費諮詢 ☺️

📱 加入 Line 官方帳號 →

📌 也歡迎追蹤 Instagram 看更多即時分析

OAuth 登入怎麼設定

xAI(Grok)、Anthropic(Claude)、Kimi 這三家支援 OAuth 登入,不用手動申請填寫 API key,指令是:

ocx login xai
ocx login anthropic
ocx login kimi

其餘 provider(如 Google Gemini、Azure OpenAI、DeepSeek、OpenRouter 等)則需要在 Web 儀表板貼上 API key。開啟儀表板的指令是 ocx gui,會打開 http://localhost:10100,點選「Add Provider」即可從 40 多家內建清單中挑選並貼上金鑰,模型會自動從 provider 的 /v1/models 端點抓取,新增後立即可用、不需重啟。

常見安裝問題:Bun 執行環境遺失

opencodex 把 Bun 執行環境包在依賴裡,不需自行安裝。如果安裝後出現「bundled Bun runtime is missing」錯誤,通常是安裝過程中 lifecycle script 被跳過(例如 npm 的 allowScripts 攔截了 bun 的 postinstall,或使用了 --ignore-scripts、--omit=optional)。解法是重新安裝時明確允許 bun 的安裝腳本:

npm install -g --allow-scripts=bun @bitkyc08/opencodex

(若當初是用 sudo 安裝的,重裝時也要繼續加 sudo)

開發工作站與多螢幕程式開發示意圖

不想用了怎麼辦

opencodex 設計上支援乾淨移除,執行 ocx stop(或儀表板的 Stop 按鈕)會關閉代理、停止背景服務,並把 Codex 設定還原成原始狀態,之後 codex 指令的行為就跟從未安裝過 opencodex 一樣,不會留下殘留設定或幽靈行程。

整體來說,這個工具對於手上同時有多家 AI 訂閱(例如 Kimi 199 方案、Grok、Claude Pro)卻苦於官方客戶端切換不便的開發者相當實用,唯一要注意的就是原貼文漏掉的 ocx start 這一步,記得跑完整套流程再開始使用。原始貼文可參考:https://x.com/gkxspace/status/2079546645302129032

🎯 想要更個人化的建議?

每個人的狀況不一樣,文章只能給通用方向。
如果你想針對自己的情況聊聊,歡迎預約免費諮詢 ☺️

📱 加入 Line 官方帳號 →

📌 也歡迎追蹤 Instagram 看更多即時分析

延伸閱讀