Codex の設定

Codex CLI は OpenAI Responses プロトコルで InOneAPI に接続できます。設定後も Codex はローカルでコードの読み取りと編集を行い、モデルのリクエストだけを InOneAPI に送信します。ゲートウェイが、選択した公共モデルについてルート戦略に基づき利用可能なプロバイダーを選択します。

事前準備

  1. コンソールでプロジェクトと API キーを作成し、呼び出しを許可するモデルと予算を制限します。
  2. モデル詳細ページからモデル ID をそのままコピーします。YOUR_MODEL_ID はドキュメント上のプレースホルダーです。
  3. Codex CLI を導入し、ターミナルで codex が実行できることを確認します。

実際のキーを config.toml に書き込まないでください。設定ファイルは環境変数を参照するだけにします。

モデルプロバイダーの設定

~/.codex/config.toml を作成または開き、以下の内容を既存の設定にマージします：

model = "YOUR_MODEL_ID"
model_provider = "inoneapi"

[model_providers.inoneapi]
name = "InOneAPI"
base_url = "https://api.inoneapi.com/v1"
env_key = "INONEAPI_API_KEY"
wire_api = "responses"

model と model_provider のルート項目は、最初の [テーブル] より前に置きます。既に存在する場合は元の値を更新し、重複して追加しないでください。CODEX_HOME を設定している場合は、そのディレクトリ内の設定が使用されます。

wire_api は必ず responses にします。モデル ID はそのままコピーし、表示名だけを入力しないでください。

API キーの設定

macOS または Linux：

export INONEAPI_API_KEY="ioa_sk_..."
codex

恒久的に有効にするには、export を ~/.zshrc または ~/.bashrc に記述し、ターミナルを開き直します。Windows PowerShell：

[Environment]::SetEnvironmentVariable("INONEAPI_API_KEY", "ioa_sk_...", "User")

設定後は PowerShell を開き直してください。

設定の確認

テスト用リポジトリで Codex を起動し、最初に読み取り専用タスクを実行します：

README を読み、このプロジェクトの起動方法を要約してください。ファイルは変更しないでください。

続いて InOneAPI コンソールで、対応するリクエスト・モデル ID・X-Gateway-Trace-ID が記録されているか確認します。最初の検証では、リスクの高いコマンドの権限を付与しないでください。

よくある問題

  • 401：現在のターミナルが INONEAPI_API_KEY を読み取っていないか、キーが失効しています。
  • 404：base_url に /v1 が含まれていないか、モデル ID が存在しません。
  • Responses のパラメータエラー：wire_api = "responses" を確認し、Responses とツール呼び出しに対応したモデルを選択してください。
  • 402：残高と予算を確認します。429：レート制限と上流の容量を確認します。Agent に無制限の再試行をさせないでください。

本番利用では Codex 専用のサブキーを作成し、予算・利用モデル・アラートを設定します。チームキーと利用量を参照してください。

任意：CC Switch にインポート

モデル詳細ページで本ツールと API キーを選択し、「CC Switch を開いてインポート」をクリックします。CC Switch 公式版 を使用してください。インポートリンクには現在のモデル ID が含まれるため、再入力する必要はありません。インポートを確認した後、本ツールのプロバイダー有効化と既定モデルの設定で接続を完了します。app 非対応と表示された場合は、CC Switch を更新するか本文の手動設定に従ってください。

インポートリンクはプロバイダーを追加するだけで、既定モデルの設定や正常なリクエストを保証するものではありません。リンクには API キーが含まれるため、共有しないでください。手動設定と CC Switch インポートはどちらか一方だけで構いません。

公式リファレンス：Codex の設定項目。

Codex · ドキュメント · InOneAPI