CLI-Handbuch
Codex CLI – Modelle, Anzeigen und Commands
Thematisch geordnetes Nachschlagewerk zu Codex CLI: wichtige Shell- und Slash-Commands, aktuelle Modellfamilien, Reasoning, Footer- und Statusanzeigen, Approval, Sandbox, Agents, Cloud, MCP, Plugins und praktische Abläufe.
CLI nach ThemaSlash-Commands erklärtModelle & ReasoningStatusanzeigenDesktop + iPhone
01 · Schnellstart
Codex CLI in drei Ebenen
Shell-Kommandos starten und verwalten Codex. Slash-Commands steuern die laufende TUI. Schnellzeichen geben Dateien oder Shell-Befehle direkt an.
Shell
codex …
Interaktiver Start, Exec, Resume, Review, Cloud, MCP, Plugins und Diagnose.
In Codex
/…
Modell, Reasoning, Plan, Permissions, Agents, Diff, Status und Sitzungen.
Schnellzeichen
@ und !
@ erwähnt Dateien; ! führt einen lokalen Shell-Befehl aus.
$ codex --version $ codex doctor $ codex > /status > /model > /permissions
02 · Modelle
Codex-Modelle und Reasoning genauer erklärt
Die Modellauswahl entscheidet über Fähigkeiten, Tempo und Verbrauch. Reasoning steuert innerhalb eines Modells, wie viel Rechenaufwand für die Lösung verwendet wird.
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
gpt-5.6-sol | Stärkstes Flaggschiff für komplexes Coding, Computer Use, tiefe Recherche und Security. | Für große Architekturänderungen, schwierige Fehler, Sicherheitsanalyse und anspruchsvolle Migrationen. |
gpt-5.6-terra | Ausgewogenes Modell für tägliche Entwicklung. | Guter Standard für Implementierung, Reviews, Tests und normale Repository-Arbeit. |
gpt-5.6-luna | Schnelles und günstigeres Modell. | Für Navigation, kleine Änderungen, Dokumentation und klar abgegrenzte Tasks. |
gpt-5.3-codex-spark | Sehr schnelles textbasiertes Research-Preview-Modell, sofern verfügbar. | Für nahezu sofortige Iterationen; Funktions- und Planzugang beachten. |
gpt-5.5-codex | Ältere Codex-Generation, je nach Konto weiterhin wählbar. | Bei neuen Projekten aktuelle 5.6-Modelle bevorzugen. |
gpt-5.4 / gpt-5.4-mini | Legacy-Auswahl mit angekündigter Ablösung in ChatGPT-Anmeldungen. | Vor dem 31. August 2026 auf 5.6-Entsprechungen migrieren, falls betroffen. |
Low / Medium
Schnell für Navigation, kleine Änderungen und klare Aufgaben. Medium ist häufig der ausgewogene Startpunkt.
High / Extra high
Für tiefere Debugging-, Review- und Architekturaufgaben. Mehr Laufzeit und Tokenverbrauch einplanen.
Max / Ultra
Für sehr schwierige Aufgaben. Ultra kann zusätzliche Agenten einsetzen und ist nicht für jeden Account oder jedes Modell verfügbar.
Praktische Wahl: Terra für normale Entwicklung, Sol für komplexe oder riskante Aufgaben, Luna für kleine und schnelle Schritte. Reasoning erst erhöhen, wenn die Aufgabe tatsächlich mehr Tiefe verlangt.
$ codex -m gpt-5.6-terra $ codex -m gpt-5.6-sol -c model_reasoning_effort="high" > /model > /reasoning > /status
03 · Anzeigen
Footer, Statusline, Tool-Ausgabe und Wartestatus
Die Codex-TUI kann Modell, Reasoning, Context, Rate Limits, Git-Branch, Session-ID, Verzeichnis und Sicherheitsmodus anzeigen.
| Anzeige | Bedeutung | Wichtig |
|---|---|---|
| Modell + Reasoning | Aktive Modellvariante und Denkstufe. | Mit /model, /reasoning und /status prüfen. |
| Context / Tokens | Belegung oder verbleibender Gesprächskontext. | Je nach Statusline eindeutig beschriften. |
| Rate limit / Usage | Verbrauch in Kontofenstern. | Nicht mit Context-Belegung verwechseln. |
| Approval wartet | Codex benötigt deine Freigabe für einen Befehl oder Zugriff. | Befehl und Pfade vor /approve lesen. |
| Read / shell / patch / tool | Tatsächliche Aktion oder Werkzeugausgabe. | Diese Zeilen zeigen reale Arbeit, nicht ein Spinnerwort. |
| Git branch / worktree | Aktiver Branch oder isolierter Arbeitsbaum. | Vor Apply/Commit sicherstellen, dass der richtige Arbeitsbereich aktiv ist. |
| Session-ID | Eindeutige Sitzung für Resume/Fork. | Für Automation und Support hilfreich. |
Eigene Statusline: Mit
/statusline kann die Anzeige angepasst werden. Deshalb bei Prozenten immer kennzeichnen, ob „used“ oder „remaining“ gemeint ist.04 · Shell-Befehle
Wichtige Codex-CLI-Befehle nach Thema
Enthält interaktive und nicht-interaktive Nutzung, Sitzungen, Modelle, Sandbox, Review, Cloud, MCP, Plugins und Diagnose.
Installation, Version und Anmeldung
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
npm install -g @openai/codex | Installiert Codex CLI global über npm. | Danach codex --version und codex doctor prüfen. |
brew install --cask codex | Installiert Codex CLI auf macOS über Homebrew. | Updates anschließend mit Homebrew oder codex update durchführen. |
codex --version | Zeigt die installierte Codex-Version. | Bei abweichender TUI oder fehlenden Commands zuerst vergleichen. |
codex update | Aktualisiert die Codex-Installation. | Installationsweg und Plattform können den Ablauf beeinflussen. |
codex doctor | Prüft Installation, Konfiguration und Laufzeitumgebung. | Guter erster Schritt bei Sandbox-, PATH-, Terminal- und Auth-Problemen. |
codex login | Startet die interaktive Anmeldung mit ChatGPT/OpenAI. | Browser- oder Device-Flow hängt von Umgebung und Account ab. |
codex login --device-auth | Verwendet einen Device-Code-Flow. | Praktisch auf Servern oder Terminals ohne direkt öffnenden Browser. |
printenv OPENAI_API_KEY | codex login --with-api-key | Übernimmt einen API-Key über stdin. | Key nicht als sichtbares Kommandoargument oder im Shell-Verlauf speichern. |
codex login status | Zeigt den aktuellen Anmeldestatus. | Hilfreich bei Account-, Workspace- oder API-Key-Verwechslungen. |
codex logout | Entfernt die lokale Anmeldung. | Repository und Konfiguration bleiben bestehen. |
codex completion bash | Erzeugt Shell-Completion für die angegebene Shell. | Unterstützte Shells über codex completion --help prüfen. |
Interaktive Sitzung starten und konfigurieren
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
codex | Startet die interaktive Codex-TUI im aktuellen Verzeichnis. | Codex erkennt Projektregeln und Git-Kontext. |
codex "Analysiere das Maven-Projekt" | Startet mit einem ersten Auftrag. | Die TUI bleibt danach geöffnet. |
codex -C C:\Projekte\order-service | Startet in einem bestimmten Arbeitsverzeichnis. | Unter Windows Pfade mit Leerzeichen korrekt quoten. |
codex -m gpt-5.6-sol | Wählt beim Start ein konkretes Modell. | Verfügbarkeit hängt von Konto und Oberfläche ab. |
codex -c key=value | Überschreibt einen Config-Wert nur für diesen Start. | Werte folgen TOML-Syntax; Strings gegebenenfalls quoten. |
codex --profile work | Aktiviert ein Profil aus ~/.codex/config.toml. | Geeignet für unterschiedliche Projekte, Provider oder Sicherheitsmodi. |
codex --image screenshot.png "Analysiere den Fehler" | Fügt dem ersten Prompt ein Bild hinzu. | Unterstützte Formate und Größen beachten. |
codex --add-dir ../shared | Erlaubt zusätzliches Verzeichnis. | Nur notwendige, vertrauenswürdige Pfade freigeben. |
Nicht-interaktiv, Skripte und CI
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
codex exec "Prüfe die Tests und erkläre Fehler" | Führt einen Auftrag nicht-interaktiv aus. | Alias: codex e. Ergebnis und Exit-Code eignen sich für Automatisierung. |
codex exec -m gpt-5.6-terra "…" | Wählt für einen Exec-Auftrag ein bestimmtes Modell. | Kosten, Tempo und Reasoning passend zum Task wählen. |
cat prompt.txt | codex exec - | Liest den Prompt von stdin. | Praktisch für generierte oder mehrzeilige Aufträge. |
codex exec --json "…" | Gibt JSONL-Ereignisse aus. | Für Maschinenverarbeitung und Live-Auswertung. |
codex exec --output-last-message result.txt "…" | Schreibt die letzte Modellnachricht zusätzlich in eine Datei. | Nützlich für Build-Artefakte und Folgeprozesse. |
codex exec resume --last "Fahre mit den Fehlern fort" | Setzt die letzte nicht-interaktive Sitzung fort. | Hält Kontext über mehrere Skriptschritte hinweg. |
codex exec --sandbox read-only "…" | Beschränkt den Auftrag auf Lesen. | Für Analyse in CI sicherer als Schreibzugriff. |
codex exec --full-auto "…" | Verwendet eine automatisiertere Voreinstellung. | Trotzdem Sandbox- und Approval-Wirkung explizit prüfen. |
Sitzungen fortsetzen, verzweigen und archivieren
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
codex resume | Öffnet die Sitzungsauswahl. | Zeigt fortsetzbare lokale Sessions. |
codex resume --last | Setzt die letzte Sitzung fort. | Schnellster Rückweg in die vorherige Arbeit. |
codex resume <session-id> | Setzt eine konkrete Sitzung fort. | Session-ID kann über Status oder Session-Auswahl ermittelt werden. |
codex fork --last | Erzeugt aus der letzten Sitzung einen unabhängigen Zweig. | Gut für alternative Lösungen ohne den Originalverlauf zu verändern. |
codex fork <session-id> | Verzweigt eine bestimmte Sitzung. | Neuer Verlauf erhält eigene Session-ID. |
codex archive <session-id> | Archiviert eine Sitzung. | Sie verschwindet aus normalen Listen, bleibt aber wiederherstellbar. |
codex unarchive <session-id> | Stellt eine archivierte Sitzung wieder her. | Danach wieder über Resume auswählbar. |
codex app [pfad] | Öffnet die Codex-App für einen Pfad, sofern installiert/unterstützt. | Die CLI übergibt den Projektkontext an die Desktop-Oberfläche. |
Modelle, Reasoning und Verhalten
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
codex -m gpt-5.6-sol | Wählt das stärkste Modell für schwierige Coding-Aufgaben. | Für Architektur, große Refactorings, Security und komplexe Debugging-Fälle. |
codex -m gpt-5.6-terra | Wählt das ausgewogene Alltagsmodell. | Guter Standard für normale Entwicklung und Reviews. |
codex -m gpt-5.6-luna | Wählt ein schnelles, günstigeres Modell. | Für kleine Änderungen, Navigation und klar begrenzte Aufgaben. |
codex -c model_reasoning_effort="high" | Setzt den Reasoning-Aufwand für diesen Start. | Verfügbare Stufen hängen vom Modell ab. |
/model | Öffnet die Modellauswahl in der TUI. | Zeigt verfügbare Modelle und meist Reasoning-Optionen. |
/reasoning | Ändert den Reasoning-Aufwand, sofern in der Version verfügbar. | Typisch: Low, Medium, High, Extra high, Max oder Ultra. |
/fast | Schaltet einen schnelleren Modus um. | Nicht mit der Wahl eines kleineren Modells gleichsetzen. |
/personality | Ändert den Antwort-/Arbeitsstil. | Beeinflusst Darstellung und Interaktion, nicht Sandbox-Rechte. |
/status | Zeigt aktives Modell, Reasoning, Sandbox, Approval und Kontext. | Bei Unsicherheit die verlässlichste In-Session-Anzeige. |
Approval, Sandbox und freigegebene Pfade
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
codex -a on-request | Fragt bei Aktionen an, die zusätzliche Freigabe benötigen. | Guter interaktiver Standard für normale Projektarbeit. |
codex -a never | Stellt keine Approval-Fragen. | Nicht erlaubte Aktionen können scheitern; für kontrollierte Automation. |
codex --sandbox read-only | Erlaubt Lesen, aber keine normalen Schreibänderungen. | Ideal für Analyse und Review. |
codex --sandbox workspace-write | Erlaubt Schreiben innerhalb des Arbeitsbereichs. | Außerhalb gelten weiterhin Sandbox-Grenzen. |
codex --sandbox danger-full-access | Hebt Sandbox-Beschränkungen weitgehend auf. | Nur in isolierter, entbehrlicher Umgebung verwenden. |
codex --add-dir ../shared | Fügt einen zusätzlichen zugelassenen Pfad hinzu. | So eng wie möglich freigeben. |
codex --yolo | Umgeht Approvals und Sandbox weitgehend. | Höchstes Risiko; nur Container/VM ohne wichtige Daten. |
codex sandbox | Startet beziehungsweise untersucht die plattformspezifische Sandbox. | Unterbefehle unterscheiden sich zwischen Linux, macOS und Windows. |
codex execpolicy | Prüft oder verwaltet Ausführungsrichtlinien. | Hilfreich für reproduzierbare Command-Freigaben. |
/permissions | Öffnet die interaktive Berechtigungsansicht. | Zeigt beziehungsweise ändert aktuelle Approval-/Sandbox-Wahl. |
/sandbox-add-read-dir <Pfad> | Ergänzt einen weiteren lesbaren Pfad. | Kein Schreibrecht; trotzdem nur vertrauenswürdige Daten einbinden. |
Git, Review und Änderungen
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
codex review --uncommitted | Prüft nicht committete Änderungen. | Ideal vor Commit; Findings anschließend im Diff verifizieren. |
codex review --base main | Vergleicht den aktuellen Branch mit main. | Geeignet für Branch- oder PR-Vorbereitung. |
codex review --commit <sha> | Prüft einen bestimmten Commit. | Review bleibt auf den gewählten Commit begrenzt. |
codex apply <cloud-task-id> | Übernimmt den Patch eines Cloud-Tasks lokal. | Vorher sauberen Git-Status sicherstellen und danach Diff/Tests prüfen. |
/diff | Zeigt lokale Änderungen innerhalb der TUI. | Vor Freigabe oder Commit verwenden. |
/review | Startet ein interaktives Code-Review. | Umfang und Vergleichsbasis im Dialog auswählen. |
/worktree | Verwaltet oder startet isolierte Worktree-Arbeit, sofern verfügbar. | Nützlich für parallele Agenten/Änderungen. |
/mention <datei> | Referenziert gezielt eine Datei oder Ressource. | Reduziert unnötiges Repository-Scanning. |
/init | Erzeugt eine AGENTS.md-Grundlage für das Projekt. | Inhalt fachlich prüfen und an Build/Test/Architektur anpassen. |
Cloud-Aufgaben und Remote-Ausführung
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
codex cloud | Öffnet die Cloud-Task-Auswahl beziehungsweise Cloud-Funktionen. | Account und Cloud-Umgebung müssen verfügbar sein. |
codex cloud exec --env <env-id> "Auftrag" | Startet einen Cloud-Task in einer definierten Umgebung. | Umgebungs-ID, Secrets und Netzwerkzugriff vorher konfigurieren. |
codex cloud list | Listet Cloud-Tasks. | Status wie pending, running oder completed prüfen. |
codex cloud list --json | Gibt Cloud-Tasks maschinenlesbar aus. | Für Dashboards oder Automatisierung geeignet. |
codex remote-control | Startet unterstützte Remote-Control-Funktionen. | Nur bei aktivierter Oberfläche und sicherer Verbindung verwenden. |
/cloud | Wechselt beziehungsweise öffnet Cloud-Funktionen, sofern angeboten. | Lokale und Cloud-Ausführung unterscheiden sich bei Umgebung und Datenzugriff. |
/local | Kehrt zu lokaler Ausführung zurück, sofern der Command verfügbar ist. | Aktive Arbeitsumgebung im Status prüfen. |
/project | Wählt einen Projektkontext in unterstützten Oberflächen. | Nicht in jeder CLI-Version vorhanden. |
MCP, Plugins, Apps und Erweiterungen
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
codex mcp list | Listet konfigurierte MCP-Server. | Mit --json maschinenlesbar. |
codex mcp add <name> -- <command> | Registriert einen lokalen stdio-MCP-Server. | Command, Argumente und Umgebungsvariablen sorgfältig prüfen. |
codex mcp get <name> | Zeigt Details eines MCP-Servers. | Transport, Status und Konfiguration kontrollieren. |
codex mcp login <name> | Authentifiziert einen unterstützten MCP-Server. | Nur bei passenden OAuth-/Auth-Funktionen. |
codex mcp logout <name> | Meldet den MCP-Server lokal ab. | Server kann konfiguriert bleiben. |
codex mcp remove <name> | Entfernt eine MCP-Konfiguration. | Vorher prüfen, ob Projekte davon abhängen. |
codex mcp-server | Startet Codex selbst als MCP-Server. | Für Integrationen; Netzwerk- und Zugriffsschutz beachten. |
codex plugin list | Listet installierte Plugins. | Plugins können Commands und Fähigkeiten ergänzen. |
codex plugin add <quelle> | Installiert ein Plugin aus einer unterstützten Quelle. | Nur vertrauenswürdige Quellen verwenden. |
codex plugin marketplace list | Zeigt konfigurierte Plugin-Marktplätze. | Organisationsrichtlinien beachten. |
/mcp | Zeigt MCP-Status in der TUI. | Fehlende Authentifizierung und Serverfehler werden sichtbar. |
/apps | Öffnet verbundene Apps, sofern verfügbar. | App-Zugriffe können zusätzliche Datenquellen erschließen. |
/plugins | Öffnet Plugin-Verwaltung. | Nach Installation ggf. Sitzung neu starten. |
/hooks | Zeigt Hook-Funktionen. | Hooks können automatisch lokale Befehle ausführen. |
/skills | Zeigt geladene Skills. | Skills beeinflussen Arbeitsabläufe und Commands. |
Diagnose, Features und interne Dienste
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
codex doctor | Prüft die lokale Installation. | Erster Diagnosebefehl. |
codex features list | Listet stabile und experimentelle Features. | Aktivierungsstatus dokumentieren, wenn Verhalten reproduzierbar sein soll. |
codex features enable <feature> | Aktiviert ein Feature. | Experimentelle Funktionen können sich kurzfristig ändern. |
codex features disable <feature> | Deaktiviert ein Feature. | Hilfreich zum Eingrenzen von Regressionen. |
codex debug models | Zeigt modellbezogene Debug-Informationen, sofern verfügbar. | Bei Modellauflösung oder Providerproblemen. |
codex app-server | Startet den internen App-Server. | Für Integrationen und Entwicklung, nicht als normaler Alltagsstart. |
codex remote-control | Startet Remote-Control-Unterstützung. | Zugriff und Netzwerkgrenzen kontrollieren. |
/debug-config | Zeigt die wirksame Konfiguration und Herkunft der Werte. | Sehr hilfreich bei widersprüchlichen globalen/projektlokalen Einstellungen. |
/feedback | Sendet Produktfeedback. | Keine vertraulichen Repository-Inhalte einfügen. |
/usage | Zeigt Nutzung und Rate-Limit-Informationen. | Je nach Konto unterschiedliche Zeitfenster und Werte. |
05 · In der TUI
Wichtige Codex-Slash-Commands nach Thema
Die lokale Ausgabe von /help ist maßgeblich, weil experimentelle Funktionen, Plugins und Kontozugang die Liste verändern.
Sitzung und Verlauf
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
/new | Beginnt eine neue Sitzung. | Bisherige Git-Änderungen bleiben bestehen. |
/clear | Leert den aktuellen Gesprächskontext. | Nicht mit Zurücksetzen von Dateien verwechseln. |
/resume | Öffnet die Auswahl vorhandener Sessions. | Zum Wechseln in einen früheren Verlauf. |
/fork | Erzeugt einen neuen Sitzungszweig. | Originalsitzung bleibt unverändert. |
/rename <Name> | Benennt die Sitzung. | Hilft bei vielen parallelen Tasks. |
/archive | Archiviert die aktuelle Sitzung. | Später über Unarchive/CLI wiederherstellbar. |
/delete | Löscht die aktuelle Sitzung aus der Verwaltung. | Projektdateien nicht automatisch betroffen; Dialog genau lesen. |
/compact | Verdichtet den Verlauf, um Context freizugeben. | Wichtige Entscheidungen vorher explizit zusammenfassen lassen. |
/copy | Kopiert die letzte Antwort. | Für normale Textweitergabe. |
/raw | Zeigt oder kopiert rohe Antwortdaten, sofern unterstützt. | Nützlich bei Formatierungsproblemen. |
/exit | Beendet die TUI. | Alias/Alternative kann /quit sein. |
Modell, Reasoning und Stil
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
/model | Wählt Modell und häufig Reasoning-Stufe. | Verfügbare Auswahl hängt vom Konto ab. |
/reasoning | Wählt den Denkaufwand. | Nicht jedes Modell unterstützt jede Stufe. |
/fast | Schaltet einen schnelleren Modus um. | Qualitäts-/Geschwindigkeitsprofil, nicht automatisch anderes Sandbox-Verhalten. |
/personality | Wählt den Interaktionsstil. | Ändert Ton und Arbeitsweise, nicht Berechtigungen. |
/plan | Wechselt in einen Planungsmodus. | Vor großen Änderungen empfehlenswert. |
/goal <Ziel> | Definiert ein prüfbares Ziel für längere Arbeit. | Ziel, Tests und Abbruchkriterien konkret formulieren. |
/side <Frage> | Startet eine Nebenfrage beziehungsweise Seitenspur. | Alias/Variante kann /btw sein. |
/status | Zeigt Modell, Reasoning, Context, Sandbox und Approval. | Verlässlichster Gesamtüberblick in der Sitzung. |
/statusline | Konfiguriert Statuszeilenfelder. | Mögliche Felder: Modell, Reasoning, Context, Limits, Git, Session-ID, Verzeichnis. |
/title | Ändert den Terminal-/Fenstertitel. | Hilfreich bei mehreren Sessions. |
/theme | Wechselt das Farbschema. | Reine Darstellungseinstellung. |
/pets | Steuert optionale dekorative TUI-Elemente, sofern verfügbar. | Hat keine fachliche Wirkung. |
Berechtigungen, Sandbox und Freigaben
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
/permissions | Öffnet die Auswahl für Approval und Sandbox. | Die beiden Konzepte getrennt betrachten. |
/approve | Genehmigt eine aktuell wartende Aktion. | Vorher Befehl, Pfade und Auswirkung lesen. |
/setup-default-sandbox | Richtet plattformspezifische Standard-Sandbox ein. | Besonders nach Erstinstallation oder Diagnose relevant. |
/sandbox-add-read-dir <Pfad> | Erlaubt einen weiteren Pfad lesend. | Kein allgemeines Schreibrecht. |
/ide | Verbindet oder konfiguriert IDE-Kontext. | Aktiven Workspace kontrollieren. |
/keymap | Wählt Tastaturbelegung. | Hilfreich bei Terminal-/Editor-Konflikten. |
/vim | Schaltet Vim-Eingabemodus um. | Nur aktivieren, wenn die Navigation vertraut ist. |
/debug-config | Zeigt wirksame Konfiguration. | Erklärt, welcher Wert aus welcher Datei/Quelle stammt. |
Agents, Prozesse und parallele Arbeit
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
/agent | Öffnet oder startet Agent-Funktionen. | In manchen Versionen als /subagents sichtbar. |
/subagents | Zeigt laufende und abgeschlossene Subagents. | Parallelität erhöht Verbrauch und Koordinationsbedarf. |
/ps | Zeigt laufende Hintergrundprozesse. | Hilft bei langen Builds oder Tests. |
/stop | Stoppt einen laufenden Prozess oder Agenten. | Bereits geschriebene Änderungen bleiben. |
/fork | Verzweigt eine Sitzung für parallele Lösungswege. | Konfliktfreie Arbeitsbereiche bevorzugen. |
/worktree | Verwaltet isolierte Git-Worktrees, sofern verfügbar. | Sehr gut für parallele Implementierungen. |
/cloud | Öffnet Cloud-Tasks, sofern aktiviert. | Umgebung und Secrets unterscheiden sich von lokal. |
/local | Wechselt zurück zur lokalen Ausführung, sofern angeboten. | Status danach prüfen. |
/goal | Lässt Agenten auf ein definiertes Ziel hinarbeiten. | Klare Tests und Abschlusskriterien sind entscheidend. |
Projektwissen und Kontext
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
/init | Erzeugt eine AGENTS.md-Projektanleitung. | Build-, Test-, Architektur- und Stilregeln konkret dokumentieren. |
/mention <Datei> | Fügt gezielt eine Datei in den Kontext ein. | Alternativ @datei nutzen. |
/import | Importiert unterstützten Kontext oder eine Ressource. | Quelle und Datenschutz vor Import prüfen. |
/memories | Zeigt gespeicherte projekt- oder nutzerbezogene Erinnerungen. | Veraltete Regeln entfernen. |
/skills | Zeigt Skills. | Skills können wiederverwendbare Arbeitsabläufe enthalten. |
/mcp | Zeigt verbundene MCP-Server und Tools. | Nur benötigte Server aktivieren. |
/apps | Öffnet verbundene Apps. | Datenzugriff und Berechtigungen kontrollieren. |
/plugins | Verwaltet Plugins. | Nur vertrauenswürdige Plugins installieren. |
/hooks | Zeigt automatische Hooks. | Hooks vor Freigabe auf Shell-Befehle prüfen. |
/project | Wählt Projektkontext in unterstützten Oberflächen. | Nicht in jeder CLI-Version verfügbar. |
Git, Review und Ergebnis
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
/diff | Zeigt lokale Änderungen. | Vor Commit und nach Agent-Arbeit prüfen. |
/review | Startet ein Code-Review. | Vergleichsbasis und Scope auswählen. |
/copy | Kopiert die letzte Antwort. | Für formatierte Weitergabe. |
/raw | Zeigt rohe Antwort. | Für genaue Ausgabe oder maschinelle Weiterverarbeitung. |
/feedback | Sendet Feedback. | Keine Secrets oder vertraulichen Quelltexte mitsenden. |
/archive | Räumt abgeschlossene Sitzungen auf. | Archiv ist wiederherstellbar; Delete nicht unbedingt. |
/usage | Zeigt Kontingent und Rate Limits. | Nicht mit Context-Prozent verwechseln. |
/status | Zeigt auch Git-, Modell- und Sicherheitsstatus. | Vor riskanten Schritten erneut prüfen. |
Bedienung und Darstellung
| Befehl | Was er macht | Was du siehst / beachten solltest |
|---|---|---|
/keymap | Öffnet Tastaturbelegung. | Terminal kann einzelne Kombinationen abfangen. |
/vim | Schaltet Vim-Modus. | Esc-/Insert-Verhalten ändert sich. |
/ide | Steuert IDE-Integration. | Editor-Kontext kann ausgewählte Dateien automatisch einbeziehen. |
/title | Setzt Fenstertitel. | Bei mehreren Terminals sehr nützlich. |
/theme | Wählt Theme. | Dark Mode auf ausreichenden Kontrast prüfen. |
/statusline | Wählt Footer-/Statusfelder. | Kontext und Rate Limits sichtbar machen. |
/feedback | Öffnet Feedback-Flow. | Produktfeedback statt Projektauftrag. |
/logout | Meldet Codex ab. | Lokale Dateien bleiben. |
/quit | Beendet Codex. | Entspricht funktional dem Exit der TUI. |
06 · Sicherheit
Approval und Sandbox sind zwei getrennte Schichten
Approval entscheidet, wann Codex dich fragt. Sandbox begrenzt, worauf ein gestarteter Prozess technisch zugreifen darf.
Approval Policy
on-request, never und weitere verfügbare Modi steuern Freigabefragen.
＋
Sandbox Mode
read-only, workspace-write oder danger-full-access bestimmen die OS-Grenzen.
--yolo beziehungsweise Bypass: deaktiviert Schutzschichten weitgehend. Nur in einer isolierten VM oder einem Container ohne wichtige Daten, Credentials oder Netzwerkzugriff verwenden.07 · Konfiguration
config.toml, Profile und AGENTS.md
Globale Einstellungen liegen typischerweise unter ~/.codex/config.toml; projektbezogene Konfiguration kann in vertrauenswürdigen Projekten unter .codex/config.toml ergänzt werden.
Globale Konfiguration
Standardmodell, Reasoning, Approval, Sandbox, MCP und allgemeine Präferenzen.
Profile
Mehrere benannte Kombinationen, gestartet mit --profile. Gut für Arbeit, privat, Read-only und CI.
AGENTS.md
Projektanweisungen zu Architektur, Build, Tests, Stil, Grenzen und Arbeitsabläufen. Mit /init als Ausgangspunkt erzeugbar.
$ codex --profile work $ codex -c model="gpt-5.6-terra" > /init > /debug-config
08 · Praxis
Typische Codex-Workflows
Kleine, prüfbare Schritte liefern meist bessere Ergebnisse als ein unkontrollierter Großauftrag.
Repository analysieren
$ codex -m gpt-5.6-terra > /plan Analysiere Architektur, Build, Tests und Risiken > /status > /mention pom.xml
Änderungen prüfen
> /diff > /review $ !mvn test > /status
Read-only Review
$ codex review --uncommitted $ codex review --base main $ codex exec --sandbox read-only "Prüfe Security-Risiken"
Automation
$ codex exec --json "Führe Tests aus und fasse Fehler zusammen" $ codex exec --output-last-message result.txt "Erzeuge Release-Zusammenfassung"
09 · Quellen
Offizielle OpenAI-Dokumentation
Bei Funktionsunterschieden gelten codex --help, codex <command> --help, /help und die aktuelle offizielle Referenz.