使用 API 金鑰的 Codex CLI——設定、模型與工作階段成本

Codex CLI 是 OpenAI 開源的終端機程式碼代理，可使用 ChatGPT 登入或API 金鑰執行。金鑰路徑最值得理解：按 token 計費、沒有月費，而且只有這條路徑能讓你將 CLI 指向其他供應商——或其他模型系列。本指南說明可正常運作的設定、會讓大多數閘道失敗的要求、一次工作階段的費用，以及如何在巴西使用 Pix 付款。

唯一重要的要求

Codex CLI 使用 OpenAI 的 Responses API，而且只有這個 API：model_providers 區塊只接受 wire_api = "responses"。只提供 /v1/chat/completions 的閘道完全無法設定——這就是許多「相容於 OpenAI」端點在此失敗的原因。Kunavo 除了聊天端點外也提供 POST /v1/responses，因此下方的設定無須調整即可運作。

設定方式

# ~/.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"
wire_api = "responses"

env_key 是環境變數的名稱，而不是金鑰：Codex 絕不會將金鑰寫入設定檔。

# O Codex lê a chave da variável indicada em env_key.
export KUNAVO_API_KEY="sk-kn-..."     # crie em kunavo.com/app/keys

# Deixe persistente (escolha o arquivo que o seu shell realmente carrega):
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

codex "explique a estrutura deste repositório"

完成註冊並儲值 $10 後，在控制面板建立金鑰——金鑰只會顯示一次。

從巴西付款——Pix，無須國際信用卡

對巴西開發者而言，障礙很少是 TOML 檔案，而是付款方式。直接向 OpenAI 支付 API 費用需要啟用海外購物功能的國際信用卡。在 Kunavo，結帳由 Stripe 處理，對於從巴西付款的使用者，Pix 會列為付款方式——金額以巴西雷亞爾顯示並立即完成入帳。偏好使用國際信用卡的人仍可使用 Visa、Mastercard、American Express、Apple Pay 和 Google Pay。

每 token 費率以 USD 制定：使用 Pix 時，Stripe 會在付款當下顯示換算後的巴西雷亞爾金額；使用信用卡時，換算依發卡機構匯率進行（請在銀行 App 中確認 IOF 與國際交易手續費）——Pix 儲值步驟請參閱使用 Pix 支付 API 指南。錢包採預付制——最低儲值額為 $10、沒有訂閱或自動續費，且餘額永不過期。

該使用哪個模型

gpt-5-6-sol 是針對程式碼調校的 GPT，也是此 CLI 的自然預設選擇，輸入 / 輸出每 1M token 為 $2.00 / $12.00，相較於 $5.00 / $30.00（OpenAI 的牌價——目前 OpenAI 收取促銷價格 $4.00 / $20.00，依價格頁面所示至少提供至 2026年11月21日）。完整費率請參閱價格頁面。

在 Codex CLI 中執行 Claude 模型

這通常會讓人意外：Codex CLI 受限於協定，而非模型。它使用 Responses 格式，而位於該端點後方的任何聊天模型都能回應。將其指向 claude-opus-5 後即可端到端執行——包括工具呼叫，因此代理仍能讀取檔案、提出編輯內容並執行指令。

# Mesmo bloco de provider, outro modelo — sem chave nova, sem config nova.
model          = "claude-opus-5"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"
wire_api = "responses"

閘道會將 Responses 請求轉換為Anthropic Messages 原生 API，再將回應轉換回 Responses 格式。需要坦白說明的一點是：Codex 會傳送只有原生 Responses 模型才能消費的不透明 reasoning 項目；傳送至非 GPT 的上游時，這些項目會被捨棄。模型會失去上一回合的私有草稿，但它所依據的可見轉錄仍會完整保留。實務上，這會讓長鏈推理的連貫性略有降低，但不會影響一般的編輯—執行—修正迴圈。

如果你特別想使用 Claude，Claude Code 就是為此設計，會直接傳送 cache_control，不經轉譯。不過，如果你偏好 Codex CLI 的沙箱，又想在其後方使用 Claude，這種組合是可行的。

一次工作階段的費用

智慧體 CLI 會在每個步驟重新傳送系統提示詞、工作歷史與檔案上下文，因此 token 累積速度比步驟數所暗示的更快。典型步驟約包含 25,000 個輸入 token 與 1,200 個輸出 token：

也就是說，使用 Pix 儲值 $10 約可支付 8 個 20 步驟的 Agentic 工作。而且失敗請求不會計費——工作階段中途的 5xx 不會出現在帳單上。

無法運作時

在責怪 Codex 之前，先確認金鑰與端點確實有回應：

# Confirme a chave e o endpoint antes de culpar o Codex.
curl https://api.kunavo.com/v1/responses \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-6-sol",
    "input": "Responda OK e nada mais."
  }'

• 404——供應商未實作 /v1/responses，或 base_url 已經包含 /responses。Codex 會自行新增路徑：基礎 URL 應以 /v1 結尾。
• 401——env_key 指定的環境變數在啟動 Codex 的 shell 中是空的。請在同一個終端機中使用 echo $KUNAVO_API_KEY 檢查。
• 402——餘額不足：請在帳務中儲值（Pix 會立即入帳）。
• model_not_found——模型 slug 不存在於目錄中；請在 /models 檢查。

常見問題