Ist Codex CLI kostenlos?

Codex CLI ist Open Source und kostenlos installierbar. Für die Nutzung meldest du dich mit einem ChatGPT-Plan oder nach zusätzlicher Einrichtung mit einem API-Key an. Welche Nutzung enthalten ist oder welche API-Kosten anfallen, hängt von deinem Account und Modell ab. Prüfe deshalb vor produktiver Automatisierung die aktuelle OpenAI-Preis- und Planseite.

Was ist der Unterschied zwischen Codex CLI und der Codex App?

Codex CLI ist das Terminal-Tool, das du mit codex startest. Es läuft komplett in der Kommandozeile und bietet die volle Bandbreite an Befehlen, Slash-Commands und Flags. Die Codex App ist eine Desktop-Anwendung (macOS und Windows), die eine grafische Oberfläche bietet. Die App hat weniger Slash-Commands, dafür eigene Shortcuts wie Cmd+Shift+P für die Command-Palette und Cmd+B für die Sidebar. Beide nutzen die gleichen Modelle und die gleiche Konfiguration.

Welches Modell soll ich für Codex nutzen?

Wähle das Modell im Kontext der Aufgabe und deines Zugangs. Die aktuelle Codex-Dokumentation zeigt gpt-5.6-sol, gpt-5.6-terra und gpt-5.6-luna als Beispiele. Öffne /model, um die in deinem Account verfügbaren Modelle und den Reasoning-Effort zu sehen. Mit -m legst du die Wahl für einen einzelnen Lauf fest.

Was ist der Unterschied zwischen codex exec und codex (interaktiv)?

codex startet eine interaktive TUI-Session, in der du mit dem Agenten hin- und her kommunizieren kannst. codex exec führt eine Aufgabe nicht-interaktiv aus: Es nimmt einen Prompt, arbeitet ihn ab und gibt das Ergebnis auf stdout aus. codex exec ist ideal für Skripte, CI/CD-Pipelines und Automatisierung.

Wie setze ich eine vorherige Session fort?

In der interaktiven TUI tippst du /resume oder codex resume im Terminal. Für nicht-interaktive Ausführung nutze 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 archivierte Session wieder her, und codex delete entfernt sie dauerhaft.

Was macht die Sandbox genau?

Die Sandbox beschränkt, was Codex auf deinem System tun darf. read-only erlaubt nur Lesen (keine Dateiänderungen, kein Netzwerk). workspace-write erlaubt Schreibzugriff nur im Arbeitsverzeichnis (kein Netzwerk). danger-full-access erlaubt alles: Lesen, Schreiben überall und Netzwerkzugriff. Für die meisten Aufgaben reicht workspace-write.

Kann ich Codex CLI in meine CI/CD-Pipeline einbauen?

Ja. Nutze codex -a never exec -s workspace-write für automatisierte Ausführung ohne Bestätigung. Das Approval-Flag ist global und muss vor exec stehen. Mit --json bekommst du strukturierte JSONL-Ausgabe. Authentifiziere dich per API-Key: echo $OPENAI_API_KEY | codex login --with-api-key. Setze --skip-git-repo-check, wenn du außerhalb eines Git-Repos arbeitest.

Wie unterscheidet sich Codex von Claude Code?

Beide sind Terminal-basierte KI-Coding-Agenten. Codex nutzt OpenAIs GPT-Modelle, Claude Code nutzt Anthropics Claude-Modelle. Codex hat eine besonders starke Cloud-Integration (Codex Cloud für Remote-Tasks) und eine eigenständige Desktop-App neben der CLI. Claude Code ist stärker terminal-first und bietet fortgeschrittene Features wie native Git-Worktrees, Hooks und Extended Thinking. Einen ausführlichen Vergleich findest du in unserem Artikel Claude Code vs. OpenAI Codex.

Codex Befehle: Die komplette Liste aller Commands

Du hast Codex installiert, tippst codex ins Terminal und fragst dich: „Und jetzt?“

So ging es mir auch. 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.

In diesem Artikel findest du alle Codex Befehle auf einen Blick: jedes CLI-Kommando, jeden Slash-Command, alle Flags und sämtliche Tastenkürzel für CLI und App. Dies ist die vollständigste deutsche Codex-Referenz, die du finden wirst. Wenn du Codex lieber direkt mit Claude Code vergleichen willst, hilft dir unser ausführlicher Claude Code vs. OpenAI Codex Vergleich.

TL;DRDas Wichtigste in Kürze

Die Referenz erfasst die aktuelle CLI: von codex exec und codex review bis zu Session-Archivierung, Plugins, App-Server und Codex Cloud
Slash-Commands im Composer steuern Modell, Berechtigungen, Sessions, Plan-Modus und weitere TUI-Funktionen. Die Tabelle nennt für alle 53 Befehle die Einführungsversion
Drei Sandbox-Modi (read-only, workspace-write, danger-full-access) und drei Approval-Policies steuern, was Codex auf deinem System tun darf
Codex Cloud kann Aufgaben in Remote-Umgebungen ausführen. App-Server und Remote-Control sind als experimentell gekennzeichnet

Codex installieren und starten

Codex CLI lässt sich per npm oder Homebrew installieren. Nach der Installation wirst du beim ersten Start aufgefordert, dich mit deinem ChatGPT-Account oder einem API-Key anzumelden.

# Installation per npm
npm install -g @openai/codex

# Oder per Homebrew
brew install --cask codex

# Interaktiv anmelden (öffnet Browser für OAuth)
codex login

# Per API-Key anmelden
echo $OPENAI_API_KEY | codex login --with-api-key

# Login-Status prüfen
codex login status

# Abmelden
codex logout

# Interaktive TUI-Session starten
codex

# Mit initialem Prompt starten
codex "Erkläre die Architektur dieses Projekts"

# Nicht-interaktiv ausführen (für Skripte)
codex exec -s workspace-write -m gpt-5.6-terra "Refactore auth.ts"

# Desktop-App starten
codex app

Tipp

Starte Codex immer im richtigen Projektordner. Mit --cd /pfad/zum/projekt kannst du das Arbeitsverzeichnis auch explizit setzen.

CLI-Befehle (Übersicht)

Codex bietet zwei Oberflächen: die CLI (Terminal-Befehle, die du direkt in der Kommandozeile ausführst) und die App (Desktop-Anwendung für macOS und Windows). Die Spalte „Beispiel“ zeigt dir die typische Verwendung jedes Befehls.

Befehlcodex

BeschreibungStartet die interaktive TUI im Terminal

Beispielcodex

Befehlcodex app

BeschreibungStartet die Codex Desktop-App auf macOS oder Windows

Beispielcodex app

Befehlcodex agents

BeschreibungZeigt Agenten-Sessions des lokalen App-Server-Daemons

Beispielcodex agents

Befehlcodex app-server

BeschreibungExperimentell: Startet den App-Server für Entwicklung, Debugging oder Remote-Verbindungen

Beispielcodex app-server --listen ws://127.0.0.1:4500

Befehlcodex apply

BeschreibungWendet den neuesten Diff eines Codex-Cloud-Chats lokal an

Beispielcodex apply TASK_ID

Befehlcodex archive

BeschreibungArchiviert eine gespeicherte Session, ohne ihr Transkript zu löschen

Beispielcodex archive SESSION

Befehlcodex cloud

BeschreibungExperimentell: Öffnet Cloud-Tasks oder führt sie im Terminal aus

Beispielcodex cloud list

Befehlcodex cloud exec

BeschreibungReicht eine Cloud-Aufgabe in einer Zielumgebung ein

Beispielcodex cloud exec --env ENV_ID "..."

Befehlcodex cloud list

BeschreibungListet Cloud-Tasks mit Filter- und Paginierungsoptionen

Beispielcodex cloud list

Befehlcodex cloud status

BeschreibungZeigt den Status eines Cloud-Tasks

Beispielcodex cloud status TASK_ID

Befehlcodex cloud diff

