Ist Codex CLI kostenlos?

Codex CLI selbst ist Open Source und kostenlos installierbar. Du brauchst aber einen OpenAI-Account mit API-Credits oder ein ChatGPT-Abo. Die Kosten hängen vom genutzten Modell und der Token-Menge ab. Mit einem ChatGPT Plus oder Pro Abo ist Codex im Rahmen der Fair-Use-Policy inkludiert.

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?

Seit dem 9. Juli 2026 ist GPT-5.6 Sol das stärkste verfügbare Modell für komplexe Coding-Aufgaben. Das bisherige Flaggschiff gpt-5.5 bleibt als günstigere Option nutzbar. Für einfachere Aufgaben reicht gpt-4.1 oder gpt-4.1-mini völlig aus und spart Kosten. Du kannst das Modell jederzeit mit /model in der TUI wechseln oder mit -m beim Start festlegen.

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. Codex speichert Sessions lokal unter ~/.codex/sessions/. Mit --ephemeral gestartete Sessions werden nicht gespeichert.

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 exec mit -s workspace-write für automatisierte Ausführung ohne Bestätigung. 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 hat dutzende CLI-Befehle, über 40 Slash-Commands in der interaktiven TUI und nochmal eine eigene Desktop-App mit separaten Shortcuts. Ohne 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

Über 30 CLI-Befehle stehen zur Verfügung: von codex exec (nicht-interaktive Ausführung) über codex review (Code Review) bis codex cloud (Cloud-Tasks)
Über 40 Slash-Commands im Composer steuern Modell, Berechtigungen, Sessions, Plan-Modus und mehr, mit Parameter und (soweit dokumentiert) Einführungs-Version in der Tabelle
Drei Sandbox-Modi (read-only, workspace-write, danger-full-access) und vier Approval-Policies steuern, was Codex auf deinem System tun darf
Codex Cloud lagert langwierige Aufgaben in Remote-Sandbox-Umgebungen aus, mit Best-of-N-Versuchen

Codex installieren und starten

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

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

# Oder per Homebrew (nativer Rust-Binary, schneller)
brew install codex

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

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

# Login-Status prüfen
codex login status

# Abmelden
codex logout

# Interaktive TUI-Session starten
codex

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

# Nicht-interaktiv ausführen (für Skripte)
codex exec -s workspace-write -m gpt-5.5 „Refactore auth.ts“

# Desktop-App starten
codex 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 interaktive TUI-Session im Terminal

Beispielcodex

Befehlcodex app

BeschreibungStartet die Codex Desktop-App (macOS/Windows)

Beispielcodex app

Befehlcodex exec

BeschreibungFührt Aufgabe nicht-interaktiv aus, streamt Output nach stdout

Beispielcodex exec "Fix bug"

Befehlcodex exec resume

BeschreibungSetzt vorherige Session nicht-interaktiv fort

Beispielcodex exec resume --last "Weiterarbeiten"

Befehlcodex review

BeschreibungCode Review (uncommitted, Branch-Diff oder Commit)

Beispielcodex review --uncommitted

Befehlcodex apply

BeschreibungWendet Diff aus einer Codex-Session oder Cloud-Task an

Beispielcodex apply TASK_ID

Befehlcodex resume

BeschreibungSetzt interaktive Session fort (Session-Picker)

Beispielcodex resume

Befehlcodex fork

BeschreibungForkt eine Session in einen neuen Thread

Beispielcodex fork

Befehlcodex cloud exec

BeschreibungReicht Cloud-Task in Sandbox-Umgebung ein

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

Befehlcodex cloud list

BeschreibungListet Cloud-Tasks auf (mit Filter und Pagination)

Beispielcodex cloud list

Befehlcodex cloud status

BeschreibungZeigt Status eines Cloud-Tasks

Beispielcodex cloud status ID

Befehlcodex cloud diff

BeschreibungZeigt den Diff eines Cloud-Tasks an

Beispielcodex cloud diff ID

Befehlcodex cloud apply

BeschreibungWendet Cloud-Task-Diff lokal an

Beispielcodex cloud apply ID

Befehlcodex mcp add

BeschreibungFügt MCP-Server hinzu (stdio oder HTTP)

Beispielcodex mcp add name -- cmd

Befehlcodex mcp list

