OpenAI Codex CLI

OpenAIs offizieller Terminal-Coding-Agent. Da er die Standard-OpenAI-API spricht, schalten dieselben zwei Umgebungsvariablen jedes OpenAI-kompatible Tool im Ökosystem frei — sobald Codex funktioniert, funktionieren auch Aider / Continue / LangChain / die reine openai CLI.

Bevor Sie beginnen

Erstellen Sie einen API-Schlüssel unter Console → API Keys. Kopieren Sie ihn sofort — er wird nur einmal angezeigt.

Schritt 1 — Umgebungsvariablen setzen

# ~/.zshrc (or equivalent)
export OPENAI_BASE_URL="https://synthorai.io/v1"
export OPENAI_API_KEY="sk-..."   # your Synthorai key

⚠

Die OpenAI-kompatible base URL muss enden auf /v1. Anders als das Anthropic SDK hängt das OpenAI SDK es nicht automatisch an. Ein häufiger Fehler ist das Einfügen von https://synthorai.io; die Anfragen treffen dann auf /chat/completions (404) statt /v1/chat/completions.

Schritt 2 — Senden Sie Ihre erste Anfrage

# Open a new shell so env vars take effect, then:
codex exec -m gpt-5.4-mini "refactor this function for readability" < src/foo.py

# Or for long reasoning-heavy tasks:
codex exec -m gpt-5.3-codex "implement unit tests for bar()"

Dieselbe Konfiguration funktioniert für die openai CLI, die Python-/Node-SDKs, Aider und jedes andere OpenAI-kompatible Tool — sie alle lesen OPENAI_BASE_URL und OPENAI_API_KEY.

Empfohlene Modelle

Parameter	Typ	Beschreibung
`gpt-5.3-codex`	`coding`	Auf Codegenerierung abgestimmt. Standardauswahl für Codex CLI.
`gpt-5.4`	`reasoning`	Flaggschiff-Reasoning. Für Refactorings auf Architekturebene verwenden.
`gpt-5.4-mini`	`fast`	Schnell, günstig und dennoch sehr leistungsfähig. Gute Standardwahl für kurze Aufgaben.
`gpt-5.4-nano`	`cheapest`	Die günstigste OpenAI-Option. Für kleine Bearbeitungen und Klassifizierung verwenden.

Fehlerbehebung

„404 Not Found" bei /chat/completions — Ihrer OPENAI_BASE_URL fehlt das /v1 Suffix. Korrektur: export OPENAI_BASE_URL="https://synthorai.io/v1".

„Erreicht weiterhin api.openai.com" — neue Umgebungsvariablen gelten nur für neue Shells. Öffnen Sie ein frisches Terminal, oder source laden Sie Ihr Profil neu.

„Modell nicht gefunden" — curl $OPENAI_BASE_URL/models -H "Authorization: Bearer $OPENAI_API_KEY" um die genaue Liste zu sehen, die Ihrem Workspace zur Verfügung steht.

Überschreibung pro Projekt — wenn Sie diese Variablen nicht global wünschen, legen Sie sie in einem Projekt .envrc (mit direnv) oder einer Shell-spezifischen Funktion ab.

Sehen Sie im model price comparison, wie sich die vier Stufen preislich schlagen.