GetAPI.ONE

Codex CLI für GetAPI.ONE konfigurieren

Installieren Sie Codex CLI aus der offiziellen Quelle, speichern Sie den ONE-Schlüssel in einer Umgebungsvariablen, konfigurieren Sie einen Responses-kompatiblen eigenen Anbieter und prüfen Sie die aktive Verbindung.

Umfang und Voraussetzungen

Diese Anleitung behandelt Codex CLI im Terminal. Sie belegt keine Kompatibilität für jeden Desktop-Client, jede IDE-Erweiterung, jedes Modell oder jede Codex-Funktion.

Ein GetAPI.ONE‑Konto mit nutzbarem Guthaben oder einem passenden Paket.
Ein benannter, eingeschränkter GetAPI.ONE‑Schlüssel, der vertraulich gespeichert ist.
Ein im aktuellen Katalog gewähltes Modell, das den Responses-Endpunkt ausdrücklich aufführt.
Berechtigung zur Installation von Codex CLI und zur Bearbeitung Ihrer benutzerspezifischen Codex-Konfiguration.

1. Codex CLI installieren und identifizieren

Nutzen Sie die aktuelle offizielle Codex-CLI-Seite für das zu Ihrem Betriebssystem passende Installationsprogramm. Der am 2026-09-07 geprüfte eigenständige macOS-/Linux-Installer verwendet den folgenden Befehl. Windows-Nutzer sollten dem Windows-Reiter der offiziellen Seite folgen, statt ungeprüft einen Unix-Shell-Befehl auszuführen.

Offizielles Installationsprogramm für macOS / Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Installierten Befehl prüfen

codex --version

2. Schlüssel in das Terminal laden

Setzen Sie den Schlüssel für die aktuelle Shell, bevor Sie Codex starten. Die Beispiele enthalten bewusst einen Platzhalter.

macOS-/Linux-Shell

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

PowerShell: aktueller Prozess

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

3. ONE-Anbieter konfigurieren

Öffnen Sie die benutzerspezifische Codex-Datei config.toml, normalerweise im Verzeichnis .codex, und ergänzen Sie den untenstehenden Anbieter. Ersetzen Sie YOUR_RESPONSES_MODEL durch ein aktuelles GetAPI.ONE‑Katalogmodell, das den Responses-Endpunkt ausdrücklich angibt.

Benutzerspezifische config.toml

model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"

[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"

4. Ausführen und prüfen

Öffnen Sie ein neues Terminal, wenn Sie die Umgebungsvariable dauerhaft gesetzt haben; andernfalls verwenden Sie das aktuelle Terminal, in dem die Variable gesetzt ist.
Öffnen Sie ein Projektverzeichnis und führen Sie codex aus. Prüfen Sie, ob angezeigter Anbieter und Modell Ihrer beabsichtigten Konfiguration entsprechen.
Senden Sie nur dann eine minimale Eingabe, wenn Sie mögliche Kosten akzeptieren.
Eine erfolgreiche Prüfung erfordert eine gültige CLI-Antwort und einen zugehörigen Anfrage- oder Nutzungsdatensatz in der GetAPI.ONE‑Konsole. Beim Erstellen dieser Anleitung wurde kein Modell aufgerufen.

Fehler in dieser Reihenfolge prüfen

Symptom	Prüfungen
codex: Befehl nicht gefunden	Prüfen Sie erneut den offiziellen Installer für Ihr Betriebssystem und ob das Installationsverzeichnis in PATH enthalten ist.
API-Schlüssel fehlt	Prüfen Sie, ob GETAPI_ONE_API_KEY in derselben Umgebung verfügbar ist, in der Codex startet, und env_key exakt geschrieben ist.
401 / Unauthorized	Kopieren Sie den ONE-Schlüssel erneut, prüfen Sie seine Aktivierung und stellen Sie sicher, dass er mit https://www.getapi.one/v1 kombiniert wird.
404 / inkompatibler Pfad	Prüfen Sie, ob /v1 in base_url enthalten bleibt und das Gateway /v1/responses angibt.
Modell nicht gefunden	Ersetzen Sie den Platzhalter durch eine exakte Katalogbezeichnung, die für die Schlüsselgruppe sichtbar und für den Responses-Endpunkt gekennzeichnet ist.
Konfiguration unverändert	Prüfen Sie, ob Sie die von Codex geladene Benutzerdatei bearbeitet haben, model_provider auf getapi_one verweist und Terminal oder Client neu gestartet wurden.