Codex とは
Codex は、ソフトウェア開発向けの OpenAI のコーディング エージェントです。Capriole AI の Responses 互換 API にリクエストを送るカスタム モデル プロバイダーを設定すると、Capriole AI を利用できます。前提条件
始める前に、次を用意してください。インストール
Codex CLI
Codex app
OpenAI Codex からアプリをダウンロードしてください。設定
~/.codex/config.toml を作成または更新します。
Codex を実行する
API キーを設定してから、Codex を起動します。対応モデル
Codex は Responses API 経由で Capriole AI の OpenAI モデルを使えます。以下のネイティブモデル ID を使うと、Codex 標準のモデル選択と推論設定を利用できます。独自のmodel_catalog_json は不要です。呼び出せるのは Capriole AI が対応しているモデルのみです。
gpt-6-astragpt-6.1-solgpt-6-solgpt-6-lunagpt-5.6-terragpt-5.6-lunagpt-5.5
gpt-6.1-sol には Codex 0.159.2 以降を使ってください。それより前のバージョンにはこのモデルのメタデータがなく、汎用設定にフォールバックします。
API は openai/ プレフィックス付きの ID と openai-latest も受け付けます。openai-latest エイリアスは Capriole AI が推奨する OpenAI の旗艦モデルを指定します。
トラブルシューティング
Codex が認証エラーを返すのはなぜですか？
codex を実行する前に、同じシェルで CAPRIOLE_AI_API_KEY がエクスポートされていることを確認してください。
Codex がモデルを見つけられないのはなぜですか？
model_provider = "capriole_ai" が設定されており、model が openai-latest または対応する Capriole AI の OpenAI モデル ID であることを確認してください。
エンドポイントまたはプロトコル エラーでリクエストが失敗するのはなぜですか？
[model_providers.capriole_ai] の下に base_url = "https://api.caprioletech.com/v1" と wire_api = "responses" が設定されていることを確認してください。
Codex が Capriole AI プロバイダーを無視するのはなぜですか？
openai などの予約済み組み込みプロバイダー ID は使わないでください。カスタム プロバイダー ID は capriole_ai のままにしてください。
設定の変更が反映されないのはなぜですか？
~/.codex/config.toml が有効なユーザー設定ファイルであることを確認し、プロジェクトスコープの .codex/config.toml に頼る前にプロジェクトを信頼してから、Codex を再起動してください。
注意事項
- この設定は
env_keyを使うため、API キーは設定ファイルではなくシェル環境に残ります。 - 公式リファレンス: Codex CLI、Codex 設定の基本、Codex 設定リファレンス、設定サンプル。