Codex Befehle: Die komplette Liste aller Commands

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

Die Referenz bezieht sich auf Codex CLI 0.161.0. Alle 55 Einträge der CLI-Übersicht haben eine Versionsangabe mit Quelllink
Die 57 Slash-Commands steuern Modell, Berechtigungen, Sessions und weitere TUI-Funktionen. Auch hier steht die Einführungsversion dabei
Drei Sandbox-Modi und die beiden CLI-Approval-Policies on-request und never steuern Shell-Zugriff und Genehmigungen
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
printenv OPENAI_API_KEY | codex login --with-api-key

# Login-Status prüfen
codex login status

# Abmelden
codex logout

# Interaktive TUI-Session starten
codex

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

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

# Desktop-App starten
codex app

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.

Die Befehlslisten beziehen sich auf Codex CLI 0.161.0 (Stand: 7. Oktober 2026). „Seit Version“ nennt den frühesten regulären Rust-Release mit dem jeweiligen Befehlsnamen. Jede Versionsangabe verlinkt dessen Quellstand. ≤ 0.2 bedeutet, dass der Befehl bereits im ersten geprüften regulären Rust-Release 0.2.0 vorkommt. Frühere JavaScript-Versionen und Vorabversionen sind nicht erfasst. Die Einführung einzelner Optionen oder die Verfügbarkeit auf jeder Plattform lässt sich daraus nicht ableiten.

Befehlcodex

Seit Version≤ 0.2

BeschreibungStartet die interaktive TUI im Terminal

Beispielcodex

Befehlcodex app

Seit Version0.95

BeschreibungÖffnet die Desktop-App, unter Windows bei Bedarf den Installer

Beispielcodex app

Befehlcodex agents

Seit Version0.149

BeschreibungZeigt Agenten-Sessions des lokalen App-Server-Daemons

Beispielcodex agents

Befehlcodex app-server

Seit Version0.43

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

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

Befehlcodex apply

Seit Version0.6

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

Beispielcodex apply TASK_ID

Befehlcodex archive

Seit Version0.136

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

Beispielcodex archive SESSION

Befehlcodex cloud

Seit Version0.43

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

Beispielcodex cloud list

Befehlcodex cloud exec

Seit Version0.47

BeschreibungReicht eine Cloud-Aufgabe in einer Zielumgebung ein

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

Befehlcodex cloud list

Seit Version0.88

BeschreibungListet Cloud-Tasks mit Filter- und Paginierungsoptionen

Beispielcodex cloud list

Befehlcodex cloud status

Seit Version0.66

BeschreibungZeigt den Status eines Cloud-Tasks

Beispielcodex cloud status TASK_ID

Befehlcodex cloud diff

Seit Version0.66

BeschreibungZeigt den Diff eines Cloud-Tasks

Beispielcodex cloud diff TASK_ID

Befehlcodex cloud apply

Seit Version0.66

BeschreibungWendet den Diff eines Cloud-Tasks lokal an

Beispielcodex cloud apply TASK_ID

Befehlcodex completion

Seit Version0.4

BeschreibungGeneriert Shell-Completions

Beispielcodex completion zsh

Befehlcodex debug

Seit Version≤ 0.2

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

Beispielcodex debug models --bundled

Befehlcodex delete

Seit Version0.140

BeschreibungLöscht eine gespeicherte Session dauerhaft

Beispielcodex delete SESSION

Befehlcodex doctor

Seit Version0.131

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

Beispielcodex doctor --summary

Befehlcodex exec

Seit Version≤ 0.2

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

Beispielcodex exec "Fix bug"

Befehlcodex exec resume

Seit Version0.35

BeschreibungSetzt eine vorherige Session nicht-interaktiv fort

Beispielcodex exec resume --last "Weiterarbeiten"

Befehlcodex exec fork

Seit Version0.148

BeschreibungForkt eine vorherige Session nicht-interaktiv in einen neuen Thread

Beispielcodex exec fork SESSION_ID "Alternative umsetzen"

Befehlcodex exec-server

Seit Version0.119

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

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

Befehlcodex execpolicy

Seit Version0.62

BeschreibungPrüft Exec-Policy-Regeln gegen einen Befehl

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

Befehlcodex features

Seit Version0.47

BeschreibungListet oder verwaltet Feature Flags

Beispielcodex features list

Befehlcodex fork

Seit Version0.81

BeschreibungForkt eine gespeicherte Session in einen neuen Thread

Beispielcodex fork --last

Befehlcodex login

Seit Version≤ 0.2

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

Beispielcodex login

Befehlcodex login status

