API キーを使う Codex CLI — 設定、モデル、セッションコスト

Codex CLI は OpenAI のオープンソースのターミナル用コードエージェントで、ChatGPT ログインと API キーの両方で動作します。理解しておくべきなのはキーを使う方法です。トークン単位で課金され、月額料金はなく、CLI を別のプロバイダー — または別のモデルファミリー — に向けられる唯一の方法です。このガイドでは、動作する設定、大半のゲートウェイを使えなくする要件、1セッションの料金、そしてブラジルから Pix で支払う方法を説明します。

重要な唯一の要件

Codex CLI が通信するのは OpenAI の Responses 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も引き続き利用できます。

トークン単位の料金は USD で設定されています。Pix では Stripe が支払い時にブラジルレアルへの換算額を表示します。カードでは発行会社の為替レートが適用されます（銀行アプリで IOF と海外取引手数料を確認してください） — Pix で API に支払う手順は Pix で API に支払う方法のガイドにあります。ウォレットは前払い式で、最低チャージ額は $10、サブスクリプションと自動更新はなく、残高に有効期限はありません。

使用するモデル

gpt-5-6-sol はコード向けに調整された GPT であり、この CLI の自然な標準モデルです。料金は、OpenAIの料金表（現在はプロモーション価格 $4.00 / $20.00 が適用されており、料金ページによると少なくとも2026年11月21日まで利用可能）の $5.00 / $30.00 に対して、100万トークンあたり $2.00 / $12.00 です。完全な料金は料金ページにあります。

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 は reasoning の不透明な項目を送信しますが、これを利用できるのはネイティブ Responses モデルだけです。そのため、GPT 以外のアップストリームへ向かう途中で破棄されます。モデルは前のターンの非公開ドラフトを失いますが、そこから続行する可視のトランスクリプトはそのまま残ります。実際には、これは長い推論チェーンでの継続性を少し低下させますが、通常の編集・実行・修正ループには影響しません。

Claude を明確に使いたい場合は、Claude Codeがそのために作られており、cache_control を変換なしで渡します。ただし、Codex CLI のサンドボックスを好み、その背後で Claude を使いたい場合は、この組み合わせも可能です。

1セッションの料金

エージェント型 CLI は、各ステップでシステムプロンプト、タスク履歴、ファイルコンテキストを再送するため、ステップ数から想像するよりも速くトークンが蓄積します。一般的な1ステップは入力約25,000トークン、出力1,200トークンです。

つまり、Pix で $10 をチャージすれば、20ステップのエージェント型タスクを約 8 件実行できます。また、失敗したリクエストには課金されません — セッション途中の 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 はパスを自動的に追加します。ベースは /v1 で終わります。
• 401 — env_key で指定された変数が、Codex を起動したシェルで空になっています。同じターミナルで echo $KUNAVO_API_KEY を実行して確認してください。
• 402 — 残高不足です。billing でチャージしてください（Pix はすぐに反映されます）。
• model_not_found — モデルのスラッグがカタログに存在しません。/models で確認してください。

よくある質問