BeschreibungZeigt den Diff eines Cloud-Tasks

Beispielcodex cloud diff TASK_ID

Befehlcodex cloud apply

BeschreibungWendet den Diff eines Cloud-Tasks lokal an

Beispielcodex cloud apply TASK_ID

Befehlcodex completion

BeschreibungGeneriert Shell-Completions

Beispielcodex completion zsh

Befehlcodex debug

BeschreibungExperimentelle Diagnosewerkzeuge für Modellkatalog, Prompt-Eingabe und App-Server

Beispielcodex debug models --bundled

Befehlcodex delete

BeschreibungLöscht eine gespeicherte Session dauerhaft

Beispielcodex delete SESSION

Befehlcodex doctor

BeschreibungPrüft Installation, Konfiguration, Anmeldung, Laufzeit und Git-Umgebung

Beispielcodex doctor --summary

Befehlcodex exec

BeschreibungFührt eine Aufgabe nicht-interaktiv aus und streamt die Ausgabe

Beispielcodex exec "Fix bug"

Befehlcodex exec resume

BeschreibungSetzt eine vorherige Session nicht-interaktiv fort

Beispielcodex exec resume --last "Weiterarbeiten"

Befehlcodex exec fork

BeschreibungForkt eine vorherige Session nicht-interaktiv in einen neuen Thread

Beispielcodex exec fork --last "Alternative umsetzen"

Befehlcodex exec-server

BeschreibungExperimentell: Startet den Exec-Server für Remote-Umgebungen

Beispielcodex exec-server --listen ws://127.0.0.1:8787

Befehlcodex execpolicy

BeschreibungPrüft Exec-Policy-Regeln gegen einen Befehl

Beispielcodex execpolicy check --rules rules.toml -- npm test

Befehlcodex features

BeschreibungListet oder verwaltet Feature Flags

Beispielcodex features list

Befehlcodex fork

BeschreibungForkt eine gespeicherte Session in einen neuen Thread

Beispielcodex fork --last

Befehlcodex login

BeschreibungMeldet dich per ChatGPT, Device-Auth, API-Key oder Access-Token an

Beispielcodex login

Befehlcodex login status

BeschreibungZeigt den aktuellen Anmeldestatus

Beispielcodex login status

Befehlcodex logout

BeschreibungEntfernt gespeicherte Zugangsdaten

Beispielcodex logout

Befehlcodex mcp

BeschreibungVerwaltet externe MCP-Server

Beispielcodex mcp list

Befehlcodex mcp add

BeschreibungFügt einen MCP-Server über stdio oder HTTP hinzu

Beispielcodex mcp add name -- command

Befehlcodex mcp get

BeschreibungZeigt die Konfiguration eines MCP-Servers

Beispielcodex mcp get name

Befehlcodex mcp remove

BeschreibungEntfernt einen MCP-Server

Beispielcodex mcp remove name

Befehlcodex mcp login

BeschreibungMeldet einen MCP-Server per OAuth an

Beispielcodex mcp login name

Befehlcodex mcp logout

BeschreibungEntfernt die OAuth-Anmeldedaten eines MCP-Servers

Beispielcodex mcp logout name

Befehlcodex mcp-server

BeschreibungStartet Codex selbst als MCP-Server über stdio

Beispielcodex mcp-server

Befehlcodex migrate-rollouts

BeschreibungPrüft oder migriert ältere lokale Sessions in die paginierte Thread-Historie

Beispielcodex migrate-rollouts --verbose

Befehlcodex plugin

BeschreibungInstalliert, listet oder entfernt Plugins aus konfigurierten Marktplätzen

Beispielcodex plugin list

Befehlcodex plugin marketplace

BeschreibungVerwaltet Plugin-Marktplatz-Quellen aus Git oder lokalen Pfaden

Beispielcodex plugin marketplace add URL

Befehlcodex queue

BeschreibungReiht eine Nachricht für eine bestehende lokale Session ein

Beispielcodex queue --thread SESSION --message "Weiter mit den Tests"

Befehlcodex remote-control

BeschreibungExperimentell: Startet, stoppt oder koppelt den fernsteuerbaren App-Server-Daemon

Beispielcodex remote-control pair

Befehlcodex resume

BeschreibungSetzt eine interaktive Session über den Picker fort

Beispielcodex resume

Befehlcodex review

BeschreibungFührt ein nicht-interaktives Review von Änderungen, Branch oder Commit aus

Beispielcodex review --uncommitted

Befehlcodex sandbox

BeschreibungFührt Befehle in einer Codex-Sandbox aus

Beispielcodex sandbox -- npm test

Befehlcodex unarchive

BeschreibungStellt eine archivierte Session wieder her

Beispielcodex unarchive SESSION

Befehlcodex update

BeschreibungAktualisiert Codex auf die neueste Version

Beispielcodex update

	Beschreibung	Beispiel
`codex`	Startet die interaktive TUI im Terminal	`codex`
`codex app`	Startet die Codex Desktop-App auf macOS oder Windows	`codex app`
`codex agents`	Zeigt Agenten-Sessions des lokalen App-Server-Daemons	`codex agents`
`codex app-server`	Experimentell: Startet den App-Server für Entwicklung, Debugging oder Remote-Verbindungen	`codex app-server --listen ws://127.0.0.1:4500`
`codex apply`	Wendet den neuesten Diff eines Codex-Cloud-Chats lokal an	`codex apply TASK_ID`
`codex archive`	Archiviert eine gespeicherte Session, ohne ihr Transkript zu löschen	`codex archive SESSION`
`codex cloud`	Experimentell: Öffnet Cloud-Tasks oder führt sie im Terminal aus	`codex cloud list`
`codex cloud exec`	Reicht eine Cloud-Aufgabe in einer Zielumgebung ein	`codex cloud exec --env ENV_ID "..."`
`codex cloud list`	Listet Cloud-Tasks mit Filter- und Paginierungsoptionen	`codex cloud list`
`codex cloud status`	Zeigt den Status eines Cloud-Tasks	`codex cloud status TASK_ID`
`codex cloud diff`	Zeigt den Diff eines Cloud-Tasks	`codex cloud diff TASK_ID`
`codex cloud apply`	Wendet den Diff eines Cloud-Tasks lokal an	`codex cloud apply TASK_ID`
`codex completion`	Generiert Shell-Completions	`codex completion zsh`
`codex debug`	Experimentelle Diagnosewerkzeuge für Modellkatalog, Prompt-Eingabe und App-Server	`codex debug models --bundled`
`codex delete`	Löscht eine gespeicherte Session dauerhaft	`codex delete SESSION`
`codex doctor`	Prüft Installation, Konfiguration, Anmeldung, Laufzeit und Git-Umgebung	`codex doctor --summary`
`codex exec`	Führt eine Aufgabe nicht-interaktiv aus und streamt die Ausgabe	`codex exec "Fix bug"`
`codex exec resume`	Setzt eine vorherige Session nicht-interaktiv fort	`codex exec resume --last "Weiterarbeiten"`
`codex exec fork`	Forkt eine vorherige Session nicht-interaktiv in einen neuen Thread	`codex exec fork --last "Alternative umsetzen"`
`codex exec-server`	Experimentell: Startet den Exec-Server für Remote-Umgebungen	`codex exec-server --listen ws://127.0.0.1:8787`
`codex execpolicy`	Prüft Exec-Policy-Regeln gegen einen Befehl	`codex execpolicy check --rules rules.toml -- npm test`
`codex features`	Listet oder verwaltet Feature Flags	`codex features list`
`codex fork`	Forkt eine gespeicherte Session in einen neuen Thread	`codex fork --last`
`codex login`	Meldet dich per ChatGPT, Device-Auth, API-Key oder Access-Token an	`codex login`
`codex login status`	Zeigt den aktuellen Anmeldestatus	`codex login status`
`codex logout`	Entfernt gespeicherte Zugangsdaten	`codex logout`
`codex mcp`	Verwaltet externe MCP-Server	`codex mcp list`
`codex mcp add`	Fügt einen MCP-Server über stdio oder HTTP hinzu	`codex mcp add name -- command`
`codex mcp get`	Zeigt die Konfiguration eines MCP-Servers	`codex mcp get name`
`codex mcp remove`	Entfernt einen MCP-Server	`codex mcp remove name`
`codex mcp login`	Meldet einen MCP-Server per OAuth an	`codex mcp login name`
`codex mcp logout`	Entfernt die OAuth-Anmeldedaten eines MCP-Servers	`codex mcp logout name`
`codex mcp-server`	Startet Codex selbst als MCP-Server über stdio	`codex mcp-server`
`codex migrate-rollouts`	Prüft oder migriert ältere lokale Sessions in die paginierte Thread-Historie	`codex migrate-rollouts --verbose`
`codex plugin`	Installiert, listet oder entfernt Plugins aus konfigurierten Marktplätzen	`codex plugin list`
`codex plugin marketplace`	Verwaltet Plugin-Marktplatz-Quellen aus Git oder lokalen Pfaden	`codex plugin marketplace add URL`
`codex queue`	Reiht eine Nachricht für eine bestehende lokale Session ein	`codex queue --thread SESSION --message "Weiter mit den Tests"`
`codex remote-control`	Experimentell: Startet, stoppt oder koppelt den fernsteuerbaren App-Server-Daemon	`codex remote-control pair`
`codex resume`	Setzt eine interaktive Session über den Picker fort	`codex resume`
`codex review`	Führt ein nicht-interaktives Review von Änderungen, Branch oder Commit aus	`codex review --uncommitted`
`codex sandbox`	Führt Befehle in einer Codex-Sandbox aus	`codex sandbox -- npm test`
`codex unarchive`	Stellt eine archivierte Session wieder her	`codex unarchive SESSION`
`codex update`	Aktualisiert Codex auf die neueste Version	`codex update`