BeschreibungListet konfigurierte MCP-Server auf

Beispielcodex mcp list

Befehlcodex mcp get

BeschreibungZeigt Konfiguration eines MCP-Servers

Beispielcodex mcp get name

Befehlcodex mcp remove

BeschreibungEntfernt einen MCP-Server

Beispielcodex mcp remove name

Befehlcodex mcp login

BeschreibungOAuth-Login für einen MCP-Server

Beispielcodex mcp login name

Befehlcodex mcp logout

BeschreibungEntfernt OAuth-Credentials eines MCP-Servers

Beispielcodex mcp logout name

Befehlcodex features list

BeschreibungZeigt Feature Flags mit Status und Reifegrad

Beispielcodex features list

Befehlcodex features enable/disable

BeschreibungAktiviert oder deaktiviert ein Feature Flag dauerhaft

Beispielcodex features enable NAME

Befehlcodex login

BeschreibungAnmelden per OAuth oder API-Key

Beispielcodex login

Befehlcodex login status

BeschreibungZeigt aktuellen Login-Status

Beispielcodex login status

Befehlcodex logout

BeschreibungEntfernt gespeicherte Credentials

Beispielcodex logout

Befehlcodex sandbox

BeschreibungFührt Befehl in Codex-Sandbox aus (macOS/Linux/Windows)

Beispielcodex sandbox -- cmd

Befehlcodex completion

BeschreibungGeneriert Shell-Completions (bash, zsh, fish, elvish, PowerShell)

Beispielcodex completion zsh

Befehlcodex update

BeschreibungPrüft auf Updates und installiert neue Version

Beispielcodex update

Befehlcodex execpolicy

BeschreibungPrüft Exec-Policy-Regeldateien vor dem Speichern

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

Befehlcodex mcp-server

BeschreibungStartet Codex selbst als MCP-Server (stdio-Transport)

Beispielcodex mcp-server

Befehlcodex plugin marketplace

BeschreibungVerwaltet Plugin-Marktplatz-Quellen (add, remove, upgrade)

Beispielcodex plugin marketplace add URL

Befehlcodex remote-control

BeschreibungStartet einen headless App-Server, fernsteuerbar per Codex App oder Chrome Extension (seit 0.130)

Beispielcodex remote-control

	Beschreibung	Beispiel
`codex`	Startet interaktive TUI-Session im Terminal	`codex`
`codex app`	Startet die Codex Desktop-App (macOS/Windows)	`codex app`
`codex exec`	Führt Aufgabe nicht-interaktiv aus, streamt Output nach stdout	`codex exec "Fix bug"`
`codex exec resume`	Setzt vorherige Session nicht-interaktiv fort	`codex exec resume --last "Weiterarbeiten"`
`codex review`	Code Review (uncommitted, Branch-Diff oder Commit)	`codex review --uncommitted`
`codex apply`	Wendet Diff aus einer Codex-Session oder Cloud-Task an	`codex apply TASK_ID`
`codex resume`	Setzt interaktive Session fort (Session-Picker)	`codex resume`
`codex fork`	Forkt eine Session in einen neuen Thread	`codex fork`
`codex cloud exec`	Reicht Cloud-Task in Sandbox-Umgebung ein	`codex cloud exec --env ENV_ID "..."`
`codex cloud list`	Listet Cloud-Tasks auf (mit Filter und Pagination)	`codex cloud list`
`codex cloud status`	Zeigt Status eines Cloud-Tasks	`codex cloud status ID`
`codex cloud diff`	Zeigt den Diff eines Cloud-Tasks an	`codex cloud diff ID`
`codex cloud apply`	Wendet Cloud-Task-Diff lokal an	`codex cloud apply ID`
`codex mcp add`	Fügt MCP-Server hinzu (stdio oder HTTP)	`codex mcp add name -- cmd`
`codex mcp list`	Listet konfigurierte MCP-Server auf	`codex mcp list`
`codex mcp get`	Zeigt Konfiguration eines MCP-Servers	`codex mcp get name`
`codex mcp remove`	Entfernt einen MCP-Server	`codex mcp remove name`
`codex mcp login`	OAuth-Login für einen MCP-Server	`codex mcp login name`
`codex mcp logout`	Entfernt OAuth-Credentials eines MCP-Servers	`codex mcp logout name`
`codex features list`	Zeigt Feature Flags mit Status und Reifegrad	`codex features list`
`codex features enable/disable`	Aktiviert oder deaktiviert ein Feature Flag dauerhaft	`codex features enable NAME`
`codex login`	Anmelden per OAuth oder API-Key	`codex login`
`codex login status`	Zeigt aktuellen Login-Status	`codex login status`
`codex logout`	Entfernt gespeicherte Credentials	`codex logout`
`codex sandbox`	Führt Befehl in Codex-Sandbox aus (macOS/Linux/Windows)	`codex sandbox -- cmd`
`codex completion`	Generiert Shell-Completions (bash, zsh, fish, elvish, PowerShell)	`codex completion zsh`
`codex update`	Prüft auf Updates und installiert neue Version	`codex update`
`codex execpolicy`	Prüft Exec-Policy-Regeldateien vor dem Speichern	`codex execpolicy check --rules rules.toml -- npm test`
`codex mcp-server`	Startet Codex selbst als MCP-Server (stdio-Transport)	`codex mcp-server`
`codex plugin marketplace`	Verwaltet Plugin-Marktplatz-Quellen (add, remove, upgrade)	`codex plugin marketplace add URL`
`codex remote-control`	Startet einen headless App-Server, fernsteuerbar per Codex App oder Chrome Extension (seit 0.130)	`codex remote-control`