Seit Version0.11

BeschreibungZeigt den aktuellen Anmeldestatus

Beispielcodex login status

Befehlcodex logout

Seit Version0.15

BeschreibungEntfernt gespeicherte Zugangsdaten

Beispielcodex logout

Befehlcodex mcp

Seit Version0.35

BeschreibungVerwaltet externe MCP-Server

Beispielcodex mcp list

Befehlcodex mcp add

Seit Version0.35

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

Beispielcodex mcp add name -- command

Befehlcodex mcp get

Seit Version0.35

BeschreibungZeigt die Konfiguration eines MCP-Servers

Beispielcodex mcp get name

Befehlcodex mcp remove

Seit Version0.35

BeschreibungEntfernt einen MCP-Server

Beispielcodex mcp remove name

Befehlcodex mcp login

Seit Version0.45

BeschreibungMeldet einen MCP-Server per OAuth an

Beispielcodex mcp login name

Befehlcodex mcp logout

Seit Version0.45

BeschreibungEntfernt gespeicherte OAuth-Anmeldedaten. Bei Enterprise Managed Auth (EMA) entfernt der Befehl die gemeinsame Autorisierung der betroffenen MCP-Server.

Beispielcodex mcp logout name

Befehlcodex migrate-rollouts

Seit Version0.148

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

Beispielcodex migrate-rollouts --verbose

Befehlcodex plugin

Seit Version0.122

BeschreibungInstalliert, listet oder entfernt Plugins aus konfigurierten Marktplätzen

Beispielcodex plugin list

Befehlcodex plugin marketplace

Seit Version0.122

BeschreibungVerwaltet Plugin-Marktplatz-Quellen aus Git oder lokalen Pfaden

Beispielcodex plugin marketplace add URL

Befehlcodex queue

Seit Version0.149

BeschreibungReiht eine Nachricht für eine bestehende lokale Session ein

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

Befehlcodex remote-control

Seit Version0.130

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

Beispielcodex remote-control pair

Befehlcodex resume

Seit Version0.35

BeschreibungSetzt eine interaktive Session über den Picker fort

Beispielcodex resume

Befehlcodex review

Seit Version0.65

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

Beispielcodex review --uncommitted

Befehlcodex sandbox

Seit Version0.45

BeschreibungFührt Befehle in einer Codex-Sandbox aus

Beispielcodex sandbox -- npm test

Befehlcodex unarchive

Seit Version0.136

BeschreibungStellt eine archivierte Session wieder her

Beispielcodex unarchive SESSION

Befehlcodex update

Seit Version0.126

BeschreibungAktualisiert Codex auf die neueste Version

Beispielcodex update

Befehlcodex mcp list

Seit Version0.35

BeschreibungListet konfigurierte MCP-Server

Beispielcodex mcp list

Befehlcodex exec review

Seit Version0.65

BeschreibungFührt ein Review mit den Ausgabeoptionen von exec aus

Beispielcodex exec review --uncommitted --json

Befehlcodex features list

Seit Version0.47

BeschreibungZeigt Feature Flags, Status und Reifegrad

Beispielcodex features list

Befehlcodex features enable

Seit Version0.93

BeschreibungAktiviert ein Feature dauerhaft

Beispielcodex features enable shell_snapshot

Befehlcodex features disable

Seit Version0.93

BeschreibungDeaktiviert ein Feature dauerhaft

Beispielcodex features disable shell_snapshot

Befehlcodex plugin add

Seit Version0.131

BeschreibungInstalliert ein Plugin aus einem Marktplatz

Beispielcodex plugin add PLUGIN@MARKETPLACE

Befehlcodex plugin list

Seit Version0.131

BeschreibungListet installierte und verfügbare Plugins

Beispielcodex plugin list --json

Befehlcodex plugin remove

Seit Version0.131

BeschreibungEntfernt ein installiertes Plugin

Beispielcodex plugin remove PLUGIN@MARKETPLACE

Befehlcodex app-server daemon

Seit Version0.131

BeschreibungVerwaltet den lokalen Hintergrundserver

Beispielcodex app-server daemon version

Befehlcodex app-server proxy

Seit Version0.125

BeschreibungVerbindet stdio mit dem Kontroll-Socket des lokalen Servers

Beispielcodex app-server proxy

Befehlcodex app-server generate-ts

Seit Version0.58

BeschreibungErzeugt TypeScript-Typen für das App-Server-Protokoll

Beispielcodex app-server generate-ts --out /tmp/codex-types

Befehlcodex app-server generate-json-schema

Seit Version0.58