Hinweis

codex exec ist der wichtigste Befehl für Automatisierung. Er führt Aufgaben nicht-interaktiv aus und gibt das Ergebnis auf stdout aus. Perfekt für Skripte und CI/CD-Pipelines.

codex exec: Flags für nicht-interaktive Ausführung

codex exec ist das Arbeitspferd für automatisierte Workflows. 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-5.6-terra "dein Prompt"

# Mit maximaler Reasoning-Tiefe
codex -a on-request exec -s workspace-write -m gpt-5.6-sol \
  -c model_reasoning_effort='"xhigh"' "komplexe Aufgabe"

# Read-only für Analyse (keine Dateiänderungen)
codex exec -s read-only -m gpt-5.6-luna "Analysiere die Architektur"

Flag--model, -m

BeschreibungÜberschreibt das Modell aus der Konfiguration

Beispiel-m gpt-5.6-terra

Flag--sandbox, -s

BeschreibungSandbox-Modus: read-only, workspace-write oder danger-full-access

Beispiel-s workspace-write

FlagGlobal: --ask-for-approval, -a

BeschreibungLegt on-request oder never fest und muss vor dem exec-Unterbefehl stehen

Beispielcodex -a on-request exec "..."

Flag--cd, -C

BeschreibungSetzt das Arbeitsverzeichnis für den Agent

Beispiel-C /pfad/zum/projekt

Flag--add-dir

BeschreibungZusätzliche beschreibbare Verzeichnisse freigeben

Beispiel--add-dir ../backend

Flag--image, -i

BeschreibungHängt Bilder an den Prompt an (wiederholbar)

Beispiel-i screenshot.png

Flag--config, -c

BeschreibungÜberschreibt config.toml-Werte (TOML-Syntax)

Beispiel-c model_reasoning_effort='"xhigh"'

Flag--profile, -p

BeschreibungLädt benanntes Config-Profil aus config.toml

Beispiel-p fast-profile

Flag--enable / --disable

BeschreibungAktiviert oder deaktiviert Feature Flag für diesen Lauf

Beispiel--enable search_tool

Flag--json

BeschreibungGibt Events als JSONL aus (eine JSON-Zeile pro Event)

Beispielcodex exec --json "..."

Flag--output-last-message, -o

BeschreibungSpeichert letzte Agent-Nachricht in Datei

Beispiel-o /tmp/result.txt

Flag--output-schema

BeschreibungJSON-Schema-Datei, die die finale Antwort beschränkt

Beispiel--output-schema schema.json

Flag--ephemeral

BeschreibungSession wird nicht auf Disk persistiert

Beispielcodex exec --ephemeral "..."

Flag--skip-git-repo-check

BeschreibungErlaubt Ausführung außerhalb eines Git-Repos

Beispielcodex exec --skip-git-repo-check "..."

Flag--color

BeschreibungANSI-Farben steuern: always, never, auto

Beispiel--color never

Flag--oss

BeschreibungNutzt einen lokalen Open-Source-Provider

Beispielcodex exec --oss "..."

Flag--local-provider

BeschreibungWählt mit --oss explizit LM Studio oder Ollama

Beispiel--oss --local-provider ollama

Flag--strict-config

BeschreibungBricht ab, wenn config.toml unbekannte Felder enthält

Beispielcodex exec --strict-config "..."

Flag--ignore-user-config

BeschreibungLädt die persönliche config.toml nicht, nutzt aber weiter die Anmeldung

Beispielcodex exec --ignore-user-config "..."

Flag--ignore-rules

BeschreibungLädt keine persönlichen oder Projekt-Exec-Policy-Regeln

Beispielcodex exec --ignore-rules "..."

Flag--dangerously-bypass-approvals-and-sandbox, --yolo

BeschreibungUmgeht Genehmigungen und Sandbox vollständig. Nur in einer extern gehärteten Umgebung verwenden.

Beispielcodex exec --yolo "..."

Flag--approve-for-me

BeschreibungLeitet Genehmigungsanfragen über eine automatische Review mit workspace-write-Sandbox weiter

Beispielcodex exec --approve-for-me "..."

Flag--dangerously-bypass-hook-trust

BeschreibungFührt aktivierte Hooks ohne gespeichertes Vertrauen aus. Nur für bereits geprüfte Automatisierung.

Beispielcodex exec --dangerously-bypass-hook-trust "..."

Flag	Beschreibung	Beispiel
`--model, -m`	Überschreibt das Modell aus der Konfiguration	`-m gpt-5.6-terra`
`--sandbox, -s`	Sandbox-Modus: read-only, workspace-write oder danger-full-access	`-s workspace-write`
`Global: --ask-for-approval, -a`	Legt on-request oder never fest und muss vor dem exec-Unterbefehl stehen	`codex -a on-request exec "..."`
`--cd, -C`	Setzt das Arbeitsverzeichnis für den Agent	`-C /pfad/zum/projekt`
`--add-dir`	Zusätzliche beschreibbare Verzeichnisse freigeben	`--add-dir ../backend`
`--image, -i`	Hängt Bilder an den Prompt an (wiederholbar)	`-i screenshot.png`
`--config, -c`	Überschreibt config.toml-Werte (TOML-Syntax)	`-c model_reasoning_effort='"xhigh"'`
`--profile, -p`	Lädt benanntes Config-Profil aus config.toml	`-p fast-profile`
`--enable / --disable`	Aktiviert oder deaktiviert Feature Flag für diesen Lauf	`--enable search_tool`
`--json`	Gibt Events als JSONL aus (eine JSON-Zeile pro Event)	`codex exec --json "..."`
`--output-last-message, -o`	Speichert letzte Agent-Nachricht in Datei	`-o /tmp/result.txt`
`--output-schema`	JSON-Schema-Datei, die die finale Antwort beschränkt	`--output-schema schema.json`
`--ephemeral`	Session wird nicht auf Disk persistiert	`codex exec --ephemeral "..."`
`--skip-git-repo-check`	Erlaubt Ausführung außerhalb eines Git-Repos	`codex exec --skip-git-repo-check "..."`
`--color`	ANSI-Farben steuern: always, never, auto	`--color never`
`--oss`	Nutzt einen lokalen Open-Source-Provider	`codex exec --oss "..."`
`--local-provider`	Wählt mit --oss explizit LM Studio oder Ollama	`--oss --local-provider ollama`
`--strict-config`	Bricht ab, wenn config.toml unbekannte Felder enthält	`codex exec --strict-config "..."`
`--ignore-user-config`	Lädt die persönliche config.toml nicht, nutzt aber weiter die Anmeldung	`codex exec --ignore-user-config "..."`
`--ignore-rules`	Lädt keine persönlichen oder Projekt-Exec-Policy-Regeln	`codex exec --ignore-rules "..."`
`--dangerously-bypass-approvals-and-sandbox, --yolo`	Umgeht Genehmigungen und Sandbox vollständig. Nur in einer extern gehärteten Umgebung verwenden.	`codex exec --yolo "..."`
`--approve-for-me`	Leitet Genehmigungsanfragen über eine automatische Review mit workspace-write-Sandbox weiter	`codex exec --approve-for-me "..."`
`--dangerously-bypass-hook-trust`	Führt aktivierte Hooks ohne gespeichertes Vertrauen aus. Nur für bereits geprüfte Automatisierung.	`codex exec --dangerously-bypass-hook-trust "..."`

