Codex CLI verwendet die OpenAI-Responses-API, nicht /v1/chat/completions. Für die GetVibe-Integration ist wire_api = "responses" erforderlich; eine aus einem allgemeinen SDK-Beispiel kopierte Chat-Completions-Basis-URL ist kein Ersatz dafür. Die generierte Einrichtung wird in der Codex-CLI-Dokumentation gepflegt und kann aus /api/integrations/codex.toml aktualisiert werden.
CLI installieren und Schlüssel festlegen
Installieren Sie die CLI und erstellen Sie ihr Konfigurationsverzeichnis. Bewahren Sie den API-Schlüssel in der Umgebung auf, nicht in der TOML-Datei:
npm install -g @openai/codex
mkdir -p ~/.codex
export GETVIBE_API_KEY="your-dashboard-key"Fügen Sie diesen Provider-Block zu ~/.codex/config.toml hinzu:
model = "gpt-5.6-luna"
model_provider = "getvibe"
model_reasoning_effort = "medium"
model_reasoning_summary = "auto"
model_context_window = 786432
[model_providers.getvibe]
name = "GetVibe"
base_url = "https://getvibeapi.com/v1"
env_key = "GETVIBE_API_KEY"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 5
stream_idle_timeout_ms = 600000Tragen Sie $GETVIBE_API_KEY nicht in den TOML-Wert ein. Codex liest die durch env_key benannte Variable; Text in einer Konfigurationsdatei wird nicht von der Shell expandiert. Stellen Sie die Umgebungsvariable für eine teamverwaltete Einrichtung über das Shell-Profil oder den Secret Manager bereit, der Codex startet.
Ein Responses-kompatibles Modell auswählen
Die generierte Codex-Konfiguration basiert auf dem veröffentlichten Katalog und empfiehlt ein Coding-Modell sowie Profile für schnelle und anspruchsvolle Aufgaben. Bevor Sie ein anderes Modell auswählen, prüfen Sie, ob es für die Responses-API gelistet ist und über das Kontextlimit verfügt, das Sie festlegen möchten. Im am 3. Oktober 2026 geprüften Katalog-Snapshot kostet GPT-6 Luna $0.0055 Eingabe · $0.0274 Ausgabe pro 1 Mio. Tokens, GPT-6 Sol $0.1096 Eingabe · $0.548 Ausgabe pro 1 Mio. Tokens und GPT-6.1 Sol $0.1096 Eingabe · $0.548 Ausgabe pro 1 Mio. Tokens pro Million Input- und Output-Tokens. Jeder Wert wird aus der aktuellen Modellseite übernommen.
Ein Profil ist nützlich, wenn sich Aufgabentypen hinsichtlich Kosten und Reasoning-Anforderungen unterscheiden. Verwenden Sie ein schnelles Profil für Zusammenfassungen oder Commit-Nachrichten und ein ausführlicheres Profil für Änderungen über mehrere Dateien hinweg. Die generierte Konfiguration des Projekts zeigt dieses Muster und aktualisiert die empfohlenen IDs, wenn sich der öffentliche Katalog ändert. Bearbeiten Sie ein Kontextfenster nicht manuell so, dass es das vom Modell unterstützte Limit überschreitet: Codex kann dann eine zu große Anfrage senden, die beim Upstream-Dienst fehlschlägt.
Mit einer schreibgeschützten Repository-Aufgabe überprüfen
Starten Sie Codex in einem temporären Checkout. Bitten Sie es, eine Funktion zu erklären, ohne Änderungen vorzunehmen. Vergewissern Sie sich, dass der GetVibe-Provider verwendet wird und die Anfrage abgeschlossen wird. Bitten Sie anschließend mit ausdrücklicher Genehmigung um einen kleinen Patch. Wenn die CLI meldet, dass ein Provider fehlt, prüfen Sie den genauen Tabellennamen und ob model_provider mit diesem übereinstimmt. Schlägt die Authentifizierung fehl, überprüfen Sie GETVIBE_API_KEY in derselben Shell, aus der Sie Codex starten.
Wenn die Antwort besagt, dass keine Tools verwendet werden können, prüfen Sie zuerst die Responses-Unterstützung des ausgewählten Modells und die CLI-Version. Dass eine Modell-ID im allgemeinen Katalog sichtbar ist, bedeutet nicht, dass dafür jedes Protokoll verfügbar ist. Protokollieren Sie die exakte Modell-ID, damit ein Tool-Fehler von einem Endpoint- oder Authentifizierungsfehler unterschieden werden kann.
Kontext und Agentenkosten steuern
Codex liest Repository-Dateien und sendet Tool-Ergebnisse als Teil seiner Unterhaltung zurück. Schließen Sie generierte Ausgaben und Abhängigkeitsverzeichnisse über Ignore-Einstellungen aus, bitten Sie Codex, nur relevante Pfade zu untersuchen, und vermeiden Sie es, eine umfangreiche Spezifikation in jedem Prompt zu wiederholen. Die Kosten einer Agentenaufgabe umfassen jeden Turn, nicht nur den abschließenden Patch. Vergleichen Sie die Dashboard-Nutzung nach einer repräsentativen Aufgabe mit den Input- und Output-Tarifen auf der Modellseite.
Halten Sie für einen fairen Modellvergleich denselben Repository-Commit, Prompt, dieselbe Genehmigungsrichtlinie und dieselben Tests ein. Verwenden Sie eine Fehlerbehebung und eine Aufgabe über mehrere Dateien hinweg und bewerten Sie den Testerfolg sowie die Anzahl der Reparatur-Turns. Der Katalogtarif von GPT-6 Luna beträgt am 3. Oktober 2026 $0.0055 Eingabe · $0.0274 Ausgabe pro 1 Mio. Tokens; die tatsächliche Abrechnung der Anfrage hängt davon ab, wie viel Kontext und Ausgabe die Aufgabe verwendet.
Profile und sichere Standardeinstellungen
Beginnen Sie bei einer normalen Coding-Aufgabe mit dem Reasoning-Level medium, und vergleichen Sie anschließend low für höhere Geschwindigkeit und high für schwierige Reasoning-Aufgaben, sofern das Modell diese Einstellungen unterstützt. Mehr Reasoning kann den Output-Verbrauch erhöhen. Vermeiden Sie es, aus Gewohnheit einen sehr großen globalen Kontext festzulegen; die generierte Datei wählt ein abgewogenes modellspezifisches Fenster. Lassen Sie das Genehmigungsverhalten von Codex aktiviert, bis Sie verstehen, welche Befehle es vorschlägt.
Wenn die CLI erfolgreich startet, aber GetVibe nie erreicht, prüfen Sie die effektive Konfiguration und nicht nur die von Ihnen bearbeitete Datei: Codex kann mit einem anderen Profil oder Konfigurationspfad gestartet worden sein. Führen Sie eine harmlose Anfrage aus, prüfen Sie die Nutzung im Dashboard und verwenden Sie es erst danach in einem wichtigen Repository.
Profile für wiederholbare Aufgabentypen verwenden
Mit Codex-Profilen kann ein Team denselben Provider beibehalten und gleichzeitig Modell und Reasoning-Aufwand für eine Aufgabe ändern. Ein schnelles Profil kann einen Diff zusammenfassen oder eine Commit-Nachricht entwerfen; ein ausführliches Profil kann einen Fehler über mehrere Dateien hinweg untersuchen. Halten Sie den Profilnamen in dem von Ihrem Team dokumentierten Befehl fest, damit zwei Entwickler nicht unbemerkt unterschiedliche Standardeinstellungen vergleichen. Profile sollten Modell-IDs verwenden, die aktuell veröffentlicht und mit Responses kompatibel sind.
Die generierte GetVibe-Konfiguration bietet ein Muster für schnelle und ausführliche Profile, kann sich aber ändern, wenn sich die Empfehlung ändert. Aktualisieren Sie sie über den dokumentierten Endpoint, statt ein altes Modell-Kontextlimit zu kopieren. Codex kann den Verlauf entsprechend dem konfigurierten Kontextfenster komprimieren. Ein Fenster, das größer ist als vom Route akzeptiert, kann lange Aufgaben daher in Anfragefehler verwandeln, anstatt nützlichen Kontext bereitzustellen.
Repository-Kontext fokussiert halten
Prüfen Sie vor dem Starten des Agenten, ob Ignore-Regeln Paket-Caches, Build-Ausgaben, generierte API-Clients und große Fixtures ausschließen. Teilen Sie Codex mit, welches Paket oder welchen Test es zuerst untersuchen soll. Bitten Sie es bei einem Fehler, die Ursache zu reproduzieren, die geplanten Änderungsdateien zu nennen, anschließend den kleinsten Patch zu erstellen und den Test auszuführen. Dadurch werden wiederholte Tool-Ausgaben reduziert und das Ergebnis lässt sich leichter prüfen.
Führen Sie für einen fairen Kostenvergleich denselben Prompt auf demselben Commit aus. Beziehen Sie eine Aufgabe ein, die keine Änderung benötigt, damit Sie sehen können, ob der Agent die Grenze einhält, sowie eine Aufgabe, die einen Testlauf erfordert, damit Sie Reparaturschleifen zählen können. Erfassen Sie den Token-Verbrauch und ob der Patch erfolgreich war, nicht nur die Länge der abschließenden Antwort.
Reasoning- und Output-Budgets
Verwenden Sie das niedrigste Reasoning-Level, das Ihre Qualitätsanforderungen erfüllt. Ein hohes Level ist für manche Planungsaufgaben nützlich, kann aber Latenz und Output-Verbrauch erhöhen. Legen Sie ein Output-Budget fest, das für den angeforderten Patch und die Erklärung groß genug ist, ohne es unbegrenzt zu lassen. Wenn die Antwort vorzeitig endet, prüfen Sie den Abschlussgrund, bevor Sie die gesamte Anfrage wiederholen; eine gezielte Fortsetzung kann weniger Kontext verwenden.
Halten Sie automatische Befehlsgenehmigungen konservativ. Codex kann einen destruktiven Shell-Befehl vorschlagen oder Dateien außerhalb des vorgesehenen Bereichs ändern. Prüfen Sie den Diff und die Testausgabe, bevor Sie ihn akzeptieren, selbst wenn die Zusammenfassung des Reasonings zuversichtlich klingt.
Häufige Fehler
- Falscher Endpoint: Die Basis-URL muss mit
/v1enden, undwire_apimussresponsessein. - 401: Exportieren Sie
GETVIBE_API_KEYin der Prozessumgebung; TOML expandiert keine Shell-Variablen. - Kontextfehler: Stimmen Sie
model_context_windowmit der veröffentlichten Seite des ausgewählten Modells ab. - Tool-Verhalten weicht ab: Testen Sie ein Responses-kompatibles Modell und halten Sie die CLI-Version aktuell.
Informationen zu JSON-Anfragefeldern finden Sie unter Messages and Responses; Informationen zu Guthaben und Abrechnung finden Sie in der Nutzungsdokumentation.