BeschreibungErzeugt JSON-Schemas für das App-Server-Protokoll

Beispielcodex app-server generate-json-schema --out /tmp/codex-schema

Befehlcodex help

Seit Version≤ 0.2

BeschreibungZeigt die Hilfe eines Befehls

Beispielcodex help exec


`codex`	≤ 0.2	Startet die interaktive TUI im Terminal	`codex`
`codex app`	0.95	Öffnet die Desktop-App, unter Windows bei Bedarf den Installer	`codex app`
`codex agents`	0.149	Zeigt Agenten-Sessions des lokalen App-Server-Daemons	`codex agents`
`codex app-server`	0.43	Experimentell: Startet den App-Server für Entwicklung, Debugging oder Remote-Verbindungen	`codex app-server --listen ws://127.0.0.1:4500`
`codex apply`	0.6	Wendet den neuesten Diff eines Codex-Cloud-Chats lokal an	`codex apply TASK_ID`
`codex archive`	0.136	Archiviert eine gespeicherte Session, ohne ihr Transkript zu löschen	`codex archive SESSION`
`codex cloud`	0.43	Experimentell: Öffnet Cloud-Tasks oder führt sie im Terminal aus	`codex cloud list`
`codex cloud exec`	0.47	Reicht eine Cloud-Aufgabe in einer Zielumgebung ein	`codex cloud exec --env ENV_ID "..."`
`codex cloud list`	0.88	Listet Cloud-Tasks mit Filter- und Paginierungsoptionen	`codex cloud list`
`codex cloud status`	0.66	Zeigt den Status eines Cloud-Tasks	`codex cloud status TASK_ID`
`codex cloud diff`	0.66	Zeigt den Diff eines Cloud-Tasks	`codex cloud diff TASK_ID`
`codex cloud apply`	0.66	Wendet den Diff eines Cloud-Tasks lokal an	`codex cloud apply TASK_ID`
`codex completion`	0.4	Generiert Shell-Completions	`codex completion zsh`
`codex debug`	≤ 0.2	Experimentelle Diagnosewerkzeuge für Modellkatalog, Prompt-Eingabe und App-Server	`codex debug models --bundled`
`codex delete`	0.140	Löscht eine gespeicherte Session dauerhaft	`codex delete SESSION`
`codex doctor`	0.131	Prüft Installation, Konfiguration, Anmeldung, Laufzeit und Git-Umgebung	`codex doctor --summary`
`codex exec`	≤ 0.2	Führt eine Aufgabe nicht-interaktiv aus und streamt die Ausgabe	`codex exec "Fix bug"`
`codex exec resume`	0.35	Setzt eine vorherige Session nicht-interaktiv fort	`codex exec resume --last "Weiterarbeiten"`
`codex exec fork`	0.148	Forkt eine vorherige Session nicht-interaktiv in einen neuen Thread	`codex exec fork SESSION_ID "Alternative umsetzen"`
`codex exec-server`	0.119	Experimentell: Startet den Exec-Server für Remote-Umgebungen	`codex exec-server --listen ws://127.0.0.1:8787`
`codex execpolicy`	0.62	Prüft Exec-Policy-Regeln gegen einen Befehl	`codex execpolicy check --rules rules.rules -- npm test`
`codex features`	0.47	Listet oder verwaltet Feature Flags	`codex features list`
`codex fork`	0.81	Forkt eine gespeicherte Session in einen neuen Thread	`codex fork --last`
`codex login`	≤ 0.2	Meldet dich per ChatGPT, Device-Auth, API-Key oder Access-Token an	`codex login`
`codex login status`	0.11	Zeigt den aktuellen Anmeldestatus	`codex login status`
`codex logout`	0.15	Entfernt gespeicherte Zugangsdaten	`codex logout`
`codex mcp`	0.35	Verwaltet externe MCP-Server	`codex mcp list`
`codex mcp add`	0.35	Fügt einen MCP-Server über stdio oder HTTP hinzu	`codex mcp add name -- command`
`codex mcp get`	0.35	Zeigt die Konfiguration eines MCP-Servers	`codex mcp get name`
`codex mcp remove`	0.35	Entfernt einen MCP-Server	`codex mcp remove name`
`codex mcp login`	0.45	Meldet einen MCP-Server per OAuth an	`codex mcp login name`
`codex mcp logout`	0.45	Entfernt gespeicherte OAuth-Anmeldedaten. Bei Enterprise Managed Auth (EMA) entfernt der Befehl die gemeinsame Autorisierung der betroffenen MCP-Server.	`codex mcp logout name`
`codex migrate-rollouts`	0.148	Prüft oder migriert ältere lokale Sessions in die paginierte Thread-Historie	`codex migrate-rollouts --verbose`
`codex plugin`	0.122	Installiert, listet oder entfernt Plugins aus konfigurierten Marktplätzen	`codex plugin list`
`codex plugin marketplace`	0.122	Verwaltet Plugin-Marktplatz-Quellen aus Git oder lokalen Pfaden	`codex plugin marketplace add URL`
`codex queue`	0.149	Reiht eine Nachricht für eine bestehende lokale Session ein	`codex queue --thread SESSION --message "Weiter mit den Tests"`
`codex remote-control`	0.130	Experimentell: Startet, stoppt oder koppelt den fernsteuerbaren App-Server-Daemon	`codex remote-control pair`
`codex resume`	0.35	Setzt eine interaktive Session über den Picker fort	`codex resume`
`codex review`	0.65	Führt ein nicht-interaktives Review von Änderungen, Branch oder Commit aus	`codex review --uncommitted`
`codex sandbox`	0.45	Führt Befehle in einer Codex-Sandbox aus	`codex sandbox -- npm test`
`codex unarchive`	0.136	Stellt eine archivierte Session wieder her	`codex unarchive SESSION`
`codex update`	0.126	Aktualisiert Codex auf die neueste Version	`codex update`
`codex mcp list`	0.35	Listet konfigurierte MCP-Server	`codex mcp list`
`codex exec review`	0.65	Führt ein Review mit den Ausgabeoptionen von exec aus	`codex exec review --uncommitted --json`
`codex features list`	0.47	Zeigt Feature Flags, Status und Reifegrad	`codex features list`
`codex features enable`	0.93	Aktiviert ein Feature dauerhaft	`codex features enable shell_snapshot`
`codex features disable`	0.93	Deaktiviert ein Feature dauerhaft	`codex features disable shell_snapshot`
`codex plugin add`	0.131	Installiert ein Plugin aus einem Marktplatz	`codex plugin add PLUGIN@MARKETPLACE`
`codex plugin list`	0.131	Listet installierte und verfügbare Plugins	`codex plugin list --json`
`codex plugin remove`	0.131	Entfernt ein installiertes Plugin	`codex plugin remove PLUGIN@MARKETPLACE`
`codex app-server daemon`	0.131	Verwaltet den lokalen Hintergrundserver	`codex app-server daemon version`
`codex app-server proxy`	0.125	Verbindet stdio mit dem Kontroll-Socket des lokalen Servers	`codex app-server proxy`
`codex app-server generate-ts`	0.58	Erzeugt TypeScript-Typen für das App-Server-Protokoll	`codex app-server generate-ts --out /tmp/codex-types`
`codex app-server generate-json-schema`	0.58	Erzeugt JSON-Schemas für das App-Server-Protokoll	`codex app-server generate-json-schema --out /tmp/codex-schema`
`codex help`	≤ 0.2	Zeigt die Hilfe eines Befehls	`codex help exec`

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