Warnung

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

Häufige Muster

# Bilder anhängen (Screenshots, Design-Specs)
codex exec -s workspace-write -m gpt-5.6-terra -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"

Code Review

codex review analysiert Codeänderungen nicht-interaktiv und gibt die Ergebnisse auf stdout aus. Dateien werden dabei nicht verändert.

Flag--uncommitted

BeschreibungReviewed staged, unstaged und untracked Changes

Beispielcodex review --uncommitted

Flag--base

BeschreibungReviewed Änderungen gegen einen Base-Branch

Beispielcodex review --base main

Flag--commit

BeschreibungReviewed einen spezifischen Commit

Beispielcodex review --commit abc123

Flag--title

BeschreibungOptionaler Titel für die Review-Zusammenfassung

Beispielcodex review --title "Auth hinzufügen"

FlagPROMPT

BeschreibungBenutzerdefinierte Review-Anweisungen (auch via stdin mit -)

Beispielcodex review "Fokus auf Sicherheit"

Flag	Beschreibung	Beispiel
`--uncommitted`	Reviewed staged, unstaged und untracked Changes	`codex review --uncommitted`
`--base`	Reviewed Änderungen gegen einen Base-Branch	`codex review --base main`
`--commit`	Reviewed einen spezifischen Commit	`codex review --commit abc123`
`--title`	Optionaler Titel für die Review-Zusammenfassung	`codex review --title "Auth hinzufügen"`
`PROMPT`	Benutzerdefinierte Review-Anweisungen (auch via stdin mit -)	`codex review "Fokus auf Sicherheit"`

# Uncommitted Changes reviewen (staged + unstaged + untracked)
codex review --uncommitted

# Änderungen gegen einen Branch reviewen (vor einem PR)
codex review --base main

# Spezifischen Commit reviewen
codex review --commit abc123

# Review 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

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 resume --last -s workspace-write -m gpt-5.6-terra \
  "Füge jetzt Error Handling hinzu"

# Spezifische Session per UUID fortsetzen
codex exec resume 7f9f9a2e-1b3c-4c7a... -s workspace-write -m gpt-5.6-terra \
  "Setze den Plan um"

# Session forken (neuer Thread basierend auf bestehendem Kontext)
codex fork --last

# Session archivieren oder wiederherstellen
codex archive SESSION
codex unarchive SESSION

# Session endgültig löschen
codex delete SESSION

# Diff aus einer lokalen Session anwenden
codex apply TASK_ID

# Diff aus einem Cloud-Task anwenden
codex cloud apply TASK_ID

# Spezifischen Versuch anwenden (bei --attempts N)
codex cloud apply TASK_ID --attempt 2

Tipp

Mit --ephemeral gestartete Sessions werden nicht auf der Festplatte gespeichert. Nutze das für schnelle Einmal-Fragen, bei denen du keinen Verlauf brauchst.

Codex Cloud

Codex Cloud arbeitet mit Remote-Umgebungen. Ohne Unterbefehl öffnet codex cloud einen Picker. codex cloud exec reicht eine Aufgabe direkt ein. Dafür ist --env Pflicht.

Flag--env

BeschreibungPflichtangabe: Ziel-Umgebungs-ID für den Cloud-Task

Beispiel--env ENV_ID

Flag--attempts

BeschreibungAnzahl Versuche (Best-of-N), Standard: 1

Beispiel--attempts 3

Flag--branch

BeschreibungGit-Branch, auf dem der Task laufen soll

Beispiel--branch feature/auth

Flag--json

BeschreibungMaschinenlesbare JSON-Ausgabe (für codex cloud list)

Beispielcodex cloud list --json

Flag--limit

BeschreibungMaximale Anzahl zurückgegebener Tasks (1-20)

Beispielcodex cloud list --limit 5

Flag--cursor

BeschreibungPaginierungs-Cursor vom vorherigen Aufruf

Beispielcodex cloud list --cursor CURSOR

Flag--attempt

BeschreibungVersuchsnummer für diff/apply (bei --attempts N)

Beispielcodex cloud diff TASK_ID --attempt 2

Flag	Beschreibung	Beispiel
`--env`	Pflichtangabe: Ziel-Umgebungs-ID für den Cloud-Task	`--env ENV_ID`
`--attempts`	Anzahl Versuche (Best-of-N), Standard: 1	`--attempts 3`
`--branch`	Git-Branch, auf dem der Task laufen soll	`--branch feature/auth`
`--json`	Maschinenlesbare JSON-Ausgabe (für codex cloud list)	`codex cloud list --json`
`--limit`	Maximale Anzahl zurückgegebener Tasks (1-20)	`codex cloud list --limit 5`
`--cursor`	Paginierungs-Cursor vom vorherigen Aufruf	`codex cloud list --cursor CURSOR`
`--attempt`	Versuchsnummer für diff/apply (bei --attempts N)	`codex cloud diff TASK_ID --attempt 2`

# Task einreichen
codex cloud exec --env ENV_ID "Refactore das Payment-Modul"

 # Best-of-3: Drei Versuche starten
codex cloud exec --env ENV_ID --attempts 3 "Fix den flaky Test"

# Auf 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

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

# Daemon für Remote-Control verwalten
codex remote-control start
codex remote-control pair
codex remote-control stop

# Modellkatalog und lokale Installation diagnostizieren
codex debug models --bundled
codex doctor --summary

Sandbox-Modi

Die Sandbox beschränkt, was Codex auf deinem System tun darf. Du setzt den Modus mit -s oder --sandbox.

Modusread-only

LesenÜberall

SchreibenNirgends

NetzwerkNein

Wann nutzen?Fragen, Erklärungen, Code-Analyse

Modusworkspace-write

LesenÜberall

SchreibenNur Arbeitsverzeichnis

NetzwerkNein

Wann nutzen?Standard für die meisten Aufgaben

Modusdanger-full-access

LesenÜberall

SchreibenÜberall

NetzwerkJa

Wann nutzen?Nur wenn ausdrücklich nötig (z. B. Pakete installieren)

Modus	Lesen	Schreiben	Netzwerk	Wann nutzen?
`read-only`	Überall	Nirgends	Nein	Fragen, Erklärungen, Code-Analyse
`workspace-write`	Überall	Nur Arbeitsverzeichnis	Nein	Standard für die meisten Aufgaben
`danger-full-access`	Überall	Überall	Ja	Nur wenn ausdrücklich nötig (z. B. Pakete installieren)

Codex bietet auch ein codex sandbox Kommando, mit dem du beliebige Befehle unter der Sandbox ausführen kannst, ohne den Agenten zu involvieren:

