Du hast Codex installiert, tippst codex ins Terminal und fragst dich: „Und jetzt?“
So ging es mir auch. OpenAIs Coding-Agent hat dutzende CLI-Befehle, über 30 Slash-Commands in der interaktiven TUI und nochmal eine eigene Desktop-App mit separaten Shortcuts. Ohne Referenz verliert man schnell den Überblick.
In diesem Artikel findest du alle Codex Befehle auf einen Blick: jedes CLI-Kommando, jeden Slash-Command, alle Flags und sämtliche Tastenkürzel. Sortiert nach CLI und App, damit du sofort weißt, was wo funktioniert. Dies ist die vollständigste deutsche Codex-Referenz, die du finden wirst.
TL;DRDas Wichtigste in Kürze
- Über 30 CLI-Befehle stehen zur Verfügung: von codex exec (nicht-interaktive Ausführung) über codex review (Code Review) bis codex cloud (Cloud-Tasks)
- 34 Slash-Commands in der interaktiven CLI-TUI, 5 in der Desktop-App. Die Tabellen zeigen dir genau, was wo verfügbar ist
- Drei Sandbox-Modi (read-only, workspace-write, danger-full-access) und vier Approval-Policies steuern, was Codex auf deinem System tun darf
- Codex Cloud ermöglicht es, langwierige Aufgaben in Remote-Sandbox-Umgebungen auszulagern, mit Best-of-N-Versuchen
Codex installieren und starten
Codex CLI lässt sich per npm oder Homebrew installieren. Nach der Installation wirst du beim ersten Start aufgefordert, dich mit deinem ChatGPT-Account oder einem API-Key anzumelden.
# Installation per npm
npm install -g @openai/codex
# Oder per Homebrew (nativer Rust-Binary, schneller)
brew install codex# Interaktiv anmelden (öffnet Browser für OAuth)
codex login
# Per API-Key anmelden
echo $OPENAI_API_KEY | codex login --with-api-key
# Login-Status prüfen
codex login status
# Abmelden
codex logout# Interaktive TUI-Session starten
codex
# Mit initialem Prompt starten
codex „Erkläre die Architektur dieses Projekts“
# Nicht-interaktiv ausführen (für Skripte)
codex exec -s workspace-write -m gpt-5.5 „Refactore auth.ts“
# Desktop-App starten
codex appTipp
Starte Codex immer im richtigen Projektordner. Mit
--cd /pfad/zum/projekt kannst du das Arbeitsverzeichnis auch explizit setzen.CLI-Befehle (Übersicht)
Codex bietet zwei Oberflächen: die CLI (Terminal-Befehle, die du direkt in der Kommandozeile ausführst) und die App (Desktop-Anwendung für macOS und Windows). Die Spalte „Verfügbar in“ zeigt dir, wo jeder Befehl funktioniert.
Befehl | Beschreibung | Verfügbar in |
|---|---|---|
codex | Startet interaktive TUI-Session im Terminal | CLI |
codex app | Startet die Codex Desktop-App (macOS/Windows) | App |
codex exec | Führt Aufgabe nicht-interaktiv aus, streamt Output nach stdout | CLI |
codex exec resume | Setzt vorherige Session nicht-interaktiv fort | CLI |
codex review | Code Review (uncommitted, Branch-Diff oder Commit) | CLI |
codex apply | Wendet Diff aus einer Codex-Session oder Cloud-Task an | CLI |
codex resume | Setzt interaktive Session fort (Session-Picker) | CLI |
codex fork | Forkt eine Session in einen neuen Thread | CLI |
codex cloud exec | Reicht Cloud-Task in Sandbox-Umgebung ein | CLI |
codex cloud list | Listet Cloud-Tasks auf (mit Filter und Pagination) | CLI |
codex cloud status | Zeigt Status eines Cloud-Tasks | CLI |
codex cloud diff | Zeigt den Diff eines Cloud-Tasks an | CLI |
codex cloud apply | Wendet Cloud-Task-Diff lokal an | CLI |
codex mcp add | Fügt MCP-Server hinzu (stdio oder HTTP) | CLI |
codex mcp list | Listet konfigurierte MCP-Server auf | CLI |
codex mcp get | Zeigt Konfiguration eines MCP-Servers | CLI |
codex mcp remove | Entfernt einen MCP-Server | CLI |
codex mcp login | OAuth-Login für einen MCP-Server | CLI |
codex mcp logout | Entfernt OAuth-Credentials eines MCP-Servers | CLI |
codex features list | Zeigt Feature Flags mit Status und Reifegrad | CLI |
codex features enable/disable | Aktiviert oder deaktiviert ein Feature Flag dauerhaft | CLI |
codex login | Anmelden per OAuth oder API-Key | CLI |
codex login status | Zeigt aktuellen Login-Status | CLI |
codex logout | Entfernt gespeicherte Credentials | CLI |
codex sandbox | Führt Befehl in Codex-Sandbox aus (macOS/Linux/Windows) | CLI |
codex completion | Generiert Shell-Completions (bash, zsh, fish, elvish, PowerShell) | CLI |
codex update | Prüft auf Updates und installiert neue Version | CLI |
codex execpolicy | Prüft Exec-Policy-Regeldateien vor dem Speichern | CLI |
codex mcp-server | Startet Codex selbst als MCP-Server (stdio-Transport) | CLI |
codex plugin marketplace | Verwaltet Plugin-Marktplatz-Quellen (add, remove, upgrade) | CLI |
Hinweis
codex exec ist der wichtigste Befehl für Automatisierung. Er führt Aufgaben nicht-interaktiv aus und gibt das Ergebnis auf stdout aus. Perfekt für Skripte und CI/CD-Pipelines.codex exec: Flags für nicht-interaktive Ausführung
codex exec ist das Arbeitspferd für automatisierte Workflows. Ohne Flags wartet Codex auf menschliche Genehmigung, was in Skripten zum Hängen führt. Deshalb solltest du mindestens einen Sandbox-Modus setzen.
# Standard-Pattern für automatisierte Ausführung
codex exec -s workspace-write -m gpt-5.5 "dein Prompt"
# Mit maximaler Reasoning-Tiefe
codex exec -s workspace-write -m gpt-5.5 \
-c model_reasoning_effort='"xhigh"' "komplexe Aufgabe"
# Read-only für Analyse (keine Dateiänderungen)
codex exec -s read-only -m gpt-5.5 "Analysiere die Architektur"Flag | Beschreibung | Beispiel |
|---|---|---|
--model, -m | Überschreibt das Modell aus der Konfiguration | -m gpt-5.5 |
--sandbox, -s | Sandbox-Modus: read-only, workspace-write oder danger-full-access | -s workspace-write |
--ask-for-approval, -a | Genehmigungs-Policy: untrusted, on-failure, on-request, never | -a on-request |
--cd, -C | Setzt das Arbeitsverzeichnis für den Agent | -C /pfad/zum/projekt |
--add-dir | Zusätzliche beschreibbare Verzeichnisse freigeben | --add-dir ../backend |
--image, -i | Hängt Bilder an den Prompt an (wiederholbar) | -i screenshot.png |
--config, -c | Überschreibt config.toml-Werte (TOML-Syntax) | -c model_reasoning_effort='"xhigh"' |
--profile, -p | Lädt benanntes Config-Profil aus config.toml | -p fast-profile |
--enable / --disable | Aktiviert oder deaktiviert Feature Flag für diesen Lauf | --enable search_tool |
--json | Gibt Events als JSONL aus (eine JSON-Zeile pro Event) | codex exec --json "..." |
--output-last-message, -o | Speichert letzte Agent-Nachricht in Datei | -o /tmp/result.txt |
--output-schema | JSON-Schema-Datei, die die finale Antwort beschränkt | --output-schema schema.json |
--ephemeral | Session wird nicht auf Disk persistiert | codex exec --ephemeral "..." |
--skip-git-repo-check | Erlaubt Ausführung außerhalb eines Git-Repos | codex exec --skip-git-repo-check "..." |
--color | ANSI-Farben steuern: always, never, auto | --color never |
--oss | Nutzt lokalen Open-Source-Provider (Ollama) | codex exec --oss "..." |
--full-auto | Deprecated. Alias für ,[object Object],. Nutze stattdessen direkt ,[object Object] | codex exec --full-auto "..." |
Warnung
--full-auto ist deprecated. Nutze stattdessen -s workspace-write (oder -s workspace-write -a on-request für das gleiche Verhalten).Häufige Muster
# Bilder anhängen (Screenshots, Design-Specs)
codex exec -s workspace-write -m gpt-5.5 -i screenshot.png „Implementiere dieses UI“
# Mehrere beschreibbare Verzeichnisse
codex exec -s workspace-write -C apps/frontend --add-dir ../backend „Sync API-Types“
# JSON-Output für Skripte
codex exec -s workspace-write --json „Liste alle TODO-Kommentare“
# Ergebnis in Datei speichern
codex exec -s workspace-write -o /tmp/result.txt „Fasse die Codebase zusammen“
# Strukturierte Ausgabe mit JSON Schema
codex exec -s workspace-write --output-schema schema.json „Extrahiere alle API-Endpoints“
# Prompt per stdin übergeben
cat prompt.txt | codex exec -s workspace-write -
# Config-Profil nutzen
codex exec -s workspace-write -p thorough „gründliche Analyse“
# Lokales Open-Source-Modell (Ollama)
codex exec --oss -s workspace-write „Erkläre diese Funktion“Code Review
codex review analysiert Codeänderungen nicht-interaktiv und gibt die Ergebnisse auf stdout aus. Dateien werden dabei nicht verändert.
Flag | Beschreibung | Beispiel |
|---|---|---|
--uncommitted | Reviewed staged, unstaged und untracked Changes | codex review --uncommitted |
--base | Reviewed Änderungen gegen einen Base-Branch | codex review --base main |
--commit | Reviewed einen spezifischen Commit | codex review --commit abc123 |
--title | Optionaler Titel für die Review-Zusammenfassung | codex review --title „Auth hinzufügen“ |
PROMPT | Benutzerdefinierte Review-Anweisungen (auch via stdin mit -) | codex review „Fokus auf Sicherheit“ |
# Uncommitted Changes reviewen (staged + unstaged + untracked)
codex review --uncommitted
# Änderungen gegen einen Branch reviewen (vor einem PR)
codex review --base main
# Spezifischen Commit reviewen
codex review --commit abc123
# Review mit Titel und benutzerdefiniertem Fokus
codex review --base main --title „Auth hinzufügen“ „Fokus auf Sicherheit“
# Review per exec mit JSON-Output
codex exec review --uncommitted --jsonSession-Management
Codex speichert Sessions lokal unter ~/.codex/sessions/. Du kannst sie jederzeit fortsetzen, forken oder nicht-interaktiv wieder aufnehmen.
# Interaktiv: Session-Picker öffnen
codex resume
# Interaktiv: Letzte Session direkt fortsetzen
codex resume --last
# Nicht-interaktiv: Letzte Session mit neuem Prompt fortsetzen
codex exec resume --last -s workspace-write -m gpt-5.5 \
„Füge jetzt Error Handling hinzu“
# Spezifische Session per UUID fortsetzen
codex exec resume 7f9f9a2e-1b3c-4c7a... -s workspace-write -m gpt-5.5 \
„Setze den Plan um“
# Session forken (neuer Thread basierend auf bestehendem Kontext)
codex fork --last# Diff aus einer lokalen Session anwenden
codex apply TASK_ID
# Diff aus einem Cloud-Task anwenden
codex cloud apply TASK_ID
# Spezifischen Versuch anwenden (bei --attempts N)
codex cloud apply TASK_ID --attempt 2Tipp
Mit
--ephemeral gestartete Sessions werden nicht auf der Festplatte gespeichert. Nutze das für schnelle Einmal-Fragen, bei denen du keinen Verlauf brauchst.Codex Cloud
Codex Cloud führt Aufgaben in sandboxed Remote-Umgebungen aus. Alle Unterbefehle sind nicht-interaktiv. Die --env-Angabe ist Pflicht.
Flag | Beschreibung | Beispiel |
|---|---|---|
--env | Pflichtangabe: Ziel-Umgebungs-ID für den Cloud-Task | --env ENV_ID |
--attempts | Anzahl Versuche (Best-of-N), Standard: 1, Max: 4 | --attempts 3 |
--branch | Git-Branch, auf dem der Task laufen soll | --branch feature/auth |
--json | Maschinenlesbare JSON-Ausgabe (für codex cloud list) | codex cloud list --json |
--limit | Maximale Anzahl zurückgegebener Tasks (1-20) | codex cloud list --limit 5 |
--cursor | Paginierungs-Cursor vom vorherigen Aufruf | codex cloud list --cursor CURSOR |
--attempt | Versuchsnummer für diff/apply (bei --attempts N) | codex cloud diff TASK_ID --attempt 2 |
# Task einreichen
codex cloud exec --env ENV_ID „Refactore das Payment-Modul“
# Best-of-3: Drei Versuche starten
codex cloud exec --env ENV_ID --attempts 3 „Fix den flaky Test“
# Auf spezifischem Branch
codex cloud exec --env ENV_ID --branch feature/auth „OAuth hinzufügen“
# Tasks auflisten
codex cloud list
codex cloud list --json --limit 5
# Status prüfen
codex cloud status TASK_ID
# Diff anzeigen (spezifischer Versuch)
codex cloud diff TASK_ID --attempt 2Sandbox-Modi
Die Sandbox beschränkt, was Codex auf deinem System tun darf. Du setzt den Modus mit -s oder --sandbox.
Modus | Lesen | Schreiben | Netzwerk | Wann nutzen? |
|---|---|---|---|---|
read-only | Überall | Nirgends | Nein | Fragen, Erklärungen, Code-Analyse |
workspace-write | Überall | Nur Arbeitsverzeichnis | Nein | Standard für die meisten Aufgaben |
danger-full-access | Überall | Überall | Ja | Nur wenn ausdrücklich nötig (z. B. Pakete installieren) |
Codex bietet auch ein codex sandbox Kommando, mit dem du beliebige Befehle unter der Sandbox ausführen kannst, ohne den Agenten zu involvieren:
# Befehl in der Sandbox ausführen (macOS)
codex sandbox macos -- npm test
# Mit Log der abgelehnten Zugriffe
codex sandbox macos --log-denials -- ./build.sh
# Linux (Landlock + seccomp)
codex sandbox linux -- python3 script.pyApproval Policies
Approval Policies steuern, wann Codex um Erlaubnis fragt, bevor ein Befehl ausgeführt wird. Den Modus setzt du mit -a oder --ask-for-approval.
Policy | Verhalten |
|---|---|
untrusted | Nur vertrauenswürdige Befehle (ls, cat, sed) laufen ohne Genehmigung |
on-failure | Alle Befehle laufen, Genehmigung nur bei Fehler |
on-request | Modell entscheidet, wann es um Erlaubnis fragt |
never | Fragt nie nach Genehmigung, Fehler gehen direkt ans Modell zurück |
Hinweis
In der interaktiven TUI wechselst du den Genehmigungsmodus mit
/permissions. Drei Presets stehen zur Auswahl: Auto (Standard), Read Only und Full Access.MCP-Server (Model Context Protocol)
Codex kann sich mit MCP-Servern verbinden, um zusätzliche Tools zu nutzen (z. B. Datenbanken, APIs, GitHub). Alle Verwaltungsbefehle sind nicht-interaktiv.
# Konfigurierte Server auflisten
codex mcp list
codex mcp list --json
# Server-Konfiguration anzeigen
codex mcp get my-server
codex mcp get my-server --json
# Stdio-Server hinzufügen
codex mcp add my-server -- npx -y @my/mcp-server
codex mcp add my-server --env API_KEY=sk-123 -- node server.js
# HTTP-Server hinzufügen
codex mcp add my-server --url https://mcp.example.com/sse
codex mcp add my-server --url https://mcp.example.com \
--bearer-token-env-var MY_TOKEN_VAR
# Server entfernen
codex mcp remove my-server
# OAuth-Login für MCP-Server
codex mcp login my-server --scopes "read,write"
codex mcp logout my-serverTipp
Mit
codex mcp-server kannst du Codex selbst als MCP-Server starten. So lässt sich Codex in andere Tools integrieren, die MCP unterstützen.Slash-Commands (CLI und App)
In der interaktiven TUI (gestartet mit codex) und in der Desktop-App stehen Slash-Commands zur Verfügung. Tippe / im Composer, um die Liste zu öffnen. Während ein Task läuft, kannst du einen Slash-Command eingeben und mit Tab in die Warteschlange stellen.
Die CLI-TUI hat deutlich mehr Slash-Commands als die App. Die Spalte „Verfügbar in“ zeigt dir, wo jeder Befehl funktioniert.
Befehl | Beschreibung | Verfügbar in |
|---|---|---|
/agent | Wechselt den aktiven Agenten-Thread | CLI |
/apps | Durchsucht und fügt Connectors/Apps hinzu | CLI |
/clear | Löscht Terminal und startet neuen Chat | CLI |
/compact | Fasst Unterhaltung zusammen, um Token freizugeben | CLI |
/copy | Kopiert letzte Antwort in die Zwischenablage (auch ,[object Object],) | CLI |
/debug-config | Gibt Konfigurations-Diagnose aus | CLI |
/diff | Zeigt Git-Diff inkl. untracked Dateien | CLI |
/exit | Beendet die CLI-Session (Alias: ,[object Object],) | CLI |
/experimental | Schaltet optionale Features ein/aus (Apps, Smart Approvals, Goals) | CLI |
/fast | Schaltet Fast-Modus ein/aus (,[object Object],, ,[object Object],, ,[object Object],) | CLI |
/feedback | Sendet Feedback und Logs an die Entwickler | CLI + App |
/fork | Verzweigt aktuelle Unterhaltung in einen neuen Thread | CLI |
/goal | Setzt persistentes Aufgabenziel (,[object Object],, ,[object Object],, ,[object Object],) | CLI |
/init | Generiert AGENTS.md als Projektkontext-Datei | CLI |
/keymap | Zeigt und ändert Tastenkürzel-Belegung für die TUI | CLI |
/logout | Meldet sich von Codex ab | CLI |
/mcp | Listet MCP-Tools auf (,[object Object], für Details) | CLI + App |
/mention | Hängt Dateien an die Unterhaltung an | CLI |
/model | Wechselt das aktive KI-Modell | CLI |
/new | Startet neue Unterhaltung in der gleichen CLI-Instanz | CLI |
/permissions | Konfiguriert Genehmigungsmodus (Auto, Read Only, Full Access) | CLI |
/personality | Ändert Kommunikationsstil (,[object Object],, ,[object Object],, ,[object Object],) | CLI |
/plan | Aktiviert Plan-Modus mit optionalem Inline-Prompt | CLI |
/plan-mode | Schaltet Multi-Step-Planungsmodus ein/aus | App |
/plugins | Verwaltet installierte Plugins (installieren, aktivieren, inspizieren) | CLI |
/ps | Zeigt Hintergrund-Terminals an | CLI |
/resume | Lädt eine vorherige Session über den Session-Picker | CLI |
/review | Analysiert Änderungen im Working Tree (Code Review) | CLI + App |
/sandbox-add-read-dir | Gibt Sandbox Lesezugriff auf ein Verzeichnis (nur Windows) | CLI |
/side | Startet kurzlebige Nebenunterhaltung | CLI |
/status | Zeigt aktives Modell, Approval Policy, beschreibbare Pfade und Token-Nutzung | CLI + App |
/statusline | Konfiguriert Elemente in der TUI-Fußzeile | CLI |
/stop | Stoppt alle Hintergrund-Terminals | CLI |
/title | Konfiguriert Elemente im Terminal-Titel | CLI |
Tastenkürzel: CLI (TUI)
Diese Shortcuts funktionieren in der interaktiven Terminal-Oberfläche (gestartet mit codex). Mit /keymap kannst du die Belegung anpassen.
Tastenkürzel | Funktion | Kontext |
|---|---|---|
Ctrl+C | Bricht aktuelle Ausführung ab | Während der Agent arbeitet |
Ctrl+D | Beendet die CLI | Bei leerem Input-Buffer |
Ctrl+G | Öffnet externen Editor (VISUAL oder EDITOR) | Für lange Prompts |
Ctrl+L | Löscht den Bildschirm (ohne neuen Chat zu starten) | Wenn das Terminal zu voll wird |
Ctrl+O | Kopiert letzte Antwort in die Zwischenablage | Nach einer Antwort |
Ctrl+R | Rückwärtssuche in der Prompt-History | Im Composer |
Alt+, | Senkt die Reasoning-Tiefe | Während der Session |
Alt+. | Erhöht die Reasoning-Tiefe | Während der Session |
Up / Down | Navigiert durch die Draft-History im Composer | Im Eingabefeld |
Tab | Reiht Follow-up-Text, Slash-Commands oder Shell-Befehle in die Warteschlange ein | Während der Agent arbeitet |
Esc + Esc | Bearbeitet vorherige Nutzernachricht | Im Composer |
@ | Fuzzy-Dateisuche zum Anhängen von Dateien | Im Eingabefeld |
! | Führt Shell-Befehl direkt aus | Am Anfang der Eingabe |
Tastenkürzel: Codex App
Die Desktop-App (gestartet mit codex app) hat eigene Tastenkürzel, die sich an gängigen IDE-Konventionen orientieren. Auf Windows ersetzt du Cmd durch Ctrl.
Tastenkürzel | Funktion |
|---|---|
Cmd+Shift+P / Cmd+K | Öffnet die Command-Palette |
Cmd+, | Öffnet die Einstellungen |
Cmd+O | Öffnet Ordner |
Cmd+N / Cmd+Shift+O | Neuer Thread |
Cmd+F | Suche im Thread |
Cmd+B | Sidebar ein-/ausblenden |
Cmd+Option+B | Diff-Panel ein-/ausblenden |
Cmd+J | Terminal ein-/ausblenden |
Cmd+Shift+[ / ] | Zum vorherigen / nächsten Thread wechseln |
Cmd+[ / ] | Zurück / vorwärts navigieren |
Cmd++ / Cmd+- | Schriftgröße vergrößern / verkleinern |
Ctrl+L | Terminal löschen |
Ctrl+M | Diktat starten |
Hinweis
Die App unterstützt auch Deeplinks per
codex://-Schema, z. B. codex://settings für Einstellungen oder codex://new?prompt=dein+prompt für einen neuen Thread mit Prompt.Konfiguration (config.toml)
Die Codex-Konfiguration liegt unter ~/.codex/config.toml. Du kannst Standardwerte setzen und benannte Profile definieren.
Setting | Beschreibung | Mögliche Werte |
|---|---|---|
model | Standard-Modell für alle Sessions | [object Object], (empfohlen), ,[object Object],, ,[object Object],, ,[object Object] |
model_reasoning_effort | Reasoning-Tiefe für komplexe Aufgaben | [object Object],, ,[object Object],, ,[object Object],, ,[object Object] |
personality | Kommunikationsstil des Agenten | [object Object],, ,[object Object],, ,[object Object] |
web_search | Modus für die Web-Suche | [object Object], (Standard), ,[object Object],, ,[object Object] |
# ~/.codex/config.toml
# Standard-Settings
model = "gpt-5.5"
model_reasoning_effort = "high"
# Profil für schnelle Aufgaben
[profiles.quick]
model = "gpt-4.1-mini"
model_reasoning_effort = "low"
# Profil für gründliche Arbeit
[profiles.thorough]
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
# Projekt-Vertrauenslevel
[projects."/pfad/zum/projekt"]
trust_level = "trusted"# Einzelnen Wert überschreiben
codex exec -s workspace-write -c model='"gpt-5.5"' "Aufgabe"
# Sandbox-Berechtigungen setzen
codex exec -s workspace-write \
-c 'sandbox_permissions=["disk-full-read-access"]' "Aufgabe"
# Profil per -p laden
codex exec -s workspace-write -p quick "Schnelle Frage"Feature Flags
Feature Flags steuern experimentelle und stabile Features. Änderungen per enable/disable werden dauerhaft in die config.toml geschrieben. Per-Run-Toggles mit --enable/--disable gelten nur für den aktuellen Lauf.
# Alle Feature Flags mit Status und Reifegrad anzeigen
codex features list
# Feature dauerhaft aktivieren / deaktivieren
codex features enable search_tool
codex features disable shell_snapshot
# Nur für diesen Lauf aktivieren (nicht persistent)
codex exec -s workspace-write --enable search_tool \
--disable shell_snapshot „Aufgabe“Globale Flags
Diese Flags stehen bei fast jedem Codex-Befehl zur Verfügung:
Flag | Beschreibung |
|---|---|
--config, -c | Überschreibt config.toml-Werte. Gepunktete Pfade für Verschachtelung. Werte werden als TOML geparst. |
--enable | Aktiviert ein Feature Flag für diesen Lauf (wiederholbar) |
--disable | Deaktiviert ein Feature Flag für diesen Lauf (wiederholbar) |
--help, -h | Zeigt Hilfe an |
--version, -V | Zeigt Versionsnummer an |
Fehlerbehebung
Problem | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Authentifizierung schlägt fehl | Veralteter Token oder falscher API-Key | codex logout, dann codex login erneut ausführen |
| Codex hängt bei codex exec | Kein Sandbox-Modus gesetzt (wartet auf Genehmigung) | Immer -s workspace-write oder -a on-request mitgeben |
| Befehl wird in Sandbox blockiert | Netzwerkzugriff oder Schreibzugriff außerhalb des Arbeitsverzeichnisses | -s danger-full-access nutzen (nur wenn nötig) |
| MCP-Server verbindet nicht | Fehlende Dependencies oder falscher Pfad | codex mcp get server-name prüfen, dann remove und neu add |
| Session lässt sich nicht fortsetzen | Session wurde mit --ephemeral gestartet | Ohne --ephemeral neu starten, damit Sessions gespeichert werden |
| Cloud-Task zeigt keinen Diff | Task läuft noch oder ist fehlgeschlagen | codex cloud status TASK_ID prüfen, dann erneut versuchen |
# Konfigurationslayer diagnostizieren
# (in der interaktiven TUI)
/debug-config
# Verfügbare Modelle als JSON anzeigen
codex debug models
# Nur eingebauten Modellkatalog anzeigen (kein API-Refresh)
codex debug models --bundled
# Exec-Policy-Regeln prüfen (vor dem Speichern)
codex execpolicy --rules rules.toml -- npm test
# Sandbox-Denials loggen (Debugging)
codex sandbox macos --log-denials -- ./build.sh