Hinweis

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

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

codex exec ist das Arbeitspferd für automatisierte Workflows. Ohne Flags wartet Codex auf menschliche Genehmigung, was in Skripten zum Hängen führt. Deshalb solltest du mindestens einen Sandbox-Modus setzen.

# Standard-Pattern für automatisierte Ausführung
codex exec -s workspace-write -m gpt-5.5 "dein Prompt"

# Mit maximaler Reasoning-Tiefe
codex exec -s workspace-write -m gpt-5.5 \
  -c model_reasoning_effort='"xhigh"' "komplexe Aufgabe"

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

Flag--model, -m

BeschreibungÜberschreibt das Modell aus der Konfiguration

Beispiel-m gpt-5.5

Flag--sandbox, -s

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

Beispiel-s workspace-write

Flag--ask-for-approval, -a

BeschreibungGenehmigungs-Policy: untrusted, on-failure, on-request, never

Beispiel-a on-request

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 lokalen Open-Source-Provider (Ollama)

Beispielcodex exec --oss "..."

Flag--full-auto

BeschreibungDeprecated. Alias für -a on-request -s workspace-write. Nutze stattdessen direkt -s workspace-write

Beispielcodex exec --full-auto "..."

Flag	Beschreibung	Beispiel
`--model, -m`	Überschreibt das Modell aus der Konfiguration	`-m gpt-5.5`
`--sandbox, -s`	Sandbox-Modus: read-only, workspace-write oder danger-full-access	`-s workspace-write`
`--ask-for-approval, -a`	Genehmigungs-Policy: untrusted, on-failure, on-request, never	`-a on-request`
`--cd, -C`	Setzt das Arbeitsverzeichnis für den Agent	`-C /pfad/zum/projekt`
`--add-dir`	Zusätzliche beschreibbare Verzeichnisse freigeben	`--add-dir ../backend`
`--image, -i`	Hängt Bilder an den Prompt an (wiederholbar)	`-i screenshot.png`
`--config, -c`	Überschreibt config.toml-Werte (TOML-Syntax)	`-c model_reasoning_effort='"xhigh"'`
`--profile, -p`	Lädt benanntes Config-Profil aus config.toml	`-p fast-profile`
`--enable / --disable`	Aktiviert oder deaktiviert Feature Flag für diesen Lauf	`--enable search_tool`
`--json`	Gibt Events als JSONL aus (eine JSON-Zeile pro Event)	`codex exec --json "..."`
`--output-last-message, -o`	Speichert letzte Agent-Nachricht in Datei	`-o /tmp/result.txt`
`--output-schema`	JSON-Schema-Datei, die die finale Antwort beschränkt	`--output-schema schema.json`
`--ephemeral`	Session wird nicht auf Disk persistiert	`codex exec --ephemeral "..."`
`--skip-git-repo-check`	Erlaubt Ausführung außerhalb eines Git-Repos	`codex exec --skip-git-repo-check "..."`
`--color`	ANSI-Farben steuern: always, never, auto	`--color never`
`--oss`	Nutzt lokalen Open-Source-Provider (Ollama)	`codex exec --oss "..."`
`--full-auto`	Deprecated. Alias für `-a on-request -s workspace-write`. Nutze stattdessen direkt `-s workspace-write`	`codex exec --full-auto "..."`

