Codex CLI

Die Einrichtung meinem Agenten überlassenCopy Anchor Link

Kopieren Sie diese Aufgabe in einen Agenten, der auf Ihrem Computer bereits einsatzbereit ist:

Lies diese Anleitung und hilf mir, Codex CLI mit TokenLab zu verbinden:
https://tokenlab.sh/docs/de/integrations/codex-cli
Prüfe zuerst meine installierte Version und die aktive Konfiguration.
Erhalte vorhandene Konten, Anbieter, Berechtigungen und andere Einstellungen.
Sichere lokale Dateien und zeige die vorgeschlagenen Änderungen.
Lass mich benötigte API-Schlüssel lokal eingeben; fordere sie niemals im Chat an, gib sie dort nicht aus und füge sie dort nicht ein.
Prüfe zuerst, ob die Konfiguration geladen werden kann.
Erkläre die Kosten kostenpflichtiger Testanfragen gesondert, bevor du sie ausführst.

ÜbersichtCopy Anchor Link

Codex CLI verbindet sich über /v1/responses mit TokenLab. Beim gewählten Modell muss tokenlab.accepted_request_formats den Wert openai_responses enthalten; Funktionen können je nach Modell variieren.

Remote Compaction in Codex CLI wird über POST /v1/responses/compact unterstützt. Codex sendet bei /compact und Auto-Compact das aktuelle Sitzungs-model in body.model, daher muss das gewünschte Modell auf dem Responses-Pfad verfügbar sein. Konfigurieren Sie nicht /v1/compact.

SystemanforderungenCopy Anchor Link

Folgen Sie der CLI-Anleitung für macOS, Linux oder Windows. Natives Windows und WSL sind getrennte Umgebungen; siehe Windows-Anleitung. npm ist eine Installationsoption, keine Voraussetzung für native Binärdateien.

InstallationCopy Anchor Link

npm install -g @openai/codex@0.149.0

Installation verifizieren:

codex --version

KonfigurationCopy Anchor Link

Schritt 1: API-Schlüssel setzenCopy Anchor Link

Setzen Sie TOKENLAB_API_KEY mit den Terminal-Schritten im Schnellstart für macOS, Linux, WSL oder Windows PowerShell, ohne den Schlüssel im Befehlsverlauf zu speichern. Starten Sie Codex in diesem Terminal. Verwenden Sie für dauerhaften Zugriff einen lokalen Secret-Manager statt eines Klartextschlüssels im Shell-Profil.

Schritt 2: tokenlab.config.toml konfigurierenCopy Anchor Link

Verwenden Sie mit Codex 0.149.0 eine separate tokenlab.config.toml im aktiven CODEX_HOME (normalerweise ~/.codex). Erstellen Sie sie nur bei freiem Namen oder sichern Sie ein bestehendes TokenLab-Profil vor Änderungen. codex --profile tokenlab lädt das Profil ausdrücklich; config.toml, auth.json, Konten und Berechtigungsregeln bleiben unverändert. Verwenden Sie keine alte Tabelle [profiles.tokenlab]. Ohne dieses Profil startet Ihre gewohnte Konfiguration. Siehe offizielle Profilkonfiguration.

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"

[model_providers.tokenlab]
env_key = "TOKENLAB_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

Dieser WebSocket-Modus ist eine Responses-over-WebSocket-Brücke für Codex-Clients. Er akzeptiert nur offizielle response.create-Ereignisse; stream ist implizit, und background sowie response.cancel sind auf diesem Transport nicht verfügbar. Er ist nicht die OpenAI Realtime API und akzeptiert keine session.update-, conversation.item.*-, input_audio_buffer.*-Events, kein binäres Audio und keine verschachtelten Realtime-response.create.response-Envelopes.

Aktuelles Codex nutzt wire_api = "responses", nicht chat/completions. Lassen Sie requires_openai_auth weg oder setzen Sie es auf false, damit dieser Anbieter env_key verwendet.

Grundlegende VerwendungCopy Anchor Link

Interaktiven Modus starten:

codex --profile tokenlab

Direkter Befehl:

codex --profile tokenlab "Fix the bug in main.py line 42"

Modell angeben:

codex --profile tokenlab -m gpt-5.6-sol "Build a REST API server"

Modell auswählenCopy Anchor Link

Wählen Sie ein Modell, dessen aktuelle tokenlab.accepted_request_formats den Wert openai_responses enthalten. Vergleichen Sie Modelle anhand Ihrer Aufgaben und prüfen Sie aktuelle Preise auf der Modellseite.

Interaktive BefehleCopy Anchor Link

Konfiguration verifizierenCopy Anchor Link

Prüfen Sie nur, ob die Umgebungsvariable gesetzt ist, ohne ihren Wert auszugeben. Diese Prüfung bestätigt nicht die Gültigkeit des Schlüssels:

if [ -n "${TOKENLAB_API_KEY:-}" ]; then
  printf '%s\n' 'TOKENLAB_API_KEY is set'
else
  printf '%s\n' 'TOKENLAB_API_KEY is not set'
fi

Starten Sie Codex und führen Sie /status aus, um das aktive Modell und die Berechtigungen zu prüfen. Falls Sie ein Profil verwenden, starten Sie dasselbe Profil. Siehe offizieller Statusbefehl.

Führen Sie den folgenden Befehl erst aus, wenn Sie eine echte Anfrage senden möchten. Dabei wird Ihr TokenLab-Guthaben verwendet. Prüfen Sie die Antwort und den zugehörigen Eintrag unter Anfragen. Eine gesetzte Variable oder ein erfolgreicher Start allein bestätigt keine erfolgreiche Anfrage.

codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."

Häufige AnwendungsfälleCopy Anchor Link

Code-Review:

git diff | codex --profile tokenlab "Review these code changes"

Commit-Nachrichten generieren:

git diff --staged | codex --profile tokenlab "Generate a commit message for these changes"

Fehler beheben:

codex --profile tokenlab "Fix the TypeScript errors in src/components/"

Code erklären:

cat main.py | codex --profile tokenlab "Explain what this code does"

FehlerbehebungCopy Anchor Link