Codex 接入第三方模型實作指南

這篇教你把第三方開源模型接到 OpenAI Codex App、CLI 和 SDK，完成設定、驗證與回退。

這篇指南適合想把 OpenAI Codex 文件和 Codex GitHub 倉庫接到自訂模型上的開發者。照做完，你會得到一套可運行的接入流程，能把第三方模型掛到 Codex App、CLI 或 SDK 上，並驗證它是否真的在工作。

本文只基於已公開資訊整理成操作步驟，重點放在準備環境、配置模型提供方、連通 Codex 工具鏈，以及最後的驗證和排錯。你不需要先改造整個專案，只要先把模型端和 Codex 端對接起來，就能開始試用。

開始之前

• OpenAI 帳號，且能存取 Codex 相關功能。
• 一個可用的第三方模型提供方帳號，支援 OpenAI 相容 API 或 Codex 相容接入方式。
• API key：OpenAI Codex 端 key，以及第三方模型端 key。
• Node 20+，如果你要用 CLI 或 SDK 的 JavaScript 範例。
• Git 2.40+，用於拉取示例專案或倉庫。
• 至少 2 GB 可用記憶體，便於本地執行 CLI、日誌和測試腳本。

Step 1: 取得 Codex 工具鏈

目的：先把 Codex 的 App、CLI 或 SDK 入口準備好，後續才能切換模型，而不是只停留在文件階段。先確認你打算從哪個入口開始：如果偏向命令列，就裝 CLI；如果偏向程式整合，就先接 SDK；如果想快速試驗，就用 App。

git clone https://github.com/openai/codex.git
cd codex
# 按倉庫說明安裝 CLI 或 SDK 依賴

驗收：你應該看到倉庫內容、安裝命令成功執行，並且本地能打開 Codex 的配置說明或幫助資訊。

Step 2: 準備第三方模型端點

目的：拿到一個可呼叫的模型 API 位址、模型名和密鑰。Codex 的接入重點不是模型來源，而是它是否能提供穩定的推理介面。優先選擇支援 OpenAI 風格請求格式的服務，這樣遷移成本最低。

把這些資訊記下來：base URL、model id、API key、請求限流規則，以及是否需要額外的 organization ID 或 project ID。後面配置時，這些欄位會直接對應到 Codex 的連線參數。

驗收：先發一次最小請求。你應該拿到一個正常的文字回覆，而不是 401、404 或格式錯誤。

Step 3: 設定 Codex 模型連線

目的：讓 Codex 讀到你的第三方模型設定，並把請求轉發過去。不同入口的設定方式會不同，但思路一致：把模型提供方的位址、密鑰和模型名寫進 Codex 的設定檔或環境變數。

export OPENAI_API_KEY="your-codex-key"
export OPENAI_BASE_URL="https://your-third-party-endpoint/v1"
export OPENAI_MODEL="your-model-name"

如果你用的是支援自訂 provider 的設定檔，就把同樣的資訊寫入對應欄位。重點是確認 Codex 發出的請求不再落到預設模型上，而是命中你填的第三方端點。

驗收：啟動 Codex CLI 或 SDK 範例後查看日誌。你應該能看到請求發往第三方 base URL，並且回傳內容來自你選擇的模型。

Step 4: 跑一次端到端任務

目的：證明接入不是「能連上」，而是「能幹活」。選一個小任務最合適，例如讓 Codex 生成一個函式、修改一個測試，或總結一段程式碼。任務越小，越容易判斷模型是否真的被呼叫。

建議先用 CLI 跑一個單檔任務，再用 SDK 跑一個簡短腳本。這樣你能分別驗證互動式流程和程式化流程，避免只在一個入口上成功。

驗收：你應該看到模型回傳可執行的程式碼、補丁或解釋，並且輸出結果符合你指定的第三方模型風格和能力邊界。

Step 5: 固化環境變數和回退方案

目的：把臨時接入變成可重複使用的設定。把 base URL、模型名和 key 放進 .env、CI secrets 或部署環境變數裡，避免每次手動輸入。同時準備一個回退方案，方便第三方模型不可用時切回預設提供方。

如果你的團隊要多人協作，最好把設定寫進 README 或內部運行手冊，並註明哪些欄位必須保密，哪些欄位可以公開。這樣後續換模型時，改動範圍會更小。

驗收：重啟終端或重新拉起容器後，Codex 仍然能自動讀到設定，不需要人工補參。

常見錯誤

• 模型名寫錯。修法：先用第三方控制台的模型列表複製準確名稱，再寫入設定。
• 端點不是 OpenAI 相容格式。修法：確認路徑、請求體和認證頭與 Codex 期望一致，必要時加一層適配代理。
• 只測了連通性，沒測任務輸出。修法：跑一次真實程式生成或修改任務，檢查回傳結果是否可用。

接下來可以看什麼

接下來可以把同一套接入方式擴展到團隊工作流裡，例如接入 CI、自動化程式碼審查，或為不同任務路由不同模型；如果你需要更穩的方案，再繼續研究 Codex 的設定層、日誌層和模型回退策略。