Zum Hauptinhalt springen

Codex Befehle: Die komplette Liste aller Commands

Codex CLI Befehle und Slash-Commands mit Einführungsversionen. Dazu Flags, Tastenkürzel und Beispiele für Sessions, Plugins und Cloud-Aufgaben.

FHFinn Hillebrandt
KI-Programmierung
Codex Befehle: Die komplette Liste aller Commands
Mit * gekennzeichnete Links sind Affiliate-Links. Kommt über solche Links ein Kauf zustande, bekommen wir eine Provision.

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.

TL;DRDas Wichtigste in Kürze
  • 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
# Installation per npm
npm install -g @openai/codex

# Oder per Homebrew
brew install --cask codex
Authentifizierung
# 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
Codex starten
# 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

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-only die 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 --resume eine 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
Quellen: OpenAI CLI-Referenz
gradually.ai

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.

Empfohlenes Muster für nicht-interaktive Ausführung
# 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 "..."

3.1 Häufige Muster

codex exec Beispiele
# 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"
Code Review Beispiele
# 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 --json

5. Session-Management

Codex speichert nicht-ephemere Sessions lokal. Du kannst sie fortsetzen, forken, archivieren oder nicht-interaktiv wieder aufnehmen.

Sessions fortsetzen
# 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
Diffs anwenden
# 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

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
Codex Cloud Beispiele
# 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 2

7. 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.

Experimentelle Remote-Befehle
# 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-only

Für die Kopplung muss der Daemon laufen. Lass ihn aktiv, solange du die Remote-Verbindung verwendest. Beende ihn erst danach in einem separaten Schritt.

Remote-Control starten und koppeln
codex remote-control start
codex remote-control pair
Remote-Control später beenden
codex remote-control stop

8. 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:

Sandbox-Utility
# 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 test

9. 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

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.

MCP-Server verwalten
# 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-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, verbose zeigt 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 settings bietet 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
Quellen: OpenAI CLI-Referenz
gradually.ai

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

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"
Basiskonfiguration: ~/.codex/config.toml
# ~/.codex/config.toml

# Standard-Settings
model = "gpt-6.1-sol"
model_reasoning_effort = "high"

# Projekt-Vertrauenslevel
[projects."/pfad/zum/projekt"]
trust_level = "trusted"
Schnelles Profil: ~/.codex/quick.config.toml
model = "gpt-6-luna"
model_reasoning_effort = "low"
Gründliches Profil: ~/.codex/thorough.config.toml
model = "gpt-6.1-sol"
model_reasoning_effort = "high"
Runtime-Overrides mit -c
# 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.

Feature Flags verwalten
# 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

Authentifizierung schlägt fehl
Wahrscheinliche Ursache
Veralteter Token oder falscher API-Key
Lösung
codex logout, dann codex login erneut ausführen
Codex hängt bei codex exec
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
Befehl wird in Sandbox blockiert
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
MCP-Server verbindet nicht
Wahrscheinliche Ursache
Fehlende Dependencies oder falscher Pfad
Lösung
codex mcp get server-name prüfen, dann remove und neu add
Session lässt sich nicht fortsetzen
Wahrscheinliche Ursache
Session wurde mit --ephemeral gestartet
Lösung
Ohne --ephemeral neu starten, damit Sessions gespeichert werden
Cloud-Task zeigt keinen Diff
Wahrscheinliche Ursache
Task läuft noch oder ist fehlgeschlagen
Lösung
codex cloud status TASK_ID prüfen, dann erneut versuchen
Codex startet nach einem Update nicht mehr
Wahrscheinliche Ursache
Veraltete oder unbekannte Felder in config.toml
Lösung
codex --strict-config und codex doctor --summary ausführen
Debug-Befehle
# 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

Häufig gestellte Fragen

Die Installation ist kostenlos, Codex CLI ist Open Source. Für die Nutzung meldest du dich mit deinem ChatGPT-Account oder, nach zusätzlicher Einrichtung, mit einem API-Key an. Was dein Plan einschließt oder welche API-Kosten anfallen, steht auf der aktuellen OpenAI-Preis- und Planseite.

Codex CLI startest du im Terminal und steuerst es über Befehle und Flags. Die Codex App ist eine Desktop-Anwendung mit grafischer Oberfläche. Befehle, Einstellungen, Integrationen und Funktionen sind nicht vollständig identisch.

codex startet eine interaktive Sitzung im Terminal. codex exec führt eine Aufgabe ohne interaktive Rückfragen aus und schreibt die Ausgabe ins Terminal. Mit --json bekommst du stattdessen zeilengetrenntes JSON, das sich für Skripte und CI-Pipelines eignet.

Mit /exit (Alias /quit) oder mit Ctrl+D bei leerem Eingabefeld beendest du die CLI. Ctrl+C bricht die laufende Ausführung ab, während der Agent arbeitet.

/btw ist ein Alias für /side. Der Befehl startet eine kurzlebige Nebenunterhaltung in einer temporären Verzweigung, optional mit direktem Text.

In der interaktiven TUI tippst du /resume oder startest codex resume im Terminal. Nicht-interaktiv nutzt du codex exec resume --last gefolgt von deinem neuen Prompt. Mit --ephemeral gestartete Sessions werden nicht gespeichert. Mit codex archive räumst du den Picker auf, codex unarchive stellt eine Session wieder her, codex delete entfernt sie dauerhaft.

Die Sandbox regelt, was Codex über Shell-Befehle lesen und ändern darf. read-only blockiert Schreibzugriffe. workspace-write erlaubt Änderungen im Arbeitsbereich, in freigegebenen Pfaden und in temporären Verzeichnissen. In beiden Modi ist Netzwerkzugriff standardmäßig gesperrt, in workspace-write lässt er sich freigeben. danger-full-access hebt die Codex-Sandbox auf, Betriebssystemrechte gelten weiter. Websuche, Apps und MCP haben eigene Richtlinien.

Ja. Ein typischer Aufruf ist codex -a never exec -s workspace-write mit deinem Auftrag. -a never verhindert Bestätigungsdialoge, workspace-write begrenzt Codex auf den Arbeitsbereich. Nutze einen isolierten Runner, der nur vertrauenswürdigen Code ausführt, und hinterlege den API-Key als geschütztes CI-Geheimnis. Mit --json erhältst du zeilengetrennte JSON-Ereignisse, --skip-git-repo-check brauchst du nur außerhalb eines Git-Repositories.
FH

Finn Hillebrandt

KI-Experte & Blogger

Finn Hillebrandt ist der Gründer von Gradually AI, SEO- und KI-Experte. Er hilft Online-Unternehmern, ihre Prozesse und ihr Marketing mit KI zu vereinfachen und zu automatisieren. Finn teilt sein Wissen hier auf dem Blog in 50+ Fachartikeln sowie über den KI Business Club.

Erfahre mehr über Finn und das Team, folge Finn bei LinkedIn, tritt seiner Facebook-Gruppe zu ChatGPT, OpenAI & KI-Tools bei oder mache es wie 17.500+ andere und abonniere seinen KI-Newsletter mit Tipps, News und Angeboten rund um KI-Tools und Online-Business. Besuche auch seinen anderen Blog, Blogmojo, auf dem es um WordPress, Bloggen und SEO geht.