Codex 接 OpenAI 兼容中轉站 Base URL 配置教程

安裝 OpenAI Codex CLI，配置 API Key、Base URL、config.toml 與 provider 切換，接入 OpenAI 相容中轉站，並用最小請求驗證模型和接口是否可用。

安裝和啟動

Codex CLI 是 OpenAI 的本地編程代理,官方安裝方式是:

npm i -g @openai/codex
codex

第一次運行時,Codex 會讓你登錄 ChatGPT 賬號或使用 API Key。用中轉站時,通常走 API Key 和 OpenAI 兼容接口。

先確認服務商支持什麼

Codex 不是普通聊天殼。它會讀代碼、改文件、跑命令,所以中轉站最好明確支持 OpenAI Responses API 或 Codex 可用的 OpenAI 兼容接口。

你需要向服務商確認:

  • Base URL 是不是 OpenAI 兼容地址
  • 是否支持 Responses API
  • 模型名應該填什麼
  • 是否支持流式輸出和工具調用
  • 是否有特殊 Header 或 query 參數

如果你還沒選好服務商，可以先看 Codex 中轉服務對比。想擴大到所有 OpenAI 兼容接口，再看 OpenAI API 中轉服務商 對比頁。對價格敏感的配置，也可以參考 便宜 OpenAI API 服務商，或直接瀏覽完整的 AI API 服務商目錄。

配置方式

臨時測試時,可以優先用環境變量:

export OPENAI_API_KEY="你的中轉站 API Key"
export OPENAI_BASE_URL="https://你的中轉站地址/v1"
codex

長期使用時,再考慮寫進 ~/.codex/config.toml,用不同 profile 區分官方 OpenAI、中轉站、本地模型或團隊網關。

排障順序

  1. 先確認 codex --version 是最新版。
  2. 再確認 OPENAI_API_KEY 和 OPENAI_BASE_URL 當前終端確實生效。
  3. 讓服務商確認 Codex 需要的接口類型,不要只問“支不支持 OpenAI 格式”。
  4. 如果你用了 config.toml,先回到環境變量臨時配置排查,減少變量。

Codex 版本變化比較快,配置項也會繼續演進。寫教程時最好把“可驗證的最小配置”和“高級 profile 配置”分開,避免讀者照抄一段複雜 TOML 後不知道錯在哪裡。

Codex OpenAI config.toml

相關錯誤

Claude Code / Codex 503 No available accounts：中轉站帳號池不可用排查 先不要盲目換 Key。這個錯誤通常說明帳號池、供應商、分組或模型路由暫時不可用。先測最小請求、確認模型和分組，再判斷是等待恢復、降低上下文，還是換 provider。 Codex: Selected model is at capacity. 模型容量已滿排查 報錯：Selected model is at capacity. Please try a different model. 先把它當作模型級容量、Admission 或串流中斷問題處理。它可能出現在官方 ChatGPT 登錄態 Codex CLI，也可能來自中轉站帳號池或 Sub2API 上游 overloaded 透傳。 Error 401 Unauthorized：AI API 中轉站認證排查 401 是認證失敗訊號。先檢查目前載入的是哪一個 Key、請求打到哪個 Base URL、header 格式是否正確，以及這個 Key 是否仍然在對應 provider 中有效。 Error 429 Too Many Requests：AI API 中轉站限流排查 報錯：exceeded retry limit, last status: 429 Too Many Requests, request id: <request-id>。AI 中轉站裡連續 429 多半是上游帳號池限流、冷卻或額度耗盡，先讓服務商換號、換線路或換模型。