Responses API で Codex を外部モデルに接続する

先に結論

現在の Codex の wire_api は "responses" のみ対応しています。 "chat" は削除されており、指定すると起動時に設定エラーになります。KimiSeek は /v1/responses を提供するため、以下の設定で直接接続できます。

30 秒でわかる判断表

Codex がデフォルトで responses を使う理由

Codex は /responses にリクエストを送り、Responses のツール呼び出しとストリーミングイベントを処理します。Chat Completions はリクエストとイベントの構造が異なり、wire_api の変更だけでは現在の Codex から利用できません。モデルの能力は上流とゲートウェイの実装にも依存し、API の疎通成功だけで全ツールの動作が確認できるわけではありません。

前提条件

• Node.js 20 以上
• Codex CLI：npm install -g @openai/codex
• KimiSeek の API Key（ks- で始まる）。ダッシュボードで作成

Step 1 · 設定ファイルを書く

設定ファイルは ~/.codex/config.toml にあります。なければ新規作成します：

model = "deepseek-v4-pro-0813"
model_provider = "kimiseek"

[model_providers.kimiseek]
name = "KimiSeek"
base_url = "https://api.kimiseek.app/v1"
env_key = "KIMISEEK_API_KEY"
wire_api = "responses"

つまずきやすいポイントは 3 つ：

1. base_url には必ず /v1 を付ける。Codex は base_url の後ろにそのまま /responses を連結します。/v1 を書き忘れると https://api.kimiseek.app/responses にリクエストが飛び、404 になります。
2. env_key は環境変数名であり、key そのものではない。ここに書くのは変数名 KIMISEEK_API_KEY で、実際の値は環境変数に入れます。
3. model は catalog に実在する id を使う。間違えると model not found になります。廃止済みのモデルでも同じエラーになります。

Step 2 · 環境変数を設定して起動

export KIMISEEK_API_KEY="ks-your-key"

codex

一時的にモデルを変えたいなら、config.toml の model を直接書き換えるか、codex --model <id> で上書きします。

Step 3 · key が有効か確認する

curl https://api.kimiseek.app/v1/models \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Set KIMISEEK_API_KEY before running this command}"

応答にモデル一覧が含まれていれば、key とネットワークの両方に問題はありません。このステップの意味は「認証の問題」と「プロトコルの問題」を切り分けることです。そうしないと、404 が出たときに key が悪いのかパスが悪いのか判断できません。

Step 4 · 30 秒で responses を検証する

curl https://api.kimiseek.app/v1/responses \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Set KIMISEEK_API_KEY before running this command}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro-0813",
    "input": "Explain what a base URL is in one sentence.",
    "max_output_tokens": 256,
    "stream": false
  }'

• HTTP 200 と output 配列を含む JSON → Responses のルートは利用可能。次に実際のタスクとツール呼び出しを確認します。
• HTTP 404 → base_url の /v1 を確認し、応答本文でルートとモデルのどちらが見つからないのかを調べます。ステータスだけでは判断できません。
• HTTP 401 → Step 3 に戻り、認証情報を確認します。

Chat Completions しか提供されない場合

wire_api = "responses" のまま、/v1/responses を提供するゲートウェイか、互換性のある変換層を使います。削除済みの "chat" に変更しないでください。

よくあるエラー

プロトコル層のエラーは他にもあります。エラー対照表 を参照してください。

コスト

Codex の利用特性は、入力が出力よりはるかに大きいことです。実行のたびに context を送り直すためです。DeepSeek V4 Pro の価格は peak と off-peak の 2 段階で、人民元建て・100 万 tokens あたりです：

peak と off-peak の差はちょうど 2 倍です。バッチ的なリファクタリングを off-peak に回せば半分に抑えられます。具体的なモデルとリアルタイムの価格は 料金ページ を参照してください。あそこはモデルカタログの設定を直接読んでいます。

対応バージョンと検証

Codex CLI 0.154.0 で設定を確認しました（2026-10-26）。プロトコルの対応状況は公式設定リファレンスを参照してください。