Coding-Tools

Codex CLI

OpenAI Codex CLI für die Verwendung der TokenLab-API konfigurieren

Von meinem Agenten einrichten lassen

Kopieren Sie diese Aufgabe an einen Agenten, der bereits auf Ihrem Computer ausgeführt wird:

Read this guide and help me connect Codex CLI to TokenLab:
https://tokenlab.sh/docs/de/integrations/codex-cli
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

Übersicht

Codex CLI kann sich über /v1/responses mit TokenLab verbinden. Das ausgewählte Modell muss openai_responses in tokenlab.accepted_request_formats aufführen; die Funktionen können je nach Modell variieren.

Die Remote-Komprimierung verwendet POST /v1/responses/compact. Codex sendet das aktuelle Sitzungsmodell in body.model, daher muss dieses Modell ebenfalls Responses unterstützen. Konfigurieren Sie nicht /v1/compact.

Systemanforderungen

Verwenden Sie die offizielle CLI-Installationsanleitung für macOS, Linux oder Windows. Natives Windows und WSL sind getrennte Umgebungen; folgen Sie der Windows-Anleitung. Der nachfolgende npm-Befehl ist eine Installationsoption, keine Voraussetzung für native Binärdateien.

Installation

npm install -g @openai/codex@0.163.0

Installation überprüfen:

codex --version

Konfiguration

Schritt 1: API-Schlüssel festlegen

Verwenden Sie die Terminal-Anweisungen aus dem Quickstart für macOS, Linux, WSL oder Windows PowerShell, um TOKENLAB_API_KEY festzulegen, ohne den Schlüssel im Befehlsverlauf zu speichern. Starten Sie Codex aus diesem Terminal. Für eine dauerhafte Nutzung verwenden Sie Ihren lokalen Secret Manager; fügen Sie keinen Klartext-Schlüssel an Ihr Shell-Profil an.

Schritt 2: tokenlab.config.toml konfigurieren

Verwenden Sie eine separate tokenlab.config.toml in Ihrem aktiven CODEX_HOME (normalerweise ~/.codex) mit Codex 0.163.0 (getestet am 18.10.2026). Erstellen Sie sie nur, wenn der Name noch nicht verwendet wird, oder sichern Sie sie vor der Bearbeitung eines bestehenden TokenLab-Profils. Das unten stehende Profil wird explizit mit codex --profile tokenlab geladen; es lässt die standardmäßige config.toml, auth.json, Konten und Berechtigungsrichtlinien unverändert. Verwenden Sie keine veraltete [profiles.tokenlab]-Tabelle. Starten Sie ohne das Profil, um zu Ihrer gewohnten Konfiguration zurückzukehren. Siehe die 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-Bridge für Codex-Clients. Er akzeptiert nur offizielle response.create-Events; stream ist implizit, und background sowie response.cancel sind auf diesem Transport nicht verfügbar. Es handelt sich nicht um die OpenAI Realtime API und es werden weder session.update, conversation.item.*, input_audio_buffer.*, binäres Audio noch verschachtelte Realtime-response.create.response-Envelopes akzeptiert.

Erstellen Sie die gewählte Konfigurationsdatei, falls sie noch nicht existiert. Starten Sie nach der Bearbeitung eine neue Sitzung mit dem entsprechenden Befehl unten.

Das aktuelle Codex verwendet wire_api = "responses". Konfigurieren Sie nicht chat/completions. Belassen Sie requires_openai_auth für diesen benutzerdefinierten Provider nicht gesetzt oder auf false, damit env_key verwendet wird.

Responses-Anfragen werden nicht in Chat Completions konvertiert. Optionale und zukünftige Felder hängen vom ausgewählten Modell ab.

Grundlegende Verwendung

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"

Ein Modell auswählen

Verwenden Sie ein Modell, das derzeit openai_responses in tokenlab.accepted_request_formats aufführt. Vergleichen Sie Kandidaten anhand Ihrer eigenen Coding-Aufgaben und prüfen Sie die aktuellen Preise auf der Modelle-Seite.

Interaktive Befehle

BefehlBeschreibung
/helpHilfe anzeigen
/exit oder Strg+CBeenden
/clearUnterhaltung leeren
/statusAktives Modell, Berechtigungen und Token-Nutzung anzeigen
/model <name>Modell wechseln

Konfiguration überprüfen

Überprüfen Sie, ob die Umgebungsvariable gesetzt ist, ohne ihren Wert auszugeben. Diese Prüfung validiert den Schlüssel nicht:

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 überprüfen. Wenn Sie ein Profil verwenden, starten Sie dasselbe Profil. Siehe den offiziellen Status-Befehl.

Wenn Sie bereit sind, eine echte Anfrage zu stellen, führen Sie den folgenden Befehl aus. Dabei wird Ihr TokenLab-Guthaben verwendet. Überprüfen Sie die Antwort und den passenden Datensatz unter Anfragen; eine Umgebungsprüfung oder ein erfolgreicher Start allein belegen noch nicht, dass eine Anfrage erfolgreich war.

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

Häufige Anwendungsfälle

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"

Bilder und Videos im selben Agenten generieren

Codex kann mit dem TokenLab MCP-Server auch Bilder und kurze Videos erstellen. Jede Generierung wird über dasselbe TokenLab-Guthaben abgerechnet. Führen Sie Folgendes in dem Terminal aus, in dem TOKENLAB_API_KEY gesetzt ist:

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

Der Befehl fügt den Server zu Ihrer Basis-config.toml hinzu. Codex lädt diese Datei auch unter dem tokenlab.config.toml-Profil, sodass die Tools mit oder ohne --profile tokenlab funktionieren. Führen Sie codex mcp list aus und prüfen Sie, ob tokenlab aufgeführt ist. Versuchen Sie dann:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video gibt eine Task-ID zurück. Der Agent ruft get_task_status auf, bis das Video fertiggestellt ist.

Fehlerbehebung

Auf dieser Seite