在 Codex CLI 裡使用

在 ~/.codex/config.toml 設定自訂 model_provider（wire_api = responses），並指定模型。

Codex 是 OpenAI 的程式開發代理（CLI 與桌面版）。它支援自訂 model provider——把 provider 指向 OLETOKEN，就會使用你的 OLETOKEN 金鑰與模型額度。

開始之前

你已建立 API 金鑰並保存完整金鑰。
你已從模型市場挑選一個模型 ID。
已安裝 Node.js 與 npm。

設定

自訂 provider 必須寫在使用者層級的 ~/.codex/config.toml。專案層級 .codex/config.toml 裡的 model_provider 與 model_providers 不會生效。

model = "gpt-5.6-terra"
model_provider = "oletoken"

[model_providers.oletoken]
name = "OleToken"
base_url = "https://<your-base-url>/v1"
env_key = "OLETOKEN_API_KEY"
wire_api = "responses"

欄位	含義
`model`	預設模型 ID
`model_provider`	指向下方定義的 provider
`base_url`	OpenAI 相容位址，要包含 `/v1`（Codex 會呼叫 `{base_url}/responses`）
`env_key`	存放金鑰的環境變數名稱——金鑰本身不會寫進檔案
`wire_api`	目前僅支援 `responses`

匯出金鑰並啟動：

export OLETOKEN_API_KEY="YOUR_API_KEY"   # 寫進 ~/.zshrc 或 ~/.bashrc 可長期生效
npm i -g @openai/codex
codex

API 金鑰頁上的**「快速介接」**彈窗提供同一份指令碼下載，金鑰、模型與 Base URL 都已填好：它會補上缺少的內容，而若 config.toml 已有 model / model_provider，則只會印出該區塊供你自行合併，不會改寫你的檔案。

疑難排解

現象	原因與處理
401	`OLETOKEN_API_KEY` 沒有匯出，或值不正確——`env_key` 只是變數名稱，金鑰必須實際存在於環境中
404	`base_url` 少了 `/v1`
Provider 未生效	設定寫在專案層級的 `.codex/config.toml`；請搬到 `~/.codex/config.toml`
找不到模型（Model not found）	該 ID 不在本站上架清單中；請從模型市場複製
餘額不足（Insufficient balance）	先儲值

wire_api 只支援 responses，因此 Codex 會把請求送到 {base_url}/responses——請確認你的 Base URL 有開放該端點（沒帶金鑰時回 401 表示路由存在）。