エージェントを設定

Codex + プロバイダー

Codex の起動設定に独自のモデルプロバイダーを割り当てるか、すでにあるネイティブのプロファイルを使用します。

プロバイダーの情報を用意する

Codex をインストールし、プロバイダーのベース URL、API キー、モデル ID を取得します。エンドポイントは OpenAI Responses API に対応している必要があり、Chat Completions の互換性だけでは不十分です。

この例では、他の Codex エントリーを変更したり、Codex のグローバル設定を編集したりせずに、Codex · work を追加します。

すでに Codex プロファイルがある場合は、既存の Codex プロファイルを使うに進んでください。

1. プロバイダーを定義する

この設定を facade.json に追加します（エージェント設定を参照）。例のベース URL、キー、モデル ID は置き換えてください。

facade.json

{
  "clis": {
    "Codex · work": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "args": [
        "-c",
        "model_provider=work",
        "-c",
        "model_providers.work.name=Work",
        "-c",
        "model_providers.work.base_url=https://api.example.com/v1",
        "-c",
        "model_providers.work.wire_api=responses",
        "-c",
        "model_providers.work.env_key=WORK_API_KEY"
      ],
      "env": {
        "WORK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

model_provider=work と各 model_providers.work.… 設定では、同じプロバイダー ID work を使用します。キーの環境変数名 WORK_API_KEY は env_key と一致している必要があります。

2. プロバイダーの設定を確認する

設定	動作
`model_provider=work`	work 設定で定義したプロバイダーを選択します。
`model_providers.work.name`	そのプロバイダーの表示名を設定します。
`model_providers.work.base_url`	API のベース URL を設定します。
`model_providers.work.wire_api=responses`	Responses API の形式を使用します。
`model_providers.work.env_key=WORK_API_KEY`	キーが入っている環境変数を Codex に伝えます。
`env.WORK_API_KEY`	そのキーを Codex プロセスに渡します。

各 -c は、このエントリーで起動するエージェントに対して Codex のオプションを 1 つ設定します。

この例ではキーを facade.json に保存します。キーがすでに環境変数にある場合は、env.WORK_API_KEY を ${env:WORK_API_KEY} に設定します。エージェントを起動する前に、エディターでその変数を利用できるようにしておく必要があります。

3. この設定で Codex を起動する

facade.json を保存し、New Agent を選択して Codex · work を選びます。/model で選択中のモデルを確認し、プロジェクトの短いタスクを送ってください。

プロバイダーが使用量を報告する場合、リクエストが正しいアカウントに表示されることを確認します。起動設定を確認するには、Show Agent Launch を実行して作業場所を選択します。レポートでこのエントリーを探すと、現在の設定で次のエージェントがどのように起動するかを確認できます。

リクエストのエラーについては、トラブルシューティングを参照してください。

例：QwenCloud

QwenCloud の Token Plan キーを使う場合は、ベース URL に https://token-plan.maas.qwencloudapi.com/compatible-mode/v1 を指定し、wire_api=responses はそのままにします。プランで利用できるモデルを使用してください。従量課金のキーでは、そのリージョンのエンドポイントを使用します。

QwenCloud の最新の Codex 設定 ↗

既存の Codex プロファイルを使う

すでにネイティブの Codex プロファイルを使っている場合は、エントリーの引数からそれを選択します。

facade.json

{
  "clis": {
    "Codex · profile": {
      "type": "codex",
      "args": [
        "--profile",
        "work"
      ]
    }
  }
}

work は、お使いのプロファイル名に置き換えてください。プロバイダーの設定は Facade のエントリーに重複して書かず、そのプロファイルに保持します。保存して New Agent を選択し、Codex · profile を選びます。短いタスクを送り、利用可能であればプロバイダーの使用履歴でリクエストを確認してください。

Markdown で表示 ↗ドキュメント

Codex + プロバイダー

プロバイダーの情報を用意する#

1. プロバイダーを定義する#

2. プロバイダーの設定を確認する#

3. この設定で Codex を起動する#

例：QwenCloud#