Codex
Codex をゲートウェイの Responses API に向けます。このページは設定の概略です。このレーンのクライアント確認レベルは、モックの Codex CLI によるエンドツーエンド実行です(TestResponses_CodexCLI_MockE2E)。ライブの Codex バイナリは、ゲートウェイに対して実行されていません(互換性マトリクス では not verified)。これはオーナーのスタンドのままです。
設定
~/.codex/config.toml:
[model_providers.yabanin]
name = "Yabanin"
base_url = "https://gateway.example.internal/v1"
env_key = "YABANIN_API_KEY"
wire_api = "responses"
キーはファイルではなく、環境に置きます。
export YABANIN_API_KEY='yb_…'
エンドポイント
POST /v1/responses です。解決されたプロバイダが openai で、組織にツール拒否の方針がない場合、ゲートウェイはボディを変えずに転送します。それ以外の場合は、呼び出しを chat completions に変換します。
プロバイダキーの持ち込み(BYOK)
組織の管理者が、管理コンソールで上流プロバイダのキーを一度追加します(設定 → プロバイダキー。BYOK を参照)。モデルが組織の資格情報を経由して経路を通る場合、クライアント側の変更は不要です。上記の yb_… のゲートウェイキーをそのまま使い、ゲートウェイが組織のキーで上流を認証します。
制限
- ステートレスなセッションモデル(R046 D1)です。ゲートウェイは、どの経路でもレスポンスの状態を保持しません。
previous_response_idは、すべての経路で 400 により拒否されます。サポートされるフローは、Codex の全履歴の再送(store=false)です。 - 変換で表現できないフィールド(
reasoning.effort、verbosity、未サポートのツール、…)は破棄され、X-Yabanin-Unsupportedレスポンスヘッダで通知されます。黙って捨てることはありません。 - ストリームの中断(R046-03)です。上流のストリームがレスポンスの途中で切れた場合、ゲートウェイは
response.failedの SSE イベントを追加し、request.failedを記録し、中断したストリームには課金しません。クライアントがハングアップした場合、消費済みのプレフィックスは課金されたままです(request.completed)。終端イベントの後の正常終了は、request.completedのままです。 - 認証面は、API キーの bearer(
yb_…)だけです。Codex の ChatGPT-OAuth ログイン(codex login)はサポートされません。上に示したとおりenv_keyを設定します。 - クライアント確認です。実機の
codex exec(codex-cli 0.162.1)を、モックの上流に対してゲートウェイで確認済みです(2026-10-18、R046-05)。有料の上流によるライブ実行は、別のオーナーのスタンドです。
確認
curl -sS -o /dev/null -w '%{http_code}\n' \
-H "Authorization: Bearer $YABANIN_API_KEY" \
https://gateway.example.internal/v1/models
200 は、ゲートウェイがキーを受理したことを意味します。Codex は起動しません。