Warnung

--full-auto ist deprecated. Nutze stattdessen -s workspace-write (oder -s workspace-write -a on-request für das gleiche Verhalten).

Häufige Muster

# Bilder anhängen (Screenshots, Design-Specs)
codex exec -s workspace-write -m gpt-5.5 -i screenshot.png „Implementiere dieses UI“

# Mehrere beschreibbare Verzeichnisse
codex exec -s workspace-write -C apps/frontend --add-dir ../backend „Sync API-Types“

# JSON-Output für Skripte
codex exec -s workspace-write --json „Liste alle TODO-Kommentare“

# Ergebnis in Datei speichern
codex exec -s workspace-write -o /tmp/result.txt „Fasse die Codebase zusammen“

# Strukturierte Ausgabe mit JSON Schema
codex exec -s workspace-write --output-schema schema.json „Extrahiere alle API-Endpoints“

# Prompt per stdin übergeben
cat prompt.txt | codex exec -s workspace-write -

# Config-Profil nutzen
codex exec -s workspace-write -p thorough „gründliche Analyse“

# Lokales Open-Source-Modell (Ollama)
codex exec --oss -s workspace-write „Erkläre diese Funktion“

Code Review

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

Flag--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 mit Titel und benutzerdefiniertem Fokus
codex review --base main --title „Auth hinzufügen“ „Fokus auf Sicherheit“

# Review per exec mit JSON-Output
codex exec review --uncommitted --json

Session-Management

Codex speichert Sessions lokal unter ~/.codex/sessions/. Du kannst sie jederzeit fortsetzen, forken oder nicht-interaktiv wieder aufnehmen.

# Interaktiv: Session-Picker öffnen
codex resume

# Interaktiv: Letzte Session direkt fortsetzen
codex resume --last

# Nicht-interaktiv: Letzte Session mit neuem Prompt fortsetzen
codex exec resume --last -s workspace-write -m gpt-5.5 \
  „Füge jetzt Error Handling hinzu“

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

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

# Diff aus einer lokalen Session anwenden
codex apply TASK_ID

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

# Spezifischen Versuch anwenden (bei --attempts N)
codex cloud apply TASK_ID --attempt 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 führt Aufgaben in sandboxed Remote-Umgebungen aus. Alle Unterbefehle sind nicht-interaktiv. Die --env-Angabe ist 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, Max: 4

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, Max: 4	`--attempts 3`
`--branch`	Git-Branch, auf dem der Task laufen soll	`--branch feature/auth`
`--json`	Maschinenlesbare JSON-Ausgabe (für codex cloud list)	`codex cloud list --json`
`--limit`	Maximale Anzahl zurückgegebener Tasks (1-20)	`codex cloud list --limit 5`
`--cursor`	Paginierungs-Cursor vom vorherigen Aufruf	`codex cloud list --cursor CURSOR`
`--attempt`	Versuchsnummer für diff/apply (bei --attempts N)	`codex cloud diff TASK_ID --attempt 2`

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

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

# Auf spezifischem Branch
codex cloud exec --env ENV_ID --branch feature/auth „OAuth hinzufügen“

# Tasks auflisten
codex cloud list
codex cloud list --json --limit 5

# Status prüfen
codex cloud status TASK_ID

# Diff anzeigen (spezifischer Versuch)
codex cloud diff TASK_ID --attempt 2

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 Sandbox ausführen (macOS)
codex sandbox macos -- npm test

# Mit Log der abgelehnten Zugriffe
codex sandbox macos --log-denials -- ./build.sh

# Linux (Landlock + seccomp)
codex sandbox linux -- python3 script.py

Approval Policies

Approval Policies steuern, wann Codex um Erlaubnis fragt, bevor ein Befehl ausgeführt wird. Den Modus setzt du mit -a oder --ask-for-approval.

Policyuntrusted

