Facade CodeCodex + 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.
1. Den Provider definieren
Fügen Sie diese Konfiguration in facade.json ein (siehe Agenteneinstellungen). Ersetzen Sie die Beispiel-Basis-URL, den Schlüssel und die Modell-ID:
{
"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.
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.
Ein vorhandenes Codex-Profil verwenden
Wenn Sie bereits ein natives Codex-Profil verwenden, wählen Sie es über die Argumente des Eintrags aus:
{
"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.