# Befehl in der 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

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.

Policyon-request

VerhaltenModell entscheidet, wann es um Erlaubnis fragt

Policynever

VerhaltenFragt nie nach Genehmigung, Fehler gehen direkt ans Modell zurück

Policy	Verhalten
`on-request`	Modell entscheidet, wann es um Erlaubnis fragt
`never`	Fragt nie nach Genehmigung, Fehler gehen direkt ans Modell zurück

Hinweis

In der interaktiven TUI wechselst du den Genehmigungsmodus mit /permissions. Drei Presets stehen zur Auswahl: Auto (Standard), Read Only und Full Access.

MCP-Server (Model Context Protocol)

Codex kann sich mit MCP-Servern verbinden, um zusätzliche Tools zu nutzen (z. B. Datenbanken, APIs, GitHub). Alle Verwaltungsbefehle sind nicht-interaktiv.

# Konfigurierte Server auflisten
codex mcp list
codex mcp list --json

# Server-Konfiguration anzeigen
codex mcp get my-server
codex mcp get my-server --json

# Stdio-Server hinzufügen
codex mcp add my-server -- npx -y @my/mcp-server
codex mcp add my-server --env API_KEY=sk-123 -- node server.js

# HTTP-Server hinzufügen
codex mcp add my-server --url https://mcp.example.com/sse
codex mcp add my-server --url https://mcp.example.com \
  --bearer-token-env-var MY_TOKEN_VAR

# Server entfernen
codex mcp remove my-server

# OAuth-Login für MCP-Server
codex mcp login my-server --scopes "read,write"
codex mcp logout my-server

Tipp

Mit codex mcp-server kannst du Codex selbst als MCP-Server starten. So lässt sich Codex in andere Tools integrieren, die MCP unterstützen.

Slash-Commands (CLI und App)

In der interaktiven TUI (gestartet mit codex) und in der Desktop-App stehen Slash-Commands zur Verfügung. Tippe / im Composer, um die Liste zu öffnen. Während ein Task läuft, kannst du einen Slash-Command eingeben und mit Tab in die Warteschlange stellen.

Die CLI-TUI hat deutlich mehr Slash-Commands als die App. Die Tabelle zeigt die aktuell dokumentierten Befehle, ihre Parameter und ihre Einführungsversion. Einzelne Befehle können abhängig von Plattform, Modell oder aktivierten Features fehlen.

Für die Versionsspalte habe ich nicht nur die Release Notes geprüft. Sie nennt für jeden Befehl die früheste regulär veröffentlichte Codex-Version, in deren Quellstand der konkrete Slash-Command verfügbar ist. Umbenennungen wie /autoreview zu /approve zählen ab der Version mit dem neuen Namen.

Befehl/agents

Parameter

Seit Version0.149

BeschreibungZeigt und wechselt zwischen allen aktiven Agent-Sessions

Befehl/app

Parameter

Seit Version0.138

BeschreibungÖffnet die aktuelle Session in der Desktop-App

Befehl/apps

Parameter

Seit Version0.93

BeschreibungDurchsucht Apps und fügt sie in den Prompt ein

Befehl/approve

Parameter

Seit Version0.129

BeschreibungGenehmigt einen Wiederholungsversuch nach einer Auto-Review-Ablehnung

Befehl/archive

Parameter

Seit Version0.136

BeschreibungArchiviert die aktuelle Session und beendet Codex

Befehl/cd

ParameterPfad optional

Seit Version0.149

BeschreibungWechselt das aktuelle Arbeitsverzeichnis

Befehl/clear

ParameterName optional

Seit Version0.105

BeschreibungLeert das Terminal und startet einen neuen Chat

Befehl/compact

Parameter

Seit Version0.11

BeschreibungFasst die sichtbare Unterhaltung zusammen und schafft Kontextplatz

Befehl/copy

Parameter

Seit Version0.105

BeschreibungKopiert die letzte fertige Codex-Ausgabe (auch Ctrl+O)

Befehl/debug-config

Parameter

Seit Version0.97

BeschreibungZeigt Konfigurations-Layer und Anforderungsdiagnose

Befehl/delete

Parameter

Seit Version0.140

BeschreibungLöscht die aktuelle Session und ihre Unter-Sessions dauerhaft

Befehl/diff

Parameter

Seit Version0.2

BeschreibungZeigt das Git-Diff einschließlich nicht getrackter Dateien

Befehl/exit

Parameter

Seit Version0.53

BeschreibungBeendet die CLI (Alias /quit)

Befehl/experimental

Parameter

Seit Version0.74

BeschreibungSchaltet experimentelle Features ein oder aus

Befehl/export

ParameterZielpfad optional

Seit Version0.148

BeschreibungExportiert die Unterhaltung als Markdown

Befehl/fast

Parameter

Seit Version0.110

BeschreibungSchaltet den Fast-Service-Tier, falls das aktive Modell ihn anbietet

Befehl/feedback

Parameter

Seit Version0.47

BeschreibungSendet Diagnose-Logs an die Codex-Maintainer

Befehl/fork

Parameter

Seit Version0.81

BeschreibungVerzweigt die aktuelle Unterhaltung in einen neuen Chat

Befehl/goal

ParameterZiel | edit | pause | resume | clear

Seit Version0.128

BeschreibungSetzt, bearbeitet, pausiert oder entfernt ein Aufgabenziel

Befehl/hooks

Parameter

Seit Version0.129

BeschreibungZeigt und verwaltet Lifecycle-Hooks

Befehl/ide

ParameterText optional

Seit Version0.129

BeschreibungBindet offene Dateien, Auswahl und IDE-Kontext ein

Befehl/import

Parameter

Seit Version0.140

BeschreibungImportiert unterstützte Claude-Code- oder Cursor-Setups, Projekte und Chats

Befehl/init

Parameter

Seit Version0.14

BeschreibungGeneriert ein AGENTS.md-Gerüst für den Projektkontext

Befehl/keymap

Parameter

Seit Version0.128

BeschreibungBelegt die TUI-Tastenkürzel neu

Befehl/logout

Parameter

Seit Version0.15

BeschreibungMeldet dich von Codex ab

Befehl/mcp

Parameterverbose

Seit Version0.23

BeschreibungListet die konfigurierten MCP-Tools auf

Befehl/memories

Parameter

Seit Version0.121

BeschreibungKonfiguriert Nutzung und Generierung von Memories

Befehl/mention

ParameterPfad

Seit Version0.21

BeschreibungHängt eine Datei oder einen Ordner an die Unterhaltung an

Befehl/model

ParameterModell

Seit Version0.23

BeschreibungWählt das aktive Modell und, falls verfügbar, den Reasoning-Effort

Befehl/new

ParameterName optional

Seit Version0.2

BeschreibungStartet einen neuen Chat in derselben CLI-Session

Befehl/permissions

Parameter

Seit Version0.89

BeschreibungLegt fest, was Codex ohne Nachfrage tun darf

Befehl/personality

Parameter

Seit Version0.92

BeschreibungWählt einen Kommunikationsstil für Antworten

Befehl/pets

Parameter

Seit Version0.131

BeschreibungWählt oder versteckt ein Terminal-Haustier (Alias /pet)

Befehl/plan

ParameterPrompt optional

Seit Version0.93

BeschreibungWechselt in den Plan-Modus

Befehl/plugins

Parameter

Seit Version0.117

BeschreibungDurchsucht installierte und verfügbare Plugins

Befehl/ps

Parameter

Seit Version0.76

BeschreibungZeigt Hintergrund-Terminals und ihre jüngste Ausgabe

Befehl/pwd

Parameter

Seit Version0.149

BeschreibungZeigt das aktuelle Arbeitsverzeichnis (Alias /cwd)

Befehl/raw

Parameteron | off

Seit Version0.129

BeschreibungSchaltet den Raw-Scrollback-Modus um