VerhaltenNur vertrauenswürdige Befehle (ls, cat, sed) laufen ohne Genehmigung

Policyon-failure

VerhaltenAlle Befehle laufen, Genehmigung nur bei Fehler

Policyon-request

VerhaltenModell entscheidet, wann es um Erlaubnis fragt

Policynever

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

Policy	Verhalten
`untrusted`	Nur vertrauenswürdige Befehle (ls, cat, sed) laufen ohne Genehmigung
`on-failure`	Alle Befehle laufen, Genehmigung nur bei Fehler
`on-request`	Modell entscheidet, wann es um Erlaubnis fragt
`never`	Fragt nie nach Genehmigung, Fehler gehen direkt ans Modell zurück

Hinweis

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

MCP-Server (Model Context Protocol)

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

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

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

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

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

# Server entfernen
codex mcp remove my-server

# OAuth-Login für MCP-Server
codex mcp login my-server --scopes "read,write"
codex mcp logout my-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 Spalte „Seit“ zeigt, ab welcher Codex-Version ein Befehl in den offiziellen Release Notes dokumentiert ist (soweit belegt, sonst „k. A.“).

Befehl/agent

Parameter

Seit0.95

BeschreibungWechselt den aktiven Agenten-Thread

Befehl/apps

Parameter

Seit0.93

BeschreibungDurchsucht Connectors und Apps und fügt sie in den Prompt ein

Befehl/approve

Parameter

Seit0.129

BeschreibungGenehmigt einen Wiederholungsversuch nach abgelehntem Auto-Review

Befehl/archive

Parameter

Seit0.136

BeschreibungArchiviert die aktuelle Session und beendet Codex

Befehl/clear

Parameter

Seit0.105

BeschreibungLeert das Terminal und startet einen neuen Chat

Befehl/compact

Parameter

Seit0.11

BeschreibungFasst die sichtbare Unterhaltung zusammen, um Token freizugeben

Befehl/copy

Parameter

Seit0.105

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

Befehl/debug-config

Parameter

Seit0.96

BeschreibungGibt Konfigurations-Layer und Diagnose aus

Befehl/delete

Parameter

Seit0.140

BeschreibungLöscht die aktuelle Session dauerhaft und beendet Codex

Befehl/diff

Parameter

Seit0.23

BeschreibungZeigt das Git-Diff inklusive untracked Dateien

Befehl/exit

Parameter

Seit0.53

BeschreibungBeendet die CLI (Alias /quit)

Befehl/experimental

Parameter

Seit0.74

BeschreibungSchaltet experimentelle Features ein oder aus

Befehl/fast

Parameteron | off | status

Seit0.110

BeschreibungSchaltet den Fast-Service-Tier um

Befehl/feedback

Parameter

Seit0.50

BeschreibungSendet Logs an die Codex-Maintainer (auch App)

Befehl/fork

Parameter

Seit0.88

BeschreibungVerzweigt die aktuelle Unterhaltung in einen neuen Thread

Befehl/goal

ParameterZiel | pause | resume | clear

Seit0.128

BeschreibungSetzt, pausiert oder löscht ein Aufgabenziel

Befehl/hooks

Parameter

Seit0.129

BeschreibungZeigt und verwaltet Lifecycle-Hooks

Befehl/ide

ParameterText

Seit0.129

BeschreibungBindet offene Dateien, Auswahl und IDE-Kontext ein

Befehl/import

Parameter

Seit0.140

BeschreibungImportiert Claude-Code-Setup, Projektdateien und Chats

Befehl/init

Parameter

Seit0.28

BeschreibungGeneriert ein AGENTS.md-Gerüst als Projektkontext

Befehl/keymap

Parameter

Seit0.129

BeschreibungBelegt die TUI-Tastenkürzel neu

Befehl/logout

Parameter

Seitk. A.

BeschreibungMeldet dich von Codex ab

Befehl/mcp

Parameterverbose

Seit0.23

BeschreibungListet die konfigurierten MCP-Tools auf (auch App)

Befehl/memories

Parameter

Seitk. A.

BeschreibungKonfiguriert Nutzung und Generierung von Memories

Befehl/mention

ParameterPfad

Seitk. A.

BeschreibungHängt eine Datei an die Unterhaltung an

Befehl/model

