メインコンテンツへスキップ
Capriole AI の API キー 1 つで、Codex から GPT-6.2 Astra と GPT-6.2 Sol を公式 API 価格より最大 92% 安く使えます。

Codex とは

Codex は、ソフトウェア開発向けの OpenAI のコーディング エージェントです。Capriole AI の Responses 互換 API にリクエストを送るカスタム モデル プロバイダーを設定すると、Capriole AI を利用できます。

前提条件

始める前に、次を用意してください。
  • Capriole AI アカウント(こちらから登録)
  • Premium プラン(月額 USD 9、無制限のウェブチャットも含む)または Team プラン。API キーにはどちらかが必要です(購読する)
  • Capriole AI API キー(キーを取得)

インストール

Codex CLI

公式インストーラーで Codex CLI をインストールします。
または、npm でインストールします。
インストールを確認します。

Codex アプリ

OpenAI Codex からアプリをダウンロードしてください。

設定

モデルの検証

Codex CLI 0.169.1 は、下記の設定を使い、Capriole AI 経由のファイル読み取り、ファイル書き込み、最終回答の確認に合格しています。 ~/.codex/config.toml を作成または更新します。
各設定の役割は次のとおりです。
  • model はデフォルト モデルです。セッション中は /model、コマンドラインでは --model で変更できます。
  • model_provider は、その下で定義している Capriole AI プロバイダーを選択します。
  • Codex が /responses を自動で付加するため、base_url には /v1 を含めます。
  • wire_api = "responses" は Responses API を使います。Codex がカスタム プロバイダーで対応しているプロトコルはこれだけです。
  • env_key は環境変数からキーを読み取り、Bearer トークンとして送ります。

Codex を実行する

API キーを設定してから、プロジェクト ディレクトリから Codex を起動します。
非対話で実行するには、codex exec を使います。

対応モデル

Codex は Responses API 経由で Capriole AI の OpenAI モデルを使えます。以下のネイティブ モデル ID を使うと、Codex 標準のモデル選択と推論設定を利用できます。独自の model_catalog_json は不要です。
  • gpt-6.2-astra
  • gpt-6.2-sol
  • gpt-6-astra
  • gpt-6.1-sol
  • gpt-6-sol
  • gpt-6-luna
  • gpt-5.6-terra
  • gpt-5.6-luna
gpt-6.2-astra と gpt-6.2-sol には Codex 0.169.1 以降、gpt-6.1-sol には Codex 0.159.2 以降を使ってください。それより前のバージョンにはこれらのモデルのメタデータがなく、汎用設定にフォールバックします。 API は openai/ プレフィックス付きの ID と openai-latest も受け付けます。openai-latest エイリアスは、Capriole AI が推奨する OpenAI の旗艦モデルに追従します。 Capriole AI は Grok を Responses API で提供しているため、Codex は同じプロバイダー経由で xai/grok-4.7 も実行できます。 Codex に組み込まれているメタデータは、OpenAI のネイティブ モデル ID 用のものだけです。openai-latest と xai/grok-4.7 では Model metadata ... not found と表示され、フォールバック設定が使われます。セッションはそのまま動作しますが、最良の結果を得るには gpt-6.2-astra などのネイティブ ID を使ってください。

トラブルシューティング

Codex が認証エラーを返すのはなぜですか?

codex を実行する前に、同じシェルで CAPRIOLE_AI_API_KEY がエクスポートされていることを確認してください。

Codex がモデルを見つけられないのはなぜですか?

model_provider = "capriole_ai" が設定されており、model が「対応モデル」に記載した 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 を再起動してください。

注意事項

最終更新日 2026年11月18日