Codex CLI

Übersicht

Typ: CodierwerkzeugPrimärer Pfad: OpenAI Responses (erweiterter optionaler Pfad)Unterstützung: Unterstützt mit Modell-/Pfad-Einschränkungen

OpenAI Codex ist ein Open-Source-Kommandozeilenwerkzeug (CLI), das als leichtgewichtiger Coding-Agent dient und in der Lage ist, Code im Terminal zu lesen, zu ändern und auszuführen. Es basiert auf GPT-Modellen und ist für Code-Generierung optimiert. Für TokenLab kann Codex CLI /v1/responses verwenden, aber Sie sollten dies als einen erweiterten Kompatibilitätspfad behandeln. Einige Responses-only-Funktionen sind nicht für jedes Modell und jeden gerouteten Pfad garantiert. 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.

Systemanforderungen

OS: macOS, Linux (offiziell unterstützt), Windows über WSL
Node.js: Version 18+
npm: Version 10.x.x oder höher

Installation

npm install -g @openai/codex

Installation verifizieren:

codex --version

Konfiguration

Schritt 1: API-Schlüssel setzen

Temporär (aktuelle Sitzung):

export OPENAI_API_KEY="sk-your-tokenlab-key"

Dauerhafte Konfiguration: In ~/.bashrc, ~/.zshrc oder ~/.bash_profile hinzufügen:

export OPENAI_API_KEY="sk-your-tokenlab-key"

Dann neu laden:

source ~/.zshrc  # or source ~/.bashrc

Schritt 2: config.toml konfigurieren

Bearbeiten Sie ~/.codex/config.toml:

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_context_window = 258000
model_auto_compact_token_limit = 232200
sandbox_mode = "danger-full-access"
approval_policy = "never"

personality = "friendly"
service_tier = "fast"

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

[features]
fast_mode = true

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.

Wenn die Konfigurationsdatei nicht existiert, führen Sie codex einmal aus, um sie zu erzeugen, und bearbeiten Sie dann die Datei. Starten Sie Codex nach dem Ändern von config.toml vollständig neu, damit die neuen Provider-Einstellungen geladen werden.

Codex stellt die Unterstützung für chat/completions bei benutzerdefinierten Providern ein. Belassen Sie wire_api = "responses" für TokenLab, es sei denn, Sie verwenden absichtlich einen älteren Kompatibilitätspfad.

TokenLab leitet unbekannte Responses-Felder bestmöglich weiter, ohne die Anfrage stillschweigend auf Chat Completions herabzustufen. Der ausgewählte Upstream entscheidet, ob ein Feld oder eine Kombination unterstützt wird.

Grundlegende Verwendung

Interaktiven Modus starten:

codex

Direkter Befehl:

codex "Fix the bug in main.py line 42"

Modell angeben:

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

Empfohlene Modelle

Modell	Am besten für
`gpt-5.6-sol`	Beste Standardwahl für Coding und Reasoning
`gpt-5-mini`	Schnellere, günstigere Fallback-Option für Coding-Workflows
`claude-sonnet-4-6`	Code-Review, Dokumentation
`deepseek-r1`	Algorithmendesign, Reasoning

Interaktive Befehle

Befehl	Beschreibung
`/help`	Hilfe anzeigen
`/exit` oder `Ctrl+C`	Beenden
`/clear`	Konversation löschen
`/config`	Konfiguration anzeigen
`/model <name>`	Modell wechseln
`/tokens`	Token-Verbrauch anzeigen

Konfiguration verifizieren

# Check environment variable
echo $OPENAI_API_KEY

# Test API connection
codex "Hello, Codex!"

# View configuration
cat ~/.codex/config.toml

Häufige Anwendungsfälle

Code-Review:

git diff | codex "Review these code changes"

Commit-Nachrichten generieren:

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

Fehler beheben:

codex "Fix the TypeScript errors in src/components/"

Code erklären:

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

Fehlerbehebung

Verbindungsfehler

Überprüfen Sie, ob base_url in config.toml genau https://api.tokenlab.sh/v1 ist
Prüfen Sie die Netzwerkverbindung
Stellen Sie sicher, dass kein Proxy stört

Authentifizierung fehlgeschlagen

Überprüfen Sie, ob env_key = "OPENAI_API_KEY" in ~/.codex/config.toml vorhanden ist
Überprüfen Sie, ob die Umgebungsvariable OPENAI_API_KEY gesetzt ist
Prüfen Sie, ob der Schlüssel mit sk- beginnt
Stellen Sie sicher, dass der Schlüssel im TokenLab-Dashboard aktiv ist

Modell nicht gefunden

Prüfen Sie, ob der Modellname genau übereinstimmt
Überprüfen Sie die Modellverfügbarkeit unter tokenlab.sh/en/models

Responses-native Feld abgelehnt

Einige Felder sind nur auf /v1/responses verfügbar, wenn TokenLab dieses Verhalten für das ausgewählte Modell und den gewählten Pfad garantieren kann
Wenn Sie unsupported_request_field sehen, entfernen Sie dieses Feld oder wechseln Sie zu einem Workflow, der nicht davon abhängt

/compact oder Auto-Compact schlägt fehl

Codex CLI ruft POST /v1/responses/compact auf, nicht /v1/compact
Die Compaction-Anfrage verwendet das aktuelle Sitzungs-model, daher muss dieses Modell auf dem Responses-Pfad verfügbar sein
Behalten Sie wire_api = "responses" und base_url = "https://api.tokenlab.sh/v1" bei

Kompatibilitätsmatrix

Coding-Tools

Native SDKs (nativ)

Frameworks & Plattformen

Chat-Apps

Übersicht

Systemanforderungen

Installation

Konfiguration

Schritt 1: API-Schlüssel setzen

Schritt 2: config.toml konfigurieren

Grundlegende Verwendung

Empfohlene Modelle

Interaktive Befehle

Konfiguration verifizieren

Häufige Anwendungsfälle

Fehlerbehebung

​Übersicht

​Systemanforderungen

​Installation

​Konfiguration

​Schritt 1: API-Schlüssel setzen

​Schritt 2: config.toml konfigurieren

​Grundlegende Verwendung

​Empfohlene Modelle

​Interaktive Befehle

​Konfiguration verifizieren

​Häufige Anwendungsfälle

​Fehlerbehebung

Übersicht

Systemanforderungen

Installation

Konfiguration

Schritt 1: API-Schlüssel setzen

Schritt 2: config.toml konfigurieren

Grundlegende Verwendung

Empfohlene Modelle

Interaktive Befehle

Konfiguration verifizieren

Häufige Anwendungsfälle

Fehlerbehebung