# Codex + Ihr Provider

Geben Sie einer Codex-Startkonfiguration einen eigenen Modell-Provider oder verwenden Sie ein vorhandenes natives Profil.

## Die Angaben Ihres Providers

Installieren Sie Codex und besorgen Sie sich Basis-URL, API-Schlüssel und Modell-ID Ihres Providers. Der Endpunkt muss die OpenAI Responses API unterstützen; Kompatibilität mit Chat Completions genügt nicht.

Das Beispiel fügt `Codex · work` hinzu, ohne andere Codex-Einträge zu ändern oder die globale Codex-Konfiguration zu bearbeiten.

Sie haben bereits ein Codex-Profil? Dann springen Sie zu [Ein vorhandenes Codex-Profil verwenden](https://facadecode.com/de/docs/providers/codex/#profile).

## 1. Den Provider definieren

Fügen Sie diese Konfiguration in facade.json ein (siehe [Agenteneinstellungen](https://facadecode.com/de/docs/settings/)). Ersetzen Sie die Beispiel-Basis-URL, den Schlüssel und die Modell-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"
      }
    }
  }
}
```

Verwenden Sie dieselbe Provider-ID `work` in `model_provider=work` und in jeder Einstellung `model_providers.work.…`. Der Variablenname des Schlüssels, `WORK_API_KEY`, muss mit `env_key` übereinstimmen.

## 2. Die Provider-Einstellungen prüfen

| Einstellung | Funktion |
| --- | --- |
| `model_provider=work` | Wählt den Provider, den die work-Einstellungen definieren. |
| `model_providers.work.name` | Gibt diesem Provider einen Anzeigenamen. |
| `model_providers.work.base_url` | Legt die Basis-URL der API fest. |
| `model_providers.work.wire_api=responses` | Verwendet das Format der Responses API. |
| `model_providers.work.env_key=WORK_API_KEY` | Legt fest, in welcher Umgebungsvariablen Codex den Schlüssel findet. |
| `env.WORK_API_KEY` | Stellt diesen Schlüssel dem Codex-Prozess bereit. |

Jedes `-c` setzt eine Codex-Option für Agenten, die mit diesem Eintrag gestartet werden.

Im Beispiel steht der Schlüssel in facade.json. Liegt der Schlüssel bereits in einer Umgebungsvariablen, setzen Sie `env.WORK_API_KEY` auf `${env:WORK_API_KEY}`. Diese Variable muss in der Umgebung des Editors verfügbar sein, bevor der Agent startet.

## 3. Codex mit dieser Konfiguration starten

Speichern Sie facade.json, wählen Sie **New Agent** und dann `Codex · work`. Prüfen Sie mit `/model` das gewählte Modell und senden Sie eine kurze Aufgabe für Ihr Projekt.

Wenn Ihr Provider die Nutzung ausweist, prüfen Sie, ob die Anfrage auf dem richtigen Konto erscheint. Um die Startkonfiguration zu prüfen, führen Sie **Show Agent Launch** aus und wählen Sie den Arbeitsort. Suchen Sie den Eintrag im Bericht, um zu sehen, wie der nächste Agent mit Ihren aktuellen Einstellungen starten würde.

Bei Anfragefehlern lesen Sie die [Fehlerbehebung](https://facadecode.com/de/docs/troubleshooting/).

## Beispiel: QwenCloud

Für einen Schlüssel aus dem QwenCloud Token Plan verwenden Sie `https://token-plan.maas.qwencloudapi.com/compatible-mode/v1` als Basis-URL und behalten `wire_api=responses` bei. Verwenden Sie ein Modell, das in Ihrem Tarif verfügbar ist. Schlüssel für nutzungsbasierte Abrechnung verwenden den Endpunkt ihrer Region.

[Aktuelle Codex-Einstellungen von QwenCloud ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/codex)

## Ein vorhandenes Codex-Profil verwenden

Wenn Sie bereits ein natives Codex-Profil verwenden, wählen Sie es über die Argumente des Eintrags aus:

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

Ersetzen Sie `work` durch das Profil, das Sie verwenden. Belassen Sie die Provider-Konfiguration in diesem Profil, statt sie im Facade-Eintrag zu wiederholen. Speichern Sie, wählen Sie **New Agent** und dann `Codex · profile`. Senden Sie eine kurze Aufgabe und prüfen Sie die Anfrage in den Nutzungsdaten Ihres Providers, sofern verfügbar.