首頁 → 指南 → Codex 接入第三方 API：命令列版與桌面版的 config.toml 設定

Codex 接入第三方 API：命令列版與桌面版的 config.toml 設定

Codex 從一個設定檔讀取服務商。五行設定加一個環境變數，就能把命令列版和桌面版同時切到另一個介面——而大多數失敗出在環境變數，不在設定檔。

設定內容

在 config.toml 中加入一個服務商，並設為預設：

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

有三處要注意。base_url 要以 /v1 結尾，因為 Codex 會自行在後面加上 /responses。wire_api = "responses" 讓 Codex 使用 Responses API，本閘道支援此介面。env_key 填的是環境變數的名稱，不是金鑰本身。

設定檔在哪裡

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

資料夾和檔案不存在就自行建立。Codex 桌面版與命令列版讀取同一個檔案，改一次兩邊都生效。不想手動編輯 TOML 的話，可以用 CC Switch 代勞——見桌面用戶端指南。

設定金鑰，讓 Codex 讀得到

macOS / Linux ——寫進終端機設定檔：

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows ——儲存到目前使用者：

setx APICLAN_API_KEY "sk-your-key"

大多數設定都壞在這一步。用 export 或 $env: 設定的變數只在該終端機視窗有效；從 Dock 或開始選單開啟的桌面版根本看不到。Windows 的 setx 會永久儲存，但只有之後啟動的程式才讀得到——要把 Codex 完全結束再重新開啟。

選擇模型與推理強度

在設定中修改 model，或在工作階段中用 /model 切換：

模型	適合
gpt-6.1-sol, gpt-5.6-terra	日常寫程式、修改、撰寫測試——單次最便宜
gpt-5.6-sol	提示詞已針對 GPT-5.6 調好時
gpt-6-astra	值得多花五倍價錢換更好答案的難題

model_reasoning_effort 可設為 low、medium、high、xhigh。強度越高寫得越多：本站 gpt-5.6-sol 的中位數呼叫，high 輸出 373 個 token，medium 只有 139 個——多了 2.7 倍，全部按輸出計費。建議從 medium 開始。價格見 OpenAI API 價格指南。

本站的 Codex 流量樣貌

過去 30 天，本閘道 87% 的 GPT 呼叫來自 Codex，全部透過 /v1/responses 串流請求。中位數呼叫：

• 帶著約 6.7 萬 token 的上下文，其中 86% 來自快取
• 全程 14 秒，第一個 token 在第 10 秒出現
• 輸出 214 個 token

最常見的四種錯誤

• 401 Unauthorized → Codex 讀不到 APICLAN_API_KEY。依上述方式設定，然後把 Codex 完全重新啟動。在同一環境中執行 echo $APICLAN_API_KEY 應能印出金鑰。
• 404 或回傳網頁 → base_url 漏了 /v1，或寫了兩次。
• model not found → 模型名稱拼錯，或你的金鑰所屬分組沒有該模型。以 GET https://apiclan.us/v1/models 回傳的清單為準。
• stream disconnected 或長任務逾時 → 推理時間太長，超過代理的等待上限。把 base_url 改成 https://api.apiclan.us/v1，這個位址繞過了 100 秒的代理限制。

Claude Code 的規則正好相反——不加 /v1——見 Claude Code base URL 指南。

開始使用

無訂閱、無最低消費、不用跟業務通話。用 USDT 儲值，用多少花多少 —— 1 USDT = 2 額度。

看 30 秒快速開始

語言: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

本頁價格由即時計費資料自動填入；第三方條款引自對方公開文件。