GetCheapAI

在 Codex 中使用 API 中轉站

透過 ~/.codex/config.toml 設定自訂的模型提供者。

3 分鐘閱讀

Codex CLI 在啟動時會讀取 ~/.codex/config.toml。透過自訂「模型提供者（model provider）」，可以讓 Codex 連接到相容 OpenAI 介面的 API 中轉站。

準備資訊

從你使用的 API 平台取得以下資訊：

  • API 位址（Base URL）：平台提供的介面根位址，通常以 /v1 結尾
  • API 金鑰（Key）：用於驗證的權杖
  • 模型名稱：平台支援、且你打算使用的模型識別碼

設定 config.toml

編輯 ~/.codex/config.toml，新增一個自訂提供者並將其設為預設：

model = "your-model-name"        # 替換為平台支援的模型名稱
model_provider = "thirdparty"    # 自訂提供者識別碼，可自行取名（勿用 openai/ollama/lmstudio）

[model_providers.thirdparty]
name = "Third-party API"
base_url = "https://example.com/v1"   # 替換為平台提供的 API 位址
env_key = "THIRDPARTY_API_KEY"        # 讀取金鑰的環境變數名稱
wire_api = "chat"                      # 第三方相容端點通常使用 chat

env_key 指定的是「存放金鑰的環境變數名稱」，而不是金鑰本身。請在終端機中匯出該變數：

export THIRDPARTY_API_KEY="your-key"

常見問題

  • 金鑰驗證失敗：若平台金鑰前綴與 OpenAI 不同而被拒絕，可在該提供者的設定下加入 requires_openai_auth = false。
  • 協定選擇：第三方相容端點一般使用 wire_api = "chat"（對應 /chat/completions）。
  • 不要把金鑰寫進 config.toml：用 env_key 指向環境變數，避免金鑰隨設定檔外洩。
  • 僅暫時改用：如只想暫時變更位址，可設定環境變數 OPENAI_BASE_URL 覆蓋目前的工作階段。

了解更多