Codex mit CometAPI verwenden

Verwenden Sie diese Anleitung, um Codex mit CometAPI als model provider auszuführen. Offizielle Referenzen:

Voraussetzungen

Anforderung	Details
OS	macOS, Linux, natives PowerShell unter Windows oder Windows mit WSL
Git	2.23+ empfohlen
Codex	Installieren Sie die Codex-App oder Codex CLI aus dem Codex quickstart
CometAPI API key	Holen Sie sich einen im CometAPI-Dashboard
Model ID	Verwenden Sie eine model ID von der Models-Seite

Wählen Sie einen Einrichtungsweg

Wir bieten zwei Optionen, damit Sie Codex schnell konfigurieren können.

Option 1: Codex manuell konfigurieren (empfohlen)

Bearbeiten Sie die benutzerspezifische Datei ~/.codex/config.toml direkt. Dies ist der zuverlässigste Weg, insbesondere für Windows- und WSL-Benutzer.

Option 2: Über ein Skript konfigurieren

Führen Sie das Einrichtungs-Skript als Abkürzung aus. Es schreibt dieselbe provider-Konfiguration und speichert den CometAPI API key für Codex.

Codex manuell konfigurieren

Codex liest persönliche Provider-Standardeinstellungen aus der benutzerspezifischen Datei ~/.codex/config.toml. Konfigurieren Sie den CometAPI-Provider dort, nicht in einer Projektdatei .codex/config.toml. Codex ignoriert provider- und provider-auth-Einstellungen in Projektkonfigurationsdateien. Die empfohlene Einrichtung verwendet einen benannten cometapi-Provider und befehlsbasierte Authentifizierung. Dadurch bleibt CometAPI vom integrierten OpenAI-Provider getrennt, erfordert keine Vererbung von Shell-Umgebungsvariablen und ersetzt ~/.codex/auth.json nicht.

macOS / Linux / WSL
Windows PowerShell

Speichern Sie Ihren CometAPI-API-Schlüssel in einer lokalen Schlüsseldatei:

mkdir -p "$HOME/.codex"
printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
chmod 600 "$HOME/.codex/cometapi_key"

Fügen Sie diese Konfiguration zu ~/.codex/config.toml hinzu:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "sh"
args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]

Speichern Sie Ihren CometAPI-API-Schlüssel im Windows-Codex-Home-Verzeichnis:

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY

Fügen Sie diese Konfiguration zu $HOME\.codex\config.toml hinzu:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "powershell.exe"
args = [
  "-NoProfile",
  "-Command",
  "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
]

Windows-natives Codex verwendet $HOME\.codex, normalerweise C:\Users\<user>\.codex. WSL verwendet das ~/.codex der Linux-Distribution. Bearbeiten Sie das Verzeichnis, das der Umgebung entspricht, in der der Codex-Agent ausgeführt wird.

Authentifizierung mit Umgebungsvariablen verwenden

Wenn Sie den CometAPI-API-Schlüssel lieber in einer Umgebungsvariablen speichern möchten, verwenden Sie env_key anstelle des Blocks [model_providers.cometapi.auth]. Verwenden Sie diese Provider-Konfiguration nur, wenn COMETAPI_KEY in der Umgebung verfügbar ist, die Codex startet:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"

Kombinieren Sie env_key nicht mit [model_providers.cometapi.auth]. Codex unterstützt pro benutzerdefiniertem Provider eine Authentifizierungsmethode.

Das Setup-Skript ausführen

Das Setup-Skript ist optional. Es schreibt dieselbe cometapi-Provider-Konfiguration nach ~/.codex/config.toml, speichert Ihren CometAPI-API-Schlüssel in ~/.codex/cometapi_key, erstellt vor Dateiänderungen Sicherungskopien und überprüft die Konfiguration mit codex exec, wenn die Codex CLI verfügbar ist. Führen Sie für macOS, Linux oder WSL das interaktive Installationsprogramm aus:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"

Für ein nicht interaktives Setup übergeben Sie den API-Schlüssel explizit:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"

Führen Sie für natives Windows PowerShell das interaktive Installationsprogramm aus:

powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"

Für ein nicht interaktives Windows-Setup übergeben Sie den API-Schlüssel explizit:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"

Standardmäßig ersetzt das Skript ~/.codex/auth.json nicht und entfernt kein ChatGPT-Login. Verwenden Sie --force-auth-json oder -ForceAuthJson nur, wenn das Skript die Codex-API-Key-Anmeldung über auth.json verwalten soll.

Einen model ID auswählen oder ändern

Verwenden Sie einen model ID von der Seite Models. Bei der manuellen Konfiguration ändern Sie den Wert von model in ~/.codex/config.toml. Übergeben Sie für macOS, Linux oder WSL --model, wenn Sie das Setup-Skript ausführen:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id

Übergeben Sie für natives Windows PowerShell -Model, wenn Sie das Setup-Skript ausführen:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"

Das Skript verwendet CODEX_HOME, wenn es gesetzt ist. Andernfalls schreibt es in das ~/.codex der aktuellen Umgebung.

Das Setup überprüfen

Um das Setup mit der Codex CLI zu überprüfen, führen Sie diesen schreibgeschützten Befehl aus einem beliebigen lokalen Projekt aus:

codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"

Wenn die Codex CLI in PATH nicht verfügbar ist, öffnen Sie die Codex-App und senden Sie einen kurzen Prompt aus einem lokalen Projekt.

Fehlerbehebung

Codex verwendet weiterhin den standardmäßigen OpenAI-Provider

Bestätige, dass model_provider = "cometapi" in der benutzerspezifischen Datei ~/.codex/config.toml steht.

Der API-Schlüssel wurde geändert

Aktualisiere ~/.codex/cometapi_key, oder führe das Setup-Skript mit dem aktualisierten Wert $COMETAPI_KEY erneut aus.

Das PowerShell-Skript schlägt während der Vorabprüfungen fehl

Verwende die manuellen nativen PowerShell-Schritte für Windows und führe dann den Verifizierungsbefehl aus.

Das per Pipe übergebene Shell-Setup fragt nach keinem API-Schlüssel

Verwende --key "$COMETAPI_KEY", setze COMETAPI_KEY oder führe den interaktiven Befehl sh -c "$(curl ...)" aus.

Die Verbindung läuft in ein Timeout oder verwendet die falsche base URL

Bestätige, dass base_url in ~/.codex/config.toml auf https://api.cometapi.com/v1 gesetzt ist.

Das Modell wurde nicht gefunden

Sieh auf der Seite Models nach den verfügbaren model IDs.

Das Windows-Setup wirkt sich auf die falsche Umgebung aus

Bearbeite $HOME\.codex für den nativen Windows-Modus oder ~/.codex innerhalb von WSL für den WSL-Agent-Modus.

Überblick

AI-Coding-Agenten

AI-Agenten

AI-Chat-Clients

Übersetzung und Sprache

Automatisierungsplattformen

Observability und Evaluierung

AI-Frameworks

Voraussetzungen

Wählen Sie einen Einrichtungsweg

Option 1: Codex manuell konfigurieren (empfohlen)

Option 2: Über ein Skript konfigurieren

Codex manuell konfigurieren

Authentifizierung mit Umgebungsvariablen verwenden

Das Setup-Skript ausführen

Einen model ID auswählen oder ändern

Das Setup überprüfen

Fehlerbehebung

​Voraussetzungen

​Wählen Sie einen Einrichtungsweg

Option 1: Codex manuell konfigurieren (empfohlen)

Option 2: Über ein Skript konfigurieren

​Codex manuell konfigurieren

​Authentifizierung mit Umgebungsvariablen verwenden

​Das Setup-Skript ausführen

​Einen model ID auswählen oder ändern

​Das Setup überprüfen

​Fehlerbehebung

Voraussetzungen

Wählen Sie einen Einrichtungsweg

Codex manuell konfigurieren

Authentifizierung mit Umgebungsvariablen verwenden

Das Setup-Skript ausführen

Einen model ID auswählen oder ändern

Das Setup überprüfen

Fehlerbehebung