Flag--worktree

BeschreibungFührt die Session in einem neuen verwalteten Git-Worktree aus

Beispielcodex exec --worktree "..."

Flag--thread-source

BeschreibungSetzt die Herkunftskennung neuer oder geforkter Threads

Beispielcodex exec --thread-source automation "..."

Flag--model, -m

BeschreibungÜberschreibt das Modell aus der Konfiguration

Beispiel-m gpt-6.1-sol

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 ~/.codex/NAME.config.toml zusätzlich zur Basis-Konfiguration

Beispiel-p fast-profile

Flag--enable / --disable

BeschreibungAktiviert oder deaktiviert Feature Flag für diesen Lauf

Beispiel--enable shell_snapshot

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--cyber-access-program

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

Beispielcodex exec --cyber-access-program standard "..."

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


`--worktree`	Führt die Session in einem neuen verwalteten Git-Worktree aus	`codex exec --worktree "..."`
`--thread-source`	Setzt die Herkunftskennung neuer oder geforkter Threads	`codex exec --thread-source automation "..."`
`--model, -m`	Überschreibt das Modell aus der Konfiguration	`-m gpt-6.1-sol`
`--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 ~/.codex/NAME.config.toml zusätzlich zur Basis-Konfiguration	`-p fast-profile`
`--enable / --disable`	Aktiviert oder deaktiviert Feature Flag für diesen Lauf	`--enable shell_snapshot`
`--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 "..."`
`--cyber-access-program`	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.	`codex exec --cyber-access-program standard "..."`
`--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-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"

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.

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

