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 覆蓋目前嘅工作階段。

了解更多