Codex CLI APIキー — 動作するカスタムプロバイダー設定

Codex APIキーとは、ChatGPTプランの代わりにCodex CLIがトークン単位で課金できる任意のキーです。platform.openai.comのOpenAI APIキーや、Codexがenv_keyで指定された環境変数から読み取る、model_providersブロック内のKunavoのsk-kn-のようなプロバイダーキーが該当します。 プロバイダーはResponses APIを提供する必要があります—以下の唯一の要件です。

Codex CLIはOpenAIのオープンソースのターミナル型コーディングエージェントで、ChatGPTのサインインまたはAPIキーのいずれかで動作します。理解しておく価値があるのはAPIキールートです。月額料金なしでトークン単位に課金され、CLIを別のプロバイダー、あるいはまったく別のモデルファミリーに向けられる唯一のルートだからです。このガイドでは、実際に使える設定、ほとんどのゲートウェイがつまずく唯一の要件、そして1回のセッションに実際にかかる費用を説明します。

重要な唯一の要件

Codex CLIは、ほとんどのツールよりもカスタムエンドポイントに厳格です。そのmodel_providersブロックにはwire_apiキーがあり、受け付ける値は1つだけです：responses。つまり、カスタムプロバイダーはOpenAIのResponses APIをPOST /v1/responsesで提供する必要があり、はるかに一般的な/v1/chat/completionsではありません。OpenAI互換ゲートウェイの多くは後者しか提供しないため、どんなbase_urlを指定してもCodex CLIを動かせません。

Kunavoは両方のインターフェースを提供するため、以下の設定がそのまま動作します。

設定

Codexは~/.codex/config.tomlを読み取ります。トップレベルの2つのキーでモデルとプロバイダーを選択し、プロバイダーブロックで接続方法を指定します。

# ~/.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は起動時にそこからキーを読み取ります—そのため設定ファイルは安全にコミットまたは共有できます。

# Codex reads the key from the variable named by env_key.
export KUNAVO_API_KEY="sk-kn-..."     # create at kunavo.com/app/keys

# Persist it (pick the file your shell actually loads):
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

codex "explain the structure of this repository"

サインアップして$10をチャージした後、ダッシュボードでキーを作成します。キーは一度しか表示されないため、すぐに保存してください。別のシェルですでにcodexを実行していた場合は再起動してください—変数はリクエストごとではなく起動時に読み取られます。

デバッグする前に確認

問題がある場合は、キー、エンドポイント、CLIのどれに原因があるかを確認します。1回のリクエストで判定できます。

# Confirm the key and the endpoint before blaming 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": "Say OK and nothing else."
  }'

JSONレスポンスが返れば、キーとエンドポイントは正常で、残る問題はconfig.tomlにあります。401はキーが間違っているか、このシェルで変数が空であることを示します。modelでの404は、スラッグがカタログと一致していないことを示します。

設定するモデル

modelの値は同じエンドポイント上の単なるスラッグなので、切り替えは1語の編集で済みます—新しいキーも新しいプロバイダーブロックも不要です。

gpt-5-6-solはコーディング向けに調整されたGPTで、このCLIの自然なデフォルトです。1Mトークンあたりの価格は$2.00 / $12.00で、OpenAIの定価は$5.00 / $30.00です — ただし、OpenAIは現在プロモーション価格 $4.00 / $20.00 を請求しており、少なくとも2026年11月21日まで利用可能です。すべてのモデルの完全な料金は料金ページにあります。

Codex CLIでClaudeモデルを実行する

意外に思われるかもしれませんが、Codex CLIはモデルではなくプロトコルに結び付いています。Responsesのワイヤ形式で通信し、そのエンドポイントの背後にあるチャットモデルが応答します。claude-opus-5を指定すれば最初から最後まで動作し、ツール呼び出しも含まれるため、エージェントは通常どおりファイルを読み、編集を提案し、コマンドを実行できます。

# Same provider block, different model — no new key, no new config.
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形式に戻します。正直な注意点が1つあります。CodexはResponsesネイティブモデルだけが消費できる不透明なreasoning項目を送信し、それらは非GPTの上流サービスへ送る途中で削除されます。モデルは前のターンの非公開スクラッチパッドを失いますが、処理元となる可視のトランスクリプトは保持されます。実際には、長い推論チェーンでは継続性が少し低下しますが、通常の編集・実行・修正ループではまったく影響しません。

それが良い考えかどうかは、動作するかどうかとは別の問題です。Claudeを特に使いたい場合、Claude CodeはClaude向けに構築されており、cache_controlを変換せずにそのまま渡します。ただし、Codex CLIのサンドボックスを好み、その背後でClaudeを使いたい場合、この組み合わせは利用できます。

セッションの料金

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

モデルファミリー間では入力料金より出力料金の差の方がはるかに大きいため、出力の多い作業では順位が変わります—1つの計算例を信頼せず、自分の数値をコスト計算ツールに入力してください。失敗したリクエストには課金されません。

APIキールートがサブスクリプションに勝る場合

ChatGPTプランには月額固定料金でCodexの利用が含まれますが、APIキーでは実行した分だけ課金されます。毎日ではなく集中的にコーディングする時期がある場合、不透明な利用枠ではなくキーごとの支出上限と使用状況の可視性を求める場合、またはサブスクリプションでは提供されないモデルを使いたい場合は、APIキーを使う方法が有利です。毎日大量に使う場合は不利です。その利用量では固定料金を上回るメリットを得るのは困難です。両方の方法を併用できます。Codexのプロファイルを使えば両方を保持し、タスクごとに切り替えられます。

トラブルシューティング

よくある質問