BeschreibungZusätzlicher Titel, nur zusammen mit --commit

Beispielcodex review --commit abc123 --title "Auth hinzufügen"

FlagPROMPT

BeschreibungBenutzerdefinierte Review-Anweisungen (auch via stdin mit -)

Beispielcodex review "Fokus auf Sicherheit"


`--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`	Zusätzlicher Titel, nur zusammen mit --commit	`codex review --commit abc123 --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 -s workspace-write -m gpt-6.1-sol resume --last \
  "Füge jetzt Error Handling hinzu"

# Spezifische Session per UUID fortsetzen
codex exec -s workspace-write -m gpt-6.1-sol resume SESSION_ID \
  "Setze den Plan um"

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

# Nicht-interaktiv forken (Session-ID erforderlich)
codex exec -s workspace-write fork SESSION_ID "Probiere einen anderen Ansatz"

# Session archivieren oder wiederherstellen
codex archive SESSION
codex unarchive SESSION

# Session endgültig löschen
codex delete SESSION

# Neuesten Diff eines Cloud-Tasks anwenden
codex apply TASK_ID

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

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

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 (1 bis 4), 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


`--env`	Pflichtangabe: Ziel-Umgebungs-ID für den Cloud-Task	`--env ENV_ID`
`--attempts`	Anzahl Versuche (1 bis 4), 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.

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.

Modusread-only

LesenGemäß Lese-Policy

SchreibenNirgends

NetzwerkStandardmäßig gesperrt

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

Modusworkspace-write

LesenGemäß Lese-Policy

SchreibenWorkspace, freigegebene Pfade und temporäre Verzeichnisse

NetzwerkStandardmäßig gesperrt

Wann nutzen?Standard für die meisten Aufgaben

Modusdanger-full-access

LesenNach Betriebssystemrechten

SchreibenÜberall

NetzwerkJa

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


`read-only`	Gemäß Lese-Policy	Nirgends	Standardmäßig gesperrt	Fragen, Erklärungen, Code-Analyse
`workspace-write`	Gemäß Lese-Policy	Workspace, freigegebene Pfade und temporäre Verzeichnisse	Standardmäßig gesperrt	Standard für die meisten Aufgaben
`danger-full-access`	Nach Betriebssystemrechten	Ü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


`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 Berechtigungen mit /permissions. Die dort angebotenen Presets kombinieren Sandbox und Genehmigungen. --approve-for-me nutzt eine automatische Prüfung von Genehmigungsanfragen und die Workspace-Sandbox.

MCP-Server (Model Context Protocol)

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

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

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

# Stdio-Server hinzufügen
codex mcp add my-server -- npx -y @my/mcp-server
codex mcp add my-server -- node /pfad/zum/server.js

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

# Server entfernen
codex mcp remove my-server

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

Tipp

codex mcp-server wurde in Version 0.154.0 entfernt. Für eigene Integrationen gibt es das App-Server-Protokoll über codex app-server. Das ist eine andere Schnittstelle und kein MCP-Server.

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. Einzelne Befehle können abhängig von Plattform, Modell oder aktivierten Features fehlen. Die Desktop-App hat eine eigene Befehlsauswahl, die du ebenfalls mit / öffnest.

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.

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/approve

Parameter

Seit Version0.129

BeschreibungGenehmigt einen Wiederholungsversuch nach einer Auto-Review-Ablehnung

Befehl/apps

Parameter

Seit Version0.93

BeschreibungZeigt und verwaltet verbundene Apps

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 Antwort oder einen Teil davon (auch Ctrl+O)

Befehl/daemon

Parameter

Seit Version0.156

BeschreibungVerwaltet den lokalen Hintergrundserver

Befehl/daybreak

Parameter

Seit Version0.161

BeschreibungSchaltet Daybreak um. Erfordert --enable cli_daybreak, einen freigeschalteten ChatGPT-Account beim OpenAI-Provider und unterstützte Modelle.

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 Version≤ 0.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/feedback

Parameter

Seit Version0.47

BeschreibungSendet Diagnose-Logs an die Codex-Maintainer

Befehl/fork

ParameterName optional

Seit Version0.81

BeschreibungVerzweigt die aktuelle Unterhaltung in einen neuen Chat

Befehl/goal

ParameterZiel | edit | pause | resume | clear

Seit Version0.126

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

Parameterdebug

Seit Version0.126

BeschreibungBelegt die TUI-Tastenkürzel neu oder zeigt ihre Diagnose

Befehl/logout

Parameter

Seit Version0.15

BeschreibungMeldet dich von Codex ab