Befehl/rename

ParameterName optional

Seit Version0.93

BeschreibungBenennt den aktuellen Chat um

Befehl/resume

Parameter

Seit Version0.65

BeschreibungLädt eine gespeicherte Session über den Session-Picker

Befehl/review

Parameter

Seit Version0.39

BeschreibungLässt Codex den Working Tree prüfen

Befehl/sandbox-add-read-dir

Parameterabsoluter Pfad

Seit Version0.102

BeschreibungGibt der Sandbox Lesezugriff auf ein zusätzliches Verzeichnis (nur Windows)

Befehl/setup-default-sandbox

Parameter

Seit Version0.100

BeschreibungRichtet die erhöhte Standard-Sandbox ein (nur Windows)

Befehl/side

ParameterText optional

Seit Version0.122

BeschreibungStartet eine kurzlebige Nebenunterhaltung in einer temporären Verzweigung (Alias /btw)

Befehl/skills

Parameter

Seit Version0.65

BeschreibungDurchsucht und nutzt Skills

Befehl/status

Parameter

Seit Version0.14

BeschreibungZeigt Modell, Approval-Policy, beschreibbare Pfade und Token-Nutzung

Befehl/statusline

Parameter

Seit Version0.99

BeschreibungKonfiguriert die Felder der TUI-Statuszeile

Befehl/stop

Parameter

Seit Version0.115

BeschreibungStoppt alle Hintergrund-Terminals (Alias /clean)

Befehl/subagents

Parameter

Seit Version0.115

BeschreibungWechselt zwischen den Subagents dieser Session

Befehl/theme

Parameter

Seit Version0.105

BeschreibungWählt ein Syntax-Highlighting-Theme

Befehl/title

Parameter

Seit Version0.117

BeschreibungKonfiguriert die Elemente im Terminal-Titel

Befehl/usage

Parameterdaily | weekly | cumulative

Seit Version0.140

BeschreibungZeigt die Token-Nutzung oder löst einen Rate-Limit-Reset ein

Befehl/vim

Parameter

Seit Version0.129

BeschreibungSchaltet den Vim-Modus für den Composer um

	Parameter		Beschreibung
`/agents`		0.149	Zeigt und wechselt zwischen allen aktiven Agent-Sessions
`/app`		0.138	Öffnet die aktuelle Session in der Desktop-App
`/apps`		0.93	Durchsucht Apps und fügt sie in den Prompt ein
`/approve`		0.129	Genehmigt einen Wiederholungsversuch nach einer Auto-Review-Ablehnung
`/archive`		0.136	Archiviert die aktuelle Session und beendet Codex
`/cd`	Pfad optional	0.149	Wechselt das aktuelle Arbeitsverzeichnis
`/clear`	Name optional	0.105	Leert das Terminal und startet einen neuen Chat
`/compact`		0.11	Fasst die sichtbare Unterhaltung zusammen und schafft Kontextplatz
`/copy`		0.105	Kopiert die letzte fertige Codex-Ausgabe (auch `Ctrl+O`)
`/debug-config`		0.97	Zeigt Konfigurations-Layer und Anforderungsdiagnose
`/delete`		0.140	Löscht die aktuelle Session und ihre Unter-Sessions dauerhaft
`/diff`		0.2	Zeigt das Git-Diff einschließlich nicht getrackter Dateien
`/exit`		0.53	Beendet die CLI (Alias `/quit`)
`/experimental`		0.74	Schaltet experimentelle Features ein oder aus
`/export`	Zielpfad optional	0.148	Exportiert die Unterhaltung als Markdown
`/fast`		0.110	Schaltet den Fast-Service-Tier, falls das aktive Modell ihn anbietet
`/feedback`		0.47	Sendet Diagnose-Logs an die Codex-Maintainer
`/fork`		0.81	Verzweigt die aktuelle Unterhaltung in einen neuen Chat
`/goal`	`Ziel \| edit \| pause \| resume \| clear`	0.128	Setzt, bearbeitet, pausiert oder entfernt ein Aufgabenziel
`/hooks`		0.129	Zeigt und verwaltet Lifecycle-Hooks
`/ide`	Text optional	0.129	Bindet offene Dateien, Auswahl und IDE-Kontext ein
`/import`		0.140	Importiert unterstützte Claude-Code- oder Cursor-Setups, Projekte und Chats
`/init`		0.14	Generiert ein AGENTS.md-Gerüst für den Projektkontext
`/keymap`		0.128	Belegt die TUI-Tastenkürzel neu
`/logout`		0.15	Meldet dich von Codex ab
`/mcp`	`verbose`	0.23	Listet die konfigurierten MCP-Tools auf
`/memories`		0.121	Konfiguriert Nutzung und Generierung von Memories
`/mention`	Pfad	0.21	Hängt eine Datei oder einen Ordner an die Unterhaltung an
`/model`	Modell	0.23	Wählt das aktive Modell und, falls verfügbar, den Reasoning-Effort
`/new`	Name optional	0.2	Startet einen neuen Chat in derselben CLI-Session
`/permissions`		0.89	Legt fest, was Codex ohne Nachfrage tun darf
`/personality`		0.92	Wählt einen Kommunikationsstil für Antworten
`/pets`		0.131	Wählt oder versteckt ein Terminal-Haustier (Alias `/pet`)
`/plan`	Prompt optional	0.93	Wechselt in den Plan-Modus
`/plugins`		0.117	Durchsucht installierte und verfügbare Plugins
`/ps`		0.76	Zeigt Hintergrund-Terminals und ihre jüngste Ausgabe
`/pwd`		0.149	Zeigt das aktuelle Arbeitsverzeichnis (Alias `/cwd`)
`/raw`	`on \| off`	0.129	Schaltet den Raw-Scrollback-Modus um
`/rename`	Name optional	0.93	Benennt den aktuellen Chat um
`/resume`		0.65	Lädt eine gespeicherte Session über den Session-Picker
`/review`		0.39	Lässt Codex den Working Tree prüfen
`/sandbox-add-read-dir`	absoluter Pfad	0.102	Gibt der Sandbox Lesezugriff auf ein zusätzliches Verzeichnis (nur Windows)
`/setup-default-sandbox`		0.100	Richtet die erhöhte Standard-Sandbox ein (nur Windows)
`/side`	Text optional	0.122	Startet eine kurzlebige Nebenunterhaltung in einer temporären Verzweigung (Alias `/btw`)
`/skills`		0.65	Durchsucht und nutzt Skills
`/status`		0.14	Zeigt Modell, Approval-Policy, beschreibbare Pfade und Token-Nutzung
`/statusline`		0.99	Konfiguriert die Felder der TUI-Statuszeile
`/stop`		0.115	Stoppt alle Hintergrund-Terminals (Alias `/clean`)
`/subagents`		0.115	Wechselt zwischen den Subagents dieser Session
`/theme`		0.105	Wählt ein Syntax-Highlighting-Theme
`/title`		0.117	Konfiguriert die Elemente im Terminal-Titel
`/usage`	`daily \| weekly \| cumulative`	0.140	Zeigt die Token-Nutzung oder löst einen Rate-Limit-Reset ein
`/vim`		0.129	Schaltet den Vim-Modus für den Composer um

Tastenkürzel: CLI (TUI)

Diese Shortcuts funktionieren in der interaktiven Terminal-Oberfläche (gestartet mit codex). Mit /keymap kannst du die Belegung anpassen.

TastenkürzelCtrl+C

BeschreibungBricht aktuelle Ausführung ab

KontextWährend der Agent arbeitet

TastenkürzelCtrl+D

BeschreibungBeendet die CLI

KontextBei leerem Input-Buffer

TastenkürzelCtrl+G

BeschreibungÖffnet externen Editor (VISUAL oder EDITOR)

KontextFür lange Prompts

TastenkürzelCtrl+L

BeschreibungLöscht den Bildschirm (ohne neuen Chat zu starten)

KontextWenn das Terminal zu voll wird

