Codex CLI: Das definitive technische Referenzhandbuch

Kurzfassung: Codex ist ein Coding-Agent für mehrere Oberflächen: Er liest Ihre Codebasis, führt Befehle in einer Sandbox auf Betriebssystemebene aus, nimmt Änderungen an Dateien vor und delegiert Aufgaben an die Cloud. Beherrschen Sie fünf Systeme – config.toml, das Sandbox-/Freigabemodell, AGENTS.md, MCP und skills – und Codex wird zum Produktivitätsmultiplikator. GPT-6-Astra ist die neue empfohlene Standardeinstellung (veröffentlicht am 3. September 2026; seit v0.153.4 die gebündelte Standardeinstellung von CLI) – OpenAI meldete den Abschluss der Einführung am 4. September (Plus und Business waren bis zum Abend eingeschlossen). In der Praxis ist die Zugriffsberechtigung jedoch weiterhin uneinheitlich. Konten ohne entsprechende Berechtigung sollten daher GPT-5.6 Sol (die Einstellung „Power“ mit mittlerem Reasoning) als stabile Ausweichlösung festlegen. GPT-5.5, das Spitzenmodell der vorherigen Generation, bietet in Codex einen Kontext von 400K und in API von 1M.^{83117145146148149} Sind Sie neu hier? Wechseln Sie direkt zu Installation und Schnellstart. Verfolgen Sie die Veröffentlichungen? Die neueste stabile Version ist v0.153.4 (4. September 2026)¹⁴⁷¹⁴⁸ – unter Versionshighlights finden Sie eine Übersicht der jüngsten Versionen und im Changelog sämtliche Aktualisierungen.¹¹⁶

Codex arbeitet als Coding-Agent für mehrere Oberflächen, nicht als Chatbot, der Code schreibt. CLI liest Ihre Codebasis, führt Befehle in einer Sandbox aus, nimmt Änderungen an Dateien vor, stellt über MCP Verbindungen zu externen Diensten her und delegiert lang laufende Aufgaben an die Cloud. Codex läuft lokal, denkt aber global: Dieselbe Intelligenz bildet je nach Ihrer Arbeitsweise die Grundlage für fünf verschiedene Oberflächen – darunter die Browsererweiterung für Chrome, Edge, Brave, Opera und Vivaldi, mit der Codex in Ihrem Browser ausgeführt wird, ohne dessen Steuerung zu übernehmen.⁹⁰¹²⁷

Ob Sie Codex nur gelegentlich oder wirklich effektiv nutzen, hängt von fünf Kernsystemen ab. Beherrschen Sie diese, wird Codex zum Produktivitätsmultiplikator:

1. Konfigurationssystem: steuert das Verhalten über config.toml
2. Sandbox- und Freigabemodell: regelt, was Codex tun darf
3. AGENTS.md: definiert Betriebsvereinbarungen auf Projektebene
4. MCP-Protokoll: erweitert die Funktionen um externe Dienste
5. Skills-System: bündelt wiederverwendbares Fachwissen

Ich habe Codex monatelang zusammen mit Claude Code in produktiven Codebasen, CI/CD-Pipelines und Teamworkflows eingesetzt. Dieser Leitfaden verdichtet meine Erfahrungen zu dem vollständigen Nachschlagewerk, das ich mir zu Beginn gewünscht hätte. Jede Funktion enthält die tatsächliche Syntax, praxisnahe Konfigurationsbeispiele und jene Sonderfälle, die selbst erfahrenen Benutzern Schwierigkeiten bereiten.

Wichtigste Erkenntnisse

• Fünf Oberflächen, eine Intelligenz: CLI, Desktop-App, IDE-Erweiterung, Cloud-Aufgaben und Browser-Erweiterung (für Chrome, Edge, Brave, Opera und Vivaldi) nutzen dieselbe GPT-5.x-Codex-Intelligenz. Wählen Sie daher die Oberfläche, die zu Ihrem Arbeitsablauf passt.⁹⁰
• Sandboxing auf Betriebssystemebene: Codex setzt Datei- und Netzwerkeinschränkungen auf Kernel-Ebene durch (Seatbelt unter macOS, Landlock + seccomp unter Linux), nicht innerhalb von Containern.
• AGENTS.md funktioniert werkzeugübergreifend: Ihre Projektanweisungen funktionieren in Codex, Cursor, Copilot, Amp, Jules, Gemini CLI, Windsurf, Cline, Aider, Zed und mehr als 60.000 Open-Source-Projekten. Einmal schreiben, überall verwenden.
• Profile sparen Aufwand beim Kontextwechsel: Definieren Sie benannte Konfigurationsvoreinstellungen (fast, careful, auto) und wechseln Sie mit --profile zwischen ihnen.
• Kontextverwaltung ist entscheidend: Die GPT-5.6-Familie (Sol, Terra, Luna) verfügt über ein Kontextfenster von 272K; GPT-5.5, das Flaggschiff der vorherigen Generation, bietet 400K in Codex und 1M in API. Verwalten Sie Ihr Token-Budget vorausschauend mit /compact, präzisen Prompts und @file-Verweisen.⁸³¹¹²

So verwenden Sie diesen Leitfaden

Dieser Leitfaden umfasst mehr als 3.300 Zeilen – beginnen Sie dort, wo es Ihrem Erfahrungsstand entspricht:

Die Kurzreferenz am Ende bietet eine übersichtliche Zusammenfassung aller wichtigen Befehle.

Release-Highlights: Was sich kürzlich geändert hat

Die Versionsgeschichte für Leser, die den Release-Zyklus von Codex verfolgen. Sind Sie neu hier? Überspringen Sie diesen Abschnitt zunächst und kehren Sie nach dem Schnellstart zurück – für produktives Arbeiten benötigen Sie nichts davon.