Befehl/mcp

Parameterverbose | login <name>

Seit Version0.23

BeschreibungListet MCP-Tools auf, verbose zeigt Details. /mcp login <name> startet seit 0.161 die Anmeldung beim Server aus einer aktiven Session.

Befehl/memories

Parameter

Seit Version0.121

BeschreibungKonfiguriert Nutzung und Generierung von Memories

Befehl/mention

Parameter

Seit Version0.21

BeschreibungÖffnet die Dateisuche für eine Erwähnung im Prompt

Befehl/model

Parameter

Seit Version0.23

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

Befehl/new

ParameterName optional

Seit Version≤ 0.2

BeschreibungStartet einen neuen Chat in derselben CLI-Session

Befehl/permissions

Parameter

Seit Version0.89

BeschreibungLegt fest, was Codex ohne Nachfrage tun darf

Befehl/pets

ParameterID | off

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/recap

Parameter

Seit Version0.151

BeschreibungFasst die aktuelle Unterhaltung zusammen

Befehl/rename

ParameterName optional

Seit Version0.93

BeschreibungBenennt den aktuellen Chat um

Befehl/resume

ParameterID oder Name optional

Seit Version0.65

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

Befehl/review

ParameterAnweisungen optional

Seit Version0.39

BeschreibungÖffnet die Review-Auswahl oder prüft mit eigenen Anweisungen

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/tui

Parameter

Seit Version0.156

BeschreibungWählt den Terminal-Renderer für den nächsten Start

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

Befehl/voice

Parametersettings | mute | stop

Seit Version0.155

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

Befehl/warnings

Parameter

Seit Version0.156

BeschreibungZeigt gespeicherte Warnungen und Diagnosedetails

Befehl/worktree

Parameter

Seit Version0.154

BeschreibungStartet oder setzt eine Unterhaltung in einem neuen Git-Worktree fort


`/agents`		0.149	Zeigt und wechselt zwischen allen aktiven Agent-Sessions
`/app`		0.138	Öffnet die aktuelle Session in der Desktop-App
`/approve`		0.129	Genehmigt einen Wiederholungsversuch nach einer Auto-Review-Ablehnung
`/apps`		0.93	Zeigt und verwaltet verbundene Apps
`/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 Antwort oder einen Teil davon (auch `Ctrl+O`)
`/daemon`		0.156	Verwaltet den lokalen Hintergrundserver
`/daybreak`		0.161	Schaltet Daybreak um. Erfordert `--enable cli_daybreak`, einen freigeschalteten ChatGPT-Account beim OpenAI-Provider und unterstützte Modelle.
`/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
`/feedback`		0.47	Sendet Diagnose-Logs an die Codex-Maintainer
`/fork`	Name optional	0.81	Verzweigt die aktuelle Unterhaltung in einen neuen Chat
`/goal`	`Ziel \| edit \| pause \| resume \| clear`	0.126	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`	`debug`	0.126	Belegt die TUI-Tastenkürzel neu oder zeigt ihre Diagnose
`/logout`		0.15	Meldet dich von Codex ab
`/mcp`	`verbose \| login <name>`	0.23	Listet MCP-Tools auf, `verbose` zeigt Details. `/mcp login <name>` startet seit 0.161 die Anmeldung beim Server aus einer aktiven Session.
`/memories`		0.121	Konfiguriert Nutzung und Generierung von Memories
`/mention`		0.21	Öffnet die Dateisuche für eine Erwähnung im Prompt
`/model`		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
`/pets`	`ID \| off`	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
`/recap`		0.151	Fasst die aktuelle Unterhaltung zusammen
`/rename`	Name optional	0.93	Benennt den aktuellen Chat um
`/resume`	ID oder Name optional	0.65	Lädt eine gespeicherte Session direkt oder über den Session-Picker
`/review`	Anweisungen optional	0.39	Öffnet die Review-Auswahl oder prüft mit eigenen Anweisungen
`/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
`/tui`		0.156	Wählt den Terminal-Renderer für den nächsten Start
`/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
`/voice`	`settings \| mute \| stop`	0.155	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`		0.156	Zeigt gespeicherte Warnungen und Diagnosedetails
`/worktree`		0.154	Startet oder setzt eine Unterhaltung in einem neuen Git-Worktree fort

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


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

TastenkürzelCmd+/

BeschreibungTastenkürzel öffnen

