文件

Codex CLI

Codex 只支援 Responses API。只要在 config.toml 中加入一個 provider 區塊，指向 Kunavo 原生的 /v1/responses 介面，並將金鑰存放在環境變數中，而非檔案內。

在 ~/.codex/config.toml 中設定 [model_providers.kunavo] 區塊與 env_key，讓金鑰留在環境變數中，永不出現在設定檔。

~/.codex/config.toml

model = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"     # the NAME of the variable, not the key
# wire_api defaults to "responses", which is the only supported value

wire_api 現在只有一個合法值："responses"；省略時也會採用這個預設值。Codex 已移除對 Chat Completions 的支援，因此任何舊指南若告訴你設定 wire_api = "chat"，內容都已過時；沒有真正 /v1/responses 路由的端點也完全無法在 Codex 中使用。Kunavo 原生實作了此路由。

env_key 存放的是環境變數的名稱，而非金鑰本身。這是 OpenAI 刻意如此設計的：config.toml 是人們會提交至版本庫、並貼到 issue 中的檔案。

還沒有金鑰？建立 Kunavo 帳戶，建立金鑰（以 sk-kn- 開頭），並從 $10 起新增額度——呼叫會從該餘額扣款，失敗的呼叫不會計費。之後儀表板會開啟 Codex CLI 設定。

逐步操作

在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
將上方區塊加入 ~/.codex/config.toml；若檔案不存在，請建立檔案。
匯出 env_key 指定的變數：export KUNAVO_API_KEY=sk-kn-...
執行 codex。最上層的 model_provider 用於選取區塊；model 用於選取區塊中的 ID。
若要每個工作階段切換模型，而不修改檔案，請使用 codex -m <model id>；或保留多個 provider 區塊，然後變更 model_provider。

已於 2026年9月6日根據 Codex 設定檔參考文件進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

這是簡短版本。完整指南——模型選擇、實際工作階段費用，以及失敗情況——請參閱 Codex CLI API 金鑰指南。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Codex CLI 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

模型 ID	Kunavo 輸入／輸出	它在 Codex CLI 中的位置
`gpt-5-6-sol`	$2.00 / $12.00	Codex 的預設搭配——原生支援 Responses，直接轉送
`gpt-6-sol`	$0.80 / $4.00	OpenAI 的 GPT-6，適用於複雜程式設計與代理程式——使用相同的 Responses 路徑，費率低於 5.6 Sol
`gpt-6-luna`	$0.04 / $0.20	最便宜的 GPT-6，適用於大量或低投入的處理
`gpt-5-6-terra`	$0.70 / $4.20	更便宜的 GPT 級別，適用於以編輯為主的工作階段
`claude-sonnet-5`	$1.40 / $7.00	透過 Responses 使用非 GPT 模型——由閘道轉換格式
`claude-opus-5`	$3.50 / $17.50	適用於值得投入該費率的深度推理規劃工作

計費方式是從預付餘額按權杖計費，沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取對帳單的影響比模型選擇更大。

常見問題

如何讓 Codex CLI 指向自訂 API 端點？

在 ~/.codex/config.toml 中加入 [model_providers.<id>] 區塊，設定 name、base_url 和 env_key，接著將最上層的 model_provider 設為該 id，並將 model 設為你要使用的 id。base_url 是服務的 /v1 根路徑；env_key 指定存放金鑰的環境變數名稱，因此金鑰不會出現在檔案中。

Codex CLI 需要哪個 wire_api 值？

「responses」——設定參考文件指出，這是唯一支援的值，也是省略時的預設值。Codex 已移除對 Chat Completions 的支援，因此無論如何設定，都無法在 Codex 中使用僅實作 /v1/chat/completions 的端點。端點必須提供真正的 /v1/responses 路由。

Codex CLI 能執行 Claude 模型嗎？

可以，前提是端點透過 Responses API 提供這些模型。Codex 會將 Responses 格式的請求傳送至 base_url 指定的位址，並傳遞模型 id，因此能將 Responses 轉換為模型原生格式的閘道，可讓 Codex 使用 Claude 或 Gemini id。Codex 本身不知道是哪家供應商在回應。

Codex CLI 將 API 金鑰存放在哪裡？

存放在供應商區塊 env_key 欄位指定的環境變數中，而非 config.toml。Codex 會在啟動時讀取該變數，因此金鑰會存放在 shell 設定檔或密碼管理工具中，設定檔可安全地提交版本控制，也可貼到錯誤回報中。