TastenkürzelCtrl+O

BeschreibungKopiert letzte Antwort in die Zwischenablage

KontextNach einer Antwort

TastenkürzelCtrl+R

BeschreibungRückwärtssuche in der Prompt-History

KontextIm Composer

TastenkürzelAlt+,

BeschreibungSenkt die Reasoning-Tiefe

KontextWährend der Session

TastenkürzelAlt+.

BeschreibungErhöht die Reasoning-Tiefe

KontextWährend der Session

TastenkürzelUp / Down

BeschreibungNavigiert durch die Draft-History im Composer

KontextIm Eingabefeld

TastenkürzelTab

BeschreibungReiht Follow-up-Text, Slash-Commands oder Shell-Befehle in die Warteschlange ein

KontextWährend der Agent arbeitet

TastenkürzelEsc + Esc

BeschreibungBearbeitet vorherige Nutzernachricht

KontextIm Composer

Tastenkürzel@

BeschreibungFuzzy-Dateisuche zum Anhängen von Dateien

KontextIm Eingabefeld

Tastenkürzel!

BeschreibungFührt Shell-Befehl direkt aus

KontextAm Anfang der Eingabe

Tastenkürzel	Beschreibung	Kontext
`Ctrl+C`	Bricht aktuelle Ausführung ab	Während der Agent arbeitet
`Ctrl+D`	Beendet die CLI	Bei leerem Input-Buffer
`Ctrl+G`	Öffnet externen Editor (VISUAL oder EDITOR)	Für lange Prompts
`Ctrl+L`	Löscht den Bildschirm (ohne neuen Chat zu starten)	Wenn das Terminal zu voll wird
`Ctrl+O`	Kopiert letzte Antwort in die Zwischenablage	Nach einer Antwort
`Ctrl+R`	Rückwärtssuche in der Prompt-History	Im Composer
`Alt+,`	Senkt die Reasoning-Tiefe	Während der Session
`Alt+.`	Erhöht die Reasoning-Tiefe	Während der Session
`Up / Down`	Navigiert durch die Draft-History im Composer	Im Eingabefeld
`Tab`	Reiht Follow-up-Text, Slash-Commands oder Shell-Befehle in die Warteschlange ein	Während der Agent arbeitet
`Esc + Esc`	Bearbeitet vorherige Nutzernachricht	Im Composer
`@`	Fuzzy-Dateisuche zum Anhängen von Dateien	Im Eingabefeld
`!`	Führt Shell-Befehl direkt aus	Am Anfang der Eingabe

Tastenkürzel: Codex App

Die Desktop-App (gestartet mit codex app) hat eigene Tastenkürzel, die sich an gängigen IDE-Konventionen orientieren. Auf Windows ersetzt du Cmd durch Ctrl.

TastenkürzelCmd+Shift+P / Cmd+K

BeschreibungÖffnet die Command-Palette

TastenkürzelCmd+,

BeschreibungÖffnet die Einstellungen

TastenkürzelCmd+O

BeschreibungÖffnet Ordner

TastenkürzelCmd+N / Cmd+Shift+O

BeschreibungNeuer Thread

TastenkürzelCmd+F

BeschreibungSuche im Thread

TastenkürzelCmd+B

BeschreibungSidebar ein-/ausblenden

TastenkürzelCmd+Option+B

BeschreibungDiff-Panel ein-/ausblenden

TastenkürzelCmd+J

BeschreibungTerminal ein-/ausblenden

TastenkürzelCmd+Shift+[ / ]

BeschreibungZum vorherigen / nächsten Thread wechseln

TastenkürzelCmd+[ / ]

BeschreibungZurück / vorwärts navigieren

TastenkürzelCmd++ / Cmd+-

BeschreibungSchriftgröße vergrößern / verkleinern

TastenkürzelCtrl+L

BeschreibungTerminal löschen

TastenkürzelCtrl+M

BeschreibungDiktat starten

Tastenkürzel	Beschreibung
`Cmd+Shift+P / Cmd+K`	Öffnet die Command-Palette
`Cmd+,`	Öffnet die Einstellungen
`Cmd+O`	Öffnet Ordner
`Cmd+N / Cmd+Shift+O`	Neuer Thread
`Cmd+F`	Suche im Thread
`Cmd+B`	Sidebar ein-/ausblenden
`Cmd+Option+B`	Diff-Panel ein-/ausblenden
`Cmd+J`	Terminal ein-/ausblenden
`Cmd+Shift+[ / ]`	Zum vorherigen / nächsten Thread wechseln
`Cmd+[ / ]`	Zurück / vorwärts navigieren
`Cmd++ / Cmd+-`	Schriftgröße vergrößern / verkleinern
`Ctrl+L`	Terminal löschen
`Ctrl+M`	Diktat starten

Hinweis

Die App unterstützt auch Deeplinks per codex://-Schema, z. B. codex://settings für Einstellungen oder codex://new?prompt=dein+prompt für einen neuen Thread mit Prompt.

Konfiguration (config.toml)

Die Codex-Konfiguration liegt unter ~/.codex/config.toml. Du kannst Standardwerte setzen und benannte Profile definieren.

Settingmodel

BeschreibungStandard-Modell für alle Sessions

Mögliche Werte"gpt-5.6-sol", "gpt-5.6-terra" oder "gpt-5.6-luna", abhängig von deinem Zugang

Settingmodel_reasoning_effort

BeschreibungReasoning-Tiefe für komplexe Aufgaben

Mögliche Werte"xhigh", "high", "medium", "low"

Settingpersonality

BeschreibungKommunikationsstil des Agenten

Mögliche Werte"pragmatic", "friendly", "none"

Settingweb_search

BeschreibungModus für die Web-Suche

Mögliche Werte"cached" (Standard), "live", "disabled"

Setting	Beschreibung	Mögliche Werte
`model`	Standard-Modell für alle Sessions	`"gpt-5.6-sol"`, `"gpt-5.6-terra"` oder `"gpt-5.6-luna"`, abhängig von deinem Zugang
`model_reasoning_effort`	Reasoning-Tiefe für komplexe Aufgaben	`"xhigh"`, `"high"`, `"medium"`, `"low"`
`personality`	Kommunikationsstil des Agenten	`"pragmatic"`, `"friendly"`, `"none"`
`web_search`	Modus für die Web-Suche	`"cached"` (Standard), `"live"`, `"disabled"`

# ~/.codex/config.toml

# Standard-Settings
model = "gpt-5.6-terra"
model_reasoning_effort = "high"

# Profil für schnelle Aufgaben
[profiles.quick]
model = "gpt-5.6-luna"
model_reasoning_effort = "low"

# Profil für gründliche Arbeit
[profiles.thorough]
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"

# Projekt-Vertrauenslevel
[projects."/pfad/zum/projekt"]
trust_level = "trusted"

# Einzelnen Wert überschreiben
codex exec -s workspace-write -c model='"gpt-5.6-terra"' "Aufgabe"

# Sandbox-Berechtigungen setzen
codex exec -s workspace-write \
  -c 'sandbox_permissions=["disk-full-read-access"]' "Aufgabe"

# Profil per -p laden
codex exec -s workspace-write -p quick "Schnelle Frage"

Feature Flags

Feature Flags steuern experimentelle und stabile Features. Änderungen per enable/disable werden dauerhaft in die config.toml geschrieben. Per-Run-Toggles mit --enable/--disable gelten nur für den aktuellen Lauf.

# Alle Feature Flags mit Status und Reifegrad anzeigen
codex features list

# Feature dauerhaft aktivieren / deaktivieren
codex features enable search_tool
codex features disable shell_snapshot

# Nur für diesen Lauf aktivieren (nicht persistent)
codex exec -s workspace-write --enable search_tool \
  --disable shell_snapshot "Aufgabe"

Globale Flags

Diese Flags stehen bei fast jedem Codex-Befehl zur Verfügung:

Flag--config, -c