TastenkürzelCtrl+`

BeschreibungTerminal ein-/ausblenden

TastenkürzelCtrl+Shift+G

BeschreibungReview-Tab öffnen

TastenkürzelCtrl+Shift+M

BeschreibungModellauswahl öffnen

TastenkürzelCtrl+Shift+V

BeschreibungSprachchat starten, wenn verfügbar

TastenkürzelCmd+Shift+A

BeschreibungChat archivieren

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

BeschreibungZwischen Chat und geöffneten Tabs wechseln

TastenkürzelCmd+J

BeschreibungUnteres Panel 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+Shift+D

BeschreibungDiktat starten, wenn verfügbar


`Cmd+/`	Tastenkürzel öffnen
Ctrl+`	Terminal ein-/ausblenden
`Ctrl+Shift+G`	Review-Tab öffnen
`Ctrl+Shift+M`	Modellauswahl öffnen
`Ctrl+Shift+V`	Sprachchat starten, wenn verfügbar
`Cmd+Shift+A`	Chat archivieren
`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`	Zwischen Chat und geöffneten Tabs wechseln
`Cmd+J`	Unteres Panel 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+Shift+D`	Diktat starten, wenn verfügbar

Hinweis

Die App unterstützt Deeplinks per codex://-Schema, z. B. codex://settings für Einstellungen oder codex://threads/new?prompt=dein%20prompt für einen neuen Chat mit vorausgefülltem Composer. Der Prompt wird dadurch nicht automatisch gesendet.

Konfiguration (config.toml)

Die Basiskonfiguration liegt 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.

Settingmodel

BeschreibungStandard-Modell für alle Sessions

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

Settingmodel_reasoning_effort

BeschreibungReasoning-Tiefe für komplexe Aufgaben

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

Settingpersonality

BeschreibungVeraltet: friendly und pragmatic ändern den Stil nicht mehr

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

Settingweb_search

BeschreibungModus für die Web-Suche

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


`model`	Standard-Modell für alle Sessions	`"gpt-6.1-sol"` oder `"gpt-6-luna"`, abhängig von deinem Zugang
`model_reasoning_effort`	Reasoning-Tiefe für komplexe Aufgaben	`"xhigh"`, `"high"`, `"medium"`, `"low"`
`personality`	Veraltet: friendly und pragmatic ändern den Stil nicht mehr	`"pragmatic"`, `"friendly"`, `"none"`
`web_search`	Modus für die Web-Suche	`"cached"` (Standard), `"live"`, `"disabled"`

# ~/.codex/config.toml

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

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

model = "gpt-6-luna"
model_reasoning_effort = "low"

model = "gpt-6.1-sol"
model_reasoning_effort = "high"

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

# Netzwerkzugriff für Shell-Befehle in workspace-write erlauben
codex exec -s workspace-write \
  -c sandbox_workspace_write.network_access=true "Aufgabe"

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

Feature Flags

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

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

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

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

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.

Flag--worktree

BeschreibungStartet in einem neuen verwalteten Git-Worktree

Beispielcodex --worktree

Flag--no-daemon

BeschreibungStartet ohne gemeinsamen Hintergrundserver

Beispielcodex --no-daemon

Flag--approve-for-me

BeschreibungPrüft Genehmigungsanfragen automatisch mit der Workspace-Sandbox

Beispielcodex --approve-for-me

Flag--profile, -p

BeschreibungLädt ein benanntes Profil aus NAME.config.toml

Beispielcodex -p thorough

Flag--cd, -C

BeschreibungSetzt den Arbeitsordner

Beispielcodex -C /path/to/project

Flag--add-dir

BeschreibungErlaubt weitere Schreibpfade

Beispielcodex --add-dir ../backend

Flag--image, -i

BeschreibungHängt Bilder an den ersten Prompt an

Beispielcodex -i screenshot.png

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 shell_snapshot

Flag--disable

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

Beispielcodex --disable shell_snapshot

Flag--model, -m

BeschreibungWählt ein Modell für den aktuellen Lauf

Beispielcodex -m gpt-6.1-sol

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


`--worktree`	Startet in einem neuen verwalteten Git-Worktree	`codex --worktree`
`--no-daemon`	Startet ohne gemeinsamen Hintergrundserver	`codex --no-daemon`
`--approve-for-me`	Prüft Genehmigungsanfragen automatisch mit der Workspace-Sandbox	`codex --approve-for-me`
`--profile, -p`	Lädt ein benanntes Profil aus NAME.config.toml	`codex -p thorough`
`--cd, -C`	Setzt den Arbeitsordner	`codex -C /path/to/project`
`--add-dir`	Erlaubt weitere Schreibpfade	`codex --add-dir ../backend`
`--image, -i`	Hängt Bilder an den ersten Prompt an	`codex -i screenshot.png`
`--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 shell_snapshot`
`--disable`	Deaktiviert ein Feature Flag für diesen Lauf (wiederholbar)	`codex --disable shell_snapshot`
`--model, -m`	Wählt ein Modell für den aktuellen Lauf	`codex -m gpt-6.1-sol`
`--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


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.rules -- npm test

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

