ドキュメント

Codex CLI

Codexが対応しているのはResponses APIのみです。config.tomlのプロバイダーブロックを1つ設定し、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"の1つだけで、省略した場合もこれがデフォルトです。CodexではChat Completionsのサポートが削除されたため、wire_api = "chat"を記述するよう案内している古いガイドは情報が古く、実際の/v1/responsesルートを持たないエンドポイントはCodexから利用できません。Kunavoはこれをネイティブに実装しています。

env_keyに指定するのは、環境変数の名前であり、キーそのものではありません。OpenAIがこの方式を採用しているのには理由があります。config.tomlは、コミットされたり、課題に貼り付けられたりするファイルだからです。

まだキーをお持ちですか？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>を使うか、プロバイダーブロックを複数用意してmodel_providerを変更します。

Codexの設定ファイルのリファレンスで2026年9月6日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

これが短い概要です。完全な手順 — モデルの選択、実際のセッション費用、失敗するケース — はCodex CLIのAPIキーガイドにあります。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これが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、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

モデル 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	推論の深さが料金に見合う計画立案向けの処理

請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト（エディターやチャットクライアントが送る内容の大半）では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

よくある質問

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のサポートを終了したため、/v1/chat/completions のみを実装するエンドポイントは、設定にかかわらずCodexから使用できません。エンドポイントは実際の /v1/responses ルートを提供する必要があります。

Codex CLIでClaudeモデルを実行できますか？

はい。エンドポイントがそれらをResponses API経由で公開していれば使用できます。Codexは base_url で指定された宛先にResponses形式のリクエストを送り、モデルIDをそのまま渡します。そのため、Responsesをモデル独自の形式に変換するゲートウェイがあれば、ClaudeやGeminiのIDをCodexで利用できます。Codex自体は、どのベンダーが応答するかを認識しません。

Codex CLIはAPIキーをどこに保存しますか？

プロバイダーブロックの env_key フィールドで指定した環境変数に保存します。config.tomlには保存しません。Codexは起動時に環境変数を読み込むため、キーはシェルのプロファイルまたはシークレットマネージャーに保存され、設定ファイルは安全にコミットしたり、バグ報告に貼り付けたりできます。