GPT-6-Astra ist das empfohlene Codex-Modell – es wurde am 3. September 2026 schrittweise eingeführt (zunächst für eine begrenzte Zahl von Organisationen, allen voran Partner des Cybersicherheitsprogramms); am folgenden Tag erklärte OpenAI die Einführung weitgehend für abgeschlossen: In einem OpenAI-Beitrag auf X vom 4. September heißt es, Astra „ist jetzt für alle Benutzer von Pro, Enterprise und Business Premium in ChatGPT Work und Codex verfügbar“ und „live in der API“. Codex-Leiter Tibo Sottiaux ergänzte noch am selben Abend, dass „Astra nun auch für alle Plus- und Business-Benutzer eingeführt ist“. In der Praxis ist die Berechtigung weiterhin uneinheitlich – Community-Berichte vom 5. September zeigen Plus-Konten, denen in Codex ausschließlich GPT-5.6-Modelle angezeigt werden, und laut Modelldokumentation hängt die Verfügbarkeit weiterhin „von der Einführung, Ihrer Anmeldemethode und Ihrem Client ab“. Daher bleibt GPT-5.6 Sol (die Einstellung „Power“ mit mittlerem Reasoning, anpassbar in Richtung Smarter oder Faster) die stabile Empfehlung für Konten, bei denen Astra noch nicht antwortet; GPT-5.5 (23. April 2026: 400K Kontext in Codex, 1M in der API, 5/30 US-Dollar pro MTok, 82,7 % und damit SOTA bei Terminal-Bench 2.0) ist das Flaggschiff der vorherigen Generation.^{83117145146149} v0.153.3 und v0.153.4 (4. September 2026) sind stabile Patches vom selben Tag, die die Einführung von GPT-6-Astra in die CLI bringen; npm latest ist jetzt 0.153.4. Der Vergleich rust-v0.153.2…rust-v0.153.4 umfasst genau vier PRs sowie eine Versionsanhebung. v0.153.3 (19:01 UTC): GPT-6-Astra wird in die Amazon-Bedrock-Kataloge aufgenommen (#42805 – die globalen und US-amerikanischen Routen von Mantle und Runtime; GPT-5.6 Sol bleibt das Standardmodell für Bedrock), außerdem werden Astras Hinweise zu asynchronen Klärungsfragen korrigiert (#42809, ausschließlich Text). v0.153.4 (23:25 UTC): Die Sichtbarkeit des gebündelten Modellkatalogs wechselt von ausgeblendet zu aufgelistet; durch die bereits vorhandene Katalogpriorität von GPT-6-Astra wird es zum gebündelten Standardmodell, sofern kein Modell ausdrücklich konfiguriert wurde (#42874, die für Benutzer sichtbare Freigabe der Vorbereitung, die der 0.154.0-alpha-Zweig als #42607 enthielt), zudem werden die Hinweise zu asynchronen Fragen von der Verfügbarkeit des Tools abhängig gemacht (#42878). Astra lässt sich seit v0.153.1 über die API konfigurieren (-m gpt-6-astra) und erscheint ab v0.153.4 in der Modellauswahl sowie als gebündeltes Standardmodell; da keine minimale CLI-Version dokumentiert ist, sollten Sie diese Versionen als effektive Untergrenzen betrachten. Betrieblicher Vorbehalt: Unter CLI 0.153.4 und neuer enthält ein noch nicht für die Einführung freigeschaltetes Konto ein gebündeltes Standardmodell, das der Benutzer nie ausgewählt hat, während das tatsächlich bereitgestellte Modell von der Berechtigung abhängt – legen Sie während der Einführung für eine deterministische Auswahl model = "gpt-5.6-sol" in config.toml fest (oder übergeben Sie -m).^145146147148 v0.153.1 und v0.153.2 (3. September 2026) sind stabile Patches vom selben Tag. Die wichtigste Änderung von v0.153.1 wird im zugehörigen Release-Text nicht aufgeführt und lässt sich nur anhand des Vergleichs rust-v0.153.0…rust-v0.153.1 belegen: Die Computer-Use-Bewertung von Guardian berücksichtigt nun die Modellanforderungen – ausschließlich auf Computer Use beschränkte Guardian-Bewertungen und schnelle Genehmigungsentscheidungen werden nur ausgeführt, wenn beim aktiven Modell node_repl_auto_review_required gesetzt ist. Frühere oder noch laufende Bewertungen werden ungültig, wenn ein Modellwechsel die Bewertung überspringt, sodass die spätere Rückkehr zu einem überprüften Modell keine veraltete Genehmigungsentscheidung reaktivieren kann. Die aufgeführte Änderung von v0.153.1 portiert einen GPT-6-Astra-Eintrag im Modellkatalog zurück, der ausschließlich über die API konfigurierbar ist – zu diesem Zeitpunkt handelte es sich um eine Katalogvorbereitung, nicht um eine Veröffentlichung: Standardmodell und Modellauswahl blieben unverändert, bis v0.153.4 am folgenden Tag das gebündelte Standardmodell umstellte. v0.153.2 enthält nur eine kosmetische Korrektur: In der Beschreibung des Fast-Tarifs von GPT-6-Astra wird „1.5x“ durch „2x speed, increased usage“ ersetzt – betroffen ist lediglich der Anzeigetext. Keiner der beobachteten Einträge aus 0.154.0-alpha wird im Vergleich rust-v0.153.0…rust-v0.153.2 übernommen; über 0.153.0 hinaus besteht das stabile Delta aus genau diesen drei Änderungen.¹⁴²¹⁴³ Seit CLI v0.153.0 (stabil, 3. September 2026) unterstützt der Vim-Modus Rückgängig und Wiederholen – u macht vollständige Composer-Entwürfe rückgängig, einschließlich eingefügter Inhalte und Bildanhänge, Ctrl+R stellt sie wieder her; Bearbeitungsschritte werden gruppiert und es gibt eine konfigurierbare Keymap-Aktion vim_normal.redo –, die Plugin-CLI kann Plugins aus Remote-Marktplätzen auflisten, installieren und entfernen (Remote-Katalogeinträge erscheinen in codex plugin list mit Quelle, Version, Installationsrichtlinie und Authentifizierungsrichtlinie in der JSON-Ausgabe), tui.auto_recap = false deaktiviert automatische Zusammenfassungen, während /recap weiterhin manuell verfügbar bleibt, und Plus- sowie Team-Tarife erhalten früher eine Warnung zum Nutzungslimit, sobald in einem Nutzungsfenster von ungefähr fünf Stunden weniger als die Hälfte des Kontingents verbleibt (für andere Tarife gelten weiterhin die bisherigen Schwellenwerte von 75/90/95 %). Der Umfang von Guardian richtet sich nun nach dem Genehmigungsmodus: Full Access überspringt Guardian-Prüfungen für Aktionen, die lediglich eine Bestätigung erfordern, und im Modus User approval werden die Guardian-Hintergrundbewertung und das Vorwärmen übersprungen, während Prüfungen sensibler Aktionen und Anfragen nach Benutzereingaben unverändert behandelt werden. Eine neue Konfigurationsoberfläche features.context_management.experimental_mode (standardmäßig deaktiviert) aktiviert für berechtigte ChatGPT-Plus-, Pro- und Pro-Lite-Sitzungen auf dem Codex-Backend tokenbudgetbasierten Kontext, Verlaufsnotizen und das Tool new_context – Sitzungen mit API-Schlüssel, benutzerdefinierte Anbieter und temporäre strukturierte Threads bleiben ausgeschlossen – und tui.disable_paste_burst ersetzt den Schlüssel auf oberster Ebene (der alte Speicherort funktioniert weiterhin als Fallback). Korrekturen: TUI-Sitzungen stellen nach dem Abbruch einer externen App-Server-Verbindung erneut eine Verbindung her und bewahren dabei Entwürfe und Transkripte; der Guardian-Prüfverlauf bleibt nach Komprimierungen, Neustarts und vom Benutzer erstellten Forks erhalten; gespeicherte Genehmigungen für MCP-Tools werden auf das ausgewählte App-Konto beschränkt und relative Pfade zu ausführbaren MCP-Dateien starten unter macOS zuverlässiger; die Rollout-Komprimierung bezieht gemeinsam genutzte Verläufe ein; und die Thread-Metadaten des App-Servers erhalten nullable Felder model und reasoningEffort sowie strukturierte asynchrone Fragen über request_user_input_async, sofern dies durch den Modellkatalog aktiviert ist.¹⁴⁰ Seit CLI v0.152.0 (stabil, 1. September 2026) ist die gesamte dreizehnteilige Beobachtungsliste aus 0.152-alpha ausgeliefert – mit einer Umkehrung: update_plan wurde optional, nicht standardmäßig aktiviert, veröffentlicht. Der endgültige Stand entspricht #41744 „Make the update_plan tool opt-in“: tools.update_plan.enabled ist standardmäßig false, und solange das Tool deaktiviert ist, werden die gebündelten Hinweise zu update_plan aus den Prompts für Modelle, Kollaborationsmodus, Multi-Agent, Komprimierung, Vorwärmen und Zielfortsetzung entfernt (siehe Plan Mode & Collaboration). Der übrige Release umfasst: Vim-Suchbewegungen (entwurfsinterne Literalsuche mit / und ?, hervorgehobene Treffer sowie wiederholte Navigation mit n/N, kombinierbar mit den Operatoren c/d/y; neue Vim-Entwürfe beginnen jetzt im Insert-Modus), aktionsfähige Banner zu Nutzungslimits in der TUI (Nutzung prüfen, Credits verwalten, Limits zurücksetzen und Tarife verwalten, gefiltert nach dem authentifizierten Konto), Fortschrittsanzeigen bei der Aktualisierung von Anmeldedaten in der TUI und in codex exec, einschließlich erneuter Amazon-Bedrock-Authentifizierung, Paketnamen ähnliche Namen für MCP-Server (:, @, / und . sind nun zulässig, sodass Namen wie npm:@modelcontextprotocol/server-sequential.thinking in CLI-Befehlen, Tool-Namespaces zur Laufzeit und der Suche nach OAuth-Anmeldedaten funktionieren), Formularanfragen über MCP openai/elicitation, ein MCP-spezifisches output_token_limit pro Tool mit konsistenter Kürzung auch nach dem Fortsetzen von Sitzungen, auf vertrauenswürdige Ursprünge beschränkte Anmeldedaten für Cloud-Aufgaben bei deaktivierten Weiterleitungen, konfigurierbare Zeitüberschreitungen für thread/shellCommand, einschließlich Fristen von mehr als einer Stunde, sowie standardmäßig über Modellmetadaten aktivierte Tokenbudgetierung. v0.152.1 (1. September) ist ein stabiler Patch mit nur einer Korrektur: Die Guardian-Genehmigungsprüfung bezieht ihre Node-REPL-Richtlinie aus den Modellmetadaten.¹³⁸¹³⁹ Seit CLI v0.151.0 (stabil, 29. August 2026) ist die gesamte Beobachtungsliste des 0.150-alpha-Zyklus ausgeliefert – und der Release-Text entspricht NICHT dem vollständigen Release: Er führt nur die nach dem Branch-Cut hinzugekommenen PRs #41183–#41209 auf, während der Vergleich rust-v0.150.1…rust-v0.151.0 164 Commits ohne einen einzigen Revert enthält (die stabile Version liegt einen Commit hinter 0.151.0-alpha.6, wobei dieser eine Commit lediglich die Versionsanhebung der Alpha-Version ist). Alle zehn beobachteten Einträge wurden übernommen: /recap fasst die aktuelle Unterhaltung auf Abruf zusammen, wobei Codex dieselbe Zusammenfassung für berechtigte inaktive, nicht fokussierte Unterhaltungen automatisch erstellt, Code-Mode-Hosts entfernen den WebSocket-Transport (nur stdio und gRPC; WebSocket bleibt ausschließlich als optionaler Rohdatenstrom für OTLP-Traces bestehen), dauerhafte Threads verwenden standardmäßig einen paginierten Verlauf, wenn ihr Speicher die paginierten APIs unterstützt (flüchtige Threads und nicht unterstützende Speicher verbleiben beim bisherigen Verhalten), der Reasoning-Aufwand persistent kommt mit Uhrzeit-Tools und gebündelten Proaktivitätshinweisen hinzu, die Standardwerte von Guardian v2 wechseln zu Computer-Use-Prüfungen mit Bildern, Vim erhält die Find- und Till-Bewegungen f/F/t/T sowie die Puffersprünge gg/G, der App-Server akzeptiert Live-Aktualisierungen der Einstellungen für den jeweiligen Turn, einschließlich einer Service-Tier-Überschreibung pro Turn, für verwaltete worktrees werden ein Parser für worktree-Einstellungen und Metadaten zur Thread-Inhaberschaft eingeführt, die Einrichtung von Amazon Bedrock wird in das TUI-Onboarding aufgenommen (hinter einem Feature-Flag), und Eingaben in Terminals mit erhöhten Rechten können eine erneute Genehmigung erfordern (write_stdin_approval, standardmäßig deaktiviert, mit einer Obergrenze von 8.000 Byte für die geprüfte Eingabe). Die eigenen Ergänzungen des Releases: eine konfigurierbare Toleranzfrist zur Erkennung von Tools optionaler MCP-Server (mcp_optional_startup_grace_ms, standardmäßig 1.000 ms), Erweiterungen können Ergebnisse von MCP-Tools prüfen oder ersetzen, bevor sie das Modell erreichen, und Plugin-Kataloge kombinieren die Konfiguration pro Repository, während sie ungültige Projektmarktplätze melden, ohne gültige Plugins auszublenden; Korrekturen sorgen dafür, dass Tool-Verfügbarkeit und Reasoning-Aufwand bei Modellwechseln und Fallbacks korrekt bleiben, verbessern die Durchsetzung der Remote-Sandbox anhand des tatsächlichen Home-Verzeichnisses, Betriebssystems und der Pfadkonventionen des Executors, rechnen die Token-Nutzung verschachtelter Subagenten dem Budget des Root-Ziels an, verhindern, dass veraltete Guardian-Klassifizierungen nach Berechtigungsänderungen Aktionen autorisieren, und unterbinden, dass /cd durch Beibehaltung wiederhergestellter Berechtigungsprofile Sandbox-Einschränkungen abschwächt.¹³⁴¹³⁵ Seit CLI v0.150.0 (stabil, 26. August 2026) verfügen hooks über ein Ereignis Interrupt – den zwölften Eintrag in HOOK_EVENT_NAMES, der beim Unterbrechen eines aktiven Turns auf oberster Ebene Befehle oder MCP-Handler ausführt (standardmäßige Zeitüberschreitung 1 Sekunde, Obergrenze 3 Sekunden, niemals für Subagenten) –, /copy öffnet eine Auswahl, die die vollständige Antwort, einzelne Codeblöcke und Blockzitate umfasst, Aufgaben können über das Terminal adressiert werden (andere Codex-Aufgaben mit @-Erwähnungen referenzieren, Agenten Aufgaben lesen, erstellen oder Nachrichten an sie senden lassen und automatisch beschreibende Titel für unbenannte Aufgaben erhalten, wobei /rename einen bearbeitbaren Titel vorschlägt), Markdown-Links werden in unterstützten Terminals als anklickbare Beschriftungen dargestellt, Tastenkürzel können zwischen Berechtigungsmodi wechseln, und der Vim-Modus erhält die Wiederholung mit .; außerdem liefern nicht vertrauenswürdige Projekte keine AGENTS.md-Anweisungen auf Projektebene mehr. features.network_proxy.credential_broker und Guardian v2s review_scope.computer_use_only werden als konfigurierbare, standardmäßig deaktivierte Oberflächen eingeführt (v0.151.0 aktivierte später die Standardwerte von Guardian v2). Der Release behebt außerdem die Schwärzung von Anmeldedaten im App-Server, die Suche nach Remote-Bearer-Token für MCP und den Start erforderlicher Server, die Windows-Sandbox mit erhöhten Rechten bei Unicode-Pfaden von Benutzern, Unix-Hänger beim Herunterfahren aufgrund abgetrennter Prozesse sowie die Kompatibilität von Amazon Bedrock mit Komprimierung und Multi-Agent.¹³² v0.150.1 (27. August) ist ein Patch mit nur einer Korrektur (npm latest bis v0.151.0): Bei der Remote-Komprimierung werden beibehaltene Bilder nun standardmäßig auf das Tokenbudget angerechnet, wobei ältere Bilder bei Bedarf entfernt werden – der Standardwert aus 0.151-alpha (#40994), zurückportiert in die stabile Version (#41003).¹³³ Seit CLI v0.149.0 (stabil, 20. August 2026) ist die Genehmigungsrichtlinie untrusted eingestellt – Konfigurationen, in denen sie noch genannt wird, sollten auf on-request umgestellt werden – und der Release übernimmt die gesamte Alpha-Beobachtungsliste: ein interaktives Dashboard codex agents (Aufgaben suchen, starten, öffnen, umbenennen und anhalten, mit konfigurierbaren Tastenkürzeln), /cd, /pwd und /cwd zur Verwaltung des Arbeitsverzeichnisses innerhalb von TUI-Sitzungen, codex queue zum Senden von Nachrichten an bestehende lokale oder Remote-Sitzungen, erweiterte Vim-Änderungsbewegungen (cw, c$, cc, Ersetzen von Zeichen), ein codex doctor, das nun Endpunktschutz, Netzwerk-/Proxyfehler, den Zustand der Desktop-App und die Update-Verbindung diagnostiziert, sowie die Reasoning-Aufwände max/ultra in den SDKs mit exakten Konfigurationsüberschreibungen für die CLI; fortgesetzte und geforkte Threads stellen außerdem ihr aktives Berechtigungsprofil wieder her, statt unbemerkt auf Standardwerte zurückzufallen. v0.149.1 (24. August) ist ein stabiler Patch mit fünf Commits, der codex exec --thread-source <SOURCE> hinzufügt (neu erstellte oder geforkte Threads als user, subagent, memory_consolidation oder mit einem Funktionsnamen klassifizieren; bei fehlender Angabe user; threadSource in den TypeScript-SDKs), daneben Rückportierungen für die Bildkomprimierung in Remote-Sitzungen und die Speicherkonsolidierung enthält und bis v0.150.1 npm latest war.¹²⁰¹²⁶ Unabhängig davon senkte OpenAI die Preise für GPT-5.6 Sol ab dem 21. August für drei Monate um mehr als 20 % (mindestens bis zum 21. November 2026) – sowohl die API-Preise als auch der Codex-Creditverbrauch sinken; die veröffentlichte Credit-Preisliste führt Sol nun mit 100 Credits pro 1M Eingabetoken (10 bei Cache-Treffern, 500 Ausgabetoken) statt zuvor 125/12,5/750 auf.¹²¹ Seit CLI v0.148.0 (stabil, 18. August 2026) können vollständige TUI-Unterhaltungen mit /export als Markdown exportiert werden (in die Zwischenablage oder eine neue Datei), codex exec fork forkt Sitzungen über die Befehlszeile, ergänzt um Archivierung und Wiederherstellung in der TUI-Auswahl zum Fortsetzen, /status, Statuszeilen und Terminaltitel zeigen für berechtigte Arbeitsbereiche geschätzte Thread-Credits oder -Kosten an, Amazon Bedrock Runtime wird zu einem integrierten Anbieter (Unterstützung für AWS-Profile und -Regionen, GPT-5.6-Routing), hooks können Befehle asynchron ausführen und MCP-Tools aufrufen, und Sandbox-Einschränkungen schlagen bei verweigerten oder nicht lesbaren Pfaden unter Linux und Windows nun sicher geschlossen fehl; außerdem akzeptiert die TUI bereits während der Initialisierung entworfene Prompts.¹¹⁸ Seit CLI v0.147.0 (stabil, 7. August 2026) ist codex exec --full-auto entfernt (seit v0.128 veraltet) – Skripte, die es weiterhin übergeben, führen nun zu einem Fehler; ersetzen Sie es durch --sandbox workspace-write zusammen mit einem Genehmigungs-Flag oder Profil. v0.147.0 liefert außerdem --approve-for-me (Genehmigungsaufforderungen werden durch einen automatischen Prüfprozess entschieden), portable Agent Plugins mit Suche in lokalen, persönlichen, arbeitsbereichsspezifischen und Remote-Katalogen, das optionale MCP-Protokoll 2026-07-28 (paginierte Erkennung, mehrstufige Anfragen, nicht blockierender Serverstart) und Unterhaltungsabschnitte zur Organisation langer Transkripte aus.¹¹⁶ v0.146.0 (stabil, 29. Juli) sorgte dafür, dass konfigurierte Proxys alle Transportschichten abdecken, fügte Manifeste für Agent Plugins sowie die Marktplätze von Amazon Bedrock und Claude Code hinzu und führte Sitzungsbenennung mit angehefteten Threads sowie vom Executor bereitgestellte skills ein; v0.146.1 (5. August) härtete die Standardwerte der automatischen Prüfung für cyberfähige Modelle.¹¹⁴¹¹⁵ Seit CLI v0.145.0 (stabil, 21. Juli 2026) migriert /import nicht nur aus Claude Code, sondern auch aus Cursor – Einstellungen, MCP servers, Plugins, Sitzungen, Befehle und projektspezifische Erinnerungen –, Voice kehrt als gestreamte Echtzeitunterhaltung V3 zurück, mit Audioeingaben und Audioausgaben von Tools in gängigen lokalen Formaten, die optionale Multi-Agent-v2-Erfahrung wird stabilisiert und bietet konfigurierbare Subagentenmodelle, Reasoning-Stufen und Parallelität, ein experimenteller paginierter Thread-Verlauf ermöglicht effizientes Fortsetzen, Suchen, persistierte Namen, Subagentenunterstützung und Erinnerungen, eine experimentelle Amazon-Bedrock-Anmeldung wird mit Unterstützung für benutzerdefinierte Endpunkte und Authentifizierung ausgeliefert (GPT-5.6 Sol als Bedrock-Standardmodell), und die gebündelten GPT-5.4-Modellauswahlen werden auf die Varianten GPT-5.6 Terra und Luna migriert; v0.144.6 (18. Juli) korrigierte die Kontextfenster von GPT-5.6 Sol/Terra/Luna auf 272.000 Token.¹¹¹¹¹² Seit CLI v0.140.0 (stabil, 15. Juni 2026) zeigt /usage die tägliche, wöchentliche und kumulierte Tokenaktivität des Kontos an, Sitzungen können über codex delete / /delete dauerhaft gelöscht werden (mit Sicherheitsabfragen zur Bestätigung), /import migriert Einrichtung, Projektkonfiguration und aktuelle Chats selektiv aus Claude Code, die Eingabe von @ öffnet standardmäßig ein einheitliches Erwähnungsmenü für Dateien, Plugins und skills, und eine verwaltete Amazon-Bedrock-Authentifizierung per API-Schlüssel wird zusammen mit verschlüsselter lokaler Speicherung für Anmeldedaten der CLI und von MCP-OAuth ausgeliefert; die experimentellen Voice-Steuerelemente /realtime wurden aus der TUI entfernt (Voice kehrte später in v0.145.0 als gestreamte Echtzeitunterhaltung V3 zurück).¹⁰²¹¹² Seit CLI v0.139.0 (stabil, 9. Juni 2026) kann Code Mode die eigenständige Websuche direkt aufrufen (auch aus verschachtelten JavaScript-Tool-Aufrufen) und Ergebnisse als Klartext empfangen; Eingabeschemas von Tools und Connectors bewahren nun oneOf-/allOf-Konstrukte für bessere Kompatibilität mit großen Schemas und MCP; codex doctor ergänzt Details zur Editor- und Pager-Umgebung (sensible Werte werden in der JSON geschwärzt), und der Plugin-Marktplatz weist in codex plugin marketplace list --json Quellen aus und listet zwischengespeicherte Kataloge schneller auf.¹⁵⁵ v0.138.0 (8. Juni) fügte /app hinzu, um eine CLI-Sitzung unter macOS und Windows an die Desktop-App zu übergeben, stellte dem Modell lokale Bildpfade bereit, flexibilisierte die Auswahl des Reasoning-Aufwands und ergänzte strukturierte JSON-Ausgaben für die Plugin-Automatisierung; außerdem begann diese Version damit, Aufgabentexte vom übergeordneten Agenten an Subagenten in Multi-Agent v2 zu verschlüsseln, sodass Delegierungsanweisungen nicht mehr im Klartext in lokalen Sitzungsprotokollen erscheinen (siehe Multi-Agent).¹⁵⁶¹⁰⁸ v0.137.0 (4. Juni) lieferte Multi-Agent v2 aus (Laufzeit pro Thread beibehalten, sauberere Follow-ups und Metadatenstandardwerte, hide_spawn_agent_metadata standardmäßig true), dazu TUI-Tastenzuweisungen für F13–F24 und eine v1-Erweiterung für skills mit Katalogauflösung pro Turn.¹⁵⁷ Seit CLI v0.135.0 (28. Mai 2026) meldet codex doctor ausführlichere Bestände zu Umgebung, Git, Terminal, App-Server und Threads; /status zeigt Details zur Remote-Verbindung und die Serverversion an, wenn die TUI über eine Remote-Verbindung verbunden ist; der Vim-Modus erhielt die Bearbeitung von Textobjekten, ein verbessertes Verhalten bei Wörtern und Zeilenenden sowie eine konfigurierbare Turn-Unterbrechung; /permissions versteht nun benannte Berechtigungsprofile und zeigt benutzerdefinierte Profile an; paketierte Codex-Builds erkennen und verwenden unter unterstütztem macOS das gebündelte, gepatchte zsh-Hilfsprogramm; und die Python-SDKs bieten benutzerfreundliche Sandbox-Voreinstellungen für Thread- und Turn-APIs.¹⁵⁹ v0.134.0 (26. Mai 2026) führte eine Suche im lokalen Unterhaltungsverlauf mit von Groß- und Kleinschreibung unabhängigen Inhaltstreffern und Ergebnisvorschauen ein, machte --profile zum primären Profilselektor für CLI, TUI-Berechtigungen und Sandbox-Abläufe (alte Profilkonfigurationen werden mit Migrationshinweisen abgelehnt), verbesserte die Einrichtung von MCP durch Umgebungsziele pro Server und OAuth-Optionen für streamfähige HTTP-Server, erhöhte die Zuverlässigkeit von Connector-Tool-Schemas durch Erhalt lokaler $ref/$defs und Komprimierung übergroßer Schemas, ließ schreibgeschützte MCP-Tools parallel ausführen, wenn sie readOnlyHint angeben, und fügte umfangreicheren Erweiterungs- und Hook-Kontext hinzu, darunter den Unterhaltungsverlauf für Erweiterungstools.¹⁰¹ v0.133.0 (21. Mai 2026) aktivierte Ziele standardmäßig mit eigenem Speicher und Fortschrittsverfolgung; codex remote-control erhielt Bereitschafts- und Statusanzeigen im Vordergrund sowie daemonähnliches Starten und Stoppen; Berechtigungsprofile erhielten Listen-APIs, Vererbung, verwaltetes requirements.toml, Laufzeitaktualisierung und eine stärkere Windows-Sandbox-Integration; die Plugin-Erkennung zeigt installierte Versionen, Marktplatzwurzeln und Remote-Sammlungen an; außerdem können Erweiterungen Start und Stopp von Subagenten, Tool-Ausführung, Turn-Metadaten sowie asynchrone Genehmigungs- und Turn-Verarbeitung beobachten. Das Codex-App-Update vom 21. Mai fügte Appshots für das vorderste Mac-Fenster, die allgemeine Verfügbarkeit des Goal-Modus in App, IDE und CLI, Verbesserungen der Anmerkungen im integrierten Browser sowie optional gesperrtes Computer Use für berechtigte Mac-Benutzer hinzu.⁹⁹¹⁰⁰ v0.132.0 (20. Mai 2026) fügte eine erstklassige Authentifizierung für die Python-SDKs, einfachere reine Text-APIs für Turns, ein umfangreicheres TurnResult, codex exec resume --output-schema, einen schnelleren TUI-Start, authentifizierungsgestützte Registrierung von Remote-Executors und die Bewahrung der Bildqualität in App-Server-Turns hinzu. Verwenden Sie ausdrückliche Sandbox-/Genehmigungs-Flags oder Berechtigungsprofile – das alte --full-auto ist seit v0.147.0 entfernt; js_repl bleibt entfernt.^{86878991969798116}

Stabilitätshinweis: Mit [EXPERIMENTAL] oder under development gekennzeichnete Funktionen können sich zwischen Releases ändern. Seit v0.133.0 (21. Mai 2026) sind Ziele standardmäßig aktiviert, Berechtigungsprofile eine erstklassige verwaltete Oberfläche, die Plugin-Erkennung besser nachvollziehbar und Remote-Control einfacher als App-Server-Befehl im Vordergrund oder als Daemon auszuführen. Codex Cloud und Code Mode bleiben experimentell beziehungsweise in Entwicklung, während die zentralen Oberflächen für CLI, Sandboxing, AGENTS.md, config.toml, Skills, hooks, Multi-Agent-Tools, Plugins, Browser, Computer Use und Appshots je nach Plattform und Tarif stabil oder als benutzerseitige Oberflächen dokumentiert sind. v0.132.0 ergänzt die Authentifizierung der Python-SDKs sowie die strukturierte Automatisierung zum Fortsetzen; v0.131.0 führte codex doctor, eine einheitliche Suche über @-Erwähnungen, Marktplatzbefehle für die CLI, versionsbewusstes Teilen von Plugins, daemonverwaltetes Remote-Control mit Aktivierung und Deaktivierung zur Laufzeit, registrierungsgestützte Umgebungen und zusätzliche Härtungen der Windows-Sandbox ein.⁹⁶⁹⁷⁹⁸ Das alte --full-auto wurde in v0.147.0 entfernt (seit v0.128 veraltet), und js_repl bleibt entfernt.^8687116 Die Alpha-Beobachtungsliste für 0.149.0 wurde mit der stabilen Version v0.149.0 (20. August 2026) ausgeliefert: Die Genehmigungsrichtlinie untrusted ist eingestellt, codex agents ist ein echter Dashboard-Befehl, codex doctor deckt Endpunktschutz sowie Netzwerk-, Desktop- und Update-Diagnosen ab, und die SDKs bieten die Reasoning-Aufwände max/ultra.¹²⁰ Die Alpha-Beobachtungsliste für 0.150.0 teilte sich bei der Auslieferung: Von den neun beobachteten Einträgen gelangten fünf in die stabile Version v0.150.0 (26. August 2026) – das Hook-Ereignis Interrupt, die /copy-Auswahl, das Überspringen von AGENTS.md in nicht vertrauenswürdigen Projekten, features.network_proxy.credential_broker und der Prüfungsumfang review_scope.computer_use_only von Guardian v2 (eine konfigurierbare Oberfläche; der aufgelöste Standardwert bleibt der reguläre Umfang) – und fünf wechselten in den 0.151.0-alpha-Zweig: /recap mit automatischer Zusammenfassungserstellung, die Entfernung von WebSocket aus Code Mode (ws://-Endpunkte funktionieren in 0.150.0 weiterhin), paginierter Thread-Verlauf als Standard für dauerhafte Threads (ThreadHistoryMode bleibt in 0.150.0 standardmäßig legacy), der Reasoning-Aufwand persistent und Guardian v2 mit Computer-Use-Prüfungen samt Bildern als Standard (transcript.include_images ist in 0.150.0 standardmäßig false). Die Budgetierung beibehaltener Bilder bei der Komprimierung folgte unmittelbar: Der Alpha-Standardwert (#40994) erreichte die stabile Version durch die Rückportierung in 0.150.1 (#41003).¹³²¹³³ Diese Beobachtungsliste für 0.151.0-alpha wurde vollständig abgearbeitet: Alle zehn Einträge gelangten ohne Reverts in die stabile Version v0.151.0 (29. August 2026) – nachweisbar nur über den Vergleich rust-v0.150.1…rust-v0.151.0 mit 164 Commits, da der Release-Text lediglich die nach dem Branch-Cut hinzugekommenen PRs #41183–#41209 aufführt.^137134135 Die anschließende Beobachtungsliste für 0.152.0-alpha (¹³⁶) wurde mit einer Umkehrung vollständig übernommen: Alle dreizehn Einträge gelangten in die stabile Version v0.152.0 (1. September 2026), update_plan wurde jedoch optional statt standardmäßig aktiviert veröffentlicht – die beobachtete Verhaltensänderung (der standardmäßig aktivierte Zustand aus #41630) wurde vor dem Branch-Cut durch #41744 „Make the update_plan tool opt-in“ rückgängig gemacht. Daher ist tools.update_plan.enabled standardmäßig false, und der Vorbehalt der vorherigen Beobachtungsnotiz („eine Verhaltensänderung, falls sie die stabile Version erreicht“) mündete in keiner Änderung des Standardverhaltens.¹³⁶¹³⁸ Zwei Tage später folgte die stabile Version v0.153.0 (3. September 2026); die Patches v0.153.1 und v0.153.2 vom selben Tag ergänzten eine Korrektur der Guardian-Modellanforderungen, eine Rückportierung des GPT-6-Astra-Katalogs und eine kosmetische Beschreibungskorrektur – der Vergleich rust-v0.153.0…rust-v0.153.2 übernimmt keinen der beobachteten Alpha-Einträge.^140142143 Die stabilen Patches v0.153.3 und v0.153.4 (4. September 2026; npm latest = 0.153.4) brachten anschließend die Veröffentlichung von GPT-6-Astra: Der Vergleich rust-v0.153.2…rust-v0.153.4 umfasst genau vier PRs sowie eine Versionsanhebung und bestätigt zwei beobachtete Einträge als über Hotfix-Rückportierungen in den 0.153-Zweig übernommen, nicht über den 0.154-Zweig – den gebündelten GPT-6-Astra-Katalog (#42607, übernommen als die Umstellung von ausgeblendet auf aufgelistet in v0.153.4, #42874, wodurch Astra zum gebündelten Standardmodell wird) und die Amazon-Bedrock-Kataloge (#42619, übernommen als #42805 in v0.153.3).¹⁴⁷¹⁴⁸ Hinweis für Scans: developers.openai.com/codex/ leitet nun per 308 auf learn.chatgpt.com/docs/ weiter – behandeln Sie learn.chatgpt.com bei künftigen Scans als kanonischen Host der Codex-Dokumentation.¹⁴⁶ Dem Release-Zyklus voraus ist nun der 0.154.0-alpha-Zweig, der 0.154.0-alpha.6 erreicht hat (veröffentlicht am 7. September 2026; die dazwischenliegenden Tags alpha.4 und alpha.5 existieren ohne veröffentlichte Releases; das Alpha-dist-tag von npm lautet 0.154.0-alpha.6) und eine Vorabversion bleibt – nichts davon wird im Haupttext dieses Leitfadens dokumentiert, bevor eine stabile Veröffentlichung erfolgt. Da die Release-Texte dieses Alpha-Zweigs leere Platzhalter sind, bilden die Vergleiche die einzige Quelle: Der Vergleich rust-v0.154.0-alpha.3…rust-v0.154.0-alpha.6 umfasst 147 Commits. Beobachtete Einträge, die sich in diesem Delta weiterentwickelten: Die Erstellung verwalteter worktrees (#42196) wurde zu einer vollständigen worktree-Oberfläche ausgebaut (Exec-Unterstützung, #42652; interaktive Sitzungen und Forks, #43069; TUI-Sitzungsbefehle, #43120; verknüpfte worktrees in der Erkennung, #43279; ein TUI-worktree-Browser, #43286; verzögerte Übergänge, #43298); frei formulierte asynchrone Benutzernachrichten (#42354) wuchsen zu einem vollständigen TUI-Cluster heran (#42677, #42889, #42891, #42894, #42897, #42903); die native Voice-Laufzeit wurde umfassend weiterentwickelt (GStreamer-Initialisierung, #42631; WebRTC-Aushandlung, #42676; optionales lokales Audio, #43079; Mikrofon-RTP, #43090; eine Echtzeitsitzungs-API, #43097; Export über SDK, #43099; begrenztes Opus-RTP, #43100; Wiedergabe, #43244 und #43248; eine Bazel-Toolchain, #43083–#43144); der Cluster zur Bereitstellung der Windows-Sandbox wurde fortgeführt (#42801, #42833, #42835; ein nativer MXC-Adapter, #42841; Socket-Herunterfahren, #43308); die Konfiguration für dauerhaftes Reasoning erhielt angrenzende, mit Flags versehene Arbeiten (#43110); und die TUI-Einstellungen wurden durch angrenzende Arbeiten ergänzt (#42791, #42674). Keine Bewegung gab es beim Vim-Replace-Modus (#42194), beim Live-Status der Kontextkomprimierung (#42319) und bei der Korrektur des Arbeitsbereichvertrauens für PATH-Hilfsprogramme (#42324); die Sicherheits-, Härtungs- und Guardian-Kontexteinträge aus alpha.3 werden weiterhin wie in ¹⁴⁴ beschrieben beobachtet. Neue beobachtete Einträge im Delta von alpha.6: Der veraltete Befehl codex mcp-server wurde im Alpha-Zweig entfernt (#42993) – eine inkompatible Änderung für diesen Leitfaden, der den Befehl als veraltet, aber funktionsfähig dokumentiert; erreicht die Entfernung die stabile Version 0.154.0, wird daraus eine dokumentierte Entfernung, weshalb sie bei der Übernahme zuerst erneut geprüft werden muss; eine Überarbeitung von Guardian v2 mit ungefähr 25 Commits (vom Modell bereitgestellte Prüfungsrichtlinien, #42744; anfragebezogene Genehmigungen, #42807; übergeordnete Antwort-IDs statt Tickets, #43002; Fehlergründe und Zeitmessung, #43005; Thread-Kontext in die guardianv2-Konfiguration verschoben, #43104; ein zentralisierter Kontextmodus, #43458; Entfernung der alten Guardian-Genehmigungsprüfpfade, #43462; Ablehnung veralteter Genehmigungen, #43442); TUI-Feinschliff für Astra (Modellauswahl, #42879; Funkeln, #42842; Eingabehinweise, #42824 und #42836; vom Server bereitgestellte Modellstandardwerte für neue Starts und Hintergrundsitzungen, #43177 und #43261; eine Überschreibungswarnung, #42639); experimentelle Benutzerverifizierung für MCP (#43265, #43289, #43352); Remote-Berechtigungsprofile (benannte TUI-Auswahl, #43340; beim Fortsetzen und Forken beibehalten, #43330); experimentelles Kontextmanagement, das beim Sitzungsstart anhand der Modellfähigkeit freigeschaltet wird (#43147, dieselbe Oberfläche features.context_management); sowie ein Konzept namens „Daybreak“-Berechtigung, das zum Zeitpunkt der Erstellung in keiner OpenAI-Dokumentation vorkommt (TUI-Hinweise zu Cyberablehnungen, zugeschnitten auf die Daybreak-Berechtigung, #42667; in Thread-Metadaten gespeicherte Daybreak-Einstellungen, #42854) – ein eigenständiger Beobachtungseintrag. Kleinere Änderungen: Erweiterung von /copy (#43055), jemalloc für musl-Builds (#42850) und eine schreibgeschützte Ansicht beim Fortsetzen eines Threads mit aktivem Schreiber (#43253). Alpha-Vergleiche überschneiden sich mit stabilen Cherry-Picks, weshalb jeder beobachtete Eintrag bei der Übernahme erneut anhand des stabilen Vergleichs geprüft werden muss.^141144150

So funktioniert Codex: Das mentale Modell

Bevor Sie sich mit den Funktionen befassen, sollten Sie verstehen, wie die Architektur von Codex Ihre gesamte Arbeit damit prägt. Das System erstreckt sich über fünf Oberflächen, denen eine gemeinsame Intelligenzschicht zugrunde liegt:

┌─────────────────────────────────────────────────────────┐
│                    CODEX SURFACES                       │
├─────────────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌────────┐   │
│  │   CLI    │  │ Desktop  │  │   IDE    │  │ Cloud  │   │
│  │ Terminal │  │   App    │  │Extension │  │  Tasks │   │
│  └──────────┘  └──────────┘  └──────────┘  └────────┘   │
│  Local exec     Multi-task    Editor-native  Async      │
│  + scripting    + worktrees   + inline edits detached   │
│  ┌──────────┐                                           │
│  │ Browser  │  Signed-in browser workflows              │
│  │Extension │  (launched May 2026)                      │
│  └──────────┘                                           │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                        │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐     │
│  │   MCP   │  │ Skills  │  │  Apps   │  │  Search │     │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘     │
│  External tools, reusable expertise, ChatGPT            │
│  connectors, web search (cached + live)                 │
├─────────────────────────────────────────────────────────┤
│  SECURITY LAYER                                         │
│  ┌─────────────────────────────────────────────────┐    │
│  │    Sandbox (Seatbelt / Landlock / seccomp)      │    │
│  │    + Approval Policy (on-request → never)       │    │
│  └─────────────────────────────────────────────────┘    │
│  OS-level filesystem + network restrictions             │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER                                             │
│  ┌─────────────────────────────────────────────────┐    │
│  │         GPT-5.x-Codex Intelligence              │    │
│  │   Tools: Shell, Patch, Read, Web Search         │    │
│  │   (legacy artifact, read_file, grep_files       │    │
│  │    removed in v0.117.0)                         │    │
│  └─────────────────────────────────────────────────┘    │
│  Shared model across all surfaces; costs tokens         │
└─────────────────────────────────────────────────────────┘

Kernschicht: Die GPT-Modellfamilie bildet die Grundlage für alles. Stand September 2026 ist gpt-6-astra das empfohlene Modell (die vollständige Einführung wurde am 4. September bekannt gegeben, die Verfügbarkeit ist in der Praxis jedoch weiterhin uneinheitlich; ab CLI 0.153.4+ ist es der mitgelieferte Standard, sofern kein Modell ausdrücklich konfiguriert wurde). gpt-5.6-sol – die Einstellung „Power“ mit mittlerem Reasoning – dient als stabile Ausweichoption; daneben stehen Terra (für den Alltag) und Luna (schnell und kostengünstig) zur Verfügung. gpt-5.5 ist das Flaggschiff der vorherigen Generation (400K Kontext in Codex, 1M in API), und gpt-5.4 wird am 31. August 2026 aus Codex entfernt.^{83117146148149} Das Modell liest Dateien, erstellt Patches, führt Shell-Befehle aus und analysiert Ihre Codebasis. Wenn der Kontext voll ist, komprimiert Codex die Unterhaltung, um Platz freizugeben. Diese Schicht verbraucht Tokens.

Sicherheitsschicht: Jeder von Codex ausgeführte Befehl durchläuft eine Sandbox auf Betriebssystemebene. Unter macOS setzt Apples Seatbelt-Framework Beschränkungen auf Kernelebene durch. Unter Linux filtern Landlock und seccomp den Dateisystem- und Systemaufrufzugriff. Die Sandbox arbeitet auf Kernelebene, nicht innerhalb von Containern. Anschließend bestimmt die Genehmigungsrichtlinie, wann eine menschliche Bestätigung angefordert wird.

Erweiterungsschicht: MCP bindet externe Dienste an (GitHub, Figma, Sentry). Skills bündeln wiederverwendbare Arbeitsabläufe, die Codex bei Bedarf lädt. Apps stellen Verbindungen zu ChatGPT-Konnektoren her. Die Websuche ergänzt Echtzeitkontext aus dem Internet.

Oberflächenschicht: CLI richtet sich an Terminal-Power-User und dient der Automatisierung. Die Desktop-App ermöglicht die parallele Projektverwaltung in mehreren Threads. Die IDE-Erweiterung unterstützt enge Bearbeitungs-, Kompilierungs- und Testzyklen. Cloud ist für asynchrone Aufgaben vorgesehen, die unabhängig ausgeführt werden.

Die wichtigste Erkenntnis: Die meisten Benutzer verwenden nur eine Oberfläche. Power-User nutzen alle fünf: Cloud für lang laufende Aufgaben, CLI für deterministische Repository-Operationen, die IDE-Erweiterung für enge Programmierzyklen, die Desktop-App für Planung und Koordination sowie die Browser-Erweiterung für Browser-Arbeitsabläufe mit aktiver Anmeldung.

Inhaltsverzeichnis

1. Wie installiere ich Codex?
2. Schnellstart: Ihre erste Sitzung
3. Zentrale Interaktionsoberflächen
4. Ausführliche Einführung in das Konfigurationssystem
5. Welches Modell sollte ich wählen?
6. Was kostet Codex?
7. Entscheidungsrahmen
8. Wie funktionieren das Sandbox- und Genehmigungssystem?
9. Wie funktioniert AGENTS.md?
10. Hooks
11. Was ist MCP (Model Context Protocol)?
12. Code Mode
13. JavaScript REPL-Laufzeit
14. Was sind Skills?
15. Plugins
16. Plan Mode und Zusammenarbeit
17. Speichersystem
18. Sitzungsverwaltung
19. Nicht interaktiver Modus (codex exec)
20. Codex Cloud und Hintergrundaufgaben
21. Die Codex Desktop App
22. GitHub Action und CI/CD
23. Codex SDK
24. Leistungsoptimierung
25. Wie behebe ich Probleme? – einschließlich codex doctor
26. Unternehmensweite Bereitstellung
27. Bewährte Verfahren und Antimuster
28. Arbeitsablaufrezepte
29. Migrationsleitfaden
30. Kurzreferenz
31. Änderungsprotokoll
32. Quellen

Wie installiere ich Codex?

Paketmanager

# npm (recommended)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

# winget (Windows)
winget install OpenAI.Codex

# Upgrade to latest
npm install -g @openai/codex@latest

Wie aktualisiere, downgrade oder deinstalliere ich Codex CLI?

Seit v0.128.0 verfügt Codex über einen Befehl zur Selbstaktualisierung; alles Weitere läuft über den Paketmanager, mit dem Codex installiert wurde.⁸⁶ Seit v0.146.0 werden Release-Artefakte, Kanalmetadaten und Installationsaliasnamen über die von OpenAI gehostete Release-Infrastruktur bereitgestellt, wobei GitHub als Fallback dient.¹¹⁴ Wenn Ihr Netzwerk GitHub für Codex-Installationen und -Aktualisierungen auf der Zulassungsliste führt, fügen Sie auch den OpenAI-Release-Host hinzu — andernfalls führt ein fehlender Eintrag wegen des Fallbacks unauffällig zu einer Beeinträchtigung, statt einen eindeutigen Fehler auszulösen.

# Check what you are running
codex --version                          # -> codex-cli 0.153.4
npm view @openai/codex version           # Latest published version

# Update
codex update                             # Built-in self-update (v0.128.0+)
npm install -g @openai/codex@latest      # Or update via npm
brew upgrade --cask codex                # Or via Homebrew

# Pin or downgrade to an exact version
npm install -g @openai/codex@0.144.6

# Uninstall
npm uninstall -g @openai/codex
brew uninstall --cask codex
winget uninstall OpenAI.Codex

Wenn ein Release bei Ihnen Probleme verursacht, ist das Anheften einer Version die richtige Lösung. Codex folgt einer schnell aktualisierten stabilen Versionslinie, daher ist die Installation einer exakten Version der schnellste Weg für ein Rollback — melden Sie das Problem, heften Sie die Version an und arbeiten Sie weiter. Prüfen Sie mit codex --version, ob das Rollback erfolgreich war, denn eine zweite, verdeckte Installation in Ihrem PATH stellt unbemerkt weiterhin die alte Binärdatei bereit (codex doctor weist unter Umgebung ausdrücklich darauf hin).

Durch die Deinstallation des Pakets wird Ihr Zustand nicht entfernt. Authentifizierungsdaten, Konfiguration und Sitzungsverlauf befinden sich in ~/.codex/. Belassen Sie den Ordner dort, um Anmeldungen und den Verlauf bei einer Neuinstallation zu erhalten; löschen Sie ihn nur, wenn Sie wirklich vollständig neu beginnen möchten — rm -rf ~/.codex entfernt außerdem config.toml, auth.json und jede gespeicherte Sitzung.

Direktes Installationsskript (ab v0.106.0)

Für macOS und Linux steht ein einzeiliges Installationsskript als Release-Asset auf GitHub zur Verfügung:⁶⁰

curl -fsSL https://github.com/openai/codex/releases/latest/download/install.sh | sh

Das Skript erkennt Ihre Plattform und Architektur automatisch, lädt die passende Binärdatei herunter und fügt sie Ihrem PATH hinzu.

Binärdateien zum Herunterladen

Für Umgebungen ohne npm oder Homebrew können Sie plattformspezifische Binärdateien von den GitHub-Releases herunterladen¹:

Systemanforderungen

• macOS: Apple Silicon oder Intel (vollständige Sandbox-Unterstützung über Seatbelt)
• Linux: x86_64 oder arm64 (Sandbox über Landlock + seccomp)
• Windows: Native Sandbox mit eingeschränkten Token (seit v0.100.0 nicht mehr experimentell). WSL wird ebenfalls unterstützt²

Authentifizierung

codex login                  # Interactive OAuth (recommended)
codex login --device-auth    # OAuth device code flow (headless)
codex login --with-api-key   # API key from stdin
codex login status           # Check auth state (exit 0 = logged in)
codex logout                 # Clear stored credentials

Es gibt 2 Authentifizierungswege:

1. ChatGPT-Konto (empfohlen): Melden Sie sich mit Ihrem bestehenden Plus-, Pro-, Team-, Business-, Edu- oder Enterprise-Abonnement an. Sie erhalten vollständigen Funktionszugriff einschließlich Cloud-Aufgaben.
2. API-Schlüssel: Legen Sie ihn über die Umgebungsvariable CODEX_API_KEY oder mit codex login --with-api-key fest. Einige Funktionen (Cloud-Threads) sind möglicherweise nicht verfügbar.

Expertentipp: Der Speicherort für Anmeldedaten lässt sich über cli_auth_credentials_store in config.toml konfigurieren. Optionen: file (Standard), keyring (Schlüsselbund des Betriebssystems) oder auto (keyring, falls verfügbar, andernfalls file).

Amazon-Bedrock-Anmeldung (v0.145.0, experimentell): Teams, deren Modellzugriff über Amazon Bedrock erfolgt, erhalten neben der bestehenden verwalteten Authentifizierung per API-Schlüssel (ab v0.140.0) und der AWS-Anmeldedatenkette einen experimentellen Anmeldeweg mit Unterstützung für benutzerdefinierte Endpunkte und Authentifizierung (siehe Benutzerdefinierte Modellanbieter). GPT-5.6 Sol ist das standardmäßige Bedrock-Modell.¹¹² v0.150.0 behebt Probleme bei der Gesprächskomprimierung und der Multi-Agent-Kompatibilität für Amazon-Bedrock-Modelle.¹³² v0.151.0 fügt den berechtigten TUI-Anmeldeabläufen eine funktionsgesteuerte Amazon-Bedrock-Option hinzu: Beim Onboarding werden vorhandene AWS-Profile und Umgebungsanmeldedaten erkannt sowie eine manuelle Einrichtung für Profile, Zugriffsschlüssel, Umgebungsvariablen und Bedrock-API-Schlüssel angeboten. Außerdem wird die AWS-Region abgefragt, Geheimnisse werden bei der Eingabe maskiert und der eingebettete Server wird bei einem Anbieterwechsel neu gestartet.¹³⁵ v0.152.0 zeigt den Fortschritt der Anmeldedatenaktualisierung an: Die TUI und codex exec zeigen den Fortschritt an, während ein Modellanbieter abgelaufene Anmeldedaten aktualisiert, einschließlich der erneuten Authentifizierung von Amazon-Bedrock-Sitzungen. Grundlage dafür sind die stabilen App-Server-Benachrichtigungen modelProvider/authRecoveryStarted und modelProvider/authRecoveryCompleted, die Thread, Turn, Anbieter und eine benutzerorientierte Meldung enthalten.¹³⁸

Shell-Vervollständigungen

# Generate completions for your shell
codex completion bash > /etc/bash_completion.d/codex
codex completion zsh > ~/.zsh/completions/_codex
codex completion fish > ~/.config/fish/completions/codex.fish

Installation überprüfen

codex --version
# codex-cli 0.153.4

Schnellstart: Ihre erste Sitzung

Starten Sie in 5 Minuten produktiv durch.

1. Installieren und authentifizieren:

npm i -g @openai/codex          # Install
codex login                      # Log in with your OpenAI account

2. Zu einem Projekt navigieren:

cd ~/my-project                  # Any git repo works

3. Codex starten:

codex

Die interaktive TUI wird angezeigt. Codex liest Ihre Projektstruktur automatisch ein.

4. Eine Frage stellen:

> What does this project do? Summarize the architecture.

Codex liest wichtige Dateien und erklärt die Codebasis. Eine solche Frage nimmt keine Änderungen vor — Codex patcht Dateien nur, wenn Sie eine Änderung anfordern. Die Sandbox und die Genehmigungsrichtlinie legen fest, wann Codex Sie zuvor um Erlaubnis bitten muss.

5. Eine Änderung vornehmen:

> Add input validation to the login endpoint

Codex schlägt Änderungen als Diff vor. Prüfen und genehmigen Sie sie mit y oder lehnen Sie sie mit n ab.

6. Einen slash command verwenden:

> /plan Refactor the database layer to use connection pooling

Codex erstellt einen Plan, ohne ihn auszuführen. Prüfen Sie den Plan und genehmigen Sie ihn anschließend, um mit der Ausführung zu beginnen.

7. Ihre Arbeit überprüfen:

> /diff

Zeigen Sie alle Änderungen an, die Codex in der aktuellen Sitzung vorgenommen hat.

Wie geht es weiter? - Richten Sie AGENTS.md mit Projektanweisungen ein (siehe Wie funktioniert AGENTS.md?) - Konfigurieren Sie ein Profil für Ihren Workflow (siehe Profile) - Probieren Sie codex exec für die nicht interaktive Automatisierung aus (siehe Nicht interaktiver Modus)

Zentrale Interaktionsoberflächen

Codex bietet fünf verschiedene Oberflächen, die auf derselben Intelligenz basieren. Jede Oberfläche ist für ein anderes Arbeitsablaufmuster optimiert.

1. Interaktive CLI (Terminal UI)

codex                        # Launch TUI
codex "fix the failing tests" # Launch with initial prompt
codex -m gpt-5.5            # Specify model
codex --sandbox workspace-write --ask-for-approval on-request

Die Terminal UI ist eine Vollbildanwendung mit:

• Eingabebereich: Geben Sie Prompts ein, hängen Sie mit @ Dateien an und führen Sie Shell-Befehle mit dem Präfix ! aus
• Ausgabebereich: Gestreamte Modellantworten, Tool-Aufrufe und Befehlsausgaben
• Statusleiste: Modell, Token-Nutzung, Git-Branch und Sandbox-Modus

Wichtige TUI-Tastenkürzel:

Änderung der Statuszeile (v0.121.0): Die bisherige Anzeige des Kontextfensters in der Statuszeile wurde durch eine Kontextprozentanzeige ersetzt, die zeigt, wie stark Ihr Kontextfenster ausgelastet ist. Wenn Sie Skripte oder hooks verwenden, die die Statuszeile auswerten, berücksichtigen Sie diese Formatänderung.⁸² Codex zeigt außerdem eine Aktualisierungsankündigung für die CLI an, sobald eine neue Version verfügbar ist.

In der TUI verfügbare slash commands:

Neugestaltung der Arbeitsablaufauswahl (v0.129.0): Über eine neu gestaltete Auswahl sind Fortsetzen und Verzweigen jetzt leichter erreichbar. Ein neuer Rohmodus für den Scrollback ermöglicht es außerdem, durch das unformatierte Transkript zu scrollen, wenn Sie Befehle oder Modellausgaben wortgetreu kopieren müssen. Das ist besonders nützlich, wenn Sie eine lange Fehlerdiagnosesitzung untersuchen oder Ausgaben an ein anderes Tool weiterleiten.⁸⁹

Einheitliches Menü für @-Erwähnungen (v0.140.0): Wenn Sie im Eingabebereich @ eingeben, öffnet sich jetzt standardmäßig ein gemeinsames Erwähnungsmenü für Dateien, Plugins und skills. Es ersetzt den bisherigen Ablauf, der ausschließlich Dateien anhängen konnte – mit einem Tastendruck können Sie auf jede Projektressource verweisen.¹⁰²

2. Codex Desktop App (macOS + Windows)

codex app                    # Launch desktop app (auto-installs if missing)

Die Desktop-App bietet Funktionen, über die die CLI nicht verfügt:

• Multitasking: Führen Sie mehrere parallele Agenten gleichzeitig in verschiedenen Projekten aus
• Git-worktree-Isolierung: Jeder Thread arbeitet mit einer isolierten Kopie Ihres Repositorys
• Inline-Diff-Review: Stellen Sie Änderungen bereit, machen Sie sie rückgängig und committen Sie sie, ohne die App zu verlassen
• Integriertes Terminal: Thread-spezifisches Terminal zum Ausführen von Befehlen
• Verzweigung von Unterhaltungen: Verzweigen Sie Unterhaltungen, um Alternativen zu untersuchen
• Schwebende Pop-out-Fenster: Lösen Sie Unterhaltungen in frei verschiebbare Fenster
• Automatisierungen: Planen Sie wiederkehrende Aufgaben (Issue-Triage, CI-Überwachung, Reaktion auf Warnmeldungen)
• Appshots: Hängen Sie das vorderste Mac-App-Fenster mit einem Screenshot und verfügbarem Text an einen Thread an
• Browserkommentare in der App: Zeigen Sie lokale oder öffentliche Seiten in der Vorschau an, hinterlassen Sie Kommentare zu Elementen oder Bereichen und lassen Sie Codex präzises visuelles Feedback umsetzen
• Computer Use: Lassen Sie Codex für klar abgegrenzte GUI-Arbeiten zugelassene Mac-Apps bedienen; eine Bedienung im gesperrten Zustand muss für berechtigte Remote-Mac-Computer-Use-Durchläufe ausdrücklich aktiviert werden

ChatGPT Voice, unterstützt von GPT-Live (Desktop 26.715, 23. Juli 2026): Die Desktop-App lässt sich jetzt per Sprache steuern – besprechen Sie Ihre Arbeit und koordinieren Sie Aufgaben in Chat, Work und Codex, ohne zu tippen. Wenn Sie unter macOS den Bildschirmkontext aktivieren, wird ein Appshot Ihres vordersten Fensters mit der Unterhaltung geteilt. So können Sie Fragen zu dem stellen, was Sie gerade sehen, anstatt es beschreiben zu müssen. Verfügbar für Plus, Pro, Business, Edu und Enterprise, sowohl in der Desktop-App als auch über Remote unter iOS. Dies ist die Sprachfunktion der Desktop-Oberfläche; die experimentelle Spracheingabe der CLI über die Leertaste ist eine separate Funktion.¹¹³

Geteilte Thread-Schnappschüsse (20. August 2026): In allen Codex-Tarifen kann die macOS-Desktop-App einen schreibgeschützten Schnappschuss eines lokalen Codex-Threads teilen. Der Schnappschuss wird nicht aktualisiert, wenn sich der ursprüngliche Thread ändert. Links aus persönlichen Konten können von allen Personen mit dem Link geöffnet werden, Links aus Arbeitsbereichskonten hingegen nur von Mitgliedern des ursprünglichen Arbeitsbereichs. Codex schwärzt vor dem Teilen bekannte Geheimnismuster. OpenAI empfiehlt Ihnen dennoch, die geteilten Inhalte zu prüfen, da vertrauliche Inhalte zurückbleiben können. Links können Sie in den ChatGPT-Datenkontrollen unter „Geteilte Links“ anzeigen oder widerrufen.¹²⁸

Wann Sie die App und wann die CLI verwenden sollten: Verwenden Sie die Desktop-App, wenn Sie mehrere Arbeitsströme koordinieren oder eine visuelle Diff-Review benötigen. Nutzen Sie die CLI, wenn Sie Befehle im Terminal kombinieren, Skripte einsetzen oder eine CI/CD-Integration benötigen.

3. IDE-Erweiterung (VS Code, Cursor, Windsurf)

Die Codex-IDE-Erweiterung integriert sich direkt in Ihren Editor:

• Standardmäßig Agentenmodus: Liest Dateien, nimmt Änderungen vor und führt Befehle aus
• Inline-Bearbeitungen: Kontextbezogene Vorschläge in Ihren aktiven Dateien
• Gemeinsame Sitzungen: Sitzungen werden zwischen der CLI und der IDE-Erweiterung synchronisiert
• Gleiche Authentifizierung: Melden Sie sich mit Ihrem ChatGPT-Konto oder API-Schlüssel an

Installieren Sie die Erweiterung über den VS Code Marketplace oder die Erweiterungsshops von Cursor und Windsurf.³

4. Codex Cloud [EXPERIMENTAL]

Cloud-Aufgaben werden asynchron in von OpenAI verwalteten Umgebungen ausgeführt:

• Starten und vergessen: Stellen Sie Aufgaben in eine Warteschlange, die unabhängig von Ihrem lokalen Computer ausgeführt werden
• Parallele Ausführung: Führen Sie mehrere Cloud-Aufgaben gleichzeitig aus
• PR-Erstellung: Codex erstellt Pull Requests aus abgeschlossenen Arbeiten
• Lokale Übernahme: Übernehmen Sie Cloud-Ergebnisse mit codex apply <TASK_ID> in Ihr lokales Repository

codex cloud list             # List recent cloud tasks
codex apply <TASK_ID>        # Apply diff from a specific cloud task

Cloud-Aufgaben sind außerdem über chatgpt.com/codex verfügbar.⁴

5. Browsererweiterung (Chrome, Edge, Brave, Opera, Vivaldi)

Codex ist als Browsererweiterung für Google Chrome, Microsoft Edge, Brave, Opera und Vivaldi verfügbar und ergänzt die CLI, die Desktop-App, die IDE-Erweiterung und die Cloud um eine fünfte Oberfläche. Die Erweiterung erschien im Mai 2026 für Chrome; mit dem Changelog vom 25. August 2026 kamen die vier weiteren Browser hinzu. Die Einrichtung erfolgt in der ChatGPT-Desktop-App unter Einstellungen > Computer Use. Alle fünf unterstützen Tab-Erwähnungen und Browsersteuerung. Opera unterstützt jedoch keinen Nebenchat, weshalb Sie entsprechende Aufgaben in der Desktop-App starten müssen. Die Erweiterung begleitet Ihr normales Surfen, statt es zu übernehmen: Codex arbeitet im Hintergrund parallel in mehreren Tabs, während Sie die Kontrolle darüber behalten, auf welche Websites es zugreift.⁹⁰¹²⁷

• Parallele Ausführung in Tabs: Codex arbeitet gleichzeitig in mehreren Tabs, ohne den Tab im Vordergrund zu sperren.
• Website-spezifische Kontrolle: Sie legen in einer Positivliste fest, mit welchen Websites Codex interagieren darf; standardmäßig besteht kein Zugriff.
• Der Browser als Werkbank: Die Erweiterung eignet sich besonders für Arbeiten an Apps und Websites, bei denen die Seite die maßgebliche Informationsquelle ist – etwa Administrationskonsolen, interne Dashboards, Benutzeroberflächen von Content-Management-Systemen und Ticketsysteme. Sie ersetzt nicht die CLI für lokale Repositorys.
• Gleiche Intelligenz: Die Browsererweiterung nutzt dieselbe GPT-5.x-Codex-Intelligenz wie die anderen Oberflächen. Konventionen aus einer AGENTS.md- oder skills-Konfiguration, die in der CLI funktionieren, gelten deshalb ebenso für browsergestützte Arbeiten.

Installieren Sie die Erweiterung über die Dokumentation zur Browsererweiterung, deren Seite früher den Titel Codex for Chrome trug.¹²⁷

Ausführlicher Einblick in das Konfigurationssystem

Codex verwendet TOML für die Konfiguration. Das Verständnis der Prioritätshierarchie ist entscheidend, da sie bestimmt, welche Einstellungen bei Konflikten Vorrang haben.

Priorität (von der höchsten zur niedrigsten)

1. Sitzungsüberschreibungen (höchste Priorität): CLI-Flags (--model, --sandbox, --ask-for-approval, --search, --enable/--disable, --profile) und Überschreibungen mit -c key=value
2. Projektkonfiguration (.codex/config.toml, wird ausgehend vom CWD aufwärts bis zum Projektstamm gesucht; das nächstgelegene Verzeichnis hat Vorrang)
3. Benutzerkonfiguration ($CODEX_HOME/config.toml, standardmäßig ~/.codex/config.toml)
4. Systemkonfiguration (/etc/codex/config.toml unter Unix)
5. Integrierte Standardwerte (niedrigste Priorität)

requirements.toml fungiert als Richtlinienbeschränkungsebene, die nach dem regulären Zusammenführen der Konfiguration einschränkt, welche Werte Benutzer auswählen können. Siehe Unternehmensbereitstellung.

Speicherorte der Konfigurationsdateien

Expertentipp: Die Umgebungsvariable CODEX_HOME überschreibt das Standardverzeichnis ~/.codex. Dies ist für CI/CD- oder Mehrkontoeinrichtungen nützlich.

Desktop-Projekte mit mehreren Ordnern (26.715, 23. Juli 2026): Ein lokales Projekt in der ChatGPT-Desktop-App kann sich nun über mehrere zusammengehörige Ordner erstrecken, von denen einer als primärer Ordner festgelegt wird (Projektmenü → Projekt bearbeiten). Die automatische Erkennung von config.toml erfolgt ausschließlich im primären Ordner; sekundäre Ordner stehen weiterhin für Dateisuche, Lese- und Bearbeitungsvorgänge zur Verfügung, liefern jedoch keine Konfiguration. Eine .codex/config.toml in einem sekundären Ordner ist eine Datei, die Codex lesen kann, aber keine Konfiguration, die geladen wird. Dies betrifft den Projektgeltungsbereich der Desktop-App und ändert nicht die oben beschriebenen Prioritätsregeln — CLI ermittelt die Projektkonfiguration weiterhin, indem es vom aktuellen Arbeitsverzeichnis aus die Verzeichnishierarchie aufwärts durchsucht.¹¹³

Vollständige Konfigurationsreferenz

# ~/.codex/config.toml — annotated reference

# ─── Model Selection ───────────────────────────────────
model = "gpt-5.6-sol"                  # Recommended default (the "Power" setting)
model_provider = "openai"               # Provider (openai, oss, or custom provider id)
model_context_window = 272000           # Token count available to active model (override)
model_auto_compact_token_limit = 200000 # Threshold triggering automatic history compaction
model_reasoning_effort = "medium"       # minimal|low|medium|high|xhigh (model-dependent)
model_reasoning_summary = "auto"        # auto|concise|detailed|none
model_verbosity = "medium"              # low|medium|high
personality = "pragmatic"               # none|friendly|pragmatic
review_model = "gpt-5.5"               # Optional model for /review command
service_tier = "fast"                  # Preferred service tier for new turns
oss_provider = "lmstudio"              # lmstudio|ollama (used with --oss)

# ─── Sandbox & Approval ───────────────────────────────
sandbox_mode = "workspace-write"        # read-only|workspace-write|danger-full-access
approval_policy = "on-request"          # on-request|never (untrusted retired in v0.149.0)

[sandbox_workspace_write]
writable_roots = []                     # Additional writable paths
network_access = false                  # Allow outbound network
exclude_tmpdir_env_var = false          # Exclude $TMPDIR from sandbox
exclude_slash_tmp = false               # Exclude /tmp from sandbox

# ─── Web Search ────────────────────────────────────────
web_search = "live"                     # Web search mode (constrained by allowed modes)

# ─── Tools ─────────────────────────────────────────────
tools.update_plan.enabled = false       # Planning tool opt-in (v0.152.0); exposes update_plan when true

# ─── Instructions ──────────────────────────────────────
developer_instructions = ""             # Additional injected instructions
model_instructions_file = ""            # Custom instructions file path
compact_prompt = ""                     # Custom history compaction prompt

# ─── Shell Environment ─────────────────────────────────
allow_login_shell = false               # Allow login shell semantics (loads .profile/.zprofile)

[shell_environment_policy]
inherit = "all"                         # all|core|none
ignore_default_excludes = false         # Set true to keep KEY/SECRET/TOKEN vars
exclude = []                            # Glob patterns to exclude
set = {}                                # Explicit overrides
include_only = []                       # Whitelist patterns

# ─── Authentication ────────────────────────────────────
cli_auth_credentials_store = "file"     # file|keyring|auto
forced_login_method = "chatgpt"         # chatgpt|api
mcp_oauth_callback_port = 0            # Fixed port for MCP OAuth callback (0 = random)
mcp_oauth_credentials_store = "auto"   # auto|file|keyring

# ─── History & Storage ─────────────────────────────────
[history]
persistence = "save-all"                # save-all|none
max_bytes = 0                           # Cap size (0 = unlimited)

tool_output_token_limit = 10000         # Max tokens per tool output (global; per-tool MCP overrides in v0.152.0)
log_dir = ""                            # Custom log directory
sqlite_home = ""                        # Override SQLite-backed resumable state location

# ─── UI & Display ──────────────────────────────────────
file_opener = "vscode"                  # vscode|vscode-insiders|windsurf|cursor|none
hide_agent_reasoning = false
show_raw_agent_reasoning = false
check_for_update_on_startup = true

[tui]
notifications = false                   # Enable notifications
notification_method = "auto"            # auto|osc9|bel
animations = true
show_tooltips = true
alternate_screen = "auto"               # auto|always|never
status_line = ["model", "context-remaining", "git-branch"]

# ─── Project Trust ─────────────────────────────────────
project_doc_max_bytes = 32768           # Max AGENTS.md size (32 KiB)
project_doc_fallback_filenames = []     # Alternative instruction filenames
project_root_markers = [".git"]         # Project root detection

# ─── Feature Flags ─────────────────────────────────────
# Use `codex features list` for current names/stages/defaults.
[features]
shell_tool = true                       # Shell command execution (stable)
unified_exec = true                     # PTY-backed exec (stable)
shell_snapshot = true                   # Shell env snapshots (stable)
enable_request_compression = true       # zstd request compression where supported (stable)
fast_mode = true                        # Service-tier selection and Fast-tier commands (stable)
goals = true                            # Goal mode; stable and on by default in v0.133.0+
hooks = true                            # Lifecycle hooks (stable)
multi_agent = true                      # Enable multi-agent collaboration tools (stable)
personality = true                      # Personality selection (stable)
plugins = true                          # Plugin system (stable)
plugin_hooks = true                     # Plugin-bundled hooks (stable)
plugin_sharing = true                   # Workspace plugin sharing (stable)
browser_use = true                      # In-app browser automation (stable)
browser_use_external = true             # Browser-extension browser use (stable)
computer_use = true                     # macOS Computer Use (stable, plan/region gated)
in_app_browser = true                   # Shared rendered-page preview (stable)
image_generation = true                 # Image-generation tool (stable)
guardian_approval = true                # Auto-review approval path (stable)
skill_mcp_dependency_install = true     # Prompt/install missing skill MCP deps (stable)
tool_suggest = true                     # Tool/plugin suggestion surface (stable)
workspace_dependencies = true           # Workspace dependency discovery (stable)
memories = true                         # Memories (experimental)
network_proxy = false                   # Sandboxed-command network proxy (experimental); boolean or table, see below
prevent_idle_sleep = true               # Keep machine awake during active turns (experimental)
terminal_resize_reflow = true           # Terminal reflow improvements (experimental)

# Removed or deprecated feature names still appear in `codex features list`
# for migration diagnostics. Do not set removed flags such as
# `collaboration_modes`, `request_rule`, `codex_git_commit`,
# `apply_patch_freeform`, `search_tool`, or `js_repl` in new configs.

# ─── Multi-Agent Roles (v0.102.0+) ───────────────────
[agents]
max_threads = 4                         # Maximum concurrent agent threads

[agents.explorer]
description = "Read-only codebase navigator"
config_file = "~/.codex/profiles/explorer.toml"

# ─── Notifications ────────────────────────────────────
notify = ["terminal-notifier", "-title", "Codex"]  # Command for notifications

# ─── Per-Project Overrides ────────────────────────────
[projects."/absolute/path/to/repo"]
trust_level = "trusted"                 # Per-project trust override

features.network_proxy ist boolean | table. Die boolesche Form startet oder stoppt lediglich den Proxy; die Tabellenform enthält die Richtlinie. Der Proxy setzt die Domänenregeln des Berechtigungsprofils für Sandbox-Befehle durch: Ist er deaktiviert, werden die Domänenregeln unter [permissions.<name>.network] nicht durchgesetzt, und der Netzwerkzugriff von Befehlen erfolgt direkt. Websuchen, Apps, MCP servers oder andere gehostete Tools werden dadurch nicht gefiltert.¹³⁰

[features.network_proxy]
enabled = true
allow_local_binding = false
proxy_url = "http://127.0.0.1:3128"

[features.network_proxy.domains]
"api.github.com" = "allow"
"*.npmjs.org" = "allow"          # subdomains only
"**.example.com" = "deny"        # apex plus subdomains; deny wins on conflicts

Von Administratoren verwaltete experimental_network-Anforderungen in requirements.toml können den Proxy ohne features.network_proxy starten.¹³⁰

Profile

Benannte Konfigurationsvorgaben für unterschiedliche Arbeitsmodi. Seit Codex 0.134.0 besitzt jedes Profil eine eigene Datei — ~/.codex/<name>.config.toml, die ausschließlich Schlüssel der obersten Ebene enthält — und --profile <name> legt diese Datei über ~/.codex/config.toml. Die älteren [profiles.<name>]-Tabellen innerhalb von config.toml und der Selektor profile = "<name>" auf oberster Ebene werden nicht mehr gelesen; eine verbliebene [profiles.<name>]-Tabelle verhindert den Start mit --profile <name>, bis Sie deren Schlüssel in die Profildatei verschoben haben.¹²²

# ~/.codex/fast.config.toml
model = "gpt-5.6-luna"
model_reasoning_effort = "low"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
personality = "pragmatic"

# ~/.codex/careful.config.toml
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
approval_policy = "on-request"   # `untrusted` retired in v0.149.0
sandbox_mode = "read-only"

# ~/.codex/auto.config.toml
model = "gpt-5.6-sol"
model_reasoning_effort = "medium"
approval_policy = "never"
sandbox_mode = "workspace-write"

Eine Profildatei bildet eine Ebene über Ihrer grundlegenden Benutzerkonfiguration und unterhalb der Projekt- und CLI-Konfiguration. Daher muss sie nur die Werte enthalten, die von Ihrer Basiskonfiguration abweichen.¹²²

Aktivieren Sie ein Profil:

codex --profile fast "quick refactor"
codex --profile careful "security audit"
codex -p auto "fix CI"

Expertentipp: Legen Sie mit profile = "fast" auf der obersten Ebene Ihrer Konfiguration ein Standardprofil fest. Überschreiben Sie es sitzungsweise mit --profile.

Benutzerdefinierte Modellanbieter

Stellen Sie eine Verbindung zu Azure, AWS Bedrock, lokalen Modellen oder Proxy-Diensten her:

[model_providers.azure]
name = "Azure OpenAI"
base_url = "https://YOUR_PROJECT.openai.azure.com/openai"
wire_api = "responses"
query_params = { api-version = "2025-04-01-preview" }
env_key = "AZURE_OPENAI_API_KEY"

# Built-in amazon-bedrock provider (v0.123.0+, first-class in v0.124.0+)
# AWS SigV4 signing + credential-based auth; AWS profile selectable via the
# nested `aws.profile` field (NOT a top-level `aws_profile` key).
# v0.130.0+ also accepts credentials from `aws login` (the AWS console-login
# flow) — Codex resolves the cached console-login session for the chosen
# profile if static keys are absent.
# v0.140.0+ adds managed Amazon Bedrock API-key authentication, and stores
# CLI and MCP OAuth credentials in encrypted local storage.[^184]
[model_providers.amazon-bedrock]
name = "Amazon Bedrock"

[model_providers.amazon-bedrock.aws]
profile = "default"                   # any profile from ~/.aws/credentials
# Region/credential resolution otherwise follows the standard AWS chain;
# v0.130.0 added support for `aws login` console-login profiles in addition
# to static access keys and IAM role assumption.[^168]

[model_providers.ollama]
name = "Ollama (Local)"
base_url = "http://localhost:11434/v1"
wire_api = "chat"

Warnung: Das chat/completions-Wire-API (wire_api = "chat") wurde für von OpenAI gehostete Modelle als veraltet eingestuft; OpenAI kündigte die Entfernung für Februar 2026 an.³⁴ Lokale Anbieter (Ollama, LM Studio) akzeptieren dieses Format möglicherweise weiterhin. Verwenden Sie für OpenAI-Endpunkte stattdessen wire_api = "responses".

Verwenden Sie lokale Modelle mit dem Flag --oss:

codex --oss "explain this function"               # Uses default OSS provider
codex --oss --local-provider lmstudio "explain"   # Explicit LM Studio
codex --oss --local-provider ollama "explain"      # Explicit Ollama

Oder legen Sie dies in der Konfiguration fest:

model_provider = "oss"
oss_provider = "lmstudio"   # or "ollama"

Inline-Konfigurationsüberschreibungen

Überschreiben Sie einen beliebigen Konfigurationswert über die Befehlszeile:

codex -c model="gpt-5.5" "refactor the API"
codex -c 'sandbox_workspace_write.network_access=true' "install dependencies"
codex -c model_reasoning_effort="xhigh" "debug the race condition"

Welches Model sollten Sie wählen?

Verfügbare Models (September 2026)

GPT-5.5 (23. April 2026) war bei der Veröffentlichung OpenAIs empfohlene Wahl für die meisten Codex-Aufgaben: komplexe Programmierung, Computerbedienung, Wissensarbeit und Forschungsabläufe. Am 23. April in Codex CLI / Web / Desktop für ChatGPT Plus / Pro / Business / Enterprise / Edu / Go verfügbar; am 24. April in der OpenAI API. Kontextfenster: 400K in Codex, 1M in der API – Codex begrenzt das Fenster auf 400K, um Durchsatz und Kosten über die verschiedenen Abonnementstufen hinweg auszubalancieren; die API stellt die vollen 1M bereit. Preise (API): 5 $ für die Eingabe / 30 $ für die Ausgabe pro MTok (das Doppelte des GPT-5.4-Tarifs; laut OpenAI beträgt die tatsächliche Erhöhung nach Verbesserungen der Tokeneffizienz etwa 20 %). Benchmarks: 82,7 % bei Terminal-Bench 2.0 (aktueller SOTA unter den öffentlich verfügbaren Models), 84,9 % bei GDPval (44 Berufe), 78,7 % bei OSWorld-Verified, 98,0 % bei Tau2-bench Telecom (ohne Prompt-Tuning). OpenAI setzte GPT-5.5 und Codex intern ein, um vor der Veröffentlichung die Bereitstellungsinfrastruktur neu zu schreiben – dadurch stieg die Geschwindigkeit der Tokengenerierung um 20 %.⁸³

GPT-5.4 und GPT-5.4 mini werden am 31. August 2026 aus Codex entfernt.¹¹⁷ Bis dahin bleibt GPT-5.4 auf allen Codex-Oberflächen auswählbar.⁶⁴ Die genaue Model-Liste variiert je nach Konto und Einführungsphase. Prüfen Sie Ihren lokalen Cache: ~/.codex/models_cache.json.

Hinweis zur Einstellung (11. März 2026): GPT-5.1-Models sind in ChatGPT nicht mehr verfügbar. Bestehende Unterhaltungen werden automatisch mit GPT-5.3 Instant, GPT-5.4 Thinking oder GPT-5.4 Pro fortgesetzt. GPT-5.1-Codex-Mini blieb bis zur Abschaltung am 23. Juli 2026 über API und CLI verfügbar.⁷¹⁸⁸

Hinweis zum kostenlosen Tarif (5. Mai 2026): GPT-5.5 Instant wurde am 5. Mai 2026 für den kostenlosen ChatGPT-Tarif eingeführt. Dadurch erreicht die GPT-5.5-Familie über kostenpflichtige Tarife hinaus ein größeres Publikum; für den Zugriff auf Codex CLI ist jedoch weiterhin ein geeignetes Plus-/Pro-/Business-/Enterprise-/Edu-/Go-Abonnement oder ein API-Schlüssel erforderlich.⁹²

GPT-5.4 mini (17. März 2026): Eine kleinere, schnellere Variante von GPT-5.4 mit einem Kontext von 400K für 0,75 $/4,50 $ pro MTok – verbraucht nur 30 % des GPT-5.4-Kontingents. Ideal für die Delegierung an Subagents: Lassen Sie GPT-5.4 die Planung und Koordination übernehmen, während GPT-5.4-mini-Subagents engere Teilaufgaben (Codebasis-Suche, Dateiüberprüfung, Dokumentverarbeitung) parallel bearbeiten.⁷⁶

Bedrock GPT-5.6 (Sol, Terra, Luna) (v0.143.0, 8. Juli 2026): Codex führte erstklassige Unterstützung für drei auf Amazon Bedrock gehostete GPT-5.6-Modelvarianten ein, einschließlich Unterstützung für die Reasoning-Aufwandsstufe max. Teams, deren Model-Zugriff über einen Bedrock-Anbieter erfolgt, können diese genauso wie andere Models benutzerdefinierter Anbieter auswählen (siehe Benutzerdefinierte Model-Anbieter); die Aufwandsstufe max ist für die anspruchsvollsten Reasoning- und agentischen Aufgaben vorgesehen.¹⁰⁶ v0.144.6 (18. Juli 2026) aktualisierte die gebündelten Anweisungen für Sol, Terra und Luna und korrigierte deren Kontextfenster auf 272.000 Tokens.¹¹¹ v0.145.0 (21. Juli 2026) ergänzt eine experimentelle Bedrock-Anmeldung mit Unterstützung für benutzerdefinierte Endpunkte und Authentifizierung, macht GPT-5.6 Sol zum standardmäßigen Bedrock-Model und migriert die gebündelte GPT-5.4-Modelauswahl auf die entsprechenden Terra- und Luna-Varianten.¹¹²

GPT-6-Astra (veröffentlicht am 3. September 2026; in Codex über v0.153.1–v0.153.4): die Chronologie mit genauen Daten: v0.153.1 bereitete am 3. September 2026 einen ausschließlich über API verfügbaren Katalogeintrag vor; OpenAI kündigte GPT-6-Astra am selben Tag an; und v0.153.4 ergänzte am 4. September den Eintrag in der Modellauswahl sowie die Umstellung auf den gebündelten CLI-Standard. Die Ankündigung beschreibt eine stufenweise Einführung, die mit einer begrenzten Zahl von Organisationen beginnt (zuerst Partner des Cybersicherheitsprogramms) und „in den kommenden Tagen“ auf ChatGPT Plus, Pro, Business und Enterprise sowie auf die OpenAI API und AWS ausgeweitet wird – die Angaben zur Einführung stammen aus Presseberichten (CNBC, Axios, Forbes, Al Jazeera, 9to5Mac).¹⁴⁵ Am 4. September überholt: OpenAI gab auf X bekannt, GPT-6 Astra sei „jetzt für alle Benutzer von Pro, Enterprise und Business Premium in ChatGPT Work und Codex verfügbar“ sowie „in der API live“; Plus und Business sollten innerhalb weniger Tage folgen. Noch am selben Abend ergänzte Codex-Leiter Tibo Sottiaux: „Astra ist jetzt auch für alle Plus- und Business-Benutzer eingeführt.“ In der Praxis bleiben die Berechtigungen uneinheitlich – Community-Berichte vom 5. September zeigen, dass Plus-Konten in Codex weiterhin nur GPT-5.6-Models sehen – und die nachstehend zitierte Verfügbarkeitsangabe der Model-Dokumentation ist unverändert, weshalb sie weiterhin als maßgebliche Erstaussage gilt.¹⁴⁹ Die Erstanbieterdokumentation ist verfügbar: Auf der API-Modelseite wird gpt-6-astra als Flaggschiff aufgeführt, „Unser leistungsfähigstes Model, entwickelt für die anspruchsvollsten End-to-End-Aufgaben“ – 10 $/MTok Eingabe, 50 $/MTok Ausgabe zu den Standardtarifen für kurze Kontexte, ein Kontextfenster mit 1,05M Tokens, maximal 922.000 Eingabetokens, maximal 128K Ausgabetokens sowie ein Wissensstand vom 30. April 2026 – mit einer dokumentierten Langkontextstufe: Prompts mit mehr als 272K Eingabetokens werden für die gesamte Anfrage zum 2-fachen Eingabe- und 1,5-fachen Ausgabepreis abgerechnet, laut Preisseite also mit 20 $/MTok für die Eingabe und 75 $/MTok für die Ausgabe. Damit liegt es oberhalb von GPT-5.6 Terra (ausgewogen) und Luna (kostengünstig). Die Codex-Dokumentation bezeichnet Astra als das empfohlene Codex-Model; seine Verfügbarkeit „hängt von der Einführung, Ihrer Anmeldemethode und Ihrem Client ab“, wobei Pro-, Business- (100 $) und Enterprise-Konten als berechtigt genannt werden. Astras dokumentierte Codex-Reasoning-Stufen: Low, Medium, High, Extra High, Max, Ultra – die Model-Dokumentationsseite kennzeichnet Medium als Standard, während der gebündelte Katalog von v0.153.4 default_reasoning_level auf low setzt. Betrachten Sie den tatsächlichen Standard daher als oberflächenabhängig und prüfen Sie /status in einer Sitzung.¹⁴⁶¹⁴⁸ In CLI ist Astra seit v0.153.1 über API konfigurierbar (-m gpt-6-astra), wurde in v0.153.3 in die Amazon-Bedrock-Kataloge aufgenommen (GPT-5.6 Sol bleibt der Bedrock-Standard) und erscheint seit v0.153.4 in der Modellauswahl sowie als gebündelter Standard, wenn kein Model ausdrücklich konfiguriert ist – da keine CLI-Mindestversion dokumentiert ist, sollten Sie diese Versionen als tatsächliche Untergrenzen behandeln. Diese Standardumstellung betrifft den gebündelten CLI-Katalog und nicht alle Oberflächen: In der Verfügbarkeitsmatrix der Model-Dokumentation ist Astra für Codex cloud als nicht verfügbar gekennzeichnet (GPT-5.6 Sol bleibt dort verfügbar), und die Seite weist darauf hin: „Derzeit können Sie das Standard-Model für Codex-cloud-Chats nicht ändern.“ Einschränkung zur Einführung: Die Berechtigung variiert je nach Konto, und unter CLI 0.153.4+ enthält ein Konto außerhalb der Einführung einen gebündelten Standard, den es noch nicht nutzen kann – fixieren Sie für eine deterministische Auswahl model = "gpt-5.6-sol" in config.toml (oder übergeben Sie -m). Die Abrechnung des Astra-Fast-Modus ist dokumentiert, obwohl die Model-Seite keine Fast-Stufe aufführt: Laut Codex-Geschwindigkeitsdokumentation kostet er bei der Anmeldung mit ChatGPT das 2,5-Fache der Standard-Credits („sofern verfügbar“), während die API-Preisseite Fast-Modus-Tarife in Höhe von genau dem Doppelten der jeweils geltenden Standardtarife ausweist (20 $/100 $ pro MTok bei kurzem Kontext, 40 $/150 $ bei langem Kontext). Die Angabe zur „2-fachen Geschwindigkeit“ in der Katalogbeschreibung von v0.153.2 bleibt reiner Kataloganzeigetext – die Geschwindigkeitsseite nennt keinen Geschwindigkeitsmultiplikator für Astra.^145146147148

Power-Voreinstellungen unter Astra (Dokumentationsergänzung am oder vor dem 6. September 2026): Der Abschnitt zur Modellauswahl in der Codex-Model-Dokumentation ordnet die Power-Optionen der Auswahl nun den Reasoning-Stufen von GPT-6-Astra zu – die erste dokumentierte Zuordnung der Power-Voreinstellungen zu Astra – und zwar in einem Absatz, der beim erneuten Zugriff für ¹⁴⁶ am 5. September noch fehlte und dessen Veröffentlichung am 7. September bestätigt wurde. Wörtlich: „Für berechtigte Pro-, Business- (100 $) und Enterprise-Konten aktualisiert die Astra-Einführung die Power-Optionen auf Terra Light, Sol Light, Sol Medium, Astra Light, Astra Medium und Astra Extra High. Die Optionen können je nach Tarif und Einführungsphase variieren.“ Der vorangehende Satz in der Dokumentation weist darauf hin, dass die Abbildungen der Auswahl weiterhin GPT-5.6-Steuerelemente zeigen. Im Zusammenhang mit der obigen Model-Tabelle bedeutet dies: „Power“ stand bislang für GPT-5.6 Sol mit mittlerem Reasoning; bei einem berechtigten Konto erstreckt sich dieselbe Voreinstellungsleiter nun über Terra, Sol und Astra mit festen Reasoning-Stufen, wobei die Optionen weiterhin vom Tarif und der Einführungsphase abhängen.¹⁴⁶

Experimentelle kontextübergreifende Notizen (Astra, in der Dokumentation veröffentlicht, Opt-in): Die Codex-Model-Dokumentationsseite enthält einen Abschnitt mit der Überschrift „Experimentelle Kontextverwaltung“, wörtlich: „Auf unterstützten Codex-Clients können Benutzer, die mit ChatGPT Plus oder Pro angemeldet sind, die experimentelle Kontextverwaltung aktivieren. Astra bewahrt Notizen über Kontextfenster hinweg auf und kann frühere Nachrichten und Tool-Ergebnisse derselben Aufgabe durchsuchen. Dieses Experiment ist standardmäßig deaktiviert und bei der Veröffentlichung nicht für die Anmeldung mit Business, Enterprise oder einem API-Schlüssel verfügbar.“ Der Opt-in-Mechanismus lautet wörtlich: „Um die Funktion zu aktivieren, setzen Sie features.context_management.experimental_mode = true in Ihrer config.toml und starten Sie anschließend eine neue Aufgabe.“ Dies ist dieselbe features.context_management.experimental_mode-Oberfläche, die mit v0.153.0 ausgeliefert wurde (siehe Kontextverwaltung) – die Dokumentationsseite verknüpft sie nun ausdrücklich mit Astra sowie der Plus- und Pro-Anmeldung, während die Versionshinweise zu v0.153.0 berechtigte Plus-, Pro- und Pro-Lite-Sitzungen genannt hatten. Experimentell und standardmäßig deaktiviert; rechnen Sie mit Änderungen am Verhalten und an den Berechtigungen.¹⁴⁰¹⁴⁶

Ablaufdiagramm zur Model-Auswahl

Is this a quick fix or simple question?
├─ Yes → gpt-5.6-luna (fastest, most affordable)
└─ No
   ├─ Do you need real-time pairing speed?
   │  ├─ Yes → gpt-5.3-codex-spark (near-instant, Pro only)
   │  └─ No
   │     ├─ Subagent or parallel subtask (search, review, processing)?
   │     │  ├─ Yes → gpt-5.6-luna (the bundled subagent pick since v0.145.0)
   │     │  └─ No
   │     │     ├─ Everyday coding task (refactor, migration, feature build)?
   │     │     │  ├─ Yes → gpt-5.6-terra (everyday model, 272K context)
   │     │     │  └─ No
   │     │     │     ├─ In the GPT-6-Astra rollout (entitled account)?
   │     │     │     │  ├─ Yes → gpt-6-astra (new flagship; bundled default at 0.153.4+)
   │     │     │     │  └─ No → gpt-5.6-sol ("Power" setting; stable fallback)
   └─ Still unsure? → gpt-5.6-sol

Reasoning-Aufwand

Steuern Sie, wie lange das Model vor einer Antwort „nachdenkt“:

Die unterstützten Stufen hängen vom Model ab. minimal ist nur für GPT-5-Models verfügbar. Nicht alle Models unterstützen jede Stufe.

Details zu persistent (v0.151.0): Bei Durchläufen mit dem Aufwand persistent sind die Erinnerung an die aktuelle Uhrzeit und das unterbrechbare Tool clock.sleep standardmäßig aktiviert (ausdrückliche Einstellungen für features.current_time_reminder und verwaltete Anforderungen bleiben erhalten). Zudem werden gebündelte Anweisungen für Proaktivität und Folgeaktionen bereitgestellt, die durch Model-Metadaten über persistent_instructions überschrieben oder deaktiviert werden können.¹³⁵

codex -c model_reasoning_effort="xhigh" "find the race condition"

Expertentipp: Reasoning mit xhigh kann für denselben Prompt 3- bis 5-mal mehr Tokens als medium verbrauchen. Verwenden Sie es nur für wirklich schwierige Probleme, bei denen sich das zusätzliche Nachdenken auszahlt.

TUI-Schnellsteuerung für Reasoning (v0.124.0+).⁸⁵ In einer interaktiven TUI-Sitzung verringert Alt+, das Reasoning um eine Stufe und Alt+. erhöht es um eine Stufe – praktisch, wenn ein schwieriges Problem während einer Sitzung vorübergehend eine Steigerung von medium → high → xhigh rechtfertigt, ohne /effort oder -c zu verwenden. Wenn Sie während einer Sitzung ein Model-Upgrade akzeptieren, wird das Reasoning auf den Standard des neuen Models zurückgesetzt, statt die vorherige Stufe zu übernehmen.

Model-Wechsel

Wechseln Sie Models während einer Sitzung mit dem Slash Command /model oder legen Sie sie für jeden Durchlauf über --model / -m fest:

codex -m gpt-5.3-codex-spark "pair with me on this component"

Was kostet Codex?

Weitere Informationen zu den Funktionen finden Sie unter Modellauswahl und zur Auswahl des richtigen Modells für die jeweilige Aufgabe unter Entscheidungsrahmen.

Zugriff über ChatGPT-Tarife

Die Verfügbarkeit von Codex hängt von Ihrem ChatGPT-Tarif und den Organisationseinstellungen ab:⁵¹

Preisaktualisierung vom April 2026: Der jährliche Business-Preis wurde von 25 $ auf 20 $ pro Sitz und Monat gesenkt. Reine Codex-Sitze mit nutzungsabhängiger Abrechnung sind jetzt für Business- und Enterprise-Arbeitsbereiche verfügbar – ohne feste Sitzgebühr und nach Tokenverbrauch abgerechnet.⁷⁹ Auf der Preisseite werden die Limits nun als modellspezifische Bereiche angegeben (siehe Tabelle oben) und nicht mehr als die zur Einführung der Desktop App im Februar 2026 angebotenen 2x-Multiplikatoren.¹⁶¹⁵²

Erhöhung der Nutzungslimits im Mai 2026 (abgelaufen am 31. Mai 2026): Codex im Plus-Tarif bot ein 25-faches 5-Stunden-Limit (gegenüber der standardmäßigen 20-fachen Erhöhung), und das Kontingent der Stufe für 100 $/Monat wurde verdoppelt.⁸⁹

Benutzererfahrung bei Nutzungslimits in der TUI (v0.152.0–v0.153.0): Das Erreichen eines Limits führt nicht mehr in eine Sackgasse. v0.152.0 zeigt über dem Eingabefeld Banner mit konkreten Handlungsoptionen an – Nutzung prüfen, Guthaben verwalten, Limits zurücksetzen, den Eigentümer des Arbeitsbereichs benachrichtigen und Tarife verwalten. Die Optionen werden nach dem authentifizierten Konto und Benutzer gefiltert; nach Limitfehlern wird die Nutzung aktualisiert, und wenn das Banner dazu auffordert, wechselt Codex zum ersten verfügbaren Ersatzmodell, ohne andere Thread-Einstellungen zu ändern.¹³⁸ v0.153.0 ergänzt frühere Warnungen für Plus- und Team-Tarife: Eine Warnung erscheint, wenn in einem Nutzungszeitraum von ungefähr fünf Stunden weniger als die Hälfte des Kontingents verbleibt. Für andere Tarife und Zeiträume gelten weiterhin die bisherigen Schwellenwerte von 75 %, 90 % und 95 %.¹⁴⁰

Guthabenkosten

Codex-Vorgänge verbrauchen Guthaben aus Ihrem Tarifkontingent:

In der Praxis „liegt der durchschnittliche Verbrauch von GPT-5.6 bei 5–40 Guthabenpunkten pro Nachricht“. Der schnelle Modus verbraucht bei unterstützten Modellen mehr Guthaben, und die Bilderzeugung schöpft enthaltene Limits 3- bis 5-mal schneller aus als vergleichbare, rein textbasierte Interaktionen.¹⁵²

Bei Enterprise- und Edu-Tarifen skaliert das Guthaben mit dem vertraglich vereinbarten Kontingent. Prüfen Sie Ihre aktuelle Nutzung mit /status in der TUI.

API-Abrechnung

Wenn Sie Codex über die API verwenden, rechnet OpenAI die Nutzung pro Token nach den regulären OpenAI-API-Preisen des ausgewählten Modells ab, einschließlich etwaiger Rabatte für Prompt-Caching. Die aktuellen Preise finden Sie auf der offiziellen API-Preisseite.²⁰

Strategien zur Kostenoptimierung

1. Profile verwenden: Erstellen Sie für Routineaufgaben ein Profil namens fast mit gpt-5.6-luna und model_reasoning_effort = "low"
2. Hohen Reasoning-Aufwand gezielt einsetzen: Verwenden Sie xhigh nur für wirklich schwierige Probleme, da dabei 3- bis 5-mal mehr Token anfallen
3. --ephemeral verwenden: Verzichten Sie in CI/CD auf die Sitzungspersistenz, um den Zusatzaufwand zu reduzieren
4. Reasoning-Zusammenfassungen minimieren: Legen Sie model_reasoning_summary = "none" fest, wenn Sie keine Erklärungen benötigen
5. Aufgaben im exec-Modus bündeln: codex exec vermeidet bei automatisierten Arbeitsabläufen den Zusatzaufwand der TUI
6. Nutzung überwachen: Prüfen Sie /status in der TUI und die Abrechnungsübersichten Ihrer Organisation – seit v0.148.0 zeigen /status, Statuszeilen und Terminaltitel für berechtigte Arbeitsbereiche die geschätzten Thread-Guthaben oder -Kosten an¹¹⁸

Kostenbeispiele aus der Praxis

Repräsentative API-Kosten für häufige Aufgaben (Preisstand von gpt-5.3-codex Mitte 2026, mittlerer Reasoning-Aufwand – die Größenverhältnisse lassen sich auf andere Modelle übertragen):

Die Kosten variieren je nach Reasoning-Aufwand, Caching und Gesprächslänge. Verwenden Sie gpt-5.6-luna für Routineaufgaben, um die entsprechenden Ausgaben deutlich zu senken. Im Cache gespeicherte Eingabe-Token werden zu einem ermäßigten Preis abgerechnet.

Verborgener Token-Zusatzaufwand

Jeder Tool-Aufruf verursacht zusätzlich zu Ihrem sichtbaren Prompt weitere Token:

Expertentipp: Überwachen Sie Ihre tatsächliche Nutzung mit /status in der TUI. Die Token-Anzahl umfasst den gesamten Zusatzaufwand, nicht nur Ihre sichtbaren Nachrichten. Falls Sie von den Kosten überrascht sind, prüfen Sie, wie viele MCP-Server verbunden sind – jeder davon fügt jedem API-Aufruf Tool-Definitionen hinzu.

Kostenmanagement für Teams

Strategien zur Kostenkontrolle im Team: - requirements.toml festlegen, um organisationsweit Limits für Modelle und Reasoning-Aufwand durchzusetzen - gpt-5.6-luna für CI/CD verwenden – automatisierte Pipelines benötigen nur selten den maximalen Reasoning-Aufwand - Profilbasierte Budgetierung – definieren Sie die Profile ci, review und dev mit geeigneten Kostenobergrenzen - Überwachung mit OpenTelemetry – Enterprise-Bereitstellungen können Nutzungstelemetrie in vorhandene Observability-Stacks exportieren

Entscheidungshilfen

Wann Sie welche Oberfläche verwenden sollten

Wann Sie welchen Sandbox-Modus verwenden sollten

Wann Sie welche Reasoning-Stufe verwenden sollten

Plan Mode im Vergleich zur direkten Ausführung

Will Codex need to change more than 3 files?
│
├── YES → Use Plan Mode (/plan)
│         Codex designs the approach BEFORE making changes.
│         You review and approve the plan.
│         Best for: refactors, new features, migrations
│
└── NO → Is the change well-defined?
         │
         ├── YES → Direct execution
         │         Just describe the task. Codex executes immediately.
         │         Best for: bug fixes, small features, test additions
         │
         └── NO → Use Plan Mode (/plan)
                  Let Codex explore and propose an approach first.
                  Best for: unfamiliar codebases, ambiguous requirements

Steer Mode: Eingabetaste oder Tabulatortaste

Faustregel: Eingabetaste = „Stopp, hören Sie sich das jetzt an.“ Tabulatortaste = „Wenn Sie fertig sind, erledigen Sie auch das.“

Desktop App im Vergleich zu CLI

How do you prefer to work?
│
├── Terminal-first → Use CLI
│   │
│   ├── Single focused task → codex (interactive TUI)
│   ├── Scripted automation → codex exec (non-interactive)
│   └── Quick one-shot → codex exec "prompt" -o result.txt
│
└── Visual/multi-project → Use Desktop App
    │
    ├── Multiple parallel tasks → Multi-thread with worktree isolation
    ├── Visual diff review → Built-in Git diff viewer
    ├── Scheduled automation → Automations tab
    └── Voice-driven → Ctrl+M for voice dictation

Welches Profil?

Ordnen Sie Ihre Aufgabe einem vorkonfigurierten Profil zu:

Profildateien (eine pro Voreinstellung in ~/.codex/; das ältere Ein-Datei-Layout mit profile = "default" + [profiles.*] wird seit 0.134.0 nicht mehr gelesen¹²²):

# ~/.codex/fast.config.toml
model = "gpt-5.6-luna"
model_reasoning_effort = "low"

# ~/.codex/careful.config.toml
model = "gpt-5.5"
model_reasoning_effort = "xhigh"

# ~/.codex/pair.config.toml
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"

# ~/.codex/ci.config.toml
model = "gpt-5.6-luna"
model_reasoning_effort = "low"
sandbox_mode = "workspace-write"

Profil für eine einzelne Sitzung wechseln: codex --profile careful

Wie funktionieren das Sandbox- und Genehmigungssystem?

Codex verwendet ein zweistufiges Sicherheitsmodell, das trennt, was technisch möglich ist, und wann Codex um eine menschliche Genehmigung bittet. Dieser Ansatz unterscheidet sich grundlegend vom Berechtigungssystem von Claude Code – Codex setzt Beschränkungen auf Betriebssystem-Kernel-Ebene durch.⁵ Informationen zu requirements.toml-Beschränkungen, die Administratoren unternehmensweit durchsetzen, finden Sie auch unter Unternehmensbereitstellung.

Härtung in v0.148.0: Sandbox-Beschränkungen verhalten sich jetzt sowohl unter Linux als auch unter Windows nach dem Prinzip „Fail Closed“ – ein verweigerter oder nicht lesbarer Pfad gilt als blockiert, statt stillschweigend zugelassen zu werden.¹¹⁸

Ebene 1: Sandbox (was möglich ist)

Die Sandbox steuert den Dateisystem- und Netzwerkzugriff mithilfe nativer Betriebssystemmechanismen:

Plattformspezifische Durchsetzung:

• macOS: Apples Seatbelt-Framework über sandbox-exec mit modusspezifischen Profilen, die zur Laufzeit kompiliert und vom Kernel durchgesetzt werden⁶. Seit v0.121.0 können macOS-Sandbox-Profile bestimmte Unix sockets auf die Positivliste setzen (z. B. docker.sock und IPC-Sockets von Editoren); außerdem ist die private DNS-Auflösung nicht mehr standardmäßig blockiert.⁸²
• Linux: Landlock für Dateisystembeschränkungen und seccomp zur Filterung von Systemaufrufen. Ein eigenständiger Hilfsprozess (codex-linux-sandbox) sorgt für mehrstufige Isolation.⁵ Bubblewrap (bwrap) wird als Abhängigkeit eingebunden und als Teil des Linux-Builds kompiliert (seit v0.100.0 nicht mehr optional)⁷. v0.117.0 verbesserte die Zuverlässigkeit der Sandbox auf älteren Distributionen mit veralteten Kernel-Konfigurationen.⁷⁵ v0.129.0 härtete den Sandbox-Start unter Linux und aktualisierte das eingebundene Bubblewrap mit Sicherheitskorrekturen aus dem Upstream-Projekt auf 0.11.2; v0.130.0 ergänzte weitere Härtungsmaßnahmen für den Start.⁸⁹⁹¹
• Windows: Native Sandbox mit eingeschränkten Tokens (seit v0.100.0 nicht mehr experimentell). WSL wird ebenfalls unterstützt und übernimmt Landlock und seccomp von Linux. v0.117.0 enthält Verbesserungen an der Sandbox mit eingeschränkten Tokens, die Prozesse besser isolieren.⁷⁵ v0.130.0 gewährt Sandbox-Benutzern Zugriff auf den Binärdatei-Cache der Desktop-Laufzeit, damit die Windows-Sandbox Laufzeitbinärdateien für Benutzer der Workspace-Sandbox zuverlässig auflösen kann.⁹¹

Warum das wichtig ist: Im Gegensatz zu containerbasierter Sandbox-Isolation (Docker) ist die Isolation auf Betriebssystemebene schneller, ressourcenschonender und schwerer zu umgehen. Der Kernel setzt die Beschränkungen durch, noch bevor Codex den Systemaufruf überhaupt sieht.

Sicherheitskorrekturen: - Umgehung der Sandbox durch zsh-Fork (v0.106.0): Eine Schwachstelle wurde behoben, durch die eine Shell-Ausführung mittels zsh-Forking Sandbox-Beschränkungen umgehen konnte.⁶⁰ Falls Sie eine ältere Version verwenden, führen Sie sofort ein Upgrade durch. - Begrenzung der Eingabegröße (v0.106.0): Codex begrenzt Eingaben jetzt auf ungefähr 1 Million Zeichen, um ein Hängenbleiben durch übermäßig große Nutzdaten zu verhindern.⁶⁰ - Sicheres Devcontainer-Profil (v0.121.0): Ein neues gehärtetes Kundenprofil für Docker-Devcontainer verwendet Bubblewrap für die Sandbox-Isolation innerhalb des Containers. WSL2 wird unterstützt; WSL1 wird ausdrücklich abgelehnt (Bubblewrap ist mit dem Kernel-Shim von WSL1 nicht kompatibel).⁸² - Guardian-Prüfung und hooks (v0.121.0): Während Guardian-Prüfungssitzungen sind hooks deaktiviert, damit hooks vor oder nach Tool-Aufrufen die Entscheidungen des Guardian-Subagenten nicht beeinflussen können.⁸² Wenn Sie für Protokollierung oder Validierung auf hooks angewiesen sind, beachten Sie, dass sie bei einer Guardian-Prüfung übersprungen werden. Greifen Sie auf die Beobachtbarkeit des App-Servers zurück, wenn Sie einen vollständigen Audit-Trail benötigen. - Linux-Dateisystem /dev (v0.105.0): Befehle in der Linux-Sandbox erhalten jetzt ein minimales /dev-Dateisystem. Das verbessert die Kompatibilität mit Tools, die Geräteknoten erwarten.⁶¹

ReadOnlyAccess-Richtlinie (v0.100.0+): Eine konfigurierbare Richtlinienstruktur zur granularen Steuerung des Lesezugriffs. Damit können Sie einschränken, aus welchen Verzeichnissen Codex lesen darf – selbst im Modus workspace-write:

[sandbox_workspace_write]
read_only_access = ["/etc", "/usr/local/share"]  # Only these paths readable outside workspace

Ebene 2: Genehmigungsrichtlinie (wann nachgefragt wird)

Die Genehmigungsrichtlinie bestimmt, wann Codex pausiert und um eine menschliche Bestätigung bittet:

on-failure erscheint weiterhin in einigen älteren Beispielen und Kompatibilitätspfaden, ist in der aktuellen OpenAI-Konfigurationsdokumentation jedoch als veraltet gekennzeichnet. Verwenden Sie vorzugsweise on-request für interaktive Ausführungen und never für nicht interaktive Ausführungen, die bereits durch eine externe Sicherheitsgrenze geschützt sind.⁸⁷

Seit v0.150.0 können Sie eine Tastenkombination festlegen, mit der Sie im Eingabefeld zwischen den Berechtigungsmodi wechseln – konfigurieren Sie diese über /keymap.¹³²

Eindeutige Genehmigungs-IDs (v0.104.0+)

Codex weist jetzt jedem Befehl innerhalb einer mehrstufigen Shell-Ausführung eine eigene Genehmigungs-ID zu. Dadurch sind Genehmigungen granular: Wenn Sie einen Befehl in einer Sequenz genehmigen, werden nachfolgende Befehle desselben Shell-Aufrufs nicht automatisch ebenfalls genehmigt.⁴⁹

Flexible Genehmigungssteuerung (v0.105.0+)

Der Genehmigungsablauf unterstützt jetzt zusätzliche Sandbox-Berechtigungen und granulare Ablehnungen:⁶¹

• Zusätzliche Sandbox-Berechtigungen: Wenn ein Befehl Zugriff benötigt, der über den aktuellen Sandbox-Modus hinausgeht, kann Codex gezielt zusätzliche Berechtigungen anfordern, statt einen vollständigen Moduswechsel zu verlangen
• Granulare Ablehnung: Sie können einzelne Tool-Aufrufe mit einer Rückmeldung ablehnen, damit Codex sein Vorgehen anpassen kann, statt denselben Befehl lediglich erneut auszuführen

Berechtigungsanfragen zur Laufzeit (v0.113.0+)

Codex enthält jetzt ein integriertes request_permissions-Tool, mit dem das Modell zur Laufzeit zusätzliche Berechtigungen anfordern kann.⁶⁹ Wenn das Modell auf eine Aufgabe stößt, die erhöhte Zugriffsrechte erfordert, kann es über den TUI-Genehmigungsablauf gezielt Berechtigungen anfordern, etwa für Dateisystempfade oder den Netzwerkzugriff. So schlägt der Vorgang nicht stillschweigend fehl, und der Benutzer muss Codex nicht mit anderen Flags neu starten.

App-Genehmigungsmodus writes (v0.144.0+)

Apps und Konnektoren erhalten eine mittlere Genehmigungsstufe: Im App-Genehmigungsmodus writes können die von einer App als schreibgeschützt deklarierten Aktionen ohne Nachfrage ausgeführt werden, während Codex vor jedem Schreibvorgang weiterhin pausiert.¹⁰⁷ Zuvor waren App-Genehmigungen eher eine Alles-oder-nichts-Entscheidung; writes entspricht dem Vertrauensmodell, das die meisten Betreiber für Integrationen tatsächlich wünschen – ansehen ohne Nachfrage, Änderungen nur nach Rückfrage.

Automatisch geprüfte Genehmigungen: --approve-for-me (v0.147.0+)

Das neue CLI-Flag --approve-for-me verwandelt Genehmigungsanfragen in automatisch geprüfte Genehmigungen: Statt Sie zu unterbrechen, wird jede Anfrage in einem Prüfdurchlauf beurteilt und in Ihrem Namen genehmigt oder abgelehnt.¹¹⁶ Dies liegt zwischen „alles genehmigen“ (der Ansatz, zu dem --full-auto früher ermutigte und der inzwischen entfernt wurde) und „bei allem unterbrechen“ – die Nachfragen bleiben als Entscheidungspunkte bestehen, werden jedoch von einem Prüfer beantwortet. Kombinieren Sie das Flag mit den sichereren Standardwerten für die automatische Prüfung cyberfähiger Modelle aus v0.146.1, die es übernimmt. Behandeln Sie dies wie jede andere Übertragung von Entscheidungsbefugnissen: geeignet für lange unbeaufsichtigte Ausführungen, bei denen eine Unterbrechung zum Stillstand führt, ungeeignet für Sitzungen mit Zugriff auf Anmeldedaten oder Produktionszustände, bei denen Sie selbst die Prüfung übernehmen möchten.

Genehmigung für Eingaben in eskalierte Terminals (v0.151.0)

Das standardmäßig deaktivierte Funktions-Flag write_stdin_approval verlangt eine neue Genehmigung, bevor eine nicht leere Eingabe an ein eskaliertes Unified-Exec-Terminal gesendet wird. Diese Prüfungen werden als writeStdin-Genehmigungen über hooks, Guardian, den App-Server und die TUI geleitet. Die Umgebung, das Startverzeichnis und der Eskalationsstatus des Terminals bleiben über mehrere Turns hinweg erhalten, und die Prozessidentität wird nach der Genehmigung erneut validiert, bevor irgendwelche Bytes geschrieben werden. Die vollständig formatierte Aktion und der Genehmigungsgrund müssen in 8.000 Bytes passen – übergroße oder abgeschnittene Aktionen werden abgelehnt, bevor eine Genehmigung angefordert oder etwas an das Terminal gesendet wird.¹³⁵

Berechtigungsprofile (v0.113.0+, erweitert in v0.128.0 und v0.133.0)

Berechtigungsprofile gliedern Sandbox-Richtlinien für Dateisystem und Netzwerk in benannte, wiederverwendbare Abschnitte. Setzen Sie default_permissions auf ein integriertes Profil wie :read-only oder :workspace, oder verweisen Sie damit auf eine benutzerdefinierte Tabelle [permissions.<name>].⁸⁷ v0.133.0 etabliert Profile als verwaltete Oberfläche: Listen-APIs stellen verfügbare Profilmetadaten bereit, Profile können voneinander erben, verwaltete requirements.toml-Dateien können Berechtigungsanforderungen deklarieren, aktive Profile werden zur Laufzeit aktualisiert, und die Einrichtung der Windows-Sandbox verwendet nun das aufgelöste Profil anstelle einer separaten Ad-hoc-Richtlinie.⁹⁸

default_permissions = "project-safe"

[permissions.project-safe.filesystem]
"/usr/local" = "read"
glob_scan_max_depth = 3

[permissions.project-safe.filesystem.":project_roots"]
"." = "write"
"**/*.env" = "none"

[permissions.project-safe.network]
enabled = true
mode = "limited"

[permissions.project-safe.network.domains]
"api.github.com" = "allow"
"registry.npmjs.org" = "allow"

Verwenden Sie none für vertrauliche Dateien und Globs, die selbst dann nicht lesbar sein sollen, wenn das Projektstammverzeichnis beschreibbar ist. Für einmalige Befehlsausnahmen sollten Sie Regeln bevorzugen, statt ein Profil umfassend zu erweitern.⁸⁷

v0.151.0: Wiederhergestellte App-Server-Threads behalten ihre Berechtigungsprofile bei, statt in veraltete, pro Turn geltende Sandbox-Überschreibungen überführt zu werden. Profile bleiben bei der Weiterleitung von Turns und bei kompatiblen Verzeichniswechseln mit /cd erhalten. Kann das wiederhergestellte Profil nach einem /cd nicht sicher als veralteter Sandbox-Modus dargestellt werden, wird der Verzeichniswechsel abgelehnt, statt die Beschränkungen stillschweigend abzuschwächen.¹³⁴

Frühere Empfehlungen zu --full-auto

Ältere Anleitungen beschrieben --full-auto als komfortablen Alias für:

codex --sandbox workspace-write --ask-for-approval on-request

In den Versionshinweisen zu v0.128.0 wird --full-auto als veraltet gekennzeichnet, und die aktuelle Hilfe von CLI führt es für interaktive Ausführungen nicht mehr auf. Verwenden Sie stattdessen die oben genannten expliziten Flags oder ein benanntes Berechtigungsprofil.⁸⁶

Mit v0.147.0 ist die Entfernung abgeschlossen: codex exec --full-auto ist nicht mehr verfügbar. Ein Skript, das dieses Flag weiterhin übergibt, bricht jetzt mit einem Fehler ab, statt ausgeführt zu werden. Die Migration ist unkompliziert: Ersetzen Sie es durch --sandbox workspace-write sowie ein Genehmigungs-Flag oder Profil, falls Ihr bisheriger Aufruf auf dem Genehmigungsverhalten von --full-auto beruhte. Prüfen Sie vor dem Upgrade jede Automatisierung, die codex exec über die Shell aufruft: Der Fehler äußert sich als defekte Pipeline, nicht als Veraltungswarnung.¹¹⁶

Sandbox-Zuverlässigkeit (v0.129.0): Die Härtung des Linux-Sandbox-Starts reduziert Race Conditions auf langsamen Dateisystemen oder bei über symbolische Links eingebundenen Checkouts. Verbesserungen an der Windows-Sandbox beheben mehrere Abstürze in Randfällen bei lang laufenden Ausführungen. Außerdem wurde das eingebundene Bubblewrap mit Sicherheitskorrekturen aus dem Upstream-Projekt auf 0.11.2 aktualisiert. Konfigurationsänderungen sind nicht erforderlich. Führen Sie codex update aus, um diese Verbesserungen zu übernehmen.⁸⁹

Empfohlene Konfigurationen

Tägliche Entwicklung (sichere Standardeinstellung):

sandbox_mode = "workspace-write"
approval_policy = "on-request"

Fortgeschrittene Benutzer (vollständiger Zugriff mit menschlicher Kontrolle):

sandbox_mode = "danger-full-access"
approval_policy = "on-request"   # `untrusted` retired in v0.149.0

Beiträge aus der Community empfehlen diese Kombination als „Sweet Spot“⁸. Bevor Sie diese Empfehlung übernehmen, sollten Sie jedoch verstehen, was sie tatsächlich bewirkt: Genehmigungsanfragen werden ausgelöst, wenn ein Befehl die Sandbox verlassen oder auf das Netzwerk zugreifen muss. danger-full-access hebt beide Grenzen auf, sodass für on-request kaum noch etwas zu eskalieren bleibt. Das Ergebnis sind maximale Berechtigungen bei minimalen Rückfragen, nicht maximale Berechtigungen mit menschlicher Prüfung jedes Befehls. Wenn Sie Letzteres möchten, behalten Sie workspace-write bei und lassen Sie die Sandbox-Grenze die Nachfragen auslösen.¹²³

CI/CD-Automatisierung:

sandbox_mode = "workspace-write"
approval_policy = "never"

Intelligente Genehmigungen mit Guardian-Subagent (v0.115.0+)

Intelligente Genehmigungen können Prüfanfragen über einen Guardian-Subagenten abwickeln, statt für jede Aktion eine menschliche Genehmigung zu verlangen. Die Guardian-Sitzung bleibt über mehrere Genehmigungen hinweg bestehen, um den Prompt-Cache wiederzuverwenden und den Startaufwand zu vermeiden. Jede Prüfung erhält einen bereinigten Verlauf, sodass frühere Entscheidungen nicht in spätere Prüfungen einfließen.⁷³

Konfigurieren Sie den Prüfer in config.toml:

approvals_reviewer = "guardian_subagent"   # "user" (default) or "guardian_subagent"

Dies ist besonders für CI/CD-Workflows nützlich, wenn Sie eine automatisierte, begründete Prüfung statt eines pauschalen approval_policy = "never" wünschen.

Guardian-v2-Standardwerte umgestellt (v0.151.0): Guardian v2 verwendet jetzt standardmäßig Computer-Use-Prüfungen mit Bildern. features.guardianv2.review_scope.computer_use_only ist standardmäßig auf true gesetzt – setzen Sie den Wert auf false, um den breiteren Prüfbereich für Tools beizubehalten. features.guardianv2.transcript.include_images ist ebenfalls standardmäßig auf true gesetzt – setzen Sie den Wert auf false, um Bilder aus Guardian-Transkripten auszuschließen. Beide Funktionen wurden in v0.150.0 als konfigurierbare, standardmäßig deaktivierte Optionen eingeführt; in v0.151.0 wurden sie standardmäßig aktiviert.¹³⁵

Der Guardian-Umfang folgt dem Genehmigungsmodus (v0.153.0): In 2 Modi überspringt Guardian nun Arbeiten, die das Ergebnis nicht beeinflussen können. Bei Full Access (das bereits approvalPolicy: "never" mit uneingeschränkten Berechtigungen kombiniert) werden reine Bestätigungsanfragen von Guardian und MCP ohne synchrone Prüfung, Vorwärmung des Samplers oder Hintergrundbewertung genehmigt. Ausstehende, fehlgeschlagene oder eingeschränkte Umgebungen gelten nicht als Full Access. Außerdem wird der aktive Berechtigungsstatus bei jedem Turn neu ausgewertet, sodass ein vorhandener Thread sicher in Full Access wechseln oder diesen Modus verlassen kann. Im Benutzergenehmigungsmodus (approvals_reviewer = "user") werden die Guardian-Vorwärmung und die asynchrone Bewertung übersprungen, während gewöhnliche Ausführungsbestätigungen für node_repl.js automatisch akzeptiert werden. Prüfungen vertraulicher Aktionen und Anfragen nach Benutzereingaben behalten ihr bisheriges Verhalten bei.¹⁴⁰ Dadurch wird eingeschränkt, wann Guardian ausgeführt wird, nicht jedoch die menschliche Genehmigungsebene: Das in dieser Anleitung beschriebene Nachfrageverhalten für danger-full-access unter on-request gehört zur Genehmigungsrichtlinie und ist ein separater Mechanismus. v0.152.1 ermöglicht Guardian-Genehmigungsprüfungen außerdem, ihre Node-REPL-Richtlinie aus den Modellmetadaten (auto_review.node_repl_policy) zu beziehen; fehlt das Feld, wird die mitgelieferte Richtlinie verwendet.¹³⁹

Guardian-Bewertungen für Computer Use berücksichtigen Modellanforderungen (v0.153.1): Reine Computer-Use-Bewertungen von Guardian und schnelle Genehmigungsentscheidungen werden jetzt nur ausgeführt, wenn das aktive Modell in seinen Metadaten node_repl_auto_review_required festlegt. Vorherige oder laufende Bewertungen werden ungültig, wenn durch einen Modellwechsel die Bewertung übersprungen wird. Dadurch kann beim späteren Wechsel zurück zu einem geprüften Modell keine veraltete Genehmigungsentscheidung reaktiviert werden. Dies ist die wichtigste Änderung des Patches v0.153.1 und wird im Text der Versionshinweise nicht aufgeführt: #42422 (ein Cherry-Pick von 38ba8cdc) lässt sich nur über den Vergleich rust-v0.153.0…rust-v0.153.1 nachweisen.¹⁴²

Verschärfte PowerShell-Klassifizierung (v0.142.2): PowerShell-Befehle mit ausführbaren AST-Bereichen, die der Sicherheitsklassifikator nicht prüfen kann, erfordern jetzt eine Genehmigung, statt die automatische Genehmigung zu umgehen. Damit wurde eine Lücke geschlossen, durch die verschleiertes oder dynamisch zusammengesetztes PowerShell die Klassifizierung unter Windows umgehen konnte.¹⁰⁵

Erweiterte Erkennung gefährlicher Befehle (v0.144.5): Die Erkennung berücksichtigt jetzt weitere erzwungene rm-Formen. Zudem werden abgelehnte Befehle mit klareren Ablehnungsgründen zurückgegeben statt mit einer undurchsichtigen Verweigerung. Das ist hilfreich, wenn Sie Genehmigungsrichtlinien abstimmen und nachvollziehen müssen, warum ein Befehl blockiert wurde.¹¹⁰

Netzwerkzugriff aktivieren

Codex blockiert den Netzwerkzugriff im Modus workspace-write standardmäßig. Aktivieren Sie ihn bei Bedarf:

# Per-run
codex -c 'sandbox_workspace_write.network_access=true' "install the packages"

# In config.toml
[sandbox_workspace_write]
network_access = true
writable_roots = ["/path/to/extra/dir"]   # Additional writable directories
exclude_slash_tmp = false                  # Prevent /tmp from being writable
exclude_tmpdir_env_var = false             # Prevent $TMPDIR from being writable

Proxy-Unterstützung für WebSocket (v0.104.0+)

Für Unternehmensumgebungen, die WebSocket-Datenverkehr über einen Proxy leiten, unterstützt Codex jetzt die Umgebungsvariablen WS_PROXY und WSS_PROXY:⁴⁹

export WSS_PROXY="https://proxy.corp.example.com:8443"
codex "update the README"

Diese ergänzen die bestehende Unterstützung für HTTPS_PROXY- und SOCKS5-Proxys (v0.93.0+).

v0.146.0 ist die Version, mit der „alle Transportschichten“ tatsächlich vollständig abgedeckt wurden. Konfigurierte Proxys werden jetzt bei der Authentifizierung, bei Plugin-Downloads, bei der MCP-Autorisierung, bei der Remote-Ausführung, bei WebSocket-Verbindungen, bei HTTP-Weiterleitungen und bei LM-Studio-Verbindungen berücksichtigt – 7 Pfade, die laut Änderungsprotokoll den Proxy zuvor ignorierten.¹¹⁴ Falls Sie Codex vor v0.146.0 hinter einem Unternehmensproxy ausgeführt haben und Anmeldungen oder Plugin-Installationen fehlschlugen, während gewöhnliche Modellaufrufe funktionierten, war diese Lücke wahrscheinlich die Ursache.

Systemproxy unter macOS (v0.142.2+): Wenn respect_system_proxy aktiviert ist, berücksichtigen macOS-Authentifizierungsclients die Proxy-, PAC- und WPAD-Einstellungen des Systems. Auf Unternehmens-Macs, deren Proxy-Konfiguration über Profile verteilt wird, sind deshalb für den Authentifizierungsdatenverkehr keine Proxy-Umgebungsvariablen pro Shell mehr erforderlich.¹⁰⁵ Seit v0.143.0 gilt dies auch für Windows und den Datenverkehr von Responses API: Codex leitet sowohl die Authentifizierung als auch Aufrufe von Responses API über den macOS- oder Windows-Systemproxy, einschließlich der automatischen Konfiguration mittels PAC und WPAD. Damit wurde die letzte Lücke für abgeschottete Unternehmensnetzwerke auf beiden Betriebssystemen geschlossen.¹⁰⁶

Sandbox testen

Überprüfen Sie das Verhalten der Sandbox, bevor Sie sich darauf verlassen:

codex sandbox macos --permissions-profile :workspace -- ls /etc/passwd   # macOS test
codex sandbox linux --permissions-profile :workspace -- cat /etc/shadow  # Linux test

Wenn die Sandbox ordnungsgemäß funktioniert, sollten beide Befehle unter einem auf den Workspace beschränkten Profil mit einem Fehler wegen fehlender Berechtigung fehlschlagen. Falls einer der Befehle erfolgreich ausgeführt wird, muss Ihre Sandbox-Konfiguration untersucht werden.

Wie funktioniert AGENTS.md?

AGENTS.md ist das Projektanweisungssystem von Codex – ein offener Standard⁹, der inzwischen von der Agentic AI Foundation der Linux Foundation verwaltet wird. Er wird von Codex, Cursor, Copilot, Amp, Jules (Google), Gemini CLI, Windsurf, Cline, Aider, Zed, Factory, RooCode und mehr als 60.000 Open-Source-Projekten unterstützt. Er legt fest, wie sich Codex innerhalb eines bestimmten Repositorys oder Verzeichnisses verhält. Unter Skills finden Sie wiederverwendbare Kompetenzpakete, die AGENTS.md ergänzen.

Ermittlungshierarchie

Beim Sitzungsstart erstellt Codex eine Anweisungskette, indem es den Verzeichnisbaum durchläuft:

1. Global (~/.codex/): AGENTS.override.md > AGENTS.md
2. Projekt (vom git-Stammverzeichnis bis zum aktuellen Verzeichnis): Auf jeder Ebene wird nach AGENTS.override.md > AGENTS.md > Ausweichdateinamen gesucht
3. Zusammenführung: Die Dateien werden vom Stammverzeichnis abwärts aneinandergefügt; näher gelegene Dateien erscheinen später im Prompt und setzen frühere Anweisungen außer Kraft

~/.codex/AGENTS.md                     ← Global defaults
  └─ /repo/AGENTS.md                   ← Project-wide rules
      └─ /repo/services/AGENTS.md      ← Service-specific rules
          └─ /repo/services/payments/
               AGENTS.override.md      ← Overrides everything above for this dir

Nicht vertrauenswürdige Projekte überspringen die projektbezogene AGENTS.md (v0.150.0): Der oben beschriebene Durchlauf setzt voraus, dass das Projekt als vertrauenswürdig eingestuft wurde. Seit v0.150.0 gilt: „Nicht vertrauenswürdige Projekte stellen keine projektbezogenen AGENTS.md-Anweisungen mehr bereit, und verwaltete Regeln zum Verweigern des Lesezugriffs bleiben auch nach Berechtigungsänderungen wirksam.“ Die projektbezogene Ermittlung wird übersprungen, während die benutzerbezogenen Anweisungen aus ~/.codex/AGENTS.md erhalten bleiben. Dadurch kann ein nicht vertrauenswürdiger Checkout keinen Betriebsrahmen einschleusen, bevor Sie ihm vertrauen.¹³²

Desktop-Projekte mit mehreren Ordnern (26.715, 23. Juli 2026): Der oben beschriebene Durchlauf bezieht sich auf CLI, wobei alles relativ zum aktuellen Arbeitsverzeichnis aufgelöst wird. In der ChatGPT-Desktop-App kann ein lokales Projekt nun mehrere zusammengehörige Ordner umfassen. Die Ermittlung erfolgt dabei relativ zu genau einem dieser Ordner: „Neue Chats, Git-Vorgänge und die automatische Ermittlung von AGENTS.md, skills und config.toml verwenden den primären Ordner. Sekundäre Ordner stehen weiterhin für Dateisuche, Lese- und Bearbeitungsvorgänge zur Verfügung.“ Über Projekt bearbeiten im Projektmenü legen Sie fest, welcher Ordner primär ist.¹¹³

Diese eine Einstellung steuert gleichzeitig drei der fünf Kernsysteme von Codex: Anweisungen, skills und Konfiguration richten sich alle nach dem primären Ordner. In der Praxis bedeutet das: Eine AGENTS.md in einem sekundären Ordner ist eine Datei, die Codex öffnen kann, aber kein geladener Betriebsrahmen. Wenn das Repository mit Ihren Regeln als zweiter Ordner hinzugefügt wurde, machen Sie es entweder zum primären Ordner oder formulieren Sie diese Regeln erneut in der AGENTS.md des primären Ordners. Dasselbe gilt für Repository-spezifische skill-Ordner, deren automatische Erkennung Sie erwartet haben. Am Verzeichnisdurchlauf von CLI hat sich nichts geändert – dies betrifft ausschließlich den Projektumfang der Desktop-App.

Was zeichnet eine hervorragende AGENTS.md aus?

Basierend auf direkten Empfehlungen von Codex selbst und etablierten Mustern aus der Community¹⁰:

EMPFOHLEN: - Formulieren Sie konkret: "Use rg --files for discovery" ist besser als "search efficiently" - Definieren Sie den Abschluss: Was bedeutet „fertig“? (Tests bestanden, Linting fehlerfrei usw.) - Geben Sie Befehle an: Build, Test, Linting und Formatierung (mit exakten Aufrufen) - Gliedern Sie nach Aufgaben: Abschnitte für Entwicklung, Review, Release und Vorfälle/Debugging - Definieren Sie die Eskalation: Was ist bei Blockaden oder unerwarteten Zuständen zu tun?

NICHT EMPFOHLEN: - Vollständige Stilrichtlinien ohne Ausführungsregeln ablegen - Mehrdeutige Anweisungen verwenden („vorsichtig sein“, „optimieren“) - Widersprüchliche Prioritäten kombinieren (Geschwindigkeit + umfassende Überprüfung + kein Laufzeitbudget) - Dokumentation in Prosa verfassen (AGENTS.md ist eine Betriebsrichtlinie, keine README)

Beispiel: AGENTS.md für den Produktivbetrieb

# Repository Guidelines

## Build, Test, and Development Commands
- Run API (dev): `python3 -m uvicorn main:app --reload`
- Install deps: `pip install -r requirements.txt`
- Lint: `python3 -m ruff check .` (auto-fix: `--fix`)
- Format: `python3 -m ruff format .`
- Tests: `python3 -m pytest -v`
- Coverage: `python3 -m pytest --cov=app --cov-report=term-missing`

## Coding Style & Naming Conventions
- Python 3.11+. Type hints on all functions.
- Ruff enforced: 88-char lines, double quotes, spaces for indent.
- Naming: modules `snake_case.py`, classes `PascalCase`, functions `snake_case`.

## Commit & Pull Request Guidelines
- Conventional Commits: `feat:`, `fix:`, `docs:`, `refactor:`, `chore:`, `test:`
- Commits should be small and focused.
- PRs must include: description, test plan, and screenshots for UI changes.

## Security
- Never commit secrets. Use `.env` for local config.
- Validate all external API calls with proper error handling.

Umgang mit Geheimnissen in Agentensitzungen

Behandeln Sie den für Codex sichtbaren Verlauf als sicherheitsrelevante Oberfläche und nicht nur den Quellcode. Die Versionshinweise von Codex dokumentieren Arbeiten an Shell-Snapshots und der Schwärzung von Umgebungsvariablen, während das Speichersystem Schreibvorgänge auf Geheimnisse prüft. Diese Schutzmaßnahmen machen Befehlsausgaben, Sitzungstranskripte, Shell-Snapshots, lokale Protokolle oder Hilfsskripte jedoch nicht zu sicheren Orten für die Ausgabe von Zugangsdaten.³⁷⁵⁵⁹⁵

Die Betriebsregel ist einfach: Geben Sie keine Geheimnisse aus, damit das Modell sie untersuchen kann; bewahren Sie Zugangsdaten für Hilfsprogramme in der von der Umgebung vorgesehenen Konfiguration auf; trennen Sie bei Audits ausführbaren Quellcode, Dokumentation, generierte Caches, Sitzungstranskripte, Shell-Snapshots, Protokolle und bewusst angelegte Geheimnisspeicher voneinander; schwärzen Sie den lokalen Verlauf, wenn ein mit hoher Sicherheit erkanntes Geheimnismuster auftritt; und führen Sie präventive hooks erst ein, nachdem sich der manuelle Hygieneprozess bewährt hat. Für die Öffentlichkeit relevant sind die Übersicht der Angriffsflächen und die Akzeptanzkriterien – nicht private Tokenwerte, exakte Pfade oder interne Erkennungsmechanismen.⁹⁵

Der Überschreibungsmechanismus

Eine AGENTS.override.md auf einer beliebigen Verzeichnisebene ersetzt die normale AGENTS.md für den jeweiligen Geltungsbereich. Verwenden Sie diesen Mechanismus für:

• Release-Sperren: „Keine neuen Funktionen, nur Fehlerbehebungen“
• Vorfallsmodus: „Alle Änderungen müssen vom Bereitschaftsdienst geprüft werden“
• Vorübergehende Härtung: „In diesem Sprint keine Abhängigkeitsaktualisierungen“

Konfiguration

# Custom fallback filenames (in addition to AGENTS.md)
project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]

# Increase max size for large instruction files
project_doc_max_bytes = 65536    # 64 KiB (default: 32 KiB)

Gerüstgenerierung

codex                           # Launch TUI
/init                           # Generate AGENTS.md scaffold

Oder überprüfen Sie Ihre Anweisungskette:

codex --ask-for-approval never "Summarize your current instructions"

Hooks

Codex führte Hooks in v0.99.0 und v0.100.0 unter den früheren Bezeichnungen AfterAgent und AfterToolUse ein, ergänzte in v0.114.0 eine experimentelle Hooks-Engine mit SessionStart und Stop⁷⁰ und erklärte Hooks in v0.124.0 (23. April 2026) für stabil.⁸⁵ Die in rust-v0.150.0 ausgelieferte Engine registriert zwölf Ereignisse (HOOK_EVENT_NAMES in codex-rs/hooks/src/lib.rs) – elf in v0.149.1, wobei Interrupt in v0.150.0 als zwölftes hinzukam¹³² – und die früheren Bezeichnungen sind aus der konfigurierbaren Oberfläche verschwunden: AfterToolUse kommt im gesamten Quellbaum nicht mehr vor, während AfterAgent nur noch als interne Payload-Bezeichnung der früheren notify-Bridge erhalten ist.¹²⁴ Hooks führen während der agentischen Schleife Skripte oder MCP-Tools aus. Alle passenden Hooks aus mehreren Dateien werden ausgeführt, mehrere passende Command-Hooks für ein Ereignis starten gleichzeitig, und jeder nicht verwaltete Hook muss vor seiner Ausführung geprüft und als vertrauenswürdig eingestuft werden.¹²⁴ v0.148.0 erweitert die Engine: Hooks können Befehle asynchron ausführen und MCP-Tools aufrufen – setzen Sie bei einem Command-Handler async = true, damit er im Hintergrund ausgeführt wird, während Codex fortfährt, oder verwenden Sie einen mcp_tool-Handler, um auf dieselben MCP servers zuzugreifen, die auch der Agent verwendet.¹¹⁸¹²⁴

Verfügbare Hook-Ereignisse

Gehostete Tools wie WebSearch durchlaufen den Hook-Pfad nicht, und einige spezialisierte Tool-Pfade können ihn umgehen; OpenAI selbst bezeichnet Hooks als „nützliche Schutzmaßnahme, nicht als vollständige Durchsetzungsgrenze“.¹²⁴

Hook-Konfiguration

Hooks sind auf drei Ebenen organisiert – ein Ereignis, eine Matcher-Gruppe und ein oder mehrere Handler – und befinden sich entweder in hooks.json (~/.codex/hooks.json, <repo>/.codex/hooks.json oder hooks/hooks.json eines Plugins) oder inline in config.toml und requirements.toml. Projektlokale Hooks werden nur geladen, wenn die .codex/-Ebene des Projekts als vertrauenswürdig eingestuft ist.¹²⁴ Die Inline-TOML-Form:

# ~/.codex/config.toml or <repo>/.codex/config.toml
[[hooks.SessionStart]]
matcher = "startup|resume"

[[hooks.SessionStart.hooks]]
type = "command"
command = "python3 ~/.codex/hooks/session_start.py"
additionalContextLimit = 5000

[[hooks.PreToolUse]]
matcher = "^Bash$"

[[hooks.PreToolUse.hooks]]
type = "command"
command = '/usr/bin/python3 "$(git rev-parse --show-toplevel)/.codex/hooks/pre_tool_use_policy.py"'
timeout = 30
statusMessage = "Checking Bash command"

[[hooks.PostToolUse]]
matcher = "^Bash$"

[[hooks.PostToolUse.hooks]]
type = "command"
command = "python3 ~/.codex/hooks/post_tool_use_review.py"
async = true
timeout = 120

Handler-Felder: type (command oder mcp_tool; prompt- und agent-Handler werden geparst, aber übersprungen), command, timeout in Sekunden (standardmäßig 600; bei SessionEnd 1 Sekunde, höchstens 3), statusMessage, additionalContextLimit (wie viel von additionalContext das Modell erreicht, bevor Codex den vollständigen Text auf der Festplatte speichert und eine Vorschau sendet), commandWindows (nur unter Windows geltende Überschreibung) und async. Befehle werden mit dem Sitzungs-cwd als Arbeitsverzeichnis ausgeführt. Daher sollten Repository-lokale Hooks Pfade ausgehend von git rev-parse --show-toplevel auflösen, anstatt einen relativen .codex/hooks/...-Pfad zu verwenden.¹²⁴

Prüfung und Vertrauen. Codex speichert die Vertrauenseinstufung anhand des aktuellen Hashes jedes nicht verwalteten Hooks; neue oder geänderte Hooks werden zur Prüfung markiert und bis zu ihrer Vertrauenseinstufung übersprungen. Führen Sie /hooks aus, um Hook-Quellen einzusehen sowie einzelne Hooks zu prüfen, als vertrauenswürdig einzustufen oder zu deaktivieren. Wenn Hooks beim Start geprüft werden müssen, zeigt Codex eine Warnung mit einem Verweis auf /hooks an. Verwaltete Hooks aus System-, MDM-, Cloud- oder requirements.toml-Quellen gelten richtlinienbedingt als vertrauenswürdig und können im Hook-Browser des Benutzers nicht deaktiviert werden. --dangerously-bypass-hook-trust führt aktivierte Hooks für einen einzelnen Aufruf ohne gespeicherte Vertrauenseinstufung aus. Dies ist für Automatisierungen vorgesehen, die Hook-Quellen an anderer Stelle überprüfen.¹²⁴

Die stdout-Ausgabe des SessionStart-Hooks fließt in den Kontext des Modells ein und eignet sich daher ideal, um beim Sitzungsstart dynamische Informationen wie Datumsangaben, Branch-Namen oder Umgebungsvariablen einzufügen.

Nachbilden von Claude Code-Hook-Mustern

Codex verwendet für die implementierten Ereignisse dieselben Ereignisnamen wie Claude Code. Daher lassen sich die meisten Hook-Konfigurationen portieren, indem Sie JSON in hooks.json verschieben und die Konfiguration über /hooks als vertrauenswürdig einstufen:

Expertentipp: Neue Hook-Ereignisse werden weiterhin mit Releases ausgeliefert – v0.150.0 fügte das Ereignis Interrupt hinzu (¹³²) –, prüfen Sie daher HOOK_EVENT_NAMES in codex-rs/hooks/src/lib.rs und das Codex-Änderungsprotokoll, um die aktuelle Liste zu erhalten.

Hook-Browser in der TUI (v0.129.0): Führen Sie /hooks in der TUI aus, um verfügbare Hooks zu finden, die derzeit aktiven Hooks anzuzeigen und einzelne Hooks ohne Bearbeitung von config.toml umzuschalten. Dies ist nützlich, wenn Sie Fehler bei einem in einem Plugin enthaltenen Hook beheben oder einen PostToolUse-Linter vorübergehend deaktivieren möchten, um sich ungestört auf eine Bearbeitungssitzung zu konzentrieren.⁸⁹

Was ist MCP (Model Context Protocol)? [EXPERIMENTAL]

MCP erweitert die Funktionen von Codex durch die Verbindung mit externen Tools und Diensten. Die Befehlsgruppe codex mcp ist derzeit als experimentell gekennzeichnet; Befehle und Konfigurationsformat können sich zwischen Releases ändern. Codex unterstützt zwei Transporttypen: STDIO (lokale Prozesse) und Streamable HTTP (Remote-Server).¹¹

MCP-Änderungen in v0.121.0: Tools werden jetzt mit einem Namespace registriert. Daher erscheinen Toolnamen in Auflistungen als <server>:<tool> statt als unqualifizierte Namen — aktualisieren Sie alle Skripte oder Prompts, die mit grep nach unqualifizierten Toolnamen suchen. Ein neues Flag supports_parallel_tool_calls wird an eingebundene MCPs weitergegeben und ermöglicht die parallele Ausführung für Server, die ihre Unterstützung dafür deklarieren. Metadaten zum Sandbox-Status werden nun über die MCP-Toolmetadaten weitergegeben, damit Server ihr Verhalten anpassen können (z. B. mit einer Warnung bei der Ausführung in einer read-only-Sandbox). Die benutzerdefinierte Anfrage codex/sandbox-state wurde entfernt — verwenden Sie stattdessen den Metadatenpfad. Phase 3 der Einführung von MCP Apps umfasst jetzt die Unterstützung für Toolaufrufe; abgeflachte verzögerte Toolaufrufe werden nun für Server unterstützt, die das Deferred-Call-Muster verwenden.⁸²

MCP-Änderungen in v0.142.2 (25. Juni 2026): MCP-Tools verwenden jetzt standardmäßig die Toolsuche, sofern sie unterstützt wird — statt alle Tooldefinitionen im Voraus zu laden, ermittelt Codex Tools bei Bedarf. Dies verbessert die Erkennung in Konfigurationen mit vielen Tools und bleibt zugleich mit älteren Modellen und Anbietern kompatibel. Remote-stdio-MCP-Server akzeptieren außerdem absolute Arbeitsverzeichnisse im Pfadformat der Remote-Plattform (etwa einen Windows-Pfad von einem macOS-Client oder umgekehrt).¹⁰⁵

MCP-Änderungen in v0.147.0 (7. August 2026): Codex ergänzt eine optionale Unterstützung für die Protokollrevision MCP 2026-07-28 — paginierte Ermittlung (große Toolkataloge werden seitenweise übertragen statt in einer einzigen übergroßen Auflistung), mehrstufige Anfragen (ein Server kann einen mehrstufigen Austausch innerhalb einer einzigen logischen Anfrage aufrechterhalten) und nicht blockierenden Serverstart. Dabei stehen zwischengespeicherte MCP-Tools bereits zur Verfügung, bevor der Server vollständig gestartet ist, sodass ein langsamer Server den Sitzungsstart nicht mehr verzögert. Da die Unterstützung aktiviert werden muss, funktionieren Server mit der älteren Revision unverändert weiter.¹¹⁶

MCP-Änderungen in v0.151.0 (29. August 2026): Optionale MCP-Server erhalten eine konfigurierbare Kulanzfrist für den Start – mcp_optional_startup_grace_ms (Standardwert 1.000 ms) legt fest, wie lange die Erfassung des Toolkatalogs auf optionale Server wartet. 0 deaktiviert die gemeinsame Kulanzfrist, sodass optionale Server auf ihren konfigurierten Wert für startup_timeout_sec zurückgreifen. Aktualisierte Werte werden während der Laufzeit und bei Aktualisierungen der MCP-Konfiguration übernommen. Erweiterungen können außerdem Ergebnisse von MCP-Tools prüfen oder ersetzen, bevor sie das Modell erreichen: ToolLifecycleContributor::on_mcp_tool_result wird ausgeführt, bevor der Abschluss von MCP veröffentlicht und das Ergebnis für das Modell vorbereitet wird — sowohl bei erfolgreichen Ergebnissen als auch bei Fehlern, einschließlich über Code Mode.¹³⁴

MCP-Änderungen in v0.152.0 (1. September 2026): Drei additive Änderungen. Formularanfragen über openai/elicitation sind jetzt verfügbar: Codex gibt Formularunterstützung an, wenn der Client eine objektwertige form-Funktion deklariert, verarbeitet Anfragen an openai/elicitation/create und leitet deren Metadaten sowie ihr undurchsichtiges Schema über den App-Server als openaiForm weiter (wobei x-openai-*-Annotationen erhalten bleiben). Die bisherige Verarbeitung von openai/form bleibt unabhängig davon bestehen, und die TUI lehnt Formularanfragen, die sie nicht darstellen kann, automatisch ab. Ausgabelimits pro Tool: Jeder Eintrag unter der tools-Konfiguration eines MCP-Servers akzeptiert einen positiven Wert für output_token_limit (beispielsweise [mcp_servers.context7.tools.search] mit output_token_limit = 2000). Überschneiden sich Plugin- und Benutzerrichtlinien, gilt das restriktivste Limit. Das effektive Budget wird im Gesprächsverlauf gespeichert, sodass Toolausgaben, Antworten von Hooks nach Toolaufrufen und fortgesetzte Sitzungen beim gleichen Limit gekürzt werden – zusätzlich zum globalen tool_output_token_limit. Servernamen im Paketstil: Namen von MCP-Servern dürfen jetzt :, @, / und . enthalten (somit ist npm:@modelcontextprotocol/server-sequential.thinking ein gültiger Name). Sie bleiben bei mcp add/get/list/remove, in Tool-Namespaces zur Laufzeit und bei der Suche nach OAuth-Anmeldedaten erhalten; nicht einfache Namen werden in generierten Wiederherstellungshinweisen für config.toml in Anführungszeichen gesetzt.¹³⁸

MCP-Server konfigurieren

STDIO-Server (lokale Prozesse):

# In ~/.codex/config.toml or .codex/config.toml

[mcp_servers.context7]
enabled = true
required = true                         # Fail startup if unavailable
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
env = { "MY_VAR" = "value" }            # Static env vars
env_vars = ["PATH", "HOME"]             # Forward host env vars
cwd = "/path/to/project"                # Optional working directory
startup_timeout_sec = 10
tool_timeout_sec = 60
enabled_tools = ["search", "summarize"]  # Tool allowlist
disabled_tools = ["slow-tool"]           # Tool denylist

HTTP-Server (Remote):

[mcp_servers.figma]
enabled = true
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
http_headers = { "X-Figma-Region" = "us-east-1" }
env_http_headers = { "X-Org-Id" = "FIGMA_ORG_ID" }  # Headers from env vars
startup_timeout_sec = 10
tool_timeout_sec = 60

CLI-Verwaltung

codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp add context7 --env API_KEY=... -- npx -y @upstash/context7-mcp   # With env vars
codex mcp add figma --url https://mcp.figma.com/mcp --bearer-token-env-var FIGMA_OAUTH_TOKEN
codex mcp list                          # List all configured servers
codex mcp list --json                   # JSON output
codex mcp get context7                  # Show server config
codex mcp get context7 --json           # JSON output
codex mcp login <server>                # OAuth flow for HTTP servers
codex mcp logout <server>               # Remove OAuth credentials
codex mcp remove <server>               # Delete server definition

Innerhalb einer Sitzung zeigt /mcp die aktiven Server und verfügbaren Tools an. /mcp verbose (ab v0.123.0)⁸⁴ liefert vollständige Serverdiagnosen, Ressourcen und Ressourcenvorlagen — hilfreich, wenn ein Server nicht geladen wird oder Tools nicht an der erwarteten Stelle erscheinen. Das einfache /mcp bleibt schnell. Seit v0.144.0 können MCP-Tools interaktiv und ohne experimentelle Aktivierung eine Authentifizierung anfordern — benötigt ein Server während einer Sitzung eine Authentifizierung, erscheint eine Aufforderung im regulären Ablauf, statt dass der Vorgang fehlschlägt, bis Sie sich vorab mit codex mcp login authentifizieren.¹⁰⁷

Das Laden von Plugin-MCP (ab v0.123.0) unterstützt sowohl das standardmäßige mcpServers-Schema als auch Serverzuordnungen auf oberster Ebene in .mcp.json. Dadurch werden Plugins, die nach einer der beiden Konventionen erstellt wurden, problemlos geladen.⁸⁴

Codex ALS MCP-Server ausführen

Veraltet (24. August 2026). Im offiziellen Änderungsprotokoll heißt es: „Der Befehl codex mcp-server ist jetzt veraltet. Verwenden Sie stattdessen den Codex-App-Server. Um Codex aus Claude Code heraus zu verwenden, nutzen Sie das Codex-Plugin für Claude Code.“ Seit v0.149.0 gibt die Binärdatei warning: `codex mcp-server` is deprecated and will be removed in a future release. auf stderr aus und startet anschließend dennoch (PR #39657). Neue Integrationen sollten das App-Server-Protokoll verwenden, also die Schnittstelle hinter der VS Code-Erweiterung und der Desktop-App (Authentifizierung, Gesprächsverlauf, Genehmigungen und gestreamte Agentenereignisse), oder aus Claude Code heraus das Codex-Plugin für Claude Code: „Verwenden Sie Codex aus Claude Code heraus, um Code zu prüfen oder Aufgaben zu delegieren.“¹²⁵

Solange der Befehl vorhanden ist, kann Codex sich weiterhin als MCP-Server für die Multi-Agenten-Orchestrierung bereitstellen (veraltet, aber unter 0.150.0 weiterhin funktionsfähig, wobei eine ausdrückliche Veraltungswarnung ausgegeben wird):^12125132

codex mcp-server                        # Start as MCP server (stdio transport); deprecated, prints a warning

Der Server stellt zwei Tools bereit: 1. codex(): Startet eine neue Sitzung mit Parametern für Prompt, Sandbox, Modell und Genehmigungen 2. codex-reply(): Setzt eine bestehende Sitzung mit threadId und Prompt fort

Verwendung mit dem Agents SDK (Python):

from agents import Agent, Runner
from agents.mcp import MCPServerStdio

async with MCPServerStdio(
    name="Codex CLI",
    params={"command": "npx", "args": ["-y", "codex", "mcp-server"]},
    client_session_timeout_seconds=360000,
) as codex_mcp_server:
    agent = Agent(name="Developer", mcp_servers=[codex_mcp_server])
    result = await Runner.run(agent, "Fix the failing tests")

Erwähnenswerte MCP-Server

Praktische Muster

Muster 1: Kontextbezogene Entwicklung — Kombinieren Sie Context7 mit der Dokumentation Ihres Frameworks, damit Codex stets über aktuelle API-Referenzen verfügt:

[mcp_servers.context7]
enabled = true
required = true
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

Muster 2: Ausgabelimits — Antworten von MCP-Tools werden standardmäßig nach etwa 25.000 Zeichen gekürzt. Verwenden Sie bei Tools, die große Datenmengen zurückgeben (Datenbankabfragen, Protokollerfassungen), enabled_tools, um die Auswahl auf bestimmte Tools zu beschränken und die Antworten fokussiert zu halten.

Muster 2a: Multimodale Toolausgabe (v0.107.0) — Benutzerdefinierte Tools können jetzt zusätzlich zu Text multimodale Ausgaben (Bilder und Rich Content) zurückgeben. So können Tools, die visuelle Artefakte erzeugen — Screenshots, Diagramme oder gerenderte Grafiken — diese direkt zur Analyse an das Modell übergeben.⁶²

Muster 3: Unternehmensweite MCP-Governance — Legen Sie über requirements.toml verbindlich fest, welche MCP-Server Entwickler verwenden dürfen:

# In /etc/codex/requirements.toml — only approved servers allowed
[mcp_servers.approved-internal]
identity = { command = "npx @company/internal-mcp" }

Jeder Server, der keiner Identität in requirements.toml entspricht, wird beim Start blockiert. Die vollständige Richtlinienkonfiguration finden Sie unter Unternehmensbereitstellung.

Code Mode [EXPERIMENTAL]

Code Mode (v0.114.0) ermöglicht stärker isolierte Programmierabläufe, indem der Aufgabenbereich des Agenten auf codebezogene Vorgänge beschränkt wird.⁷⁰ Ist dieser Modus aktiviert, konzentriert sich der Agent auf das Lesen, Schreiben und Testen von Code, ohne umfassendere Systeminteraktionen auszuführen.

Seit v0.139.0 kann Code Mode die eigenständige Websuche direkt aufrufen — auch aus verschachtelten JavaScript-Tool-Aufrufen heraus — und erhält die Ergebnisse als Klartext. Dadurch kann ein Code-Mode-Ablauf aktuelle Informationen abrufen, ohne den isolierten Programmierkontext zu verlassen.¹⁵⁵ v0.146.0 erweitert die eigenständige Websuche auf kompatible benutzerdefinierte Modellanbieter, sodass diese Funktion nicht mehr auf von OpenAI gehostete Modelle beschränkt ist.¹¹⁴

Mit v0.146.0 konnte sich app-server mit entfernten Code-Mode-Hosts verbinden, sodass sich die Code-Mode-Laufzeit nicht mehr auf demselben Rechner wie der Client befinden musste — ursprünglich über WebSocket.¹¹⁴ v0.151.0 entfernt den WebSocket-Transport (#40692): app-server-Verbindungen über --code-mode-host akzeptieren nur noch gRPC-Endpunkte mit http:// und https://, während der eigenständige Code-Mode-Host auf stdio- und gRPC-Listener beschränkt ist — beim Tag rust-v0.151.0 lautet die Listener-Dokumentation wörtlich: „Transport endpoint: stdio, stdio://, or grpc://IP:PORT.“ WebSocket bleibt lediglich als optionaler Endpunkt erhalten, der rohe OTLP-Trace-Batches für das Tracing streamt, nicht als Sitzungstransport.¹³⁵

Diese Funktion ist experimentell. Prüfen Sie die Versionshinweise auf Aktualisierungen.

JavaScript REPL-Laufzeit [REMOVED]

Codex v0.100.0 führte eine experimentelle JavaScript-REPL-Laufzeit (js_repl) ein, die mit v0.106.0 über die /experimental-Oberfläche zugänglich gemacht wurde.⁶⁰ Diese Anleitung ist inzwischen nur noch von historischem Interesse. Das Änderungsprotokoll von v0.128.0 enthält den Eintrag „Remove js_repl feature“, und in der aktuellen Funktionsliste sind sowohl js_repl als auch js_repl_tools_only als entfernt gekennzeichnet.⁸⁶

Fügen Sie neuen Konfigurationen nicht features.js_repl = true hinzu. Verwenden Sie Shell-Befehle, eingecheckte Skripte, MCP-Tools oder einen Codex-skill mit einem scripts/-Verzeichnis, wenn Sie wiederholbar ausführbare Logik benötigen.

Was sind skills?

skills sind wiederverwendbare, auf bestimmte Aufgaben zugeschnittene Funktionspakete, die Codex bei Bedarf lädt. Sie entsprechen dem offenen Agent-skills-Standard.¹³

Aufbau eines skills

my-skill/
  SKILL.md           (required: instructions)
  scripts/           (optional: executable scripts)
  references/        (optional: reference docs)
  assets/            (optional: images, icons)
  agents/openai.yaml (optional: metadata, UI, dependencies)

Speicherorte für die Erkennung

Codex speichert vom Benutzer installierte skills unter $CODEX_HOME/skills (Standard: ~/.codex/skills), einschließlich integrierter System-skills unter .system/. Codex unterstützt per Symlink eingebundene skill-Ordner.

Einen skill erstellen

SKILL.md-Format:

---
name: security-audit
description: Run a thorough security audit on the codebase.
---

## Security Audit Procedure

1. Scan for hardcoded secrets using `rg -i "(api_key|password|secret|token)\s*=" --type py`
2. Check for SQL injection: look for string interpolation in queries
3. Verify input validation on all API endpoints
4. Check dependency vulnerabilities: `pip audit` or `npm audit`
5. Review authentication and authorization patterns
6. Report findings with severity levels (Critical/High/Medium/Low)

Metadaten (agents/openai.yaml):

interface:
  display_name: "Security Audit"
  short_description: "Full codebase security review"
  icon_small: "./assets/shield.svg"
  brand_color: "#DC2626"
  default_prompt: "Run a security audit on this repository"

policy:
  allow_implicit_invocation: false    # Require explicit $skill

dependencies:
  tools:
    - type: "mcp"
      value: "snyk"
      transport: "streamable_http"
      url: "https://mcp.snyk.io/mcp"

skills aufrufen

• Explizit: Über das /skills-Menü oder durch Erwähnung von $skill-name im Prompt
• Implizit: Codex erkennt anhand der Aufgabenbeschreibung automatisch passende skills (wenn allow_implicit_invocation: true gesetzt ist)
• Erstellung: Verwenden Sie $skill-creator, um interaktiv einen neuen skill zu erstellen
• Installation: Verwenden Sie $skill-installer install <name>, um Community-skills zu installieren
• Vom Executor bereitgestellt (v0.146.0): Codex erkennt vom Executor angebotene skills und liest deren zugehörige Ressourcen, einschließlich der skills, die Sie ausdrücklich auswählen¹¹⁴

Kontextbudgets können skill-Kataloge kürzen. v0.146.0 behält bei knappem Kontext mehr verfügbare skills bei und warnt, wenn ein Katalog gekürzt werden muss.¹¹⁴ Zuvor konnte eine große skill-Bibliothek unbemerkt gekürzt werden, sodass ein erwarteter skill schlicht nicht angeboten wurde. Wenn Sie bei vielen skills auf den impliziten Aufruf angewiesen sind, achten Sie auf diese Warnung.

Aktivieren/Deaktivieren

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

skills im Vergleich zu slash commands

Fehlerbehebung bei skills

Wenn ein skill nicht aktiviert wird:

1. Prüfen Sie die Erkennung: /skills sollte ihn in der TUI auflisten
2. Überprüfen Sie den Pfad: Stellen Sie sicher, dass sich der skill-Ordner an einem erkannten Speicherort befindet (~/.codex/skills/, im Projektstammverzeichnis oder unter /etc/codex/skills/)
3. Prüfen Sie enabled: skills mit enabled = false in config.toml werden nicht geladen
4. Prüfen Sie die implizite Aktivierung: Wenn Sie sich auf die automatische Erkennung verlassen, stellen Sie sicher, dass allow_implicit_invocation: true in agents/openai.yaml gesetzt ist
5. Verwenden Sie Schlüsselwörter: Nehmen Sie Begriffe aus der description des skills in Ihren Prompt auf, um die implizite Zuordnung zu verbessern

Praxisbeispiel: Deployment-skill

Ein vollständiger, aus mehreren Dateien bestehender skill, der das Zusammenspiel von Referenzen und Skripten zeigt:

deploy-skill/
  SKILL.md
  references/
    runbook.md
    rollback-checklist.md
  scripts/
    pre-deploy-check.sh
    smoke-test.sh
  agents/openai.yaml

SKILL.md:

---
name: deploy
description: Deploy the application to staging or production. Runs pre-flight checks, executes deployment, and verifies with smoke tests.
---

## Deployment Procedure

### Pre-flight
1. Run `scripts/pre-deploy-check.sh` to verify:
   - All tests pass
   - No uncommitted changes
   - Branch is up to date with remote
2. Review the runbook at `references/runbook.md` for environment-specific steps.

### Deploy
3. Execute the deployment command for the target environment.
4. Monitor logs for errors during rollout.

### Verify
5. Run `scripts/smoke-test.sh <environment-url>` to confirm critical paths.
6. If smoke tests fail, follow `references/rollback-checklist.md`.

Aufruf mit: $deploy to staging oder $deploy production with canary rollout

Plugins

Plugins bündeln skills, MCP-Einträge, hooks und App-Connectors in einem einzigen installierbaren Paket (v0.110.0+).⁶⁵ Seit v0.117.0 sind Plugins vollwertige Bestandteile des Produkts: Produktspezifische Plugins werden beim Start automatisch synchronisiert, und /plugins bietet einen Browser innerhalb der TUI für die Suche und Verwaltung.⁷⁵ v0.128.0 erweiterte die Plugin-Workflows um die Installation über Marketplaces, die Zwischenspeicherung externer Bundles, APIs für die externe Deinstallation, in Plugins gebündelte hooks, den Aktivierungsstatus von hooks und den Import von Konfigurationen externer Agents.⁸⁶ v0.129.0 (7. Mai 2026) ergänzt die Freigabe von Plugins in Workspaces (Sie können einen Plugin-Satz an Teammitglieder übertragen, ohne ihn erneut zu veröffentlichen), Zugriffskontrollen für Freigaben (pro Empfänger aktivieren/deaktivieren oder widerrufen), Quellenfilterung (einschränken, aus welchen Marketplaces ein Workspace Inhalte bezieht) und Marketplace-Vorgänge, die direkt über den /plugins-Browser statt über die CLI aufgerufen werden können.⁸⁹ v0.133.0 (21. Mai 2026) erleichtert die Überprüfung der Plugin-Suche: Listenausgaben berücksichtigen den jeweiligen Marketplace, installierte Versionen sind sichtbar, Marketplace-Stammverzeichnisse werden aufgeführt und externe Plugin-Sammlungen lassen sich anzeigen, ohne erraten zu müssen, aus welcher Registry ein Ergebnis stammt.⁹⁸ v0.130.0 (8. Mai 2026) macht die Plugin-Paketierung transparenter und den Freigabe-Workflow besser steuerbar:⁹¹

• Gebündelte hooks in den Plugin-Details sichtbar. Die Detailansicht unter /plugins führt nun sämtliche Lifecycle-hooks auf, die ein Plugin bündelt (SessionStart, UserPromptSubmit, Stop usw.). Bevor Sie ein Plugin installieren, können Sie genau erkennen, welche hooks es für Ihre Sitzung registriert – unerwartete Nebenwirkungen durch hooks eines Plugins, dem Sie allein aufgrund seiner Tools vertrauen, gehören damit der Vergangenheit an.
• Metadaten zu Plugin-Freigaben in shareContext. Wird ein Plugin aus einem Workspace freigegeben, enthält die Nutzlast des Freigabelinks nun Link-Metadaten (Ersteller, Geltungsbereich, Aktualität). Empfangende Sitzungen können dadurch die Herkunft anzeigen und entscheiden, ob sie die Freigabe annehmen.
• Sichtbarkeitseinstellungen für Freigaben. Die Freigabeeinstellungen enthalten einen Schalter für die Sichtbarkeit. So können Teams Plugins in bestimmten Workspaces oder für bestimmte Empfängerlisten veröffentlichen, ohne sie allgemein innerhalb der gesamten Organisation auffindbar zu machen.

v0.143.0 (8. Juli 2026) aktiviert externe Plugins standardmäßig. Externe Plugins sind nun ohne Opt-in-Flag aktiviert, der /plugins-Katalog erhält aussagekräftigere Zeilen (npm-Marketplace-Quellen neben git und lokalen Quellen), und jeder Eintrag zeigt sowohl die externe als auch die lokal installierte Version an, sodass Abweichungen auf einen Blick erkennbar sind.¹⁰⁶ Für Teams, die einen gemeinsamen Plugin-Satz standardisieren, entfällt durch diese standardmäßige Aktivierung externer Plugins der bisher für die Einführung erforderliche Aktivierungsschritt auf jedem einzelnen Rechner.

Plugin-Quellen

Seit v0.147.0 durchsucht eine einzige Plugin-Suchanfrage lokale, persönliche, Workspace- und externe Kataloge – Sie suchen nach einer Funktion, nicht nach dem Katalog, in dem sie zufällig enthalten ist. In Verbindung mit portablen Agent-Plugin-Paketen lässt sich ein in einer Umgebung erstelltes Plugin problemlos in einer anderen installieren, statt an den Rechner oder Workspace gebunden zu sein, in dem es erstellt wurde.¹¹⁶

Plugin-Suche

Codex teilt dem Modell zu Beginn der Sitzung mit, welche Plugins aktiviert sind (v0.111.0), wodurch installierte MCPs, Apps und skills leichter gefunden werden.⁶⁵ Das Modell kann während einer Sitzung anhand des Aufgabenkontexts passende Plugins vorschlagen. In v0.117.0 werden produktspezifische Plugins beim Start synchronisiert, sodass der aktuelle Plugin-Katalog ohne manuelles Eingreifen verfügbar ist.⁷⁵ Seit v0.142.0 gliedert das Menü /plugins externe Plugins in die Bereiche Von OpenAI kuratiert, Workspace und Für mich freigegeben. Bei geeigneten Anfragen können relevante Plugins zudem direkt im Dialog empfohlen und installiert werden.¹⁰⁴ Seit v0.151.0 laden plugin/list und plugin/installed die effektive Plugin-Konfiguration für jedes angeforderte cwd – lokale Marketplaces werden in der Reihenfolge der Anfragen zusammengeführt, Installations- und Aktivierungsstatus werden über Repositorys hinweg zusammengeführt und ungültige Projektkonfigurationen über marketplaceLoadErrors gemeldet, ohne gültige lokale Kataloge oder global aktivierte externe Kataloge zu verwerfen.¹³⁴

@plugin-Erwähnungen (v0.112.0+)

Verweisen Sie im Chat mit @plugin-name direkt auf ein beliebiges installiertes Plugin.⁶⁸ Wenn Sie ein Plugin erwähnen, wird dessen Kontext (Funktionen, Tools, Konfiguration) automatisch in das Kontextfenster des Modells aufgenommen – Sie müssen nicht beschreiben, was das Plugin leistet.

@deploy push this branch to staging with canary rollout
@linter check for unused imports in src/

Dies funktioniert mit jedem installierten Plugin, einschließlich benutzerdefinierter skills, MCP-Server und App-Connectors.

Plugin-Marketplace (v0.113.0+)

Der Plugin-Marketplace bietet nun umfassendere Suchmöglichkeiten mit Metadaten, Kategorien und Bewertungen.⁶⁹ Authentifizierungsprüfungen bei der Installation stellen sicher, dass für Plugins, die API-Schlüssel oder OAuth benötigen, bereits vor der Installation gültige Anmeldedaten vorliegen. Ein Deinstallations-Endpunkt entfernt Plugins und die zugehörige Konfiguration vollständig.

Hinzufügen von Drittanbieter-Marketplaces (v0.121.0+)

In der aktuellen Dokumentation zu OpenAI Codex erfolgt die Verwaltung von Marketplace-Quellen weiterhin über codex plugin marketplace. Damit wird die Verteilung von Drittanbieter-Plugins über den offiziellen Marketplace von OpenAI hinaus formalisiert. Unterstützt werden die Kurzschreibweise für GitHub-Repositorys, HTTP(S)-Git-URLs, SSH-URLs und lokale Marketplace-Stammverzeichnisse; verwenden Sie --ref, um eine Git-Referenz festzuschreiben, und wiederholen Sie --sparse PATH ausschließlich für Git-basierte Marketplace-Repositorys.⁹³

# GitHub repository (shorthand)
codex plugin marketplace add owner/repo

# Arbitrary git URL
codex plugin marketplace add https://git.example.com/team/plugins.git

# SSH Git URL
codex plugin marketplace add git@example.com:team/plugins.git

# Local directory
codex plugin marketplace add /path/to/local/marketplace

# Upgrade or remove a configured marketplace
codex plugin marketplace upgrade <marketplace-name>
codex plugin marketplace remove <marketplace-name>

Nach dem Hinzufügen erscheinen die Plugins eines Marketplace neben den Standard-Plugins im /plugins-Browser. Aufrufer des App-Servers (IDE-/Desktop-Integrationen) können Marketplaces über einen entsprechenden Endpunkt programmgesteuert registrieren.⁸²

Sicherheitshinweis: Drittanbieter-Marketplaces führen beliebigen Plugin-Code mit Ihren Codex-Berechtigungen aus. Prüfen Sie Quellen, bevor Sie sie hinzufügen, und bevorzugen Sie bei der ersten Ausführung eine Sandbox-Umgebung.

Agent Plugins: der herstellerübergreifende Standard (v0.146.0–v0.147.0)

„Agent Plugins“ bezeichnet nicht nur eine Funktion von Codex, sondern einen offenen, herstellerneutralen Paketierungsstandard, der am 6. August 2026 als Agent Plugins 1.0.0 veröffentlicht wurde. Die offizielle Website fasst ihn als „ein portables Paketformat für wiederverwendbare Komponenten zur Erweiterung von KI-Agents“ zusammen.¹⁵¹ Ein Plugin ist ein Verzeichnis mit einem obligatorischen plugin.json-Manifest (einem geschlossenen Schema mit genau zehn zulässigen Feldern auf oberster Ebene – $schema, name, version, description, author, homepage, repository, license, keywords, extensions –, wobei Clients jedes unbekannte Feld melden und ignorieren müssen), einem optionalen Ordner skills/ (jedes unmittelbar darin enthaltene Unterverzeichnis mit einer SKILL.md stellt einen skill dar), einer optionalen Datei mcp.json, die stdio-, Streamable-HTTP- oder ältere HTTP+SSE-Server deklariert, sowie optionalen Client-Namespace-Verzeichnissen in umgekehrter Domainnotation, die andere Clients ignorieren müssen. Sein normativer Geltungsbereich ist die Paketierung: Die Spezifikation „definiert die maßgebliche Agent Plugins Specification v1.0.0 für die Paketierung wiederverwendbarer Komponenten, mit denen KI-Agents durch verteilbare Plugins erweitert werden“ – Agent Skills und MCP behalten darunter ihre eigenen Spezifikationen.¹⁵¹

Entscheidend ist die Governance. Vercel initiierte den Vorschlag und entwickelte die Spezifikation 1.0 gemeinsam mit Amazon, Anysphere (Cursor), GitHub, Microsoft und OpenAI. Die Liste der Maintainer im Repository der Spezifikation umfasst Amazon, Cursor, Microsoft, OpenAI und Vercel; Google gab am Veröffentlichungstag bekannt, dem Kreis der wichtigsten Maintainer beizutreten.¹⁵¹ Zu den namentlich genannten Clients zum Veröffentlichungszeitpunkt zählen ChatGPT, Codex, Cursor, GitHub Copilot, Kiro und VS Code. Eine auffällige Ausnahme: Anthropic, das sowohl das zugrunde liegende Agent-Skills-Format als auch MCP entwickelt hat, gehört nicht zu den Maintainern – Claude Code behält sein eigenes Plugin-Format, während Codex die Lücke seinerseits mit der Claude Code-Marketplace-Quelle (v0.146.0) und /import überbrückt.¹⁵¹

Für Codex bedeutet das: v0.146.0 ergänzt Agent-Plugins-Manifeste, die Veröffentlichung von Workspace-Plugins und zwei weitere Plugin-Marketplaces – Amazon Bedrock und Claude Code¹¹⁴ –, während v0.147.0 den Kreislauf mit der Installation portabler Agent Plugins und der Suche in lokalen, persönlichen, Workspace- und externen Katalogen schließt.¹¹⁶ Für Teams ist die Veröffentlichung in Workspaces der praktisch besonders nützliche Teil: Veröffentlichen Sie Plugins in Ihrem eigenen Workspace, statt einen öffentlichen Marketplace einzurichten oder jeden Entwickler aufzufordern, eine Git-Quelle manuell hinzuzufügen.

In den Versionshinweisen werden die Codex-Oberflächen angekündigt, ohne ihre Konfigurationsschlüssel oder die Syntax der CLI zu veröffentlichen. Dieser Eintrag dokumentiert, dass die Funktion eingeführt wurde und was der Standard festlegt, nicht aber, wie sie in Codex verwendet wird – betrachten Sie den Workflow zur Erstellung von Manifesten und jeden Aufruf von codex plugin publish als nicht verifiziert, bis die Dokumentation von OpenAI sie behandelt.

Plugins verwalten

codex plugin marketplace add <src>       # Add a marketplace source
codex plugin marketplace upgrade [name]  # Upgrade one marketplace or all
codex plugin marketplace remove <name>   # Remove a configured marketplace
codex plugin list                        # List plugins; includes remote catalog entries (v0.153.0)
codex plugin list --json                 # JSON adds source, version, install + auth policy (v0.153.0)

v0.153.0 erweitert die Plugin-CLI von der Marketplace-Verwaltung auf Plugin-Vorgänge für externe Marketplaces: codex plugin list enthält Einträge aus externen Katalogen (einschließlich Quelle, Version, Installationsrichtlinie und Authentifizierungsrichtlinie in der JSON-Ausgabe), und externe Plugins können über die bestehende Plugin-CLI hinzugefügt und entfernt werden. Externe Kataloge werden nach Geltungsbereich und Sammlung zwischengespeichert – aktuelle zwischengespeicherte Ergebnisse werden bevorzugt, eine Hinzufügeanfrage, die ein Plugin nicht im Cache findet, ruft die Daten einmal erneut ab, und der lokale kuratierte Katalog bleibt erhalten, wenn eine ungefilterte externe Auflistung fehlschlägt (bei ausdrücklich ausgewählten externen Marketplaces werden Fehler weiterhin angezeigt).¹⁴⁰

Verwenden Sie in der TUI /plugins (v0.117.0+), um einzelne Plugins interaktiv zu durchsuchen, zu installieren und zu entfernen, ohne Ihre Sitzung zu verlassen.⁷⁵

Expertentipp: Plugins bündeln, wofür früher eine separate MCP-Konfiguration, die Installation von skills und die Einrichtung von App-Connectors erforderlich waren. Ein einzelnes Plugin kann alle drei Komponenten enthalten – dadurch lassen sich Teams schneller einarbeiten und Konfigurationen leichter übertragen.

Plan Mode und Zusammenarbeit

Im Plan Mode kann Codex zunächst ein Vorgehen entwerfen, bevor Änderungen ausgeführt werden. Er ist standardmäßig aktiviert (seit v0.94.0).¹⁴ Unter Entscheidungsrahmen finden Sie den Entscheidungsbaum „Plan Mode oder direkte Ausführung“.

Plan Mode im Vergleich zum Tool update_plan (v0.152.0): Hierbei handelt es sich um zwei verschiedene Dinge, von denen nur eines standardmäßig aktiviert ist. Der Plan Mode – der in diesem Abschnitt beschriebene Modus für die Zusammenarbeit, in dem Codex vor der Ausführung einen Vorschlag unterbreitet – ist seit v0.94.0 standardmäßig aktiviert und bleibt unverändert. update_plan ist ein Planungs-Tool, das das Modell aufrufen kann, um innerhalb eines Turns einen strukturierten Plan zu verwalten. Es wurde mit v0.152.0 als Opt-in-Funktion eingeführt: tools.update_plan.enabled ist standardmäßig auf false gesetzt. Solange das Tool deaktiviert ist, entfernt Codex zudem die mitgelieferten update_plan-Anweisungen aus seinen Modell-, Zusammenarbeitsmodus-, Multi-Agent-, Komprimierungs-, Vorbereitungs- und Zielverfolgungs-Prompts. Benutzerdefinierte Basisanweisungen, Modellkataloganweisungen, Zusammenarbeitsrichtlinien und der Text des Benutzerziels bleiben auch dann erhalten, wenn sie sich auf die Planung beziehen. Aktivieren Sie das Tool ausdrücklich mit tools.update_plan.enabled = true in config.toml.¹³⁸

Plan Mode aufrufen

/plan                              # Switch to plan mode
/plan "redesign the API layer"     # Plan mode with initial prompt

Im Plan Mode führt Codex folgende Aktionen aus: - Dateien lesen und die Codebasis analysieren - Einen Implementierungsplan vorschlagen - Keine Änderungen vornehmen, bis Sie diese genehmigen - Den Plan in einer eigenen TUI-Ansicht streamen

Steer Mode

Im Steer Mode (seit v0.98.0 standardmäßig aktiviert) können Sie während der laufenden Arbeit von Codex neue Anweisungen einbringen, ohne die aktuelle Aufgabe zu unterbrechen.¹⁴

Dafür gibt es zwei Eingabemethoden:

Praktische Beispiele:

# Codex is refactoring the auth module...

[Enter] "Use bcrypt instead of argon2 — we already have it as a dependency"
→ Codex adjusts immediately, mid-turn

[Tab] "Once auth is done, update the migration script too"
→ Codex finishes auth refactor, then starts the migration

Der Steer Mode ist in der TUI immer aktiv. Wenn Sie lieber warten möchten, bis Codex die Arbeit abgeschlossen hat, bevor Sie weitere Anweisungen geben, geben Sie diese nach Abschluss des Turns einfach wie gewohnt ein – ein besonderer Modus ist dafür nicht erforderlich.

TUI-Verbesserungen (v0.105.0–v0.106.0)

Syntaxhervorhebung (v0.105.0): Die TUI hebt nun die Syntax abgegrenzter Codeblöcke und eingebetteter Diffs hervor. Mit /theme können Sie ein Farbschema auswählen.⁶¹

Neue TUI-Befehle (v0.105.0+):⁶¹

Sprachtranskription (v0.105.0, experimentell): Drücken Sie die Leertaste, um Prompts per Sprachtranskription zu diktieren. Diese Funktion ist experimentell und erfordert möglicherweise eine Mikrofonberechtigung.⁶¹ Seit v0.107.0 unterstützen Echtzeit-Sprachsitzungen die Auswahl von Mikrofon und Lautsprecher, sodass Sie bestimmte Hardware für die Audioeingabe und -ausgabe auswählen können.⁶² In v0.140.0 entfernt, in v0.145.0 zurückgekehrt: Die experimentellen /realtime-Sprachsteuerelemente und ihre Audioabhängigkeiten wurden in v0.140.0 aus der TUI entfernt; die Sprachtranskription über die Leertaste war davon nicht betroffen.¹⁰² Mit v0.145.0 kehrt die Sprachfunktion in neuer Form zurück: Audioeingaben und Audio-Tool-Ausgaben in gängigen lokalen Audioformaten sowie gestreamte Echtzeitunterhaltungen mit V3.¹¹²

Weitere Verbesserungen: - Lange Links bleiben nun auch dann anklickbar, wenn sie über mehrere TUI-Zeilen umgebrochen werden (v0.105.0)⁶¹ - Links zu lokalen Dateien werden mit verbesserter Formatierung dargestellt (v0.106.0)⁶⁰ - In TUI-Markdown bleiben Weblinks über OSC-8-Metadaten anklickbar, während Tabellen bei Platzmangel auf gut lesbare Schlüssel-Wert-Einträge zurückfallen, ohne die Linkziele zu verlieren (v0.136.0)¹⁵⁸ - Markdown-Links erscheinen in unterstützten Terminals als anklickbare Beschriftungen; andernorts bleiben die URLs sichtbar (v0.150.0)¹³² - Die Verarbeitung von Ctrl+C für Sub-Agents wurde korrigiert, sodass untergeordnete Prozesse ordnungsgemäß beendet werden (v0.106.0)⁶⁰

Speichersystem

Codex verfügt über ein persistentes Speichersystem (v0.100.0+), das Fakten, Präferenzen und Projektkontext sitzungsübergreifend speichert.²⁴

Speicherbefehle

Erinnerungen werden in Markdown-Dateien unter ~/.codex/memory/ gespeichert. Codex lädt sie beim Sitzungsstart und nutzt sie in allen künftigen Sitzungen zur Steuerung seines Verhaltens.

Geeignete Speicherinhalte

Erinnerungen eignen sich am besten für dauerhafte Präferenzen und Projektfakten:

• Projektkonventionen: „Dieses Projekt verwendet Tabulatoren statt Leerzeichen“ oder „Antworten von API enthalten immer ein meta-Feld“
• Tool-Präferenzen: „Verwenden Sie pnpm statt npm“ oder „Führen Sie Tests mit pytest -x --tb=short aus“
• Architekturentscheidungen: „Das Authentifizierungsmodul befindet sich in src/core/auth/, nicht in src/middleware/“
• Workflow-Präferenzen: „Führen Sie immer den Linter aus, bevor Sie mir einen Diff zeigen“

Speicher in Pipelines

Bei der Ausführung von codex exec werden Erinnerungen automatisch geladen. Dadurch profitieren CI/CD-Pipelines und Skripte vom selben Kontext wie interaktive Sitzungen – Sie müssen die Anweisungen nicht bei jedem Aufruf wiederholen.

Speicheroptimierungen (v0.101.0–v0.107.0)

• Bereinigung von Geheimnissen: Erinnerungen werden automatisch auf Geheimnisse geprüft, bevor sie auf den Datenträger geschrieben werden
• Berücksichtigung des CWD: Speicherdateien enthalten nun den Kontext des Arbeitsverzeichnisses, um projektspezifische Erinnerungen abzurufen
• Ausschluss von Entwicklernachrichten: Entwickler- und Systemnachrichten werden von den Speichereingaben der Phase 1 ausgeschlossen. Dadurch verbessert sich die Speicherqualität, weil der Fokus auf Benutzerinteraktionen liegt
• Diff-basiertes Vergessen (v0.106.0): Der Speicher verwendet nun Diff-basiertes Vergessen, um veraltete Fakten zu entfernen und den Speicherbestand dauerhaft schlank und relevant zu halten⁶⁰
• Nutzungsabhängige Auswahl (v0.106.0): Beim Abrufen von Erinnerungen wird nun deren Nutzung berücksichtigt, sodass häufig abgerufene und in letzter Zeit relevante Erinnerungen priorisiert werden⁶⁰
• Konfigurierbare Erinnerungen (v0.107.0): Erinnerungen lassen sich nun vollständig konfigurieren. Mit codex debug clear-memories können Sie alle gespeicherten Erinnerungen zurücksetzen und neu beginnen – hilfreich beim Wechsel zwischen voneinander unabhängigen Projekten oder wenn sich der Speicherzustand vom aktuellen Kontext entfernt hat⁶²
• Modell-Upgrade für Phase 2 (v0.121.0): Das Modell zur Speicherkonsolidierung in Phase 2 ist nun gpt-5.4 und ersetzt den bisherigen Standard. Die Pipeline der Phase 2 wird zwischen Sitzungen ausgeführt, um die Transkripte aus Phase 1 zu dauerhaften Fakten zu verdichten. Der Modellwechsel verbessert die Qualität des Abrufs bei gleichen Token-Kosten.⁸²
• TUI-Speichermenü (v0.121.0): Eine neue sitzungsinterne Benutzeroberfläche bietet Zugriff auf den Speichermodus, das Löschen einzelner Erinnerungen und eine Schaltfläche zum Zurücksetzen. Beim Zurücksetzen des Speichers bleiben frühere Rollouts erhalten, anstatt ungültig zu werden. Dadurch wird der künftige Abrufbereich geleert, ohne die Sitzungswiedergabe zu beeinträchtigen.⁸²

Speicher im Vergleich zu AGENTS.md

Tipp: Verwenden Sie /m_update für Fakten, die dauerhaft erhalten bleiben sollen. Sitzungsspezifischen Kontext können Sie Codex direkt in der Unterhaltung mitteilen. Für gemeinsam genutzten Teamkontext verwenden Sie AGENTS.md.

Sitzungsverwaltung

Codex speichert Sitzungen unter ~/.codex/sessions/ und ermöglicht damit das Fortsetzen, Forken und Multi-Thread-Workflows über CLI und Desktop-Oberflächen hinweg.

Mit v0.146.0 können Threads gezielt adressiert werden. /new und /clear akzeptieren jetzt einen Sitzungsnamen, wichtige Threads lassen sich anheften und Nebengespräche bleiben geöffnet, sodass Sie nicht mehr eines schließen müssen, um zu einem anderen zu gelangen.¹¹⁴ In der Praxis bedeutet das, dass ein lang laufendes Projekt nicht mehr aus einer Liste von Zeitstempeln besteht, die Sie anhand des Datums wiedererkennen müssen. v0.147.0 führt Gesprächsabschnitte ein: Gespräche lassen sich in dauerhafte, manuell sortierte Abschnitte gliedern, und lange Transkripte werden schrittweise angezeigt, anstatt vollständig geladen zu werden.¹¹⁶ v0.148.0 führt /export und das Forken über die Befehlszeile ein: /export schreibt das vollständige Gespräch als Markdown in die Zwischenablage oder in eine neue Datei, codex exec fork forkt eine Sitzung nicht interaktiv und in der Auswahl zum Fortsetzen können Sitzungen archiviert und wiederhergestellt werden.¹¹⁸ v0.149.0 führt codex queue ein — damit senden Sie über die Befehlszeile Nachrichten an bestehende lokale oder entfernte Sitzungen — und stellt bei fortgesetzten oder geforkten Threads das aktive Berechtigungsprofil wieder her.¹²⁰ v0.150.0 führt automatische Titel ein: Unbenannte Terminalaufgaben erhalten automatisch aussagekräftige Titel, und /rename schlägt anhand des Gesprächs einen bearbeitbaren Titel vor.¹³² v0.151.0 führt /recap ein: Fordern Sie bei Bedarf eine kurze Zusammenfassung der jüngsten Fortschritte und nächsten Schritte des Gesprächs an. Codex erstellt dieselbe Zusammenfassung außerdem automatisch für geeignete inaktive, nicht fokussierte Gespräche und fügt sie dem Transkript hinzu. Dabei werden begrenzte, isolierte Anfragen verwendet und Wiederholungsversuche nur bei automatisch aufgetretenen Fehlern durchgeführt.¹³⁵ Mit v0.153.0 wird die automatische Variante optional: tui.auto_recap = false bricht geplante automatische Zusammenfassungsprüfungen ab und verwirft ausstehende automatische Ergebnisse, während das manuelle /recap weiterhin funktioniert.¹⁴⁰

codex agents (v0.149.0) ist das interaktive Dashboard für jede aktive Agentensitzung auf dem Rechner: Auf einem einzigen Bildschirm können Sie Aufgaben suchen, starten, öffnen, umbenennen und beenden; die Tastenkürzel sind konfigurierbar. Innerhalb einer Sitzung wechseln Sie mit /agents zwischen allen aktiven Agentensitzungen und mit /subagents zwischen den Subagenten der aktuellen Sitzung.¹²⁰¹²⁹ Mit v0.150.0 können Aufgaben direkt aus dem Gespräch adressiert werden: Verweisen Sie mit @-Erwähnungen auf andere Codex-Aufgaben und weisen Sie Agenten im Terminal an, Aufgaben zu lesen, zu erstellen oder ihnen Nachrichten zu senden.¹³²

Fortsetzen

Setzen Sie Ihre Arbeit dort fort, wo Sie aufgehört haben:

codex resume                          # Interactive picker (sorted by recency)
codex resume <SESSION_ID>             # Resume a specific session
codex exec resume --last "continue"   # Non-interactive: resume most recent

Der Slash-Befehl /resume innerhalb der TUI öffnet dieselbe interaktive Auswahl mit Suchfunktion.

Paginierter Threadverlauf (v0.145.0, in v0.151.0 regulär freigegeben): Der paginierte Threadverlauf erweitert die Sitzungsverwaltung um effizientes Fortsetzen, die Suche im Verlauf, dauerhaft gespeicherte Threadnamen, Subagentenunterstützung und Erinnerungen. Der Verlauf wird seitenweise statt vollständig geladen, was bei langlebigen Arbeitsverzeichnissen mit Hunderten von Sitzungen entscheidend ist. Die Funktion wurde in v0.145.0 als experimentell eingeführt; v0.151.0 überführt die APIs aus dem experimentellen Status (thread/turns/list, thread/items/list und thread/revert benötigen die experimentelle API-Funktion nicht mehr) und legt die paginierte Variante NUR für dauerhafte Threads als aufgelösten Standard fest, deren Speicher thread/turns/list und thread/items/list unterstützt, und nur dann, wenn thread/start kein historyMode angibt. Flüchtige Threads und Threads, deren Speicher diese APIs nicht unterstützt, verwenden weiterhin standardmäßig den Legacy-Modus; explizite Auswahlen behalten ihr Verhalten bei, und das ThreadHistoryMode-Enum auf Protokollebene verwendet beim Tag rust-v0.151.0 (protocol.rs:755-758) weiterhin standardmäßig Legacy — es handelt sich also um einen aufgelösten Standard für unterstützte dauerhafte Threads und nicht um eine pauschale Umstellung.¹¹²¹³⁵

Fork

Verzweigen Sie ein Gespräch, um Alternativen zu erkunden, ohne Ihren aktuellen Fortschritt zu verlieren:

/fork                              # Fork current conversation
/fork "try a different approach"   # Fork with new prompt

Forks erstellen unabhängige Threads, die bis zum Fork-Punkt denselben Verlauf teilen. Seit v0.146.0 ist der Fork-Verlauf paginiert, und Forks können als temporär erstellt werden — ein temporärer Fork erscheint nicht in Threadlisten, sodass einmalige Experimente nicht die Threadliste überladen, in der Sie tatsächlich navigieren.¹¹⁴ Änderungen in einem Fork wirken sich nicht auf den anderen aus. Dies eignet sich zum Vergleichen verschiedener Ansätze (z. B. „forken und Redis statt Memcached ausprobieren“) oder zum sicheren Erproben riskanter Änderungen.

Thread-Forking in Subagenten (v0.107.0): Threads können jetzt in unabhängige Subagenten geforkt werden. Dadurch kann ein Gespräch parallele Arbeitsströme erzeugen, die autonom ausgeführt werden. Dies erweitert das bestehende Fork-Modell: Statt lediglich das Gespräch zu verzweigen, wird der geforkte Thread zu einem Subagenten mit eigenem Ausführungskontext.⁶² Seit v0.117.0 verwenden Subagenten pfadbasierte Adressen (z. B. /root/agent_a) sowie eine strukturierte Kommunikation zwischen Agenten, wodurch die Multi-Agent-Koordination expliziter und leichter zu debuggen ist.⁷⁵

Verschlüsselte Nachrichten zwischen Agenten (v0.138.0+): Multi-Agent v2 verschlüsselt jetzt den Aufgabentext, den ein übergeordneter Agent beim Erstellen oder Anschreiben eines Subagenten sendet. Die Nachrichtenparameter von spawn_agent, send_message und followup_task sind als verschlüsselt gekennzeichnet: Die Responses-API verschlüsselt die Nutzdaten, wenn das übergeordnete Modell den Tool-Aufruf ausgibt. Das lokal ausgeführte Codex überträgt ausschließlich den Geheimtext (InterAgentCommunication.encrypted_content, mit leerem Klartextinhalt), den die API serverseitig entschlüsselt, wenn sie ihn an das empfangende Modell übergibt.¹⁰⁸ Daraus ergeben sich drei praktische Konsequenzen:

• Ihre lokalen Sitzungsprotokolle enthalten den Klartext der Delegierung nicht mehr. Sie können erkennen, dass ein übergeordneter Agent einen Subagenten erstellt hat und welches Ergebnis zurückkam, jedoch nicht die genaue Anweisung, die er gesendet hat. Wenn Sie Multi-Agent-Ausführungen anhand des Sitzungsverlaufs prüfen oder debuggen, fehlt dieser Datensatz. Für das offene Regressionsproblem, das diesen Umstand erfasst, ist bis Mitte Juli 2026 keine verknüpfte Fehlerbehebung vorhanden.¹⁰⁹ Lebenszyklusereignisse von Erweiterungen (Start und Stopp von Subagenten, Tool-Ausführung, Metadaten von Durchläufen — v0.133.0+) sowie die Beobachtungsfunktionen des App-Servers sind die verbleibenden Ansatzpunkte, um die Ereignisse zu rekonstruieren.⁹⁸
• Modelle benutzerdefinierter Anbieter können ausfallen. Ein Modellendpunkt, der nicht für die verschlüsselte Tool-Nutzung konfiguriert ist, weist das verschlüsselte spawn_agent-Schema mit einem 400-Fehler zurück ("declares encrypted parameters but is not configured for encrypted tool use"). Wenn die Multi-Agent-Delegierung bei einem benutzerdefinierten Anbieter mit diesem Fehler scheitert, liegt dies an der Verschlüsselungsänderung und nicht an Ihrer Konfiguration.¹⁰⁹
• Von Codex erzeugte Benachrichtigungen bleiben lesbar. Benachrichtigungen über den Abschluss von Subagenten werden von Codex selbst erzeugt. Sie bleiben daher im Klartext und werden jetzt als typisierte agent_message-Elemente statt als serialisierte JSON-Umschläge dargestellt.¹⁰⁸

OpenAI hat das Bedrohungsmodell hinter dieser Änderung nicht veröffentlicht. Der PR beschreibt den Geheimtextfluss, ohne anzugeben, wovor er schützt.

Multi-Agent v2 stabilisiert (v0.145.0, optional aktivierbar): Die mit v0.137.0 eingeführte und in v0.138.0 um verschlüsselte Delegierung erweiterte Multi-Agent-v2-Umgebung ist jetzt als optional aktivierbare Funktion stabilisiert. v0.145.0 führt konfigurierbare Subagentenmodelle, individuelle Reasoning-Stufen pro Subagent, eine konfigurierbare Parallelität, wiederhergestellte Multi-Agent-Rollen und eine verbesserte Agentennavigation ein. Falls Sie v2 während der anfänglichen Schwierigkeiten von v0.137/v0.138 noch nicht eingesetzt haben, ist dies die Version, in der sich die Konfigurationsoberfläche stabilisiert: Modell- und Reasoning-Auswahl für Subagenten werden jetzt in der Konfiguration festgelegt, statt durch die Laufzeitumgebung vorgegeben zu sein.¹¹²

Threadliste

Aktive Sitzungen anzeigen und verwalten:

/status                            # Current session info and token usage
/ps                                # Show background terminals in session

In der Desktop App werden Threads mit vollständigem Verlauf und Diff-Vorschauen in der Seitenleiste angezeigt.

Sitzungslebenszyklus

Sitzungen werden zwischen CLI und der Desktop App synchronisiert — beginnen Sie in einer Anwendung und setzen Sie Ihre Arbeit in der anderen fort.

Nicht interaktiver Modus (codex exec)

codex exec führt Codex nicht interaktiv für Skripte, CI/CD und Automatisierung aus.¹⁵

Grundlegende Verwendung

codex exec "summarize the repository structure"
codex exec --sandbox workspace-write -c approval_policy=on-request "fix the CI failure"   # exec has no -a flag; set the policy via -c or config
codex exec --json "triage open bugs" -o result.txt

Standardmäßig schreibt codex exec Fortschrittsmeldungen und Ereignisse nach stderr und die abschließende Agentennachricht nach stdout. Dadurch lässt es sich mit standardmäßigen Unix-Pipelines kombinieren.

Sitzungsarchivierung (v0.136.0)

Sitzungen können archiviert werden, damit die Liste zum Fortsetzen und Forken übersichtlich bleibt, ohne den Verlauf zu löschen. Archivieren Sie eine Sitzung in der TUI mit /archive oder über die Shell:¹⁵⁸

codex archive <session-id>     # archive a session
codex unarchive <session-id>   # restore it

Eine archivierte Sitzung ist vor dem Fortsetzen oder Forken geschützt, bis Sie die Archivierung aufheben – eine Sicherheitsvorkehrung dagegen, versehentlich eine Sitzung fortzuführen, die Sie eigentlich abschließen wollten. Ebenfalls neu in dieser Version: codex app-server --stdio startet den App-Server für Editor- und Host-Integrationen im stdio-Modus, und /diff darf von einem Repository bereitgestellte Git-Hilfsprogramme nicht mehr ausführen (eine Verbesserung der Befehlssicherheit). Unter Windows ergänzt ein Alpha-Bereitstellungspfad codex sandbox setup --elevated für Administratoren.¹⁵⁸

Ausgabe im JSON-Lines-Format

Mit --json wird stdout zu einem JSONL-Ereignisstrom:

codex exec --json "fix the tests" | jq

Ereignistypen: thread.started, turn.started/completed/failed, item.started/completed, error

{"type":"thread.started","thread_id":"019c5c94-..."}
{"type":"turn.started"}
{"type":"item.started","item":{"id":"item_1","type":"command_execution","status":"in_progress"}}
{"type":"item.completed","item":{"id":"item_3","type":"agent_message","text":"..."}}
{"type":"turn.completed","usage":{"input_tokens":24763,"cached_input_tokens":24448,"output_tokens":122}}

Strukturierte Ausgabe

Erzwingen Sie die Antwortstruktur mit einem JSON Schema:

codex exec "Extract project metadata" \
  --output-schema ./schema.json \
  -o ./project-metadata.json

-o / --output-last-message schreibt die abschließende Nachricht in eine Datei.

Sitzung fortsetzen und überprüfen

codex exec resume --last "continue where you left off"
codex exec resume <SESSION_ID> "fix the remaining issues"
codex exec review --base main           # Code review against a branch

Wichtige Flags

CI-Authentifizierung

codex exec unterstützt CODEX_API_KEY für die nicht interaktive Authentifizierung in Automatisierungsumgebungen.

Startbanner von codex exec (v0.130.0). Das Startbanner von codex exec enthält nicht mehr die veraltete Formulierung „research preview“. Wenn Ihre CI die Startausgabe ausliest, ist der Bannertext nun kürzer; strukturierte --json-Ereignisse bleiben unverändert.⁹¹

codex remote-control (v0.130.0+)

codex remote-control ist ein Befehl der obersten Ebene, der einen Headless-App-Server startet, der von einem anderen Prozess gesteuert werden soll – etwa von IDE-Erweiterungen, benutzerdefinierten Orchestratoren oder Remote-Steuerungsebenen. Er ersetzt den Aufruf von codex app-server mit mehreren Flags, den viele Integratoren bisher manuell zusammensetzten, und bietet Drittanbieterwerkzeugen einen einzigen stabilen Einstiegspunkt in dieselbe App-Server-Laufzeit, die auch den Desktop- und IDE-Oberflächen zugrunde liegt.⁹¹ v0.133.0 verbessert das Laufzeitverhalten des Befehls: Er kann wie ein Vordergrundbefehl ausgeführt werden, auf die Betriebsbereitschaft warten, einen maschinenlesbaren Status melden und weiterhin explizite daemonartige Befehle zum start / stop für langlebige Controller-Konfigurationen bereitstellen.⁹⁸ v0.143.0 ergänzt codex remote-control pair. Dieser Befehl erzeugt aus einem laufenden Daemon einen manuellen Kopplungscode, sodass sich ein Controller ohne automatische Erkennung verbinden kann – nützlich, wenn sich der steuernde Prozess auf einem anderen Host oder in einem anderen Netzwerksegment als der Daemon befindet.¹⁰⁶

# Start a headless, remotely controllable app-server
codex remote-control

# Generate a manual pairing code for an out-of-band controller (v0.143.0+)
codex remote-control pair

# Same lifecycle as a TUI session: thread store, hooks, plugins, MCP, sandbox
# all initialize from your normal config.toml.

Kombinieren Sie codex remote-control mit den unten beschriebenen APIs zur App-Server-Paginierung, wenn Sie Benutzeroberflächen entwickeln, die umfangreiche Thread-Verläufe auflisten müssen, ohne sämtliche Turns gleichzeitig in den Arbeitsspeicher zu laden.

App-Server-Thread-Paginierung (v0.130.0+)

App-Server-Clients können umfangreiche Threads nun über drei unterschiedliche Ansichten der Turn-Elemente seitenweise abrufen:⁹¹

Kombinieren Sie die Paginierung mit der in v0.121.0 eingeführten ThreadStore-Schnittstelle, um langlebige Threads effizient zu durchlaufen. Das gilt besonders für Remote-Control-Bereitstellungen, bei denen sich der Orchestrator auf einem anderen Rechner als die Rollout-Dateien befinden kann.⁸² v0.143.0 erweitert die Inspektionsmöglichkeiten eines Controllers: App-Server-Clients können nun verfügbare Umgebungen auflisten, die Nachfolger-Threads eines Threads anzeigen und den Verlauf an einem bestimmten Turn forken – genau die Grundfunktionen, die eine Benutzeroberfläche benötigt, um einen Lauf von einem früheren Punkt aus zu verzweigen, ohne ihn erneut bis dorthin auszuführen.¹⁰⁶ v0.151.0 hebt die APIs für paginierte Thread-Verläufe aus dem experimentellen Status und verwendet für dauerhafte Threads mit unterstützenden Speichern standardmäßig den paginierten Verlauf, wenn bei thread/start kein historyMode angegeben wird (ephemere Threads und nicht unterstützende Speicher verwenden weiterhin den Legacy-Modus); das Laden des vollständigen Verlaufs ist für paginierte Threads veraltet (#40676).¹³⁵

Live-Aktualisierung der App-Server-Konfiguration (v0.130.0+)

Aktive App-Server-Threads übernehmen Änderungen an config.toml nun ohne Neustart: Bearbeiten und speichern Sie die Konfiguration, damit der laufende Thread die neuen Werte bei seinem nächsten Turn verwendet. Diese Fehlerbehebung ergänzt codex remote-control: Ein langlebiger Headless-Server kann direkt neu konfiguriert werden, statt ihn herunterzufahren.⁹¹

Live-Einstellungen auf Turn-Ebene (v0.151.0): Die Einstellungen eines laufenden Turns lassen sich nun während der Ausführung ändern. Die experimentelle App-Server-Methode turn/settings/update aktualisiert model, effort, summary und serviceTier für nachfolgende Schritte eines bestimmten aktiven Turns, ohne künftige Turns zu verändern. Dabei meldet sie, ob die Aktualisierung angewendet oder abgelehnt wurde oder ihr Ziel nicht mehr vorhanden war. Verwaltete Beschränkungen werden erneut validiert, und die bei der Zulassung des Turns festgelegten Genehmigungs- und Guardian-Sicherheitseigenschaften bleiben erhalten, bevor eine aktualisierte Momentaufnahme der Einstellungen veröffentlicht wird. turn/start akzeptiert außerdem serviceTierForTurn, sodass ein einzelner neuer Turn die Dienststufe überschreiben kann, ohne die gespeicherte Stufe des Threads zu verändern („default“ steht für Standardgeschwindigkeit; fehlt der Wert oder ist er null, wird die Stufe des Threads übernommen).¹³⁵

Verschlüsselte Remote-Ausführungsumgebungen (v0.141.0)

Seit v0.141.0 (stabil, 18. Juni 2026) verbinden sich Remote-Ausführungsumgebungen über authentifizierte, Ende-zu-Ende-verschlüsselte Noise-Relay-Kanäle. Steuerungsebene und Ausführungsumgebung müssen dem dazwischenliegenden Relay somit nicht mehr vertrauen. Das ist besonders relevant, wenn Ihr Orchestrator einen App-Server über eine Netzwerkgrenze hinweg steuert. Dieselbe Version sorgt außerdem dafür, dass bei der plattformübergreifenden Remote-Ausführung das native Arbeitsverzeichnis und die native Shell der Ausführungsumgebung erhalten bleiben. Steuert ein Controller auf einem Betriebssystem eine Ausführungsumgebung auf einem anderen, werden Pfade und Shell-Semantik daher nicht mehr im Hintergrund umgeschrieben. Für die Kompatibilität mit Unternehmens-Proxys akzeptiert TLS nun außerdem P-521-Zertifikatsignaturen.¹⁰³

Codex Cloud und Hintergrundaufgaben [EXPERIMENTAL]

GitLab-Unterstützung (Beta, 19. August 2026): Codex Cloud kann jetzt in allen ChatGPT-Tarifen mit GitLab-Projekten verbunden werden – verknüpfen Sie ein Projekt, erstellen Sie Umgebungen, starten Sie Aufgaben aus Issues und Merge Requests und fordern Sie Reviews an; für Self-Managed GitLab ist Version 19.0 oder höher erforderlich.¹¹⁹

Status: Codex Cloud ist eine experimentelle Funktion. Schnittstellen, Preise und Verfügbarkeit können sich ändern. OpenAI verwaltet die Cloud-Umgebungen, und Sie haben keine Kontrolle über die Infrastruktur.

Codex Cloud führt Aufgaben asynchron in von OpenAI verwalteten Umgebungen aus.⁴ Seit CLI v0.150.0 können Aufgaben auch über eine Terminal-Unterhaltung angesprochen werden: Verweisen Sie mit @-Erwähnungen auf andere Codex-Aufgaben und weisen Sie Agenten an, Aufgaben zu lesen, zu erstellen oder ihnen Nachrichten zu senden.¹³² Informationen zur Integration von Codex in Ihre CI-Pipeline finden Sie außerdem unter GitHub Action und CI/CD.

Anmeldedaten für Cloud-Aufgaben besser geschützt (v0.152.0): Anfragen für Cloud-Aufgaben können gespeicherte ChatGPT-Anmeldedaten enthalten. Deshalb wird ihr Ziel jetzt eingeschränkt, bevor die Authentifizierung überhaupt geladen wird: CODEX_CLOUD_TASKS_BASE_URL wird anhand vertrauenswürdiger ChatGPT-HTTPS-Ursprünge auf Port 443 validiert (URLs mit Benutzerinformationen, Abfragen oder Fragmenten werden abgelehnt), und Weiterleitungen sind für das Cloud-Aufgaben-Backend sowie die Clients zur Umgebungserkennung deaktiviert, damit Anmeldedaten niemals an ein Weiterleitungsziel übermittelt werden.¹³⁸

Funktionsweise

1. Reichen Sie eine Aufgabe ein (über chatgpt.com/codex, die Slack-Integration oder CLI)
2. Codex klont Ihr Repository in eine isolierte Cloud-Sandbox
3. Der Agent arbeitet selbstständig: Er liest Code, führt Tests aus und nimmt Änderungen vor
4. Nach Abschluss erstellt Codex einen PR oder stellt ein Diff zur Überprüfung bereit
5. Übernehmen Sie die Ergebnisse lokal mit codex apply <TASK_ID>

Internetzugriff in der Cloud

Der Internetzugriff für Agenten ist standardmäßig deaktiviert und wird für jede Umgebung separat konfiguriert:

• Aus: Kein Internetzugriff für Agenten (Standardeinstellung)
• Ein: Optionale Domain-Zulassungsliste und Einschränkungen für HTTP-Methoden

Allowed domains: pypi.org, npmjs.com, github.com
Allowed methods: GET, HEAD, OPTIONS

Einrichtungsskripte können weiterhin auf das Internet zugreifen, um Abhängigkeiten zu installieren, selbst wenn der Internetzugriff für Agenten deaktiviert ist.

Slack-Integration

Erwähnen Sie @Codex in einem Slack-Kanal oder Thread, um eine Cloud-Aufgabe zu starten.

Voraussetzungen: 1. Berechtigter ChatGPT-Tarif (Plus, Pro, Business, Enterprise oder Edu) 2. Verbundenes GitHub-Konto 3. Mindestens eine konfigurierte Cloud-Umgebung 4. Für Ihren Workspace installierte Slack-App

Codex antwortet mit einem Aufgabenlink und veröffentlicht die Ergebnisse nach Abschluss.

Cloud-CLI

codex cloud exec --env <ENV_ID> "Fix failing tests"  # Start a cloud task
codex cloud status <TASK_ID>                          # Check task progress
codex cloud diff <TASK_ID>                            # View task diff
codex cloud list                                      # List recent tasks
codex cloud list --json                               # JSON output
codex cloud apply <TASK_ID>                           # Apply from cloud subcommand
codex apply <TASK_ID>                                 # Apply diff (top-level shortcut)

Die Codex Desktop App

Die Codex Desktop App (macOS und Windows) bietet eine grafische Oberfläche, die für die Verwaltung mehrerer Projekte optimiert ist.¹⁶ Die Windows-Version wurde am 4. März 2026 mit nativer PowerShell-Unterstützung und nativer Windows-Sandbox veröffentlicht.⁶⁶

Installation

codex app                      # Auto-downloads and installs on first run

Oder laden Sie die App direkt herunter: Codex.dmg (macOS) | Im Microsoft Store erhältlich (Windows)

Wichtigste Funktionen

Appshots, Browserkommentare und Computer Use

Mit den App-Updates vom 21. Mai wird die Desktop-App zu einer umfassenderen Kontextoberfläche und dient nicht mehr nur als Thread-Manager. Verwenden Sie Appshots, wenn Codex den Zustand einer anderen Mac-App kennen muss, bevor es handeln kann: Codex erfasst das vorderste Fenster sowie den verfügbaren sichtbaren und außerhalb des sichtbaren Bereichs liegenden Text, den die App bereitstellt, und speichert den Anhang lokal im Sitzungsverlauf.⁹⁹

Verwenden Sie für Web- und Frontend-Arbeiten zunächst den integrierten Browser, sofern für die Seite keine Anmeldung erforderlich ist: Er bietet Ihnen und Codex eine gemeinsame gerenderte Vorschau, unterstützt Browseraktionen wie Klicken, das Erstellen von Screenshots, das Herunterladen von Assets und die schreibgeschützte Überprüfung von JavaScript und ermöglicht es Ihnen, Seitenbereiche mit Kommentaren zu markieren, die Codex im nächsten Durchlauf bearbeiten kann.⁹⁹ Nutzen Sie für Websites, auf denen Sie angemeldet sind, weiterhin die Browsererweiterung (Chrome, Edge, Brave, Opera oder Vivaldi; Opera bietet keinen Seitenchat). Website-Werkzeuge (WebMCP, 25. August 2026): Im integrierten Browser der Desktop-App können ChatGPT Work und Codex von einer Website bereitgestellte Werkzeuge verwenden, um mit der Seite zu arbeiten. Verwenden Sie dafür GPT-5.6 Sol oder GPT-5.6 Terra in der neuesten Version der Desktop-App, da Website-Werkzeuge weder mit GPT-5.6 Luna noch in Enterprise- oder Edu-Workspaces verfügbar sind.¹²⁷

Verwenden Sie Computer Use nur, wenn sich die Aufgabe weder mit einer strukturierten Integration noch mit einer Browservorschau verifizieren lässt. Computer Use kann zulässige Mac-Apps prüfen und bedienen, übernimmt für Dateiänderungen und Shell-Befehle jedoch die Genehmigungs- und Sandbox-Regeln von Codex. Die Nutzung bei gesperrtem Mac bleibt eng begrenzt: Codex kann nach dem Sperren des Macs während aktiver, vertrauenswürdiger Computer Use-Durchläufe vorübergehend auf zulässige Apps zugreifen; dabei greifen Schutzmechanismen zur erneuten Sperrung sowie eine Erkennung lokaler Eingaben.⁹⁹

Thread-Modi

Jeder Thread wird in einem von drei Modi ausgeführt, die Sie beim Erstellen auswählen:

Funktionsweise der Worktree-Isolation:

Wenn Sie einen Worktree-Thread starten, führt die Desktop-App folgende Schritte aus: 1. Sie erstellt in einem temporären Verzeichnis einen neuen Git-Worktree (git worktree add) 2. Sie checkt von Ihrem aktuellen HEAD einen neuen Branch aus 3. Sie führt den Agenten innerhalb des Worktrees aus – sämtliche Dateiänderungen bleiben isoliert 4. Nach Abschluss zeigt sie ein Diff zur Überprüfung an – Sie entscheiden, welche Änderungen zurückgeführt werden

Dadurch können mehrere Worktree-Threads gleichzeitig und konfliktfrei im selben Repository ausgeführt werden. Jeder erhält einen eigenen Branch und ein eigenes Arbeitsverzeichnis.

Worktree-Einstellungen und Thread-Eigentümerschaft (v0.151.0): Das Verhalten verwalteter Worktrees wird von einem speziellen Einstellungsparser aus der bestehenden [desktop]-Konfiguration ermittelt: Als Worktree-Stammverzeichnis wird standardmäßig $CODEX_HOME/worktrees verwendet, die automatische Bereinigung ist standardmäßig aktiviert und 15 Worktrees werden beibehalten. Konfigurierte Stammverzeichnisse, Bereinigungsoptionen und Aufbewahrungszahlen werden vor der Verwendung validiert. Jeder verwaltete verknüpfte Worktree kann zudem in seinen Git-Metadaten einen versionierten Eigentümerschaftseintrag namens codex-thread.json enthalten, der ihn einem Thread zuordnet: Schreibvorgänge sind atomar und überschreiben nichts (wiederholte Zuordnungen sind idempotent, widersprüchliche Eigentümer werden abgelehnt), während primäre, verschachtelte und nicht verwaltete Checkouts abgelehnt werden, bevor die Eigentümerschaftsmetadaten verändert werden.¹³⁵

Automatisierungen

Automatisierungen werden lokal in der App ausgeführt. Daher muss die App geöffnet und das Projekt auf dem Datenträger verfügbar sein:

• In Git-Repositorys verwenden Automatisierungen eigene Hintergrund-Worktrees, die von Ihrem Arbeitsverzeichnis isoliert sind
• In Projekten ohne Git werden die Durchläufe direkt im Projektverzeichnis ausgeführt
• Automatisierungen verwenden Ihre standardmäßigen Sandbox-Einstellungen

Eine Automatisierung einrichten: 1. Öffnen Sie ein Projekt in der Desktop-App 2. Klicken Sie in der Seitenleiste auf die Registerkarte „Automatisierungen“ 3. Definieren Sie einen Auslöser (Zeitplan, Webhook oder manuell) 4. Schreiben Sie den Prompt und wählen Sie den Ausführungsmodus (lokal oder Worktree) 5. Legen Sie die Reasoning-Stufe für den Automatisierungsdurchlauf fest (App v26.312)⁷² 6. Automatisierungen werden planmäßig ausgeführt und stellen die Ergebnisse zur Überprüfung in eine Warteschlange

Anwendungsbeispiele: - Issue-Triage: Neue Issues automatisch kategorisieren und priorisieren - CI-Überwachung: Build-Fehler überwachen und Korrekturen vorschlagen - Reaktion auf Warnmeldungen: Mit diagnostischen Analysen auf Überwachungswarnungen reagieren - Abhängigkeitsaktualisierungen: Sicherheitspatches suchen und anwenden

Die Ergebnisse werden in einer Prüfwarteschlange zur manuellen Genehmigung angezeigt.

Windows-Unterstützung

Die Codex Desktop App wurde am 4. März 2026 für Windows veröffentlicht (App v26.304) und bietet native PowerShell-Unterstützung, eine native Windows-Sandbox sowie vollständige Funktionsgleichheit einschließlich skills, Automatisierungen und worktrees, ohne dass WSL erforderlich ist.⁶⁶

GitHub Action & CI/CD

Die offizielle GitHub Action integriert Codex in Ihre CI/CD-Pipeline.¹⁸

Grundlegende Verwendung

# .github/workflows/codex.yml
name: Codex
on:
  pull_request:
    types: [opened]

jobs:
  codex:
    runs-on: ubuntu-latest
    outputs:
      final_message: ${{ steps.run_codex.outputs.final-message }}
    steps:
      - uses: actions/checkout@v5
      - name: Run Codex
        id: run_codex
        uses: openai/codex-action@v1
        with:
          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
          prompt-file: .github/codex/prompts/review.md
          sandbox: workspace-write
          safety-strategy: drop-sudo

Konfigurationsoptionen

Ausgabe: final-message, der Text der abschließenden Codex-Antwort für nachgelagerte Schritte/Jobs.

Sicherheitsstrategien

Zugriffskontrollen

with:
  allow-users: "admin,maintainer"     # Limit who can trigger
  allow-bots: false                   # Block bot-triggered runs

Standardmäßig können nur Mitwirkende mit Schreibzugriff Codex-Workflows auslösen.

Codex SDK

Mit dem TypeScript SDK lassen sich die Agent-Funktionen von Codex in benutzerdefinierte Anwendungen integrieren.¹⁹

Installation

npm install @openai/codex-sdk

Grundlegende Verwendung

import { Codex } from "@openai/codex-sdk";

const codex = new Codex();
const thread = codex.startThread();

// Multi-turn conversation
const turn1 = await thread.run("Diagnose CI failures and propose a fix");
console.log(turn1.finalResponse);

const turn2 = await thread.run("Implement the fix and add tests");
console.log(turn2.items);

// Resume a previous session
const resumed = codex.resumeThread("<thread-id>");
await resumed.run("Continue from previous work");

Erweiterte SDK-Funktionen

• runStreamed(...): Asynchroner Ereignisstream für Zwischenaktualisierungen
• Python SDK-Authentifizierung (ab v0.132.0): Anmeldung per API-Schlüssel, ChatGPT-Browser-/Gerätecode-Abläufe, Kontoeinsicht und Abmeldung sind vollwertige SDK-Pfade.⁹⁷
• Komfortfunktion für reine Textdurchläufe (ab v0.132.0): Python-Durchlauf-APIs akzeptieren einfache Zeichenfolgen und geben umfangreichere TurnResult-Metadaten mit gesammelten Elementen, Zeitangaben und Nutzung zurück.⁹⁷
• outputSchema: Erzwingt eine JSON-strukturierte Endausgabe
• Multimodale Eingabe: Text und lokale Bilder übergeben ({ type: "local_image", path: "..." })
• Bild-Workflows (v0.117.0): view_image gibt URLs zurück, generierte Bilder lassen sich erneut öffnen und der Bildverlauf bleibt beim Fortsetzen einer Sitzung erhalten⁷⁵
• Umgebungsübergreifendes view_image (v0.130.0): Bei Sitzungen, die sich über mehrere Umgebungen erstrecken (eingeführt in v0.124.0 mit Umgebungs- und Arbeitsordnerauswahl pro Durchlauf, in v0.125.0 durch persistente Umgebungen verfeinert), löst view_image Dateipfade nun über die ausgewählte Umgebung statt über das lokale Dateisystem des Orchestrators auf. Ein aus einer entfernten Umgebung angehängtes Bild wird relativ zum Arbeitsordner dieser Umgebung abgerufen, nicht relativ zum Host, auf dem das SDK ausgeführt wird.⁹¹

Thread- und Client-Konfiguration

// Custom working directory, skip git check
const thread = codex.startThread({
  workingDirectory: "/path/to/project",
  skipGitRepoCheck: true,
});

// Custom environment and config overrides
const codex = new Codex({
  env: { CODEX_API_KEY: process.env.MY_KEY },
  config: { model: "gpt-5.5" },
});

Sitzungen werden unter ~/.codex/sessions gespeichert.

Laufzeitumgebung: Node.js 18+.

Leistungsoptimierung

Kontextverwaltung

Die Größe des Kontextfensters hängt vom Modell ab. Die aktuelle GPT-5.6-Familie (Sol, Terra, Luna) verwendet ein Fenster von 272K; GPT-5.5, das Flaggschiff der vorherigen Generation, bietet in Codex 400K (1M in der API); GPT-5.4 / GPT-5.4-mini (werden am 31. August 2026 aus Codex entfernt) bieten 1M / 400K; die ältere GPT-5.3-Codex-Familie unterstützte 272K Eingabe + 128K Ausgabe (400K Gesamtbudget). Bei allen füllt sich das Fenster schneller als erwartet – verwalten Sie es vorausschauend:

1. Verwenden Sie regelmäßig /compact: Fasst den Gesprächsverlauf zusammen, um Tokens freizugeben
2. Stellen Sie lokale Dokumentation bereit: Eine hochwertige AGENTS.md und lokale Dokumentation verringern den Erkundungsaufwand, der Kontext verbraucht
3. Hängen Sie mit @ bestimmte Dateien an: Verweisen Sie direkt auf Dateien, statt Codex mit deren Suche zu beauftragen
4. Formulieren Sie gezielte Prompts: Klar abgegrenzte Prompts mit konkreten Dateien verbrauchen weniger Kontext als eine ergebnisoffene Erkundung

Experimentelle Kontextverwaltung (v0.153.0, standardmäßig deaktiviert): features.context_management.experimental_mode aktiviert für geeignete ChatGPT Plus-, Pro- und Pro Lite-Sitzungen mit dem Codex-Backend einen koordinierten Kontextstapel – Kontext mit Token-Budget, Verlaufsnotizen und ein new_context-Tool. Sitzungen mit API-Schlüssel, benutzerdefinierte Anbieter, Nicht-Codex-Endpunkte und temporäre strukturierte Threads sind ausgeschlossen. Da sich die Funktion ausdrücklich noch in Entwicklung befindet, sollten Sie sie als Vorschau auf die künftige Kontextverwaltung betrachten und keine Workflows darauf aufbauen.¹⁴⁰

Token-Effizienz

Geschwindigkeitsoptimierung

1. gpt-5.3-codex-spark: Variante mit geringerer Latenz für interaktive Zusammenarbeit
2. --profile fast: Vorkonfiguriertes gpt-5.6-luna mit geringem Reasoning
3. Parallele Tool-Ausführung: Codex führt unabhängige Lesevorgänge und Prüfungen gleichzeitig aus; strukturieren Sie Prompts so, dass dies möglich ist
4. Ergebnisorientierte Schleifen: Fordern Sie „implementieren, testen, korrigieren und bei erfolgreichem Ergebnis beenden“ statt schrittweiser Anweisungen an

Wie behebe ich Probleme?

Häufige Probleme und Lösungen

Referenz der Fehlermeldungen

Was macht codex doctor?

codex doctor ist der zentrale Befehl, den Sie ausführen sollten, bevor Sie einen Fehler melden oder eine defekte Installation untersuchen. Er erfasst die lokale Laufzeitumgebung, Konfiguration, Authentifizierung, das Terminal, Netzwerk und den Zustand in einem einzigen Bericht. Auch die Issue-Vorlage des Projekts fordert Sie dazu auf, dessen Ausgabe einzufügen.¹⁵³

codex doctor                           # Full human-readable report (the default)
codex doctor --summary                 # Compact view
codex doctor --json                    # Redacted structured JSON, for bug reports
codex doctor --all                     # Expand truncated lists
codex doctor --no-color                # Strip ANSI color

Der Bericht ist in feste Abschnitte gegliedert, sodass Sie direkt zum benötigten Abschnitt springen können:¹⁵³

Jede Prüfung besitzt eine Statusmarkierung – ✓ OK, ✗ fehlgeschlagen, ⚠ Warnung, ○ inaktiv – sowie eine Zusammenfassungszeile. Mit --json erhält jede Prüfung einen stabilen Bezeichner. Dadurch lässt sich die Ausgabe nicht nur visuell prüfen, sondern auch in CI oder einem Supportskript verwenden.¹⁵³

Der Befehl wurde über mehrere Versionen hinweg erweitert: Er erschien in v0.131.0, erhielt in v0.135.0 Berichte zur Umgebung, zu Git, zum Terminal, App-Server und Thread-Inventar und wurde in v0.139.0 um Details zu Editor und Pager ergänzt, wobei vertrauliche Werte in JSON unkenntlich gemacht werden.^96159155

Verwenden Sie den Befehl zuerst, nicht zuletzt. Die meisten Meldungen der Art „Codex funktioniert nicht“ lassen sich auf etwas zurückführen, das doctor bereits benennt: einen veralteten Authentifizierungsmodus, eine config.toml, die nicht geparst werden konnte, oder eine zweite Installation, welche diejenige in Ihrem PATH überschattet.

Diagnose-Tools

codex doctor                           # Full local diagnostic (start here)
codex --version                        # Check CLI version
codex login status                     # Verify authentication
codex mcp list                         # Check MCP server status
codex debug app-server --help          # Debug app server issues

TUI-Diagnose innerhalb der Sitzung:

/status                                # Token/session overview
/debug-config                          # Show config layers and requirement sources
/compact                               # Summarize history to reclaim context

Hinweis: codex --verbose ist kein gültiges Top-Level-Flag. Verwenden Sie stattdessen die oben genannten Debug-Unterbefehle und TUI-Diagnosen.

Saubere Neuinstallation

npm uninstall -g @openai/codex && npm install -g @openai/codex@latest

Dabei bleibt ~/.codex/ mit Authentifizierung, Konfiguration und Sitzungen erhalten. Informationen zum Festlegen einer bestimmten Version, zum Downgrade nach einer fehlerhaften Veröffentlichung oder zum vollständigen Löschen des Zustands finden Sie unter Aktualisieren, Downgrade oder Deinstallieren.

Debug-Modus

codex debug app-server send-message-v2  # Test app-server client

Probleme melden

/feedback                              # Send logs to Codex maintainers (in TUI)

Alternativ können Sie Probleme unter github.com/openai/codex/issues melden.¹

Codex Security [VORSCHAU]

Codex Security startete am 6. März 2026 als Forschungsvorschau und erweiterte den Codex-Stack um kontextbezogene Anwendungssicherheitsprüfungen.⁷⁷ Die Funktion ist über Codex Web für Kunden von ChatGPT Pro, Enterprise, Business und Edu verfügbar.

Funktionsweise: Codex Security analysiert Repositorys, um ein projektspezifisches Bedrohungsmodell zu erstellen, identifiziert Schwachstellen anhand ihrer tatsächlichen Auswirkungen und unterzieht die Ergebnisse in einer Sandbox-Umgebung Belastungstests, um sie zu validieren. Der Agent hebt Ergebnisse mit höherer Konfidenz samt Korrekturen hervor und reduziert so das Rauschen durch unbedeutende Fehler.

Leistung: Während der Forschungsvorschau überprüfte Codex Security 1,2 Millionen Commits und identifizierte 10.561 Schwachstellen mit hohem Schweregrad. Die Präzision verbesserte sich im Laufe der Zeit: Das Rauschen sank um 84 %, überbewertete Schweregrade gingen um mehr als 90 % zurück und die Falsch-positiv-Rate wurde halbiert. Das System hat reale Schwachstellen in OpenSSH, GnuTLS und Chromium gefunden, denen 14 CVEs zugewiesen wurden.⁷⁷

Hinweis: Codex Security ist vom integrierten Sandbox-Sicherheitsmodell von CLI getrennt. Die Sandbox schützt Ihren Computer vor Codex; Codex Security schützt Ihre Codebasis vor Schwachstellen.

Enterprise-Bereitstellung

Administratorkontrollen (requirements.toml)

Administratoren setzen Unternehmensrichtlinien über requirements.toml durch. Diese administrativ erzwungene Konfigurationsdatei schränkt sicherheitsrelevante Einstellungen ein, die Benutzer nicht überschreiben können:²¹

v0.146.0 führt die Erkennung von Enterprise-Tarifen und Administratorkontrollen für In-App-Updates ein.¹¹⁴ In einer verwalteten Geräteflotte entscheidet damit nicht mehr jeder Entwickler selbst, wann er CLI beim Erscheinen einer neuen Version aktualisiert, sondern der Administrator bestimmt den Zeitpunkt der Einführung. Die Versionshinweise kündigen diese Kontrolle an, nennen jedoch nicht den zugehörigen Schlüssel in requirements.toml — betrachten Sie den genauen Einstellungsnamen als unbestätigt, bis OpenAI ihn dokumentiert.

# /etc/codex/requirements.toml

# Restrict which approval policies users can select
allowed_approval_policies = ["on-request", "never"]   # `untrusted` retired in v0.149.0

# Limit available sandbox modes
allowed_sandbox_modes = ["read-only", "workspace-write"]

# Control web search capabilities
allowed_web_search_modes = ["cached"]

# Allowlist MCP servers by identity (both name and identity must match)
[mcp_servers.approved-server]
identity = { command = "npx approved-mcp-server" }

# Admin-enforced command restrictions
[[rules.prefix_rules]]
pattern = [{ token = "rm" }, { any_of = ["-rf", "-fr"] }]
decision = "forbidden"
justification = "Recursive force-delete is prohibited by IT policy"

[[rules.prefix_rules]]
pattern = [{ token = "sudo" }]
decision = "prompt"
justification = "Elevated commands require explicit approval"

Im Gegensatz zur benutzerspezifischen config.toml, in der Präferenzen festgelegt werden, bildet requirements.toml eine verbindliche Einschränkungsebene. Sie begrenzt die Werte, die Benutzer auswählen können, und lässt sich von ihnen nicht überschreiben. Administratorvorgaben können lediglich nachfragen oder etwas verbieten (niemals stillschweigend erlauben).

macOS-MDM-Konfiguration

Verteilen Sie die Konfiguration per MDM über die Einstellungsdomäne com.openai.codex.²¹ Codex unterstützt standardmäßige macOS-MDM-Nutzlasten (Jamf Pro, Fleet, Kandji usw.). Codieren Sie TOML ohne Zeilenumbruch als Base64:

Priorität (von der höchsten zur niedrigsten):

1. Verwaltete macOS-Einstellungen (MDM)
2. Aus der Cloud abgerufene Vorgaben (ChatGPT Business / Enterprise)
3. /etc/codex/requirements.toml (lokales Dateisystem)

Cloud-Vorgaben ergänzen nur noch nicht festgelegte Vorgabefelder, sodass verwaltete Ebenen mit höherer Priorität stets Vorrang haben. Cloud-Vorgaben werden nach Möglichkeit abgerufen; schlägt der Abruf fehl oder tritt eine Zeitüberschreitung auf, wird Codex ohne die Cloud-Ebene fortgesetzt.

OpenTelemetry-Integration

Codex unterstützt die Weitergabe des OpenTelemetry-Trace-Kontexts aus standardmäßigen OTel-Umgebungsvariablen bis zu Aufrufen von OpenAI API. Legen Sie vor dem Start von Codex die standardmäßigen Umgebungsvariablen fest:

# Point Codex at your OTel collector
export OTEL_EXPORTER_OTLP_ENDPOINT="https://otel-collector.internal:4318"
export OTEL_SERVICE_NAME="codex-cli"
export OTEL_RESOURCE_ATTRIBUTES="team=platform,env=production"

# Launch Codex — trace context propagates to all OpenAI API calls
codex

• Standardmäßige OTEL_*-Umgebungsvariablen werden berücksichtigt (Endpunkt, Dienstname, Ressourcenattribute)
• Der Trace-Kontext wird durch Codex bis zu den API-Aufrufen weitergegeben und ermöglicht so eine durchgängige Beobachtbarkeit
• Mithilfe von Ressourcenattributen können Sie Traces nach Team, Umgebung oder Projekt kennzeichnen
• Beachten Sie beim Aktivieren der Protokollierung von Prompts und Tools die Datenschutzanforderungen — Traces können Codeausschnitte enthalten
• Konfigurierbare OpenTelemetry-Trace-Metadaten (ab v0.130.0). Zusätzlich zur standardmäßigen OTEL_RESOURCE_ATTRIBUTES-Hülle stellt die codex-otel-Crate nun konfigurierbare Trace-Metadaten bereit. Dadurch können Administratoren Traces mit organisationsspezifischen Dimensionen (Kostenstelle, Projekt-ID, Ticketreferenz) kennzeichnen, ohne OTEL_RESOURCE_ATTRIBUTES bei jedem Aufruf vollständig neu erstellen zu müssen. Kombinieren Sie dies mit den in derselben Version eingeführten, erweiterten Analysefunktionen für Reviews und Feedback, um Debugging und Triage über CLI-, App-Server- und Remote-Control-Sitzungen hinweg zu vereinheitlichen.⁹¹

Enterprise-Zugriff

• ChatGPT Business / Enterprise / Edu: Von Organisationsadministratoren kontrollierter Zugriff mit automatisch angewendeten, aus der Cloud abgerufenen Vorgaben. Unterstützt SSO über SAML/OIDC mit Ihrem Identitätsanbieter (Okta, Entra ID usw.)
• API: Standardmäßige Authentifizierung und Abrechnung für API sowie Organisations- und Projektkontrollen. OpenAI veröffentlicht SOC-2-Typ-II- und SOC-3-Berichte; für den Enterprise-Tarif ist ein HIPAA BAA verfügbar
• Codex SDK: Integration in interne Tools und Arbeitsabläufe
• Richtliniendurchsetzung im großen Maßstab: Verwenden Sie per MDM verteiltes requirements_toml_base64 oder /etc/codex/requirements.toml auf Dateisystemebene

Datenverarbeitung und Compliance: - Ein- und Ausgaben von API werden gemäß den Bedingungen von OpenAI für Business/Enterprise/API nicht zum Training verwendet - Datenverkehr von OpenAI API wird standardmäßig über eine Infrastruktur in den USA geleitet. Wenden Sie sich bei Anforderungen an eine EU-Datenresidenz an das Enterprise-Vertriebsteam von OpenAI - Sitzungsprotokolle werden lokal gespeichert; nur API-Aufrufe verlassen den Rechner - ChatGPT Enterprise unterstützt Compliance-Frameworks wie SOC 2, GDPR und CCPA

Einführungsstrategie

Empfohlene schrittweise Einführung in Organisationen:

1. Pilotphase (Woche 1–2): Stellen Sie Codex 3–5 erfahrenen Entwicklern bereit. Erzwingen Sie dabei über requirements.toml die read-only-Sandbox mit on-request-Genehmigungen und cached-Websuche. Sammeln Sie Feedback zu AGENTS.md-Mustern und zum Bedarf an MCP-Servern.
2. Teamerweiterung (Woche 3–4): Führen Sie Codex im gesamten Team ein. Verteilen Sie eine einheitliche config.toml für das Team per MDM oder Repository. Aktivieren Sie für vertrauenswürdige Repositorys die workspace-write-Sandbox.
3. CI-Integration (Woche 5–6): Fügen Sie codex-action für automatisierte PR-Reviews und die Testgenerierung zu CI/CD-Pipelines hinzu. Verwenden Sie --ephemeral, damit die Kosten kalkulierbar bleiben.
4. Organisationsweite Einführung (ab Monat 2): Stellen Sie Codex per MDM bereit und erzwingen Sie über requirements.toml genehmigte MCP-Server, Sandbox-Richtlinien und Modellfreigabelisten.

Audit-Muster

Überwachen Sie die Codex-Nutzung und setzen Sie Compliance-Vorgaben durch:

• OpenTelemetry-Traces: Überwachen Sie das Volumen der API-Aufrufe, die Token-Nutzung und die Latenz pro Team
• Sitzungspersistenz: Prüfen Sie ~/.codex/sessions/ im Rahmen von Compliance-Reviews (in sensiblen Kontexten mit --ephemeral deaktivieren)
• MCP-Identitätsdurchsetzung: requirements.toml protokolliert blockierte Serverzugriffsversuche — prüfen Sie diese auf eine unautorisierte Tool-Nutzung
• Git-Audit-Trail: Alle Dateiänderungen durch Codex durchlaufen das standardmäßige git — prüfen Sie sie anhand des Branch-Verlaufs und der PR-Diffs

Bewährte Verfahren und Anti-Patterns

Prompt-Muster

1. Einschränkungsorientierte Prompts: Beginnen Sie mit den Grenzen. „Ändern Sie NICHT die API-Verträge. Refaktorieren Sie ausschließlich die interne Implementierung.“
2. Strukturierte Reproduktionsschritte: Nummerierte Schritte führen zu besseren Fehlerbehebungen als vage Beschreibungen
3. Verifizierungsanfragen: Schließen Sie mit „Führen Sie den Linter und die kleinste relevante Testsuite aus. Nennen Sie die Befehle und Ergebnisse.“
4. Dateiverweise: Verwenden Sie @filename, um bestimmte Dateien an den Kontext anzuhängen
5. Ergebnisorientierte Schleifen: „Implementieren Sie die Änderung, führen Sie die Tests aus, beheben Sie Fehler und stoppen Sie erst, wenn alle Tests bestanden wurden.“ Codex iteriert bis zum Abschluss

Testphilosophie

In der Community herrscht weitgehend Einigkeit über eine testgetriebene Zusammenarbeit mit KI:²²

• Definieren Sie Tests vorab als Abschlusssignale
• Lassen Sie Codex iterieren, bis die Tests bestanden wurden (Rot → Grün → Refaktorieren)
• Übernehmen Sie Programmiermuster im Tiger Style
• Geben Sie bei Patch-Anfragen den exakten Dateiinhalt an. Codex verwendet strikte Übereinstimmungen und kein unscharfes AST-basiertes Patching

Bewährte Verfahren für die Kontextverwaltung

• Stellen Sie hochwertige lokale Dokumentation bereit, statt sich auf die Websuche zu verlassen
• Pflegen Sie strukturiertes Markdown mit Inhaltsverzeichnissen und Fortschrittsdateien („progressive disclosure“)
• Vereinheitlichen Sie die Zeilenenden (LF oder CRLF) in allen versionierten Dateien, um Patch-Fehler zu vermeiden
• Halten Sie AGENTS.md knapp, da lange Anweisungen aus dem Kontext verdrängt werden

Git-Workflow

• Erstellen Sie stets einen neuen Branch, bevor Sie Codex in unbekannten Repositorys ausführen
• Verwenden Sie Patch-basierte Workflows (git diff / git apply) statt direkter Änderungen
• Prüfen Sie Vorschläge von Codex wie PRs bei einem Code-Review
• Überprüfen Sie Änderungen vor dem Commit mit /diff

Community-skills und Prompts

Das Repository feiskyer/codex-settings bietet von der Community gepflegte Konfigurationen:²³

Wiederverwendbare Prompts (in ~/.codex/prompts/): - deep-reflector: Erkenntnisse aus Entwicklungssitzungen extrahieren - github-issue-fixer [issue-number]: Systematische Fehleranalyse und PR-Erstellung - github-pr-reviewer [pr-number]: Code-Review-Workflows - ui-engineer [requirements]: Frontend-Entwicklung auf Produktionsniveau

Community-skills: - claude-skill: Aufgaben mit Berechtigungsmodi an Claude Code übergeben - autonomous-skill: Sitzungsübergreifende Aufgabenautomatisierung mit Fortschrittsverfolgung - deep-research: Parallele Orchestrierung von Teilaufgaben - kiro-skill: Pipeline von Anforderungen → Design → Aufgaben → Ausführung

Anti-Patterns

Häufige Fehler, die Token verschwenden, schlechte Ergebnisse hervorbringen oder frustrierende Workflows verursachen.

Kostenbezogene Anti-Patterns

Kontextbezogene Anti-Patterns

Workflow-Anti-Patterns

Prompt-Anti-Patterns

Workflow-Rezepte

Durchgängige Muster für häufige Entwicklungsszenarien.

Rezept 1: Einrichtung eines neuen Projekts

mkdir my-app && cd my-app && git init
codex

> Create a FastAPI project with: main.py, requirements.txt, Dockerfile,
  basic health endpoint, and a README. Use async throughout.

> /init

Prüfen Sie die generierte AGENTS.md, passen Sie sie an Ihre Konventionen an und führen Sie anschließend Folgendes aus:

> Run the health endpoint test and confirm it passes

Rezept 2: Täglicher Entwicklungsablauf

cd ~/project && git checkout -b feature/user-auth
codex

> @src/models/user.py @src/api/auth.py
  Add password reset functionality. Requirements:
  1. POST /api/auth/reset-request (email → sends token)
  2. POST /api/auth/reset-confirm (token + new password)
  3. Tests for both endpoints
  Run tests when done.

Prüfen Sie die Änderungen mit /diff und erstellen Sie anschließend den Commit.

Rezept 3: Komplexes Refactoring im Plan-Modus

codex

> /plan Migrate the database layer from raw SQL to SQLAlchemy ORM.
  Constraints: don't change any API contracts, keep all existing tests passing.

Prüfen Sie den Plan. Genehmigen oder steuern Sie ihn:

[Tab] Also add a migration script using Alembic

Nachdem Codex den Plan ausgeführt hat, überprüfen Sie das Ergebnis:

> Run the full test suite and report results
> /diff

Rezept 4: PR-Review mit codex exec

codex exec --model gpt-5.6-luna \
  "Review the changes in this branch against main. \
   Flag security issues, missed edge cases, and style violations. \
   Format as a markdown checklist." \
  -o review.md

Rezept 5: Debugging mit Cloud Tasks [EXPERIMENTAL]

codex cloud exec --env my-env "Diagnose why the /api/orders endpoint returns 500 \
  for orders with > 100 line items. Check the serializer, database query, \
  and pagination logic. Propose a fix with tests."