Du hast Codex installiert, tippst codex ins Terminal und fragst dich, wie du eine Session fortsetzt, ein Review startest oder ein anderes Modell wählst.
OpenAIs Coding-Agent entwickelt sich schnell weiter. Neue Befehle für Sessions, Plugins, Cloud und Remote-Steuerung kommen dazu, andere verschwinden. Ohne aktuelle Referenz verlierst du schnell den Überblick.
Hier findest du die CLI-Befehle und Slash-Commands mit ihrer Einführungsversion, dazu wichtige Flags und Tastenkürzel für CLI und App. Wenn du Codex mit Claude Code vergleichen willst, hilft dir der Vergleich von Claude Code und OpenAI Codex.
- Codex CLI installierst du per npm oder Homebrew, danach startest du es mit codex und meldest dich mit ChatGPT-Account oder API-Key an
- Die 59 Slash-Commands steuern Modell, Berechtigungen, Sessions und weitere TUI-Funktionen
- Drei Sandbox-Modi und die beiden CLI-Approval-Policies on-request und never steuern Shell-Zugriff und Genehmigungen
- Mit codex exec führst du Aufgaben nicht-interaktiv aus, zum Beispiel in Skripten
1. Codex installieren und starten
Codex CLI lässt sich per npm oder Homebrew installieren. Der Quellcode ist auf GitHub unter Apache-2.0-Lizenz offen. 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
brew install --cask codex# Interaktiv anmelden (öffnet Browser für OAuth)
codex login
# Per API-Key anmelden
printenv 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-6.1-sol "Refactore auth.ts"
# Desktop-App starten
codex app--cd /pfad/zum/projekt kannst du das Arbeitsverzeichnis auch explizit setzen.2. 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 „Beispiel“ zeigt dir die typische Verwendung jedes Befehls.
Die Befehlslisten beziehen sich auf Codex CLI 0.166.0, geprüft am 31. Oktober 2026. „Seit Version“ nennt den frühesten geprüften regulären Rust-Release mit dem jeweiligen Befehlsnamen. ≤ 0.2 bedeutet, dass der Befehl bereits im ersten geprüften Release 0.2.0 vorkommt.
Bei codex mcp steht 0.35 für die Verwaltungsbefehle. In 0.34 startete der gleichnamige Befehl noch einen MCP-Server.
codex- Seit Version
- ≤ 0.2
- Beschreibung
- Startet die interaktive TUI im Terminal
- Beispiel
codex
codex app- Seit Version
- 0.95
- Beschreibung
- Startet die ChatGPT-Desktop-App oder bei fehlender Installation den Installer. macOS öffnet einen Workspace-Pfad, Windows gibt ihn zum Öffnen aus.
- Beispiel
codex app
codex agents- Seit Version
- 0.149
- Beschreibung
- Zeigt Agenten-Sessions des lokalen App-Server-Daemons
- Beispiel
codex agents
codex app-server- Seit Version
- 0.43
- Beschreibung
- Experimentell: Startet den App-Server für Entwicklung, Debugging oder Remote-Verbindungen
- Beispiel
codex app-server --listen ws://127.0.0.1:4500
codex apply- Seit Version
- 0.6
- Beschreibung
- Wendet den neuesten Diff eines Codex-Cloud-Chats lokal an (Alias:
codex a) - Beispiel
codex apply TASK_ID
codex archive- Seit Version
- 0.136
- Beschreibung
- Archiviert eine gespeicherte Session, ohne ihr Transkript zu löschen
- Beispiel
codex archive SESSION
codex cloud- Seit Version
- 0.43
- Beschreibung
- Experimentell: Öffnet oder führt Cloud-Tasks im Terminal aus (Alias:
codex cloud-tasks) - Beispiel
codex cloud list
codex cloud exec- Seit Version
- 0.47
- Beschreibung
- Reicht eine Cloud-Aufgabe in einer Zielumgebung ein
- Beispiel
codex cloud exec --env ENV_ID "..."
codex cloud list- Seit Version
- 0.88
- Beschreibung
- Listet Cloud-Tasks mit Filter- und Paginierungsoptionen
- Beispiel
codex cloud list
codex cloud status- Seit Version
- 0.66
- Beschreibung
- Zeigt den Status eines Cloud-Tasks
- Beispiel
codex cloud status TASK_ID
codex cloud diff- Seit Version
- 0.66
- Beschreibung
- Zeigt den Diff eines Cloud-Tasks
- Beispiel
codex cloud diff TASK_ID
codex cloud apply- Seit Version
- 0.66
- Beschreibung
- Wendet den Diff eines Cloud-Tasks lokal an
- Beispiel
codex cloud apply TASK_ID
codex completion- Seit Version
- 0.4
- Beschreibung
- Generiert Shell-Completions
- Beispiel
codex completion zsh
codex debug- Seit Version
- ≤ 0.2
- Beschreibung
- Experimentelle Diagnosewerkzeuge für Modellkatalog, Prompt-Eingabe und App-Server
- Beispiel
codex debug models --bundled
codex debug models- Seit Version
- Nicht dokumentiert
- Beschreibung
- Gibt den Modellkatalog als JSON aus, den Codex aktuell sieht. Mit --bundled erscheint nur der mitgelieferte Katalog ohne Aktualisierung.
- Beispiel
codex debug models --bundled
codex debug prompt-input- Seit Version
- 0.119
- Beschreibung
- Gibt die modellseitig sichtbare Prompt-Eingabe einschließlich Systemhinweisen als JSON aus
- Beispiel
codex debug prompt-input --help
codex debug app-server send-message-v2- Seit Version
- 0.95
- Beschreibung
- Experimentell: Sendet eine Nachricht über den integrierten App-Server-Testclient
- Beispiel
codex debug app-server send-message-v2 --help
codex delete- Seit Version
- 0.140
- Beschreibung
- Löscht eine gespeicherte Session dauerhaft
- Beispiel
codex delete SESSION
codex doctor- Seit Version
- 0.131
- Beschreibung
- Prüft Installation, Konfiguration, Anmeldung, Laufzeit und Git-Umgebung. Seit 0.166 beschränkt
--network-onlydie Prüfung auf Konfiguration, Netzwerk, Provider-HTTP und WebSocket. - Beispiel
codex doctor --summary
codex exec- Seit Version
- ≤ 0.2
- Beschreibung
- Führt eine Aufgabe nicht-interaktiv aus und streamt die Ausgabe (Alias:
codex e) - Beispiel
codex exec "Fix bug"
codex exec resume- Seit Version
- 0.35
- Beschreibung
- Setzt eine vorherige Session nicht-interaktiv fort
- Beispiel
codex exec resume --last "Weiterarbeiten"
codex exec fork- Seit Version
- 0.148
- Beschreibung
- Forkt eine vorherige Session nicht-interaktiv in einen neuen Thread
- Beispiel
codex exec fork SESSION_ID "Alternative umsetzen"
codex exec-server- Seit Version
- 0.119
- Beschreibung
- Experimentell: Startet den Exec-Server für Remote-Umgebungen
- Beispiel
codex exec-server --listen ws://127.0.0.1:8787
codex execpolicy- Seit Version
- 0.62
- Beschreibung
- Prüft Exec-Policy-Regeln gegen einen Befehl
- Beispiel
codex execpolicy check --rules rules.rules -- npm test
codex execpolicy check- Seit Version
- 0.62
- Beschreibung
- Prüft Regeldateien und zeigt, ob ein Befehl erlaubt, nach Bestätigung ausgeführt oder blockiert würde
- Beispiel
codex execpolicy check --rules rules.rules -- npm test
codex features- Seit Version
- 0.47
- Beschreibung
- Listet oder verwaltet Feature Flags
- Beispiel
codex features list
codex fork- Seit Version
- 0.81
- Beschreibung
- Forkt eine gespeicherte Session in einen neuen Thread
- Beispiel
codex fork --last
codex login- Seit Version
- ≤ 0.2
- Beschreibung
- Meldet dich per ChatGPT, Device-Auth, API-Key oder Access-Token an
- Beispiel
codex login
codex login status- Seit Version
- 0.11
- Beschreibung
- Zeigt den aktuellen Anmeldestatus
- Beispiel
codex login status
codex logout- Seit Version
- 0.15
- Beschreibung
- Entfernt gespeicherte Zugangsdaten
- Beispiel
codex logout
codex mcp- Seit Version
- 0.35
- Beschreibung
- Verwaltet externe MCP-Server
- Beispiel
codex mcp list
codex mcp add- Seit Version
- 0.35
- Beschreibung
- Fügt einen MCP-Server über stdio oder HTTP hinzu
- Beispiel
codex mcp add name -- command
codex mcp get- Seit Version
- 0.35
- Beschreibung
- Zeigt die Konfiguration eines MCP-Servers
- Beispiel
codex mcp get name
codex mcp remove- Seit Version
- 0.35
- Beschreibung
- Entfernt einen MCP-Server
- Beispiel
codex mcp remove name
codex mcp login- Seit Version
- 0.45
- Beschreibung
- Meldet einen MCP-Server per OAuth an
- Beispiel
codex mcp login name
codex mcp logout- Seit Version
- 0.45
- Beschreibung
- Entfernt gespeicherte OAuth-Anmeldedaten. Bei Enterprise Managed Auth (EMA) entfernt der Befehl die gemeinsame Autorisierung der betroffenen MCP-Server.
- Beispiel
codex mcp logout name
codex migrate-rollouts- Seit Version
- 0.148
- Beschreibung
- Prüft oder migriert ältere lokale Sessions in die paginierte Thread-Historie
- Beispiel
codex migrate-rollouts --verbose
codex migrate-nfs-db- Seit Version
- 0.164
- Beschreibung
- Experimentell: Migriert Codex-SQLite-Datenbanken für Netzwerkdateisysteme. Nur ausführen, wenn alle Codex- und SQLite-Clients beendet sind.
- Beispiel
codex migrate-nfs-db --help
codex plugin- Seit Version
- 0.122
- Beschreibung
- Installiert, listet oder entfernt Plugins aus konfigurierten Marktplätzen
- Beispiel
codex plugin list
codex plugin marketplace- Seit Version
- 0.122
- Beschreibung
- Verwaltet Plugin-Marktplatz-Quellen aus Git oder lokalen Pfaden
- Beispiel
codex plugin marketplace add URL
codex plugin marketplace add- Seit Version
- 0.122
- Beschreibung
- Fügt eine Plugin-Marktplatz-Quelle hinzu
- Beispiel
codex plugin marketplace add https://github.com/org/marketplace
codex plugin marketplace list- Seit Version
- 0.122
- Beschreibung
- Listet konfigurierte Plugin-Marktplatz-Quellen
- Beispiel
codex plugin marketplace list
codex plugin marketplace upgrade- Seit Version
- 0.122
- Beschreibung
- Aktualisiert einen oder alle Plugin-Marktplätze
- Beispiel
codex plugin marketplace upgrade
codex plugin marketplace remove- Seit Version
- 0.122
- Beschreibung
- Entfernt eine Plugin-Marktplatz-Quelle
- Beispiel
codex plugin marketplace remove MARKETPLACE
codex queue- Seit Version
- 0.149
- Beschreibung
- Reiht eine Nachricht für eine bestehende lokale Session ein. Seit 0.166 nimmt
--resumeeine nicht geladene Session danach wieder auf. - Beispiel
codex queue --thread SESSION --message "Weiter mit den Tests"
codex remote-control- Seit Version
- 0.130
- Beschreibung
- Experimentell: Startet, stoppt oder koppelt den fernsteuerbaren App-Server-Daemon
- Beispiel
codex remote-control pair
codex remote-control start- Seit Version
- 0.131
- Beschreibung
- Startet den App-Server-Daemon mit aktivierter Fernsteuerung
- Beispiel
codex remote-control start
codex remote-control pair- Seit Version
- 0.131
- Beschreibung
- Erfordert einen laufenden Daemon und gibt einen kurzlebigen Kopplungscode aus
- Beispiel
codex remote-control pair
codex remote-control stop- Seit Version
- 0.131
- Beschreibung
- Beendet den App-Server-Daemon mit Fernsteuerung
- Beispiel
codex remote-control stop
codex resume- Seit Version
- 0.35
- Beschreibung
- Setzt eine interaktive Session über den Picker fort
- Beispiel
codex resume
codex review- Seit Version
- 0.65
- Beschreibung
- Führt ein nicht-interaktives Review von Änderungen, Branch oder Commit aus
- Beispiel
codex review --uncommitted
codex sandbox- Seit Version
- 0.45
- Beschreibung
- Führt Befehle in einer Codex-Sandbox aus
- Beispiel
codex sandbox -- npm test
codex sandbox uninstall- Seit Version
- 0.162
- Beschreibung
- Entfernt die systemweiten Konten und Netzwerkregeln der alten Windows-Sandbox. Als Administrator ausführen, nachdem nutzende Apps und gegebenenfalls der Provisionierungsdienst beendet sind. CODEX_HOME einschließlich Sandbox-Daten und Dateiberechtigungen bleibt erhalten.
- Beispiel
codex sandbox uninstall
codex unarchive- Seit Version
- 0.136
- Beschreibung
- Stellt eine archivierte Session wieder her
- Beispiel
codex unarchive SESSION
codex update- Seit Version
- 0.126
- Beschreibung
- Aktualisiert Codex auf die neueste Version
- Beispiel
codex update
codex mcp list- Seit Version
- 0.35
- Beschreibung
- Listet konfigurierte MCP-Server
- Beispiel
codex mcp list
codex exec review- Seit Version
- 0.65
- Beschreibung
- Führt ein Review mit den Ausgabeoptionen von exec aus
- Beispiel
codex exec review --uncommitted --json
codex features list- Seit Version
- 0.47
- Beschreibung
- Zeigt Feature Flags, Status und Reifegrad
- Beispiel
codex features list
codex features enable- Seit Version
- 0.93
- Beschreibung
- Aktiviert ein Feature dauerhaft
- Beispiel
codex features enable shell_snapshot
codex features disable- Seit Version
- 0.93
- Beschreibung
- Deaktiviert ein Feature dauerhaft
- Beispiel
codex features disable shell_snapshot
codex plugin add- Seit Version
- 0.131
- Beschreibung
- Installiert ein Plugin aus einem Marktplatz
- Beispiel
codex plugin add PLUGIN@MARKETPLACE
codex plugin list- Seit Version
- 0.131
- Beschreibung
- Listet installierte und verfügbare Plugins
- Beispiel
codex plugin list --json
codex plugin remove- Seit Version
- 0.131
- Beschreibung
- Entfernt ein installiertes Plugin
- Beispiel
codex plugin remove PLUGIN@MARKETPLACE
codex app-server daemon- Seit Version
- 0.131
- Beschreibung
- Verwaltet den lokalen Hintergrundserver
- Beispiel
codex app-server daemon version
codex app-server daemon bootstrap- Seit Version
- 0.131
- Beschreibung
- Installiert den Hintergrundserver für den automatischen Start
- Beispiel
codex app-server daemon bootstrap
codex app-server daemon start- Seit Version
- 0.131
- Beschreibung
- Startet den lokalen Hintergrundserver
- Beispiel
codex app-server daemon start
codex app-server daemon restart- Seit Version
- 0.131
- Beschreibung
- Startet den lokalen Hintergrundserver neu
- Beispiel
codex app-server daemon restart
codex app-server daemon update- Seit Version
- Nicht dokumentiert
- Beschreibung
- Aktualisiert ein vom Hintergrundserver verwaltetes Codex-Paket
- Beispiel
codex app-server daemon update --help
codex app-server daemon enable-remote-control- Seit Version
- 0.131
- Beschreibung
- Aktiviert die Fernsteuerung für den Hintergrundserver
- Beispiel
codex app-server daemon enable-remote-control
codex app-server daemon disable-remote-control- Seit Version
- 0.131
- Beschreibung
- Deaktiviert die Fernsteuerung für den Hintergrundserver
- Beispiel
codex app-server daemon disable-remote-control
codex app-server daemon stop- Seit Version
- 0.131
- Beschreibung
- Stoppt den lokalen Hintergrundserver
- Beispiel
codex app-server daemon stop
codex app-server daemon version- Seit Version
- 0.131
- Beschreibung
- Gibt die Version der lokalen CLI und des laufenden App-Servers als JSON aus
- Beispiel
codex app-server daemon version
codex app-server proxy- Seit Version
- 0.125
- Beschreibung
- Verbindet stdio mit dem Kontroll-Socket des lokalen Servers
- Beispiel
codex app-server proxy
codex app-server generate-ts- Seit Version
- 0.58
- Beschreibung
- Erzeugt TypeScript-Typen für das App-Server-Protokoll
- Beispiel
codex app-server generate-ts --out /tmp/codex-types
codex app-server generate-json-schema- Seit Version
- 0.58
- Beschreibung
- Erzeugt JSON-Schemas für das App-Server-Protokoll
- Beispiel
codex app-server generate-json-schema --out /tmp/codex-schema
codex help- Seit Version
- ≤ 0.2
- Beschreibung
- Zeigt die Hilfe eines Befehls
- Beispiel
codex help exec
codex migrate-nfs-db ersetzt konfigurierte Datenbanken und legt Sicherungen der WAL-Dateien an. Beende alle Codex- und SQLite-Clients auf sämtlichen Rechnern, die diese Datenbanken verwenden, und lasse sie bis zum erfolgreichen Abschluss beendet. Das Netzwerkdateisystem muss gemeinsame POSIX-Dateisperren unterstützen. Mit --staging-dir PFAD wählst du einen lokalen Arbeitsordner mit genügend Speicherplatz. Die Migration ist experimentell und für Netzwerkdateisysteme gedacht.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.3. codex exec: Flags für nicht-interaktive Ausführung
codex exec ist das Arbeitspferd für automatisierte Workflows. Lege Sandbox und Approval-Policy bewusst fest. So verhält sich ein Lauf in Skripten reproduzierbar und dein Zugriff bleibt nachvollziehbar.
# Standard-Pattern für automatisierte Ausführung
codex -a never exec -s workspace-write -m gpt-6.1-sol "dein Prompt"
# Mit höherer Reasoning-Tiefe
codex -a on-request exec -s workspace-write -m gpt-6.1-sol \
-c model_reasoning_effort='"xhigh"' "komplexe Aufgabe"
# Read-only für Analyse (keine Dateiänderungen)
codex exec -s read-only -m gpt-6-luna "Analysiere die Architektur"--worktree- Beschreibung
- Führt die Session in einem neuen verwalteten Git-Worktree aus
- Beispiel
codex exec --worktree "..."
--thread-source- Beschreibung
- Setzt die Herkunftskennung neuer oder geforkter Threads
- Beispiel
codex exec --thread-source automation "..."
--model, -m- Beschreibung
- Überschreibt das Modell aus der Konfiguration
- Beispiel
-m gpt-6.1-sol
--sandbox, -s- Beschreibung
- Sandbox-Modus: read-only, workspace-write oder danger-full-access
- Beispiel
-s workspace-write
Global: --ask-for-approval, -a- Beschreibung
- Legt on-request oder never fest und muss vor dem exec-Unterbefehl stehen
- Beispiel
codex -a on-request exec "..."
--cd, -C- Beschreibung
- Setzt das Arbeitsverzeichnis für den Agent
- Beispiel
-C /pfad/zum/projekt
--add-dir- Beschreibung
- Zusätzliche beschreibbare Verzeichnisse freigeben
- Beispiel
--add-dir ../backend
--image, -i- Beschreibung
- Hängt Bilder an den Prompt an (wiederholbar)
- Beispiel
-i screenshot.png
--config, -c- Beschreibung
- Überschreibt config.toml-Werte (TOML-Syntax)
- Beispiel
-c model_reasoning_effort='"xhigh"'
--profile, -p- Beschreibung
- Lädt ~/.codex/NAME.config.toml zusätzlich zur Basis-Konfiguration
- Beispiel
-p fast-profile
--enable / --disable- Beschreibung
- Aktiviert oder deaktiviert Feature Flag für diesen Lauf
- Beispiel
--enable shell_snapshot
--json- Beschreibung
- Gibt Events als JSONL aus (eine JSON-Zeile pro Event)
- Beispiel
codex exec --json "..."
--output-last-message, -o- Beschreibung
- Speichert letzte Agent-Nachricht in Datei
- Beispiel
-o /tmp/result.txt
--output-schema- Beschreibung
- JSON-Schema-Datei, die die finale Antwort beschränkt
- Beispiel
--output-schema schema.json
--ephemeral- Beschreibung
- Session wird nicht auf Disk persistiert
- Beispiel
codex exec --ephemeral "..."
--cyber-access-program- Beschreibung
- Wählt seit 0.161 ein experimentelles Cyber-Zugangsprogramm beim OpenAI-Provider. Werte sind standard, daybreak_blue und daybreak_red, abhängig von deiner Freigabe. Nicht mit Review kombinierbar; Fork benötigt einen Prompt.
- Beispiel
codex exec --cyber-access-program standard "..."
--skip-git-repo-check- Beschreibung
- Erlaubt Ausführung außerhalb eines Git-Repos
- Beispiel
codex exec --skip-git-repo-check "..."
--color- Beschreibung
- ANSI-Farben steuern: always, never, auto
- Beispiel
--color never
--oss- Beschreibung
- Nutzt einen lokalen Open-Source-Provider
- Beispiel
codex exec --oss "..."
--local-provider- Beschreibung
- Wählt mit --oss explizit LM Studio oder Ollama
- Beispiel
--oss --local-provider ollama
--strict-config- Beschreibung
- Bricht ab, wenn config.toml unbekannte Felder enthält
- Beispiel
codex exec --strict-config "..."
--ignore-user-config- Beschreibung
- Lädt die persönliche config.toml nicht, nutzt aber weiter die Anmeldung
- Beispiel
codex exec --ignore-user-config "..."
--ignore-rules- Beschreibung
- Lädt keine persönlichen oder Projekt-Exec-Policy-Regeln
- Beispiel
codex exec --ignore-rules "..."
--dangerously-bypass-approvals-and-sandbox, --yolo- Beschreibung
- Umgeht Genehmigungen und Sandbox vollständig. Nur in einer extern gehärteten Umgebung verwenden.
- Beispiel
codex exec --yolo "..."
--approve-for-me- Beschreibung
- Leitet Genehmigungsanfragen über eine automatische Review mit workspace-write-Sandbox weiter
- Beispiel
codex exec --approve-for-me "..."
--dangerously-bypass-hook-trust- Beschreibung
- Führt aktivierte Hooks ohne gespeichertes Vertrauen aus. Nur für bereits geprüfte Automatisierung.
- Beispiel
codex exec --dangerously-bypass-hook-trust "..."
--yolo ist ein Alias für --dangerously-bypass-approvals-and-sandbox. Er umgeht Genehmigungen und Sandbox vollständig. Nutze ihn nur innerhalb einer extern gehärteten Umgebung.3.1 Häufige Muster
# Bilder anhängen (Screenshots, Design-Specs)
codex exec -s workspace-write -m gpt-6.1-sol -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 oder LM Studio)
codex exec --oss --local-provider ollama -s workspace-write "Erkläre diese Funktion"
# Konfiguration vor einem automatisierten Lauf strikt prüfen
codex exec --strict-config -s workspace-write "Prüfe die Konfiguration"4. Code Review
codex review analysiert Codeänderungen nicht-interaktiv und gibt die Ergebnisse auf stdout aus. Dateien werden dabei nicht verändert.
Wähle entweder --uncommitted, --base, --commit oder einen eigenen Prompt. Diese Ziele lassen sich nicht kombinieren. --title gehört zu --commit.
--strict-config- Beschreibung
- Bricht bei unbekannten config.toml-Feldern ab
- Beispiel
codex review --strict-config --uncommitted
--uncommitted- Beschreibung
- Reviewed staged, unstaged und untracked Changes
- Beispiel
codex review --uncommitted
--base- Beschreibung
- Reviewed Änderungen gegen einen Base-Branch
- Beispiel
codex review --base main
--commit- Beschreibung
- Reviewed einen spezifischen Commit
- Beispiel
codex review --commit abc123
--title- Beschreibung
- Zusätzlicher Titel, nur zusammen mit --commit
- Beispiel
codex review --commit abc123 --title "Auth hinzufügen"
PROMPT- Beschreibung
- Benutzerdefinierte Review-Anweisungen (auch via stdin mit -)
- Beispiel
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 eines Commits mit Titel
codex review --commit abc123 --title "Auth hinzufügen"
# Review mit benutzerdefiniertem Fokus
codex review "Fokus auf Sicherheit"
# Review per exec mit JSON-Output
codex exec review --uncommitted --json5. Session-Management
Codex speichert nicht-ephemere Sessions lokal. Du kannst sie fortsetzen, forken, archivieren 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 -s workspace-write -m gpt-6.1-sol resume --last \
"Füge jetzt Error Handling hinzu"
# Spezifische Session per UUID fortsetzen
codex exec -s workspace-write -m gpt-6.1-sol resume SESSION_ID \
"Setze den Plan um"
# Session forken (neuer Thread basierend auf bestehendem Kontext)
codex fork --last
# Nicht-interaktiv forken (Session-ID erforderlich)
codex exec -s workspace-write fork SESSION_ID "Probiere einen anderen Ansatz"
# Session archivieren oder wiederherstellen
codex archive SESSION
codex unarchive SESSION
# Session endgültig löschen
codex delete SESSION# Neuesten Diff eines Cloud-Tasks 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 2--ephemeral gestartete Sessions werden nicht auf der Festplatte gespeichert. Nutze das für schnelle Einmal-Fragen, bei denen du keinen Verlauf brauchst.6. Codex Cloud
Codex Cloud arbeitet mit Remote-Umgebungen. Ohne Unterbefehl öffnet codex cloud einen Picker. codex cloud exec reicht eine Aufgabe direkt ein. Dafür ist --env Pflicht.
--env- Beschreibung
- Pflichtangabe: Ziel-Umgebungs-ID für den Cloud-Task
- Beispiel
--env ENV_ID
--attempts- Beschreibung
- Anzahl Versuche (1 bis 4), Standard: 1
- Beispiel
--attempts 3
--branch- Beschreibung
- Git-Branch, auf dem der Task laufen soll
- Beispiel
--branch feature/auth
--json- Beschreibung
- Maschinenlesbare JSON-Ausgabe (für codex cloud list)
- Beispiel
codex cloud list --json
--limit- Beschreibung
- Maximale Anzahl zurückgegebener Tasks (1-20)
- Beispiel
codex cloud list --limit 5
--cursor- Beschreibung
- Paginierungs-Cursor vom vorherigen Aufruf
- Beispiel
codex cloud list --cursor CURSOR
--attempt- Beschreibung
- Versuchsnummer für diff/apply (bei --attempts N)
- Beispiel
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 einem bestimmten Branch ausführen
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 27. App-Server und Remote-Steuerung
App-Server, Remote-Verbindungen und Remote-Control sind experimentell. Sie eignen sich für fortgeschrittene Setups und können sich zwischen Releases ändern. Für die tägliche Arbeit brauchst du sie nicht.
# App-Server mit WebSocket-Endpunkt starten
codex app-server --listen ws://127.0.0.1:4500
# TUI mit einem App-Server verbinden
codex --remote ws://127.0.0.1:4500
# Modellkatalog und lokale Installation diagnostizieren
codex debug models --bundled
codex doctor --summary
# Nur Konfiguration, Netzwerk und WebSocket prüfen
codex doctor --network-onlyFür die Kopplung muss der Daemon laufen. Lass ihn aktiv, solange du die Remote-Verbindung verwendest. Beende ihn erst danach in einem separaten Schritt.
codex remote-control start
codex remote-control paircodex remote-control stop8. Sandbox-Modi
Laut OpenAIs Sicherheitsdokumentation beschränkt die Sandbox, was Codex auf deinem System tun darf. Du setzt den Modus mit -s oder --sandbox.
Die Tabelle beschreibt modellgenerierte Shell-Befehle. Netzwerkanfragen sind in read-only und workspace-write standardmäßig gesperrt, lassen sich für den Workspace-Modus aber ausdrücklich freigeben. Websuche, MCP-Server und verbundene Apps haben eigene Zugriffspfade. Zusätzliche Schreibpfade setzt du mit --add-dir; geschützte Verzeichnisse wie .git können trotzdem schreibgeschützt bleiben.
read-only- Lesen
- Gemäß Lese-Policy
- Schreiben
- Nirgends
- Netzwerk
- Standardmäßig gesperrt
- Wann nutzen?
- Fragen, Erklärungen, Code-Analyse
workspace-write- Lesen
- Gemäß Lese-Policy
- Schreiben
- Workspace, freigegebene Pfade und temporäre Verzeichnisse
- Netzwerk
- Standardmäßig gesperrt
- Wann nutzen?
- Standard für die meisten Aufgaben
danger-full-access- Lesen
- Nach Betriebssystemrechten
- Schreiben
- Überall
- Netzwerk
- Ja
- Wann nutzen?
- 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 aktuellen Codex-Sandbox ausführen
codex sandbox -- npm test
# Mit Log der verweigerten Zugriffe (macOS)
codex sandbox --log-denials -- ./build.sh
# Mit Projektordner als Arbeitsverzeichnis
codex sandbox -C apps/frontend -- npm test9. Approval Policies
Approval Policies steuern, wann Codex um Erlaubnis fragt, bevor ein Befehl ausgeführt wird. Den Modus setzt du mit dem globalen Flag -a oder --ask-for-approval vor dem Unterbefehl, zum Beispiel mit codex -a on-request exec.
on-request- Modell entscheidet, wann es um Erlaubnis fragt
never- Fragt nie nach Genehmigung, Fehler gehen direkt ans Modell zurück
/permissions. Die dort angebotenen Presets kombinieren Sandbox und Genehmigungen. --approve-for-me nutzt eine automatische Prüfung von Genehmigungsanfragen und die Workspace-Sandbox.10. 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 -- node /pfad/zum/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-servercodex mcp-server wurde in Version 0.154.0 entfernt. Für eigene Integrationen gibt es das App-Server-Protokoll über codex app-server. Das ist eine andere Schnittstelle und kein MCP-Server.11. Slash-Commands der CLI
In der interaktiven TUI (gestartet mit codex) öffnet / im Composer die Befehlsliste. Während ein Task läuft, kannst du unterstützte Slash-Commands mit Tab in die Warteschlange stellen.
Die Tabelle zeigt die Befehle der CLI-TUI, ihre Parameter und ihre Einführungsversion. Die Desktop-App hat eine eigene Befehlsauswahl, die du ebenfalls mit / öffnest.
OpenAIs CLI-Referenz nennt zusätzlich /fast für Modelle mit einer verfügbaren Fast-Stufe. Er gehört nicht zur festen Befehlsliste. Codex erzeugt ihn aus dem Modellkatalog und zeigt ihn nur, wenn das aktuelle Modell eine Fast-Stufe anbietet. Deshalb fehlt er in der Tabelle.
Die Versionsangaben folgen derselben Rust-Release-Historie wie die CLI-Übersicht. Bei Umbenennungen wie /autoreview zu /approve zählt die Version mit dem neuen Namen. Aliase stehen beim Hauptbefehl und können später hinzugekommen sein.
/agents- Parameter
- Seit Version
- 0.149
- Beschreibung
- Zeigt und wechselt zwischen allen aktiven Agent-Sessions
/app- Parameter
- Seit Version
- 0.138
- Beschreibung
- Öffnet die aktuelle Session in der Desktop-App
/approve- Parameter
- Seit Version
- 0.129
- Beschreibung
- Genehmigt einen Wiederholungsversuch nach einer Auto-Review-Ablehnung
/apps- Parameter
- Seit Version
- 0.93
- Beschreibung
- Zeigt und verwaltet verbundene Apps
/archive- Parameter
- Seit Version
- 0.136
- Beschreibung
- Archiviert die aktuelle Session und beendet Codex
/cd- Parameter
- Pfad optional
- Seit Version
- 0.149
- Beschreibung
- Wechselt das aktuelle Arbeitsverzeichnis
/clear- Parameter
- Name optional
- Seit Version
- 0.105
- Beschreibung
- Leert das Terminal und startet einen neuen Chat
/compact- Parameter
- Seit Version
- 0.11
- Beschreibung
- Fasst die sichtbare Unterhaltung zusammen und schafft Kontextplatz
/config- Parameter
- Seit Version
- 0.163
- Beschreibung
- Öffnet die Suche für Einstellungen und ändert unterstützte Optionen direkt
/copy- Parameter
- Seit Version
- 0.105
- Beschreibung
- Kopiert die letzte Antwort oder einen Teil davon (auch
Ctrl+O)
/daemon- Parameter
- Seit Version
- 0.156
- Beschreibung
- Verwaltet den lokalen Hintergrundserver
/daybreak- Parameter
- Seit Version
- 0.161
- Beschreibung
- Schaltet Daybreak um. Erfordert
--enable cli_daybreak, einen freigeschalteten ChatGPT-Account beim OpenAI-Provider und unterstützte Modelle.
/debug-config- Parameter
- Seit Version
- 0.97
- Beschreibung
- Zeigt Konfigurations-Layer und Anforderungsdiagnose
/delete- Parameter
- Seit Version
- 0.140
- Beschreibung
- Löscht die aktuelle Session und ihre Unter-Sessions dauerhaft
/diff- Parameter
- Seit Version
- ≤ 0.2
- Beschreibung
- Zeigt das Git-Diff einschließlich nicht getrackter Dateien
/exit- Parameter
- Seit Version
- 0.53
- Beschreibung
- Beendet die CLI (Alias
/quit)
/experimental- Parameter
- Seit Version
- 0.74
- Beschreibung
- Schaltet experimentelle Features ein oder aus
/export- Parameter
- Zielpfad optional
- Seit Version
- 0.148
- Beschreibung
- Exportiert die Unterhaltung als Markdown
/feedback- Parameter
- Seit Version
- 0.47
- Beschreibung
- Sendet Diagnose-Logs an die Codex-Maintainer
/fork- Parameter
- Name optional
- Seit Version
- 0.81
- Beschreibung
- Verzweigt die aktuelle Unterhaltung in einen neuen Chat
/goal- Parameter
Ziel | edit | pause | resume | clear- Seit Version
- 0.126
- Beschreibung
- Setzt, bearbeitet, pausiert oder entfernt ein Aufgabenziel
/hooks- Parameter
- Seit Version
- 0.129
- Beschreibung
- Zeigt und verwaltet Lifecycle-Hooks
/ide- Parameter
- Text optional
- Seit Version
- 0.129
- Beschreibung
- Bindet offene Dateien, Auswahl und IDE-Kontext ein
/import- Parameter
- Seit Version
- 0.140
- Beschreibung
- Importiert unterstützte Claude-Code- oder Cursor-Setups, Projekte und Chats
/init- Parameter
- Seit Version
- 0.14
- Beschreibung
- Generiert ein AGENTS.md-Gerüst für den Projektkontext
/keymap- Parameter
debug- Seit Version
- 0.126
- Beschreibung
- Belegt die TUI-Tastenkürzel neu oder zeigt ihre Diagnose
/logout- Parameter
- Seit Version
- 0.15
- Beschreibung
- Meldet dich von Codex ab
/mcp- Parameter
verbose | login <name>- Seit Version
- 0.23
- Beschreibung
- Listet MCP-Tools auf,
verbosezeigt Details./mcp login <name>startet seit 0.161 die Anmeldung beim Server aus einer aktiven Session.
/memories- Parameter
- Seit Version
- 0.121
- Beschreibung
- Konfiguriert Nutzung und Generierung von Memories
/mention- Parameter
- Seit Version
- 0.21
- Beschreibung
- Öffnet die Dateisuche für eine Erwähnung im Prompt
/model- Parameter
- [Modell] [--reasoning=<Stufe>] [--speed=<Tarif>]
- Seit Version
- 0.23
- Beschreibung
- Wählt das aktive Modell und, falls verfügbar, den Reasoning-Effort
/new- Parameter
- Name optional
- Seit Version
- ≤ 0.2
- Beschreibung
- Startet einen neuen Chat in derselben CLI-Session
/permissions- Parameter
- [Profil]
- Seit Version
- 0.89
- Beschreibung
- Legt fest, was Codex ohne Nachfrage tun darf
/pets- Parameter
ID | off- Seit Version
- 0.131
- Beschreibung
- Wählt oder versteckt ein Terminal-Haustier (Alias
/pet)
/plan- Parameter
- Prompt optional
- Seit Version
- 0.93
- Beschreibung
- Wechselt in den Plan-Modus
/plugins- Parameter
- Seit Version
- 0.117
- Beschreibung
- Durchsucht installierte und verfügbare Plugins
/presets- Parameter
- Seit Version
- 0.164
- Beschreibung
- Wählt und verwaltet bis zu zehn wiederverwendbare Prompts und Slash-Commands
/ps- Parameter
- Seit Version
- 0.76
- Beschreibung
- Zeigt Hintergrund-Terminals und ihre jüngste Ausgabe
/pwd- Parameter
- Seit Version
- 0.149
- Beschreibung
- Zeigt das aktuelle Arbeitsverzeichnis (Alias
/cwd)
/raw- Parameter
on | off- Seit Version
- 0.129
- Beschreibung
- Schaltet den Raw-Scrollback-Modus um
/recap- Parameter
- Seit Version
- 0.151
- Beschreibung
- Fasst die aktuelle Unterhaltung zusammen
/rename- Parameter
- Name optional
- Seit Version
- 0.93
- Beschreibung
- Benennt den aktuellen Chat um
/resume- Parameter
- ID oder Name optional
- Seit Version
- 0.65
- Beschreibung
- Lädt eine gespeicherte Session direkt oder über den Session-Picker
/review- Parameter
- Anweisungen optional
- Seit Version
- 0.39
- Beschreibung
- Öffnet die Review-Auswahl oder prüft mit eigenen Anweisungen
/setup-default-sandbox- Parameter
- Seit Version
- 0.100
- Beschreibung
- Richtet die erhöhte Standard-Sandbox ein (nur Windows)
/side- Parameter
- Text optional
- Seit Version
- 0.122
- Beschreibung
- Startet eine kurzlebige Nebenunterhaltung in einer temporären Verzweigung (Alias
/btw)
/skills- Parameter
- Seit Version
- 0.65
- Beschreibung
- Durchsucht und nutzt Skills
/status- Parameter
- Seit Version
- 0.14
- Beschreibung
- Zeigt Modell, Approval-Policy, beschreibbare Pfade und Token-Nutzung
/statusline- Parameter
- [<Element...> | --clear] [--colors|--no-colors]
- Seit Version
- 0.99
- Beschreibung
- Konfiguriert die Felder der TUI-Statuszeile
/stop- Parameter
- Seit Version
- 0.115
- Beschreibung
- Stoppt alle Hintergrund-Terminals (Alias
/clean)
/subagents- Parameter
- Seit Version
- 0.115
- Beschreibung
- Wechselt zwischen den Subagents dieser Session
/theme- Parameter
- Seit Version
- 0.105
- Beschreibung
- Wählt ein Syntax-Highlighting-Theme
/title- Parameter
- [<Element...> | --clear]
- Seit Version
- 0.117
- Beschreibung
- Konfiguriert die Elemente im Terminal-Titel
/tui- Parameter
- Seit Version
- 0.156
- Beschreibung
- Wählt den Terminal-Renderer für den nächsten Start
/usage- Parameter
daily | weekly | cumulative- Seit Version
- 0.140
- Beschreibung
- Zeigt die Token-Nutzung oder löst einen Rate-Limit-Reset ein
/vim- Parameter
- Seit Version
- 0.129
- Beschreibung
- Schaltet den Vim-Modus für den Composer um
/voice- Parameter
settings | mute | stop- Seit Version
- 0.155
- Beschreibung
- Schaltet den Sprachmodus um, öffnet Einstellungen oder schaltet das Mikrofon stumm.
/voice settingsbietet seit 0.161 auch Mikrofon und Lautsprecher zur Auswahl. Bei Mikrofonen mit mindestens drei Eingangskanälen kannst du die Kanäle zum Mischen wählen.
/warnings- Parameter
- Seit Version
- 0.156
- Beschreibung
- Zeigt gespeicherte Warnungen und Diagnosedetails
/worktree- Parameter
- Seit Version
- 0.154
- Beschreibung
- Startet oder setzt eine Unterhaltung in einem neuen Git-Worktree fort
12. Tastenkürzel: CLI (TUI)
Diese Shortcuts funktionieren in der interaktiven Terminal-Oberfläche (gestartet mit codex). Mit /keymap kannst du die Belegung anpassen.
Ctrl+C- Beschreibung
- Bricht aktuelle Ausführung ab
- Kontext
- Während der Agent arbeitet
Ctrl+D- Beschreibung
- Beendet die CLI
- Kontext
- Bei leerem Input-Buffer
Ctrl+G- Beschreibung
- Öffnet externen Editor (VISUAL oder EDITOR)
- Kontext
- Für lange Prompts
Ctrl+L- Beschreibung
- Löscht den Bildschirm (ohne neuen Chat zu starten)
- Kontext
- Wenn das Terminal zu voll wird
Ctrl+O- Beschreibung
- Kopiert letzte Antwort in die Zwischenablage
- Kontext
- Nach einer Antwort
Ctrl+R- Beschreibung
- Rückwärtssuche in der Prompt-History
- Kontext
- Im Composer
Alt+,- Beschreibung
- Senkt die Reasoning-Tiefe
- Kontext
- Während der Session
Alt+.- Beschreibung
- Erhöht die Reasoning-Tiefe
- Kontext
- Während der Session
Up / Down- Beschreibung
- Navigiert durch die Draft-History im Composer
- Kontext
- Im Eingabefeld
Tab- Beschreibung
- Reiht Follow-up-Text, Slash-Commands oder Shell-Befehle in die Warteschlange ein
- Kontext
- Während der Agent arbeitet
Esc + Esc- Beschreibung
- Bearbeitet vorherige Nutzernachricht
- Kontext
- Im Composer
@- Beschreibung
- Fuzzy-Dateisuche zum Anhängen von Dateien
- Kontext
- Im Eingabefeld
!- Beschreibung
- Führt Shell-Befehl direkt aus
- Kontext
- Am Anfang der Eingabe
13. Tastenkürzel: Codex App
Die Desktop-App (gestartet mit codex app) hat eigene Tastenkürzel. Die Tabelle zeigt die macOS-Belegung. Viele Cmd-Kürzel verwenden auf Windows Ctrl, andere unterscheiden sich. Die vollständigen Plattformlisten stehen in der OpenAI-Referenz. Eigene Belegungen findest du unter „Einstellungen > Tastenkürzel“.
Cmd+/- Beschreibung
- Tastenkürzel öffnen
Ctrl+`- Beschreibung
- Terminal ein-/ausblenden
Ctrl+Shift+G- Beschreibung
- Review-Tab öffnen
Ctrl+Shift+M- Beschreibung
- Modellauswahl öffnen
Ctrl+Shift+V- Beschreibung
- Sprachchat starten, wenn verfügbar
Cmd+Shift+A- Beschreibung
- Chat archivieren
Cmd+Shift+P / Cmd+K- Beschreibung
- Öffnet die Command-Palette
Cmd+,- Beschreibung
- Öffnet die Einstellungen
Cmd+O- Beschreibung
- Öffnet Ordner
Cmd+N / Cmd+Shift+O- Beschreibung
- Neuer Thread
Cmd+F- Beschreibung
- Suche im Thread
Cmd+B- Beschreibung
- Sidebar ein-/ausblenden
Cmd+Option+B- Beschreibung
- Zwischen Chat und geöffneten Tabs wechseln
Cmd+J- Beschreibung
- Unteres Panel ein-/ausblenden
Cmd+Shift+[ / ]- Beschreibung
- Zum vorherigen / nächsten Thread wechseln
Cmd+[ / ]- Beschreibung
- Zurück / vorwärts navigieren
Cmd++ / Cmd+-- Beschreibung
- Schriftgröße vergrößern / verkleinern
Ctrl+L- Beschreibung
- Terminal löschen
Ctrl+Shift+D- Beschreibung
- Diktat starten, wenn verfügbar
codex://-Schema, z. B. codex://settings für Einstellungen oder codex://threads/new?prompt=dein%20prompt für einen neuen Chat mit vorausgefülltem Composer. Der Prompt wird dadurch nicht automatisch gesendet.14. Konfiguration (config.toml)
Laut Konfigurationsdokumentation liegt die Basiskonfiguration unter ~/.codex/config.toml. Seit Version 0.134.0 liegen benannte Profile in eigenen Dateien wie ~/.codex/quick.config.toml. --profile quick lädt diese Datei über die Basiswerte. Die frühere Struktur [profiles.quick] gehört nicht mehr in deine Konfiguration.
model- Beschreibung
- Standard-Modell für alle Sessions
- Mögliche Werte
"gpt-6.1-sol"oder"gpt-6-luna", abhängig von deinem Zugang
model_reasoning_effort- Beschreibung
- Reasoning-Tiefe für komplexe Aufgaben
- Mögliche Werte
"xhigh","high","medium","low"
personality- Beschreibung
- Veraltet: friendly und pragmatic ändern den Stil nicht mehr
- Mögliche Werte
"pragmatic","friendly","none"
web_search- Beschreibung
- Modus für die Web-Suche
- Mögliche Werte
"cached"(Standard),"live","disabled"
# ~/.codex/config.toml
# Standard-Settings
model = "gpt-6.1-sol"
model_reasoning_effort = "high"
# Projekt-Vertrauenslevel
[projects."/pfad/zum/projekt"]
trust_level = "trusted"model = "gpt-6-luna"
model_reasoning_effort = "low"model = "gpt-6.1-sol"
model_reasoning_effort = "high"# Einzelnen Wert überschreiben
codex exec -s workspace-write -c model='"gpt-6.1-sol"' "Aufgabe"
# Netzwerkzugriff für Shell-Befehle in workspace-write erlauben
codex exec -s workspace-write \
-c sandbox_workspace_write.network_access=true "Aufgabe"
# Profil per -p laden
codex exec -s workspace-write -p quick "Schnelle Frage"15. 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 shell_snapshot
codex features disable shell_snapshot
# Nur für diesen Lauf aktivieren (nicht persistent)
codex exec -s workspace-write --enable shell_snapshot \
--json "Aufgabe"16. Globale Flags
Diese Startoptionen steuern die interaktive CLI und, je nach Unterbefehl, weitere Läufe. Mit codex help BEFEHL prüfst du, welche Optionen ein konkreter Unterbefehl annimmt.
--worktree- Beschreibung
- Startet in einem neuen verwalteten Git-Worktree
- Beispiel
codex --worktree
--no-daemon- Beschreibung
- Startet ohne gemeinsamen Hintergrundserver
- Beispiel
codex --no-daemon
--approve-for-me, --not-so-yolo- Beschreibung
- Prüft Genehmigungsanfragen automatisch mit der Workspace-Sandbox; nicht mit --sandbox oder --yolo kombinierbar
- Beispiel
codex --approve-for-me
--profile, -p- Beschreibung
- Lädt ein benanntes Profil aus NAME.config.toml
- Beispiel
codex -p thorough
--cd, -C- Beschreibung
- Setzt den Arbeitsordner
- Beispiel
codex -C /path/to/project
--add-dir- Beschreibung
- Erlaubt weitere Schreibpfade
- Beispiel
codex --add-dir ../backend
--image, -i- Beschreibung
- Hängt Bilder an den ersten Prompt an
- Beispiel
codex -i screenshot.png
--config, -c- Beschreibung
- Überschreibt config.toml-Werte. Gepunktete Pfade für Verschachtelung. Werte werden als TOML geparst.
- Beispiel
-c model_reasoning_effort='"high"'
--enable- Beschreibung
- Aktiviert ein Feature Flag für diesen Lauf (wiederholbar)
- Beispiel
codex --enable shell_snapshot
--disable- Beschreibung
- Deaktiviert ein Feature Flag für diesen Lauf (wiederholbar)
- Beispiel
codex --disable shell_snapshot
--model, -m- Beschreibung
- Wählt ein Modell für den aktuellen Lauf
- Beispiel
codex -m gpt-6.1-sol
--oss- Beschreibung
- Nutzt einen lokalen Open-Source-Modell-Provider
- Beispiel
codex --oss --local-provider ollama
--local-provider- Beschreibung
- Wählt für --oss LM Studio oder Ollama, sofern nicht bereits konfiguriert
- Beispiel
codex --oss --local-provider ollama
--remote- Beschreibung
- Verbindet TUI, agents, queue, resume, fork sowie Session-Archivierung, -Löschung und -Wiederherstellung mit einem App-Server über WebSocket oder Unix-Socket
- Beispiel
codex --remote ws://127.0.0.1:4500
--remote-auth-token-env- Beschreibung
- Liest für --remote einen Bearer-Token aus einer Umgebungsvariable. Nur mit --remote und über wss:// oder loopback ws://
- Beispiel
--remote-auth-token-env CODEX_REMOTE_TOKEN
--sandbox, -s- Beschreibung
- Wählt read-only, workspace-write oder danger-full-access
- Beispiel
-s workspace-write
--ask-for-approval, -a- Beschreibung
- Legt die Genehmigungs-Policy on-request oder never fest
- Beispiel
codex -a on-request
--search- Beschreibung
- Schaltet von der standardmäßigen gecachten auf Live-Websuche um
- Beispiel
codex --search "Prüfe die aktuelle Dokumentation"
--no-alt-screen- Beschreibung
- Startet die TUI im Inline-Modus und erhält den Terminal-Scrollback
- Beispiel
codex --no-alt-screen
--strict-config- Beschreibung
- Bricht bei unbekannten config.toml-Feldern ab
- Beispiel
codex --strict-config
--dangerously-bypass-approvals-and-sandbox, --yolo- Beschreibung
- Umgeht Genehmigungen und Sandbox. Ausschließlich innerhalb einer extern gehärteten Umgebung.
- Beispiel
codex --yolo "..."
--dangerously-bypass-hook-trust- Beschreibung
- Lässt aktivierte Hooks ohne gespeichertes Vertrauen laufen. Nur für bereits geprüfte Automatisierung.
- Beispiel
codex --dangerously-bypass-hook-trust "..."
--help, -h- Beschreibung
- Zeigt Hilfe an
- Beispiel
codex --help
--version, -V- Beschreibung
- Zeigt Versionsnummer an
- Beispiel
codex --version
17. Fehlerbehebung
- Wahrscheinliche Ursache
- Veralteter Token oder falscher API-Key
- Lösung
- codex logout, dann codex login erneut ausführen
- Wahrscheinliche Ursache
- Die Approval-Policy verlangt in einer unbeaufsichtigten Umgebung eine Bestätigung
- Lösung
- Für kontrollierte Automatisierung -s workspace-write und bewusst -a never setzen
- Wahrscheinliche Ursache
- Netzwerkzugriff oder Schreibzugriff außerhalb des Arbeitsverzeichnisses
- Lösung
- Zuerst --add-dir für weitere Schreibpfade prüfen. danger-full-access nur bewusst einsetzen
- Wahrscheinliche Ursache
- Fehlende Dependencies oder falscher Pfad
- Lösung
- codex mcp get server-name prüfen, dann remove und neu add
- Wahrscheinliche Ursache
- Session wurde mit --ephemeral gestartet
- Lösung
- Ohne --ephemeral neu starten, damit Sessions gespeichert werden
- Wahrscheinliche Ursache
- Task läuft noch oder ist fehlgeschlagen
- Lösung
- codex cloud status TASK_ID prüfen, dann erneut versuchen
- Wahrscheinliche Ursache
- Veraltete oder unbekannte Felder in config.toml
- Lösung
- codex --strict-config und codex doctor --summary ausführen
# 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 check --rules rules.rules -- npm test
# Sandbox-Denials loggen (Debugging)
codex sandbox --log-denials -- ./build.sh