ParameterModell

Seit0.23

BeschreibungWählt das aktive Modell und den Reasoning-Effort

Befehl/new

Parameter

Seit0.59

BeschreibungStartet eine neue Unterhaltung in derselben CLI-Session

Befehl/permissions

Parameter

Seit0.89

BeschreibungLegt fest, was Codex ohne Nachfrage tun darf

Befehl/personality

ParameterStil

Seit0.92

BeschreibungWählt einen Kommunikationsstil für die Antworten

Befehl/plan

ParameterPrompt

Seit0.93

BeschreibungWechselt in den Plan-Modus (optionaler Inline-Prompt)

Befehl/plugins

Parameter

Seit0.117

BeschreibungDurchsucht installierte und verfügbare Plugins

Befehl/ps

Parameter

Seit0.76

BeschreibungZeigt experimentelle Hintergrund-Terminals

Befehl/raw

Parameteron | off

Seit0.129

BeschreibungSchaltet den Raw-Scrollback-Modus um

Befehl/resume

Parameter

Seit0.65

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

Befehl/review

Parameter

Seit0.39

BeschreibungLässt Codex den Working Tree prüfen (Code Review, auch App)

Befehl/sandbox-add-read-dir

ParameterVerzeichnis

Seitk. A.

BeschreibungGibt der Sandbox Lesezugriff auf ein Verzeichnis (nur Windows)

Befehl/side

ParameterText

Seit0.122

BeschreibungStartet eine kurzlebige Nebenunterhaltung (Alias /btw)

Befehl/skills

Parameter

Seit0.65

BeschreibungDurchsucht und nutzt Skills

Befehl/status

Parameter

Seit0.23

BeschreibungZeigt Modell, Approval Policy, beschreibbare Pfade und Token-Nutzung (auch App)

Befehl/statusline

Parameter

Seit0.99

BeschreibungKonfiguriert die Elemente der TUI-Statuszeile

Befehl/stop

Parameter

Seit0.115

BeschreibungStoppt alle Hintergrund-Terminals

Befehl/theme

Parameter

Seit0.105

BeschreibungWählt ein Syntax-Highlighting-Theme

Befehl/title

Parameter

Seit0.117

BeschreibungKonfiguriert die Elemente im Terminal-Titel

Befehl/usage

Parameterdaily | weekly | cumulative

Seit0.140

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

Befehl/vim

Parameter

Seit0.129

BeschreibungSchaltet den Vim-Modus für den Composer um

	Parameter		Beschreibung
