# Codex + プロバイダー

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

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

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

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

すでに Codex プロファイルがある場合は、[既存の Codex プロファイルを使う](https://facadecode.com/ja/docs/providers/codex/#profile)に進んでください。

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

この設定を facade.json に追加します（[エージェント設定](https://facadecode.com/ja/docs/settings/)を参照）。例のベース URL、キー、モデル ID は置き換えてください。

```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** を実行して作業場所を選択します。レポートでこのエントリーを探すと、現在の設定で次のエージェントがどのように起動するかを確認できます。

リクエストのエラーについては、[トラブルシューティング](https://facadecode.com/ja/docs/troubleshooting/)を参照してください。

## 例：QwenCloud

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

[QwenCloud の最新の Codex 設定 ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/codex)

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

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

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

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