OpenAI Codex CLI ist OpenAIs terminal-nativer Coding-Agent, der Codebases inspiziert, Dateien bearbeitet, Tests ausführt, sich in Remote-Aufgaben der Codex Cloud integriert und direkt über die Kommandozeile via MCP auf externe Tools zugreift.
Dieser Spickzettel deckt Codex-CLI-Unterbefehle und Flags, Sandbox- und Genehmigungsrichtlinien, interaktive TUI-Slash-Befehle, Tastenkürzel sowie die Konfiguration über config.toml und AGENTS.md ab.
🔗 Verwandte Spickzettel: Terminal-KI-Coding-CLIs im Vergleich · Claude Code CLI Spickzettel · Antigravity CLI (agy) Spickzettel · AI Agent Harness Engineering Spickzettel
1. Installation, Authentifizierung & zentrale CLI-Befehle
1.1 Installation & Authentifizierung
| Aktion | Befehl | Hinweise |
|---|---|---|
| Globale npm-Installation | npm install -g @openai/codex |
Standard-Installation über alle Plattformen hinweg |
| Offizielles Installationsskript | curl -fsSL https://chatgpt.com/codex/install.sh | sh |
Einzeiler-Installer für macOS / Linux |
| Browser-Login | codex login |
Authentifizierung mit ChatGPT Plus / Pro / Team-Konto |
| API-Key-Auth | export OPENAI_API_KEY="sk-..." |
Ideal für Headless-CI oder Container-Umgebungen |
1.2 CLI-Unterbefehle & globale Flags
| Befehl / Flag | Beschreibung | Beispielaufruf |
|---|---|---|
codex |
Interaktive TUI im aktuellen Verzeichnis starten | codex |
codex "prompt" |
Interaktive Sitzung direkt mit Start-Prompt beginnen | codex "Debug 500 timeout errors on login" |
codex exec / codex e |
Nicht-interaktive (Headless-)Ausführung für Skripte und CI | codex exec "Run all unit tests and fix failures" |
codex exec --json |
Strukturierte JSON-Logs von Reasoning und Dateiänderungen streamen | codex exec --json "Refactor utils" > run.jsonl |
codex review |
Nicht-interaktives Code-Review auf dem aktuellen Git-Diff | codex review |
codex resume |
Sitzungsauswahl öffnen (gespeichert unter ~/.codex/sessions/) |
codex resume / codex resume --last / codex resume <id> |
codex apply / codex a |
Diffs aus Codex-Cloud-Aufgaben lokal anwenden | codex apply <task_id> |
codex cloud |
Entfernte Codex-Cloud-Aufgaben einsehen oder verwalten | codex cloud |
codex mcp |
Server-Integrationen des Model Context Protocol (MCP) verwalten | codex mcp list / codex mcp add <name> ... |
-m, --model <name> |
Zugrunde liegendes Modell für Sitzung oder Lauf festlegen | codex -m gpt-6.1-sol |
--strict-config |
Syntax und Schlüssel in config.toml streng validieren |
codex --strict-config |
2. Matrix für Sandbox- & Genehmigungsrichtlinien
Codex CLI trennt Berechtigungen in zwei orthogonale Ebenen: worauf die Umgebung zugreifen darf (--sandbox) und wann der Benutzer gefragt werden muss (--ask-for-approval).
| Flag | Gültige Werte | Verhalten & empfohlene Nutzung |
|---|---|---|
--sandbox <mode>(Alias -s) |
read-only |
Nur lesen: Code inspizieren und durchsuchen, ohne Dateien zu verändern |
workspace-write |
Workspace-Schreibzugriff (empfohlener Standard): Änderungen nur im Arbeitsverzeichnis zulassen | |
danger-full-access |
Uneingeschränkter Zugriff: voller Dateisystem-/Systemzugriff (nur in isolierten Containern) | |
--ask-for-approval <policy> |
on-request |
Empfohlener Standard: Modell fragt bei riskanten Aktionen nach Bestätigung |
on-failure |
Nur bei Fehlern eskalieren (nutzen Sie on-request, falls Sandbox-Eskalationsabfragen wichtig sind) |
|
never |
Vollständig stumm: nie interaktiv nachfragen (für CI / automatisierte Pipelines) |
⚠️ Hinweis zu veralteten & entfernten Flags:
--full-autoist seitv0.128.0veraltet (deprecated). Geben Sie Sandbox- und Genehmigungsrichtlinie explizit an:codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"- Die Genehmigungsrichtlinie
untrustedwurde inv0.149.0entfernt; stellen Sie Konfigurationen aufon-requestum.
3. Interaktive TUI-Slash-Befehle
Tippen Sie / im interaktiven codex-TUI-Prompt, um Kontext, Berechtigungen und Workflows zu steuern:
3.1 Kontext, Modelle & Berechtigungen
| Befehl | Funktion | Hinweise & Anwendung |
|---|---|---|
/init |
Auf das Repository zugeschnittene Starter-AGENTS.md erzeugen |
Empfohlener erster Schritt in einem neuen Projekt |
/status |
Aktives Modell, Berechtigungen und Token-Verbrauch prüfen | Verbleibende Kontextkapazität im Blick behalten |
/model |
Modell und Reasoning-Effort-Stufe interaktiv wechseln | Reasoning-Tiefe ohne Neustart anpassen |
/permissions |
Sandbox-Modus und Genehmigungsrichtlinie während der Sitzung ändern | Berechtigungen bei Bedarf verschärfen oder lockern |
/mcp |
Verbundene MCP-Server inspizieren und verwalten | Verbindung zu externen Tools und Datenbanken testen |
3.2 Engineering-Workflows & Sitzungssteuerung
| Befehl | Funktion | Hinweise & Anwendung |
|---|---|---|
/plan |
Implementierungsplan entwerfen und prüfen, bevor Dateien geändert werden | Architektur vor großen Refactorings abstimmen |
/review |
Mehrperspektivisches Code-Review für uncommittete Änderungen starten | Bugs, Randfälle und Sicherheitsrisiken aufspüren |
/diff |
Aktuelle uncommittete Dateiänderungen prüfen | Diffs Zeile für Zeile vor der Übernahme kontrollieren |
/fork |
Gesprächsfaden in einen separaten Checkpoint abzweigen | Alternativen Ansatz testen, ohne den Hauptkontext zu belasten |
/compact |
Gesprächsverlauf zusammenfassen, um Kontextspeicher freizugeben | Drift in langen Multi-Turn-Sitzungen verhindern |
/copy |
Letzte abgeschlossene Antwort in die Zwischenablage kopieren | Patches oder Zusammenfassungen schnell übernehmen |
/title |
Aktuellen Gesprächsfaden umbenennen | Erleichtert das Wiederfinden über codex resume |
/statusline / /theme |
Statusleiste im Footer oder TUI-Farbschema anpassen | Terminaldarstellung individualisieren |
/prompts:<name> |
Eigene Markdown-Prompt-Vorlage aufrufen | Führt ~/.codex/prompts/<name>.md aus |
4. Terminal-Tastenkürzel & Eingabesyntax
| Kürzel / Syntax | Aktion | Wirkung & Szenario |
|---|---|---|
@<path> |
Unscharfe Dateireferenz | Dateiinhalt inline einfügen (z. B. @src/auth.ts) |
!<command> |
Inline-Shell-Befehl | Shell-Befehle innerhalb aktiver Sandbox-Regeln ausführen (z. B. !npm test) |
Tab |
Nächsten Prompt einreihen | Folge-Prompt, Slash-Befehl oder !-Befehl während laufender Arbeit einreihen |
Enter |
Während des Laufs eingreifen / steuern | Zusätzliche Anweisungen geben, während der Agent aktiv antwortet |
Ctrl + G |
Externen Editor öffnen | Mehrzeilige Prompts in $VISUAL / $EDITOR (Vim, VS Code usw.) verfassen |
Ctrl + R |
Prompt-Verlauf durchsuchen | Rückwärtssuche in zuvor gesendeten Prompts |
Ctrl + L |
Bildschirm leeren & neu zeichnen | Terminal aufräumen, während der Gesprächsstand erhalten bleibt |
Ctrl + O |
Letzte Ausgabe kopieren | Entspricht /copy |
Ctrl + X |
Tastaturmenü öffnen | Tastatur-Presets und Erweiterungen aufrufen |
Ctrl + C |
Abbrechen / Beenden | Aktive Aufgabe abbrechen oder Codex-Sitzung beenden |
5. Konfigurationsdateien & Speicherhierarchie (config.toml & AGENTS.md)
Projektspezifische Einstellungen überschreiben globale Benutzervorgaben:
| Ebene | Globaler Geltungsbereich (alle Repos) | Projekt-Geltungsbereich (aktuelles Repo) | Zweck |
|---|---|---|---|
| Kernkonfiguration | ~/.codex/config.toml |
.codex/config.toml |
Standardmodell, Sandbox, Genehmigungsrichtlinie, Netzwerk-Schalter, MCP |
| Agenten-Anweisungen | ~/.codex/AGENTS.md |
./AGENTS.md (Repo-Wurzel) |
Build-/Testbefehle, Coding-Standards, Architekturregeln |
| Eigene Prompts | ~/.codex/prompts/*.md |
— | Wiederverwendbare /prompts:<name>-Slash-Command-Vorlagen |
| Sitzungsprotokolle | ~/.codex/sessions/ |
— | Persistente Logs zur Wiederherstellung per codex resume |
Empfohlene Minimalkonfiguration ~/.codex/config.toml
# Standardmodell
model = "gpt-6.1-sol"
# Standard-Sandbox und Genehmigungsrichtlinie
sandbox_mode = "workspace-write"
approval_policy = "on-request"
# Ausgehenden Netzwerkzugriff innerhalb der Sandbox standardmäßig sperren
network_access = false