`/agent`		0.95	Wechselt den aktiven Agenten-Thread
`/apps`		0.93	Durchsucht Connectors und Apps und fügt sie in den Prompt ein
`/approve`		0.129	Genehmigt einen Wiederholungsversuch nach abgelehntem Auto-Review
`/archive`		0.136	Archiviert die aktuelle Session und beendet Codex
`/clear`		0.105	Leert das Terminal und startet einen neuen Chat
`/compact`		0.11	Fasst die sichtbare Unterhaltung zusammen, um Token freizugeben
`/copy`		0.105	Kopiert die letzte fertige Codex-Ausgabe (auch `Ctrl+O`)
`/debug-config`		0.96	Gibt Konfigurations-Layer und Diagnose aus
`/delete`		0.140	Löscht die aktuelle Session dauerhaft und beendet Codex
`/diff`		0.23	Zeigt das Git-Diff inklusive untracked Dateien
`/exit`		0.53	Beendet die CLI (Alias `/quit`)
`/experimental`		0.74	Schaltet experimentelle Features ein oder aus
`/fast`	`on \| off \| status`	0.110	Schaltet den Fast-Service-Tier um
`/feedback`		0.50	Sendet Logs an die Codex-Maintainer (auch App)
`/fork`		0.88	Verzweigt die aktuelle Unterhaltung in einen neuen Thread
`/goal`	`Ziel \| pause \| resume \| clear`	0.128	Setzt, pausiert oder löscht ein Aufgabenziel
`/hooks`		0.129	Zeigt und verwaltet Lifecycle-Hooks
`/ide`	Text	0.129	Bindet offene Dateien, Auswahl und IDE-Kontext ein
`/import`		0.140	Importiert Claude-Code-Setup, Projektdateien und Chats
`/init`		0.28	Generiert ein AGENTS.md-Gerüst als Projektkontext
`/keymap`		0.129	Belegt die TUI-Tastenkürzel neu
`/logout`		k. A.	Meldet dich von Codex ab
`/mcp`	`verbose`	0.23	Listet die konfigurierten MCP-Tools auf (auch App)
`/memories`		k. A.	Konfiguriert Nutzung und Generierung von Memories
`/mention`	Pfad	k. A.	Hängt eine Datei an die Unterhaltung an
`/model`	Modell	0.23	Wählt das aktive Modell und den Reasoning-Effort
`/new`		0.59	Startet eine neue Unterhaltung in derselben CLI-Session
`/permissions`		0.89	Legt fest, was Codex ohne Nachfrage tun darf
`/personality`	Stil	0.92	Wählt einen Kommunikationsstil für die Antworten
`/plan`	Prompt	0.93	Wechselt in den Plan-Modus (optionaler Inline-Prompt)
`/plugins`		0.117	Durchsucht installierte und verfügbare Plugins
`/ps`		0.76	Zeigt experimentelle Hintergrund-Terminals
`/raw`	`on \| off`	0.129	Schaltet den Raw-Scrollback-Modus um
`/resume`		0.65	Lädt eine gespeicherte Session über den Session-Picker
`/review`		0.39	Lässt Codex den Working Tree prüfen (Code Review, auch App)
`/sandbox-add-read-dir`	Verzeichnis	k. A.	Gibt der Sandbox Lesezugriff auf ein Verzeichnis (nur Windows)
`/side`	Text	0.122	Startet eine kurzlebige Nebenunterhaltung (Alias `/btw`)
`/skills`		0.65	Durchsucht und nutzt Skills
`/status`		0.23	Zeigt Modell, Approval Policy, beschreibbare Pfade und Token-Nutzung (auch App)
`/statusline`		0.99	Konfiguriert die Elemente der TUI-Statuszeile
`/stop`		0.115	Stoppt alle Hintergrund-Terminals
`/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.5“ (empfohlen), „gpt-5.4“, „gpt-4.1“, „gpt-4.1-mini“

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.5“` (empfohlen), `„gpt-5.4“`, `„gpt-4.1“`, `„gpt-4.1-mini“`
`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.5"
model_reasoning_effort = "high"

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

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

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

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

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

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

Feature Flags

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

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

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

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

Globale Flags

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

Flag--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--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`
`--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 UrsacheKein Sandbox-Modus gesetzt (wartet auf Genehmigung)

LösungImmer -s workspace-write oder -a on-request mitgeben

ProblemBefehl wird in Sandbox blockiert

Wahrscheinliche UrsacheNetzwerkzugriff oder Schreibzugriff außerhalb des Arbeitsverzeichnisses

Lösung-s danger-full-access nutzen (nur wenn nötig)

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

Problem	Wahrscheinliche Ursache	Lösung
Authentifizierung schlägt fehl	Veralteter Token oder falscher API-Key	codex logout, dann codex login erneut ausführen
Codex hängt bei codex exec	Kein Sandbox-Modus gesetzt (wartet auf Genehmigung)	Immer -s workspace-write oder -a on-request mitgeben
Befehl wird in Sandbox blockiert	Netzwerkzugriff oder Schreibzugriff außerhalb des Arbeitsverzeichnisses	-s danger-full-access nutzen (nur wenn nötig)
MCP-Server verbindet nicht	Fehlende Dependencies oder falscher Pfad	codex mcp get server-name prüfen, dann remove und neu add
Session lässt sich nicht fortsetzen	Session wurde mit --ephemeral gestartet	Ohne --ephemeral neu starten, damit Sessions gespeichert werden
Cloud-Task zeigt keinen Diff	Task läuft noch oder ist fehlgeschlagen	codex cloud status TASK_ID prüfen, dann erneut versuchen

# Konfigurationslayer diagnostizieren
# (in der interaktiven TUI)
/debug-config

# Verfügbare Modelle als JSON anzeigen
codex debug models

# Nur eingebauten Modellkatalog anzeigen (kein API-Refresh)
codex debug models --bundled

# Exec-Policy-Regeln prüfen (vor dem Speichern)
codex execpolicy check --rules rules.toml -- npm test

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