BeschreibungÜberschreibt config.toml-Werte. Gepunktete Pfade für Verschachtelung. Werte werden als TOML geparst.

Beispiel-c model_reasoning_effort='"high"'

Flag--enable

BeschreibungAktiviert ein Feature Flag für diesen Lauf (wiederholbar)

Beispielcodex --enable search_tool

Flag--disable

BeschreibungDeaktiviert ein Feature Flag für diesen Lauf (wiederholbar)

Beispielcodex --disable search_tool

Flag--model, -m

BeschreibungWählt ein Modell für den aktuellen Lauf

Beispielcodex -m gpt-5.6-terra

Flag--oss / --local-provider

BeschreibungNutzt ein lokales Open-Source-Modell und wählt bei Bedarf LM Studio oder Ollama

Beispielcodex --oss --local-provider ollama

Flag--remote

BeschreibungVerbindet TUI, resume, fork sowie Session-Archivierung mit einem App-Server über WebSocket oder Unix-Socket

Beispielcodex --remote ws://127.0.0.1:4500

Flag--remote-auth-token-env

BeschreibungLiest für --remote einen Bearer-Token aus einer Umgebungsvariable

Beispiel--remote-auth-token-env CODEX_REMOTE_TOKEN

Flag--sandbox, -s

BeschreibungWählt read-only, workspace-write oder danger-full-access

Beispiel-s workspace-write

Flag--ask-for-approval, -a

BeschreibungLegt die Genehmigungs-Policy on-request oder never fest

Beispielcodex -a on-request

Flag--search

BeschreibungSchaltet von der standardmäßigen gecachten auf Live-Websuche um

Beispielcodex --search "Prüfe die aktuelle Dokumentation"

Flag--no-alt-screen

BeschreibungStartet die TUI im Inline-Modus und erhält den Terminal-Scrollback

Beispielcodex --no-alt-screen

Flag--strict-config

BeschreibungBricht bei unbekannten config.toml-Feldern ab

Beispielcodex --strict-config

Flag--dangerously-bypass-approvals-and-sandbox, --yolo

BeschreibungUmgeht Genehmigungen und Sandbox. Ausschließlich innerhalb einer extern gehärteten Umgebung.

Beispielcodex --yolo "..."

Flag--dangerously-bypass-hook-trust

BeschreibungLässt aktivierte Hooks ohne gespeichertes Vertrauen laufen. Nur für bereits geprüfte Automatisierung.

Beispielcodex --dangerously-bypass-hook-trust "..."

Flag--help, -h

BeschreibungZeigt Hilfe an

Beispielcodex --help

Flag--version, -V

BeschreibungZeigt Versionsnummer an

Beispielcodex --version

Flag	Beschreibung	Beispiel
`--config, -c`	Überschreibt config.toml-Werte. Gepunktete Pfade für Verschachtelung. Werte werden als TOML geparst.	`-c model_reasoning_effort='"high"'`
`--enable`	Aktiviert ein Feature Flag für diesen Lauf (wiederholbar)	`codex --enable search_tool`
`--disable`	Deaktiviert ein Feature Flag für diesen Lauf (wiederholbar)	`codex --disable search_tool`
`--model, -m`	Wählt ein Modell für den aktuellen Lauf	`codex -m gpt-5.6-terra`
`--oss / --local-provider`	Nutzt ein lokales Open-Source-Modell und wählt bei Bedarf LM Studio oder Ollama	`codex --oss --local-provider ollama`
`--remote`	Verbindet TUI, resume, fork sowie Session-Archivierung mit einem App-Server über WebSocket oder Unix-Socket	`codex --remote ws://127.0.0.1:4500`
`--remote-auth-token-env`	Liest für --remote einen Bearer-Token aus einer Umgebungsvariable	`--remote-auth-token-env CODEX_REMOTE_TOKEN`
`--sandbox, -s`	Wählt read-only, workspace-write oder danger-full-access	`-s workspace-write`
`--ask-for-approval, -a`	Legt die Genehmigungs-Policy on-request oder never fest	`codex -a on-request`
`--search`	Schaltet von der standardmäßigen gecachten auf Live-Websuche um	`codex --search "Prüfe die aktuelle Dokumentation"`
`--no-alt-screen`	Startet die TUI im Inline-Modus und erhält den Terminal-Scrollback	`codex --no-alt-screen`
`--strict-config`	Bricht bei unbekannten config.toml-Feldern ab	`codex --strict-config`
`--dangerously-bypass-approvals-and-sandbox, --yolo`	Umgeht Genehmigungen und Sandbox. Ausschließlich innerhalb einer extern gehärteten Umgebung.	`codex --yolo "..."`
`--dangerously-bypass-hook-trust`	Lässt aktivierte Hooks ohne gespeichertes Vertrauen laufen. Nur für bereits geprüfte Automatisierung.	`codex --dangerously-bypass-hook-trust "..."`
`--help, -h`	Zeigt Hilfe an	`codex --help`
`--version, -V`	Zeigt Versionsnummer an	`codex --version`

Fehlerbehebung

ProblemAuthentifizierung schlägt fehl

Wahrscheinliche UrsacheVeralteter Token oder falscher API-Key

Lösungcodex logout, dann codex login erneut ausführen

ProblemCodex hängt bei codex exec

Wahrscheinliche UrsacheDie Approval-Policy verlangt in einer unbeaufsichtigten Umgebung eine Bestätigung

LösungFür kontrollierte Automatisierung -s workspace-write und bewusst -a never setzen

ProblemBefehl wird in Sandbox blockiert

Wahrscheinliche UrsacheNetzwerkzugriff oder Schreibzugriff außerhalb des Arbeitsverzeichnisses

LösungZuerst --add-dir für weitere Schreibpfade prüfen. danger-full-access nur bewusst einsetzen

ProblemMCP-Server verbindet nicht

Wahrscheinliche UrsacheFehlende Dependencies oder falscher Pfad

Lösungcodex mcp get server-name prüfen, dann remove und neu add

ProblemSession lässt sich nicht fortsetzen

Wahrscheinliche UrsacheSession wurde mit --ephemeral gestartet

LösungOhne --ephemeral neu starten, damit Sessions gespeichert werden

ProblemCloud-Task zeigt keinen Diff

Wahrscheinliche UrsacheTask läuft noch oder ist fehlgeschlagen

Lösungcodex cloud status TASK_ID prüfen, dann erneut versuchen

ProblemCodex startet nach einem Update nicht mehr

Wahrscheinliche UrsacheVeraltete oder unbekannte Felder in config.toml

Lösungcodex --strict-config und codex doctor --summary ausführen

Problem	Wahrscheinliche Ursache	Lösung
Authentifizierung schlägt fehl	Veralteter Token oder falscher API-Key	codex logout, dann codex login erneut ausführen
Codex hängt bei codex exec	Die Approval-Policy verlangt in einer unbeaufsichtigten Umgebung eine Bestätigung	Für kontrollierte Automatisierung -s workspace-write und bewusst -a never setzen
Befehl wird in Sandbox blockiert	Netzwerkzugriff oder Schreibzugriff außerhalb des Arbeitsverzeichnisses	Zuerst --add-dir für weitere Schreibpfade prüfen. danger-full-access nur bewusst einsetzen
MCP-Server verbindet nicht	Fehlende Dependencies oder falscher Pfad	codex mcp get server-name prüfen, dann remove und neu add
Session lässt sich nicht fortsetzen	Session wurde mit --ephemeral gestartet	Ohne --ephemeral neu starten, damit Sessions gespeichert werden
Cloud-Task zeigt keinen Diff	Task läuft noch oder ist fehlgeschlagen	codex cloud status TASK_ID prüfen, dann erneut versuchen
Codex startet nach einem Update nicht mehr	Veraltete oder unbekannte Felder in config.toml	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.toml -- npm test

# Sandbox-Denials loggen (Debugging)
codex sandbox macos --log-denials -- ./build.sh