Quellen zur Befehlsreferenz

Die Syntax und Konfiguration findest du in OpenAIs CLI-Referenz und der Konfigurationsdokumentation. Die Versionsspalten verlinken die jeweiligen Release-Quellstände von OpenAI. Für Sandbox und Genehmigungen gilt die Sicherheitsdokumentation.

FAQ

Häufig gestellte Fragen

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.

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.

Wähle das Modell im Kontext der Aufgabe und deines Zugangs. Die offizielle Dokumentation verwendet gpt-6.1-sol als Beispiel. Verfügbarkeit und Denkaufwand hängen von deinem Zugang und Modell ab. Ö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.

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.

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.

Die Sandbox beschränkt, was Codex auf deinem System tun darf. read-only verhindert Dateiänderungen durch Shell-Befehle. workspace-write erlaubt Änderungen im Workspace, in zusätzlich freigegebenen Pfaden und temporären Verzeichnissen. Netzwerkzugriff für Shell-Befehle ist standardmäßig gesperrt und lässt sich gezielt konfigurieren. danger-full-access hebt diese Sandbox-Grenzen auf. Websuche, Apps und MCP haben eigene Verbindungen und Richtlinien. Für die meisten Aufgaben reicht workspace-write.

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: printenv OPENAI_API_KEY | codex login --with-api-key. Setze --skip-git-repo-check, wenn du außerhalb eines Git-Repos arbeitest.

Beide sind Terminal-basierte KI-Coding-Agenten. Codex nutzt OpenAIs GPT-Modelle, Claude Code nutzt Anthropics Claude-Modelle. Beide bieten inzwischen Desktop-Oberflächen, Remote-Arbeit, Hooks und Git-Worktrees. Unterschiede liegen unter anderem bei verfügbaren Modellen, Erweiterungen, Berechtigungen und der Ausführung in Cloud-Umgebungen. Einen ausführlichen Vergleich findest du in unserem Artikel Claude Code vs. OpenAI Codex.

Codex Befehle: Die komplette Liste aller Commands

Codex installieren und starten

CLI-Befehle (Übersicht)

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

Häufige Muster

Code Review

Session-Management

Codex Cloud

App-Server und Remote-Steuerung

Sandbox-Modi

Approval Policies

MCP-Server (Model Context Protocol)

Slash-Commands der CLI

Tastenkürzel: CLI (TUI)

Tastenkürzel: Codex App

Konfiguration (config.toml)

Feature Flags

Globale Flags

Fehlerbehebung

Quellen zur Befehlsreferenz

FAQ

Häufig gestellte Fragen

Finn Hillebrandt

Ähnliche Artikel

Claude Code Befehle (100+): Die Referenz

Claude Code datenschutzkonform nutzen im Unternehmen

OpenAI Codex datenschutzkonform nutzen im Unternehmen

Cursor datenschutzkonform nutzen für Kundenprojekte

Claude Code Alternativen 2026: 12 Tools

Claude Kosten: Was Claude Code wirklich pro Monat kostet

Codex installieren und starten

CLI-Befehle (Übersicht)

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

Häufige Muster

Code Review

Session-Management

Codex Cloud

App-Server und Remote-Steuerung

Sandbox-Modi

Approval Policies

MCP-Server (Model Context Protocol)

Slash-Commands der CLI

Tastenkürzel: CLI (TUI)

Tastenkürzel: Codex App

Konfiguration (config.toml)

Feature Flags

Globale Flags

Fehlerbehebung

Quellen zur Befehlsreferenz

FAQ

Häufig gestellte Fragen

Ist Codex CLI kostenlos?

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

Welches Modell soll ich für Codex nutzen?

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

Wie setze ich eine vorherige Session fort?

Was macht die Sandbox genau?

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

Wie unterscheidet sich Codex von Claude Code?

Finn Hillebrandt

Ähnliche Artikel

Claude Code Befehle (100+): Die Referenz

Claude Code datenschutzkonform nutzen im Unternehmen

OpenAI Codex datenschutzkonform nutzen im Unternehmen

Cursor datenschutzkonform nutzen für Kundenprojekte

Claude Code Alternativen 2026: 12 Tools

Claude Kosten: Was Claude Code wirklich pro Monat kostet