Codex CLI: Das umfassende technische Referenzhandbuch

TL;DR: Codex ist ein Coding-Agent für mehrere Oberflächen: Er liest Ihre Codebasis, führt Befehle in einer Sandbox auf Betriebssystemebene aus, patcht Dateien 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 Kraftmultiplikator. Welches Modell: Die Modelldokumentation von OpenAI empfiehlt inzwischen GPT-6 Sol (gpt-6-sol, seit v0.156.1 in der CLI-Modellauswahl) für alltägliche und komplexe Programmieraufgaben, GPT-6-Astra für die anspruchsvollsten End-to-End-Aufgaben (weiterhin der mitgelieferte Standard der CLI, wenn kein Modell festgelegt ist) und GPT-6 Luna für klar umrissene Aufgaben mit hohem Volumen. Die Verfügbarkeit hängt vom Tarif, den Arbeitsbereichseinstellungen und der schrittweisen Einführung ab; die GPT-5.6-Modelle bleiben vorerst verfügbar. GPT-5.5 wird am 14. Oktober 2026 für die Anmeldung bei Codex über ChatGPT eingestellt.¹⁴⁶¹⁷¹ Neu hier? Springen Sie direkt zu Installation und Schnellstart. Verfolgen Sie die Veröffentlichungen? Die neueste stabile Version ist v0.157.1 (26. September 2026); die Versionshighlights beginnen mit einer Zusammenfassung des aktuellen Stands (was standardmäßig aktiviert und was noch experimentell ist) und behandeln anschließend jede Version. Das Änderungsprotokoll führt sämtliche Aktualisierungen des Leitfadens auf.¹¹⁶¹⁷⁴

Codex arbeitet als Coding-Agent für mehrere Oberflächen, nicht als Chatbot, der Code schreibt. Die CLI liest Ihre Codebasis, führt Befehle in einer Sandbox aus, patcht Dateien, 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 unterstützt je nach Ihrer Arbeitsweise fünf unterschiedliche Oberflächen, darunter die Browsererweiterung für Chrome, Edge, Brave, Opera und Vivaldi, mit der Codex in Ihrem Browser ausgeführt wird, ohne diesen zu übernehmen.⁹⁰¹²⁷

Der Unterschied zwischen gelegentlicher und effektiver Codex-Nutzung liegt in fünf Kernsystemen. Beherrschen Sie diese, wird Codex zum Kraftmultiplikator:

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 Teamarbeitsabläufen eingesetzt. Dieser Leitfaden verdichtet diese Erfahrungen zu der vollständigen Referenz, die ich mir zu Beginn gewünscht hätte. Jede Funktion enthält die tatsächliche Syntax, praxisnahe Konfigurationsbeispiele und jene Grenzfälle, an denen selbst erfahrene Benutzer scheitern.

Wichtigste Erkenntnisse

• Fünf Oberflächen, ein Gehirn: CLI, Desktop-App, IDE-Erweiterung, Cloud-Aufgaben und Browser-Erweiterung (für Chrome, Edge, Brave, Opera und Vivaldi) nutzen alle dieselbe Modellfamilie. Wählen Sie daher die Oberfläche, die am besten zu Ihrem Arbeitsablauf passt.⁹⁰
• Sandboxing auf Betriebssystemebene: Codex setzt Datei- und Netzwerkbeschrä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 reduzieren den Aufwand für Kontextwechsel: Definieren Sie benannte Konfigurationsvorgaben (fast, careful, auto) und wechseln Sie mit --profile zwischen ihnen.
• Kontextverwaltung ist entscheidend: Der integrierte Codex-Katalog stellt GPT-6 Astra, Sol und Luna sowie der GPT-5.6-Familie ein Kontextfenster von 272K bereit (der API führt GPT-6 Sol und Luna mit 1,05M auf); GPT-5.5 bietet in Codex 400K, bis es dort am 14. Oktober 2026 eingestellt wird. Verwalten Sie Ihr Token-Budget vorausschauend mit /compact, präzisen Prompts und @file-Referenzen.⁸³¹¹²

So verwenden Sie diesen Leitfaden

Dieser Leitfaden umfasst mehr als 3.300 Zeilen – beginnen Sie an der Stelle, die Ihrem Erfahrungsstand entspricht:

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

Release-Highlights: Was sich zuletzt geändert hat

Die Versionshistorie in absteigender Reihenfolge richtet sich an Leser, die den Release-Zyklus von Codex verfolgen. Neu hier? Springen Sie zum Schnellstart; die folgenden Informationen benötigen Sie nicht, um produktiv zu arbeiten. Details zur Verifizierung (Vergleiche, Commit-Listen, Dokumentationsprüfungen) finden Sie in den Fußnoten.

Aktueller Stand

Codex CLI mit Stand vom 26. September 2026

• Stable: v0.157.1, veröffentlicht am 26. September (npm latest), ein Windows-Patch auf Grundlage von v0.157.0 (25. September).
• Alpha: npm alpha ist 0.159.0-alpha.4. Für die 0.158-Reihe gab es kein Stable-Release.
• Seit v0.157.0 standardmäßig aktiviert: das Vollbildtranskript, der automatische Start des Hintergrundservers und der Guardian-Thread-Kontext. Um eine dieser Funktionen zu deaktivieren, setzen Sie fullscreen_transcript = false unter [tui], daemon_auto_start = false unter [features] (oder starten Sie mit --no-daemon) beziehungsweise thread_context = false unter [features.guardianv2].
• Seit v0.156.0 standardmäßig aktiviert: /voice, verwaltete worktrees und die Wiederverwendung der übergeordneten Guardian-Kompaktierung ([features]-Schlüssel realtime_conversation, worktrees, guardian_reuse_parent_compaction).
• Weiterhin optional oder experimentell: experimentelle Kontextverwaltung, Codex Cloud und Code-Modus.
• Modelle: GPT-6 Sol (gpt-6-sol) für alltägliche und komplexe Programmieraufgaben, GPT-6-Astra für die anspruchsvollsten End-to-End-Aufgaben (weiterhin der integrierte Standard von CLI, wenn kein Modell festgelegt ist) und GPT-6 Luna für Aufgaben mit hohem Volumen. GPT-5.5 wird am 14. Oktober 2026 aus Codex für die ChatGPT-Anmeldung entfernt.
• Versionsfixierung: npm install -g @openai/codex@0.157.1; bestätigen Sie die Version anschließend mit codex --version.¹⁷⁴¹⁷⁵

v0.157.1 (26. September 2026)

Ein Windows-Patch mit vier aus dem Hauptentwicklungszweig zurückportierten Korrekturen. Codex öffnet beim Start des Code-Modus-Hosts oder eines lokalen stdio-MCP-Servers kein Konsolenfenster mehr. Der Hintergrundserver kann nun starten, wenn Windows den Prozess innerhalb eines äußeren Jobobjekts belässt. Außerdem hält ein abgekoppelter Hintergrundserver die Ausgabepipes des Startprogramms nicht mehr offen, was zuvor dazu führen konnte, dass der aufrufende Befehl nach Beendigung des Startprogramms weiter wartete. In den GitHub-Versionshinweisen und im Changelog-Eintrag heißt es lediglich, dass die Highlights „nicht ermittelt werden konnten“; die obige Liste stammt aus den Commits des Releases.

Was Sie tun sollten: Führen Sie ein Upgrade durch, wenn Sie Codex unter Windows verwenden. Die vier Korrekturen betreffen ausschließlich Windows.¹⁷⁴

v0.157.0 (25. September 2026)

Dieses Release aktiviert drei weitere Funktionen standardmäßig.

• Das Vollbildtranskript ist standardmäßig aktiviert. Die Vollbildoberfläche, die v0.156.0 über /tui anbot, wird nun beim Öffnen einer Sitzung verwendet – auch wenn die Konfiguration keinen Abschnitt [tui] enthält. Um den Terminal-Scrollback beizubehalten, wählen Sie in /tui die Option „Scrollback“ oder setzen Sie fullscreen_transcript = false unter [tui]; --no-alt-screen und tui.alternate_screen = "never" haben weiterhin Vorrang. Mit Umschalttaste-Klick lässt sich jetzt eine Transkriptauswahl erweitern.
• Der Hintergrundserver startet automatisch bei geeigneten interaktiven Starts; die Option befindet sich nicht mehr unter /experimental. Starts mit --no-daemon, --oss, --profile oder den meisten -c-Überschreibungen verwenden ihn nicht. Stimmen die Einstellungen eines laufenden Servers nicht mit der Sitzung überein, bietet Codex an, die Sitzung ohne ihn auszuführen, ihn mit den erforderlichen Einstellungen neu zu starten oder den Vorgang abzubrechen (Standardoption). Um den automatischen Start zu deaktivieren, setzen Sie daemon_auto_start = false unter [features].
• Der Guardian-Thread-Kontext ist standardmäßig aktiviert – sowohl für synchrone als auch für asynchrone Reviews und unabhängig vom Guardian-v2-Schalter enabled. Um ihn zu deaktivieren, setzen Sie thread_context = false unter [features.guardianv2].

Modelle: GPT-6 Sol und Luna, die erstmals mit v0.156.1 ausgeliefert wurden, sind ebenfalls in diesem Release enthalten. Auch die Amazon-Bedrock-Kataloge führen sie nun, wobei GPT-6 Sol GPT-5.6 Sol als Bedrock-Standard ersetzt. Für GPT-5.6 Sol entfällt die Dienststufe ultrafast, sodass nur Fast verbleibt. Der integrierte Katalog weist GPT-6-Astra nicht mehr als Modell mit Unterstützung für die experimentelle Kontextverwaltung aus (siehe Kontextverwaltung).

Ebenfalls neu: Mit dem Tastenkürzel f lässt sich eine in einer anderen App geöffnete Unterhaltung abspalten, wobei Entwürfe und eingereihte Prompts erhalten bleiben; /import funktioniert in Remote- und Hintergrundserversitzungen; und das Terminal stellt Unicode-Aufzählungszeichen, Kontrollkästchen und ausgerichtete Gleichungen dar. Korrekturen sorgen dafür, dass Sprachunterhaltungen beim Wechseln zwischen Threads weiterlaufen, nicht gesendete Antworten nach dem Ende eines Durchlaufs wiederhergestellt werden, tmux-Mauseinstellungen berücksichtigt werden, Echtzeitverbindungen und eigenständige Websuchen über konfigurierte Proxys geleitet werden, vorübergehende Fehler bei Datei-Uploads mit einem Timeout von fünf Minuten erneut versucht werden und Netzwerkeinschränkungen auch bei Weiterleitungen sowie offenen HTTP- und WebSocket-Verbindungen gelten. Unter Windows ist der Zugriff auf Sandbox-Objekte auf die Anmeldesitzung des Runners beschränkt.¹⁷⁴

v0.156.1 (23. September 2026)

Ein Patch mit einer einzigen Änderung, der GPT-6 Sol und GPT-6 Luna in die Stable-Version von CLI bringt. Beide erscheinen nun in der /model-Auswahl unter GPT-6-Astra, das weiterhin an erster Stelle steht und der integrierte Standard bleibt, wenn in config.toml kein Modell festgelegt ist. Die GPT-5.6-Familie wird in der Auswahl nun als ältere Modelle bezeichnet (bei GPT-5.6 Sol steht „Älteres Programmiermodell für komplexe Aufgaben“), GPT-5.5 als „Legacy-Programmiermodell“. Wenn Sie sich einem Ratenlimit nähern, schlägt die Aufforderung zum Modellwechsel jetzt gpt-6-luna statt gpt-5.6-luna vor.

Wenn Ihre Konfiguration ein älteres Modell angibt, erscheint einmalig eine Aufforderung zur Migration: Gespeicherte Auswahlen von gpt-5.6-sol, gpt-5.6-terra, gpt-5.5 und gpt-5.4 verweisen auf GPT-6 Sol; gpt-5.6-luna und gpt-5.4-mini verweisen auf GPT-6 Luna. Die Amazon-Bedrock-Kataloge ändern sich in diesem Release nicht: GPT-6 Sol und Luna sind dort nicht enthalten, und GPT-5.6 Sol bleibt der Bedrock-Standard.

Ein Kostendetail, das in der Dokumentation nicht erwähnt wird: Der integrierte Katalog legt Fast (priority) als Standarddienststufe für GPT-6 Sol und Luna fest. Deshalb kann eine TUI-Sitzung ohne gesetztes service_tier im Fast-Modus starten, den die ChatGPT-Anmeldung mit dem 2,5-Fachen der Standard-Credits abrechnet. Prüfen Sie dies mit /fast status; /fast off wechselt zu Standard.

Was Sie tun sollten: Führen Sie ein Upgrade durch und testen Sie anschließend codex -m gpt-6-sol mit einer vertrauten Aufgabe. Die Verfügbarkeit hängt von Ihrem Tarif, den Workspace-Einstellungen und dem Rollout ab; Enterprise-Administratoren müssen die neuen Modelle zunächst aktivieren.¹⁷¹

v0.156.0 (22. September 2026)

Dieses Release aktiviert drei Funktionen gleichzeitig standardmäßig; die ersten beiden wurden am selben Tag im Dokumentations-Changelog angekündigt.

• Voice ist standardmäßig aktiviert. /voice startet auf unterstützten Builds eine Live-Unterhaltung, ohne dass Sie zuvor /experimental aufrufen müssen. Ebenfalls neu: eine konfigurierbare F8-Umschaltung, eine /voice settings-Auswahl für die in künftigen Unterhaltungen verwendete Stimme, integrierte Voice-Runtimes für Linux und Windows sowie Unterstützung für reduzierte Bewegung.
• Verwaltete worktrees sind standardmäßig aktiviert. --worktree und /worktree benötigen kein Feature-Flag mehr. Worktree-Sitzungen können sich mit einem vorhandenen lokalen Daemon verbinden und über die Agentenübersicht erstellt werden.
• Die Wiederverwendung der übergeordneten Guardian-Kompaktierung ist standardmäßig aktiviert: Wenn Guardian eine Review-Sitzung neu startet, kann die verschlüsselte Kompaktierung des übergeordneten Threads wiederverwendet werden.

Wie Sie die einzelnen Funktionen deaktivieren, erfahren Sie in den Zeilen zu /voice und /worktree in der Tabelle der slash commands sowie im Guardian-Abschnitt.

Ebenfalls neu: eine optionale Vollbild-TUI, die über /tui ausgewählt wird und Transkriptsuche, Auswahl und Kopieren per Maus, Kopieren per Rechtsklick, anklickbare Links sowie eine Warnungsansicht bietet; sechs integrierte Themes in der /theme-Auswahl; das Analysedashboard /usage; im Terminal dargestellte Mermaid-Diagramme und TeX-Mathematik mit jeweils eigenem Schalter; ein /daemon-Menü und ein Flag --no-daemon; außerdem sind Reasoning-Zusammenfassungen für neue TUI-Threads standardmäßig deaktiviert. Sicherheitskorrekturen schließen Sandbox-Lücken unter Windows bei eingehendem Datenverkehr, privilegierten Sockets und schreibgeschützten Datei-Handles; zudem gibt codex doctor in seinen Fehlermeldungen keine Konfigurationswerte mehr aus. Fehlerkorrekturen bewahren gestreamte Antworten nach fehlgeschlagenen oder unterbrochenen Durchläufen, reparieren die Zwischenablageweiterleitung in tmux und SSH, stellen den Plan-Modus beim Fortsetzen wieder her und ermöglichen die Wiederherstellung der Anmeldung über System-Proxys.¹⁶⁹

v0.155.1 (18. September 2026)

Ein Hotfix mit einer einzigen Korrektur. Unter 0.155.0 forderte ein neuer lokaler TUI-Thread ohne model_reasoning_summary in der Konfiguration detailed-Zusammenfassungen an. Anbieter, die keine Reasoning-Zusammenfassungen unterstützen, lehnten die Anfrage daraufhin vollständig ab. 0.155.1 stellt none als Rückfallwert wieder her, sodass bei einem nicht gesetzten Schlüssel keine Zusammenfassungen angefordert werden. Explizite Einstellungen für auto, concise und detailed wurden stets berücksichtigt und werden es weiterhin. Dieselbe einzeilige Änderung wurde auch in den Hauptentwicklungszweig übernommen und mit 0.156.0 ausgeliefert.

Was Sie tun sollten: Wenn neue TUI-Sitzungen unter 0.155.0 bei einem Nicht-OpenAI- oder selbst gehosteten Anbieter fehlgeschlagen sind, führen Sie ein Upgrade durch. Wenn Sie Zusammenfassungen wünschen, setzen Sie den Schlüssel ausdrücklich (siehe Konfigurationsreferenz).¹⁵⁸

v0.155.0 (17. September 2026)

Voice hielt als experimentelle, optionale Funktion Einzug in die Stable-TUI: /voice öffnete auf unterstützten Builds eine Live-Unterhaltung mit Streaming-Transkript und Mikrofonsteuerung, die über /experimental aktiviert wurde. Hinzu kamen ein konfigurierbares Tastenkürzel zum Stummschalten und signierte Voice-Ressourcen in den macOS-Paketen. Fünf Tage später aktivierte v0.156.0 die Funktion standardmäßig. Verwaltete worktrees blieben in diesem Release standardmäßig deaktiviert.

Ebenfalls in 0.155.0:

• MCP-Benutzerverifizierung: Touch-ID-Verifizierung von MCP-Anfragen, signiert durch die Secure Enclave, in lokalen TUI-Sitzungen auf unterstützten Macs, einschließlich einer auf den Workspace beschränkten Identität und nativer Verifizierung bei der Fortsetzung von MCP-Tools.
• Der Windows-slash command /sandbox-add-read-dir wurde entfernt.
• Worktree-Verwaltung: Blenden Sie Worktree-Sitzungen in der Agentenübersicht aus, archivieren oder löschen Sie sie, zeigen Sie Eigentümerdetails an und bestätigen Sie das Löschen eines sauberen verwalteten worktree.
• Live-Reasoning-Zusammenfassungen werden in der TUI-Statuszeile gestreamt; abgeschlossene Arbeiten erhalten Abschlusszeitstempel.
• Daemon: konfigurierbare Aktualisierungszeitpläne, ein Befehl codex app-server daemon update und die Wiederherstellung von Threads nach Daemon-Neustarts.
• Amazon-Bedrock-Befehle für AWS-Anmeldedaten sowie eine an Stable-Releases von CLI angeglichene Veröffentlichung der Python-SDK.

Sicherheitskorrekturen schließen WSL-Interop-Ausbrüche und verhindern die Offenlegung von Anmeldedaten durch Shell-Snapshots. Memory v2 wird lediglich als Grundlage für Speicherung und Konsolidierung eingeführt, nicht als nutzbare Funktion.¹⁵⁶

v0.154.0 (9. September 2026)

Dieses Release wurde ungefähr auf dem Stand von 0.154.0-alpha.6 erstellt. Daher wurden alle Funktionen, die erstmals in alpha.7 erschienen – Live-TUI-Voice, MCP-Benutzerverifizierung, Memory v2, Konfiguration automatischer Daemon-Aktualisierungen und Fixierung des Reasoning-Aufwands – auf 0.155 verschoben.

Entfernt: codex mcp-server und die eigenständige Binärdatei codex-mcp-server. Migrieren Sie Integrationen zum App-Server-Protokoll oder zum Codex-Plugin für Claude Code; codex mcp, das Codex mit externen MCP-Servern verbindet, ist davon nicht betroffen (siehe Codex ALS MCP-Server ausführen). Auch die alten Guardian-Pfade für Genehmigungs-Reviews wurden entfernt. Zudem werden Genehmigungen jetzt abgelehnt, wenn neue Benutzeranweisungen sie ungültig machen.

Neu:

• Experimentelle verwaltete worktrees über --worktree oder /worktree, mit Unterstützung für codex exec und einem TUI-Worktree-Browser.
• Asynchrone Benutzernachrichten: Beantworten Sie Inline-Fragen, während Codex weiterarbeitet, ohne Ihren Entwurf zu verlieren.
• Unterstützung für Windows-Dienste: Sandbox-Bereitstellung, der App-Server-Daemon unter Windows und verwaltete Daemon-Aktualisierungen.
• Remote-Berechtigungsprofile, die vom App-Server erkannt und in der TUI anhand ihres Namens ausgewählt werden können.
• Vim-Ersetzungsmodus R, Live-Status der Kontextkompaktierung und experimentelle Kontextverwaltung, die beim Sitzungsstart anhand der Modellfunktionen freigeschaltet wird.

Sicherheit: PATH-Hilfsprogramme werden nicht mehr ausgeführt, bevor das Vertrauen in den Workspace hergestellt wurde, und die macOS-Sandbox ist gegen die Einschleusung von Terminaleingaben gehärtet. MCP-Verbindungen koordinieren die Aktualisierung von OAuth-Tokens, beim Remote-Fortsetzen und -Abspalten bleiben gespeicherte Berechtigungen erhalten, und beim Fortsetzen einer in einer anderen App geöffneten Unterhaltung wird ein schreibgeschütztes Transkript angezeigt. Voice wurde lediglich als Laufzeitinfrastruktur ausgeliefert, und die ersten Daybreak-Codeverweise erschienen ohne öffentliche Dokumentation.¹⁵²¹⁵³

v0.153.3 und v0.153.4 (4. September 2026)

Patches vom selben Tag, die den Start von GPT-6-Astra in CLI überführten. v0.153.3 nahm Astra in die Amazon-Bedrock-Kataloge auf (GPT-5.6 Sol blieb der Bedrock-Standard) und korrigierte Astras Anleitung für asynchrone Rückfragen. v0.153.4 fügte Astra der Modellauswahl hinzu, machte es zum integrierten Standard, wenn kein Modell konfiguriert ist, und präzisierte die Anleitung zu asynchronen Fragen abhängig von der Tool-Verfügbarkeit.

Was Sie tun sollten: Astra funktioniert ab v0.153.1 mit -m gpt-6-astra und erscheint ab v0.153.4 in der Auswahl. Da keine Mindestversion von CLI dokumentiert ist, sollten Sie diese Versionen als Untergrenzen betrachten. Wenn Ihr Konto nicht zur Nutzung des vom integrierten Standard ausgewählten Modells berechtigt ist, setzen Sie model ausdrücklich in config.toml, statt sich auf den Standard zu verlassen.^145146147148

v0.153.1 und v0.153.2 (3. September 2026)

v0.153.1 sorgt dafür, dass Guardians Computer-Use-Bewertung die Modellanforderungen berücksichtigt: Ausschließlich für Computer Use bestimmte Bewertungen und schnelle Genehmigungsentscheidungen werden nur ausgeführt, wenn die Metadaten des aktiven Modells node_repl_auto_review_required setzen. Ein Modellwechsel, bei dem die Bewertung übersprungen wird, macht vorherige oder laufende Bewertungen ungültig, sodass sie durch einen späteren Rückwechsel nicht wieder als veraltete Genehmigung aktiviert werden können. Im Release-Text wird lediglich ein zurückportierter GPT-6-Astra-Katalogeintrag aufgeführt, der über API konfiguriert werden kann; Auswahl und Standard änderten sich erst mit v0.153.4. v0.153.2 korrigiert die Beschreibung der Astra-Fast-Stufe von „1,5-fach“ zu „2-fache Geschwindigkeit, höhere Nutzung“ (nur Anzeigetext).¹⁴²¹⁴³

v0.153.0 (3. September 2026)

• Vim-Rückgängig und -Wiederholen: u und Ctrl+R stellen vollständige Composer-Entwürfe einschließlich eingefügter Inhalte und Bildanhänge wieder her; vim_normal.redo ist eine konfigurierbare Tastenzuordnungsaktion.
• Remote-Plugin-Marktplätze: Der Plugin-CLI kann Remote-Plugins auflisten, installieren und entfernen; codex plugin list zeigt Quelle, Version, Installationsrichtlinie und Authentifizierungsrichtlinie an.
• tui.auto_recap = false deaktiviert automatische Zusammenfassungen; das manuelle /recap funktioniert weiterhin.
• Frühere Ratenlimitwarnungen für Plus und Team, wenn in einem Zeitfenster von ungefähr fünf Stunden weniger als die Hälfte des Kontingents verbleibt; für andere Tarife gelten weiterhin die Schwellenwerte von 75/90/95 %.
• Der Guardian-Umfang folgt dem Genehmigungsmodus: Full Access überspringt Guardian-Reviews für Aktionen, die lediglich eine Bestätigung erfordern, und der Benutzergenehmigungsmodus überspringt Hintergrundbewertung und Vorwärmung.
• features.context_management.experimental_mode (standardmäßig deaktiviert) aktiviert Token-Budget-Kontext, Verlaufsnotizen und das Tool new_context für geeignete Plus-, Pro- und Pro-Lite-Sitzungen im Codex-Backend.
• tui.disable_paste_burst ersetzt den Schlüssel auf oberster Ebene, der weiterhin als Rückfalloption funktioniert.

Korrekturen: TUI-Sitzungen stellen nach einem Abbruch der App-Server-Verbindung die Verbindung wieder her, ohne dass Entwürfe verloren gehen; der Guardian-Review-Verlauf bleibt über Kompaktierungen, Neustarts und Abspaltungen hinweg erhalten; und gespeicherte MCP-Genehmigungen sind auf das ausgewählte Konto beschränkt.¹⁴⁰

v0.152.0 und v0.152.1 (1. September 2026)

update_plan wurde optional: tools.update_plan.enabled ist standardmäßig false. Solange die Funktion deaktiviert ist, wird die integrierte Anleitung zu update_plan aus den Prompts für Modell, Kollaborationsmodus, Multi-Agent, Kompaktierung, Vorwärmung und Zielfortsetzung entfernt (siehe Plan-Modus und Zusammenarbeit). Ebenfalls neu: Vim-Suche mit / und ? sowie n/N, kombinierbar mit Operatoren, wobei neue Entwürfe im Insert-Modus beginnen; handlungsorientierte Ratenlimitbanner; Fortschrittsanzeigen bei der Aktualisierung von Anmeldedaten einschließlich erneuter Amazon-Bedrock-Authentifizierung; MCP-Servernamen im Paketstil (:, @, / und . sind zulässig); MCP-Formularanfragen vom Typ openai/elicitation; ein MCP-output_token_limit pro Tool; auf vertrauenswürdige Ursprünge beschränkte Anmeldedaten für Cloud-Aufgaben; konfigurierbare Timeouts für thread/shellCommand; und standardmäßig über Modellmetadaten aktivierte Token-Budgetierung. Mit v0.152.1 kann Guardian Review seine Node-REPL-Richtlinie aus Modellmetadaten beziehen.¹³⁸¹³⁹

v0.151.0 (29. August 2026)

• /recap fasst die Unterhaltung bei Bedarf zusammen; geeignete inaktive und nicht fokussierte Unterhaltungen werden von Codex automatisch zusammengefasst.
• Code-Modus-Hosts unterstützen den WebSocket-Transport nicht mehr (nur stdio und gRPC).
• Dauerhafte Threads verwenden standardmäßig einen paginierten Verlauf, sofern der Speicher dies unterstützt.
• Der Reasoning-Aufwand persistent wird zusammen mit Uhrzeit-Tools und integrierter Proaktivitätsanleitung eingeführt.
• Guardian v2 verwendet standardmäßig Computer-Use-Reviews mit Bildern.
• Vim erhält die Suchbewegungen f/F/t/T sowie gg/G.
• Eingaben in Terminals mit erweiterten Berechtigungen können eine erneute Genehmigung erfordern (write_stdin_approval, standardmäßig deaktiviert).
• Eine konfigurierbare Karenzzeit für optionale MCP-Server (mcp_optional_startup_grace_ms, Standardwert 1.000 ms); Erweiterungen können außerdem Ergebnisse von MCP-Tools prüfen oder ersetzen.

Korrekturen verhindern, dass /cd Sandbox-Einschränkungen abschwächt und veraltete Guardian-Klassifizierungen nach Berechtigungsänderungen Aktionen autorisieren. Im Release-Text werden nur die letzten PRs aufgeführt; der vollständige Änderungssatz ist im Vergleich enthalten.¹³⁴¹³⁵

v0.150.0 und v0.150.1 (26.–27. August 2026)

hooks erhalten ein Interrupt-Ereignis, das ausgeführt wird, wenn ein aktiver Durchlauf auf oberster Ebene unterbrochen wird (standardmäßig 1 Sekunde Timeout, maximal 3 Sekunden, niemals für Subagenten). /copy öffnet eine Auswahl für die vollständige Antwort, einzelne Codeblöcke oder Blockzitate. Aufgaben können mit @-Erwähnungen adressiert werden, Agenten können Aufgaben lesen, erstellen und ihnen Nachrichten senden, und /rename schlägt einen bearbeitbaren Titel vor. Markdown-Links werden als anklickbare Beschriftungen dargestellt, Tastenkürzel können zwischen Berechtigungsmodi wechseln, Vim erhält die Wiederholungsfunktion ., und nicht vertrauenswürdige Projekte stellen keine AGENTS.md-Anweisungen auf Projektebene mehr bereit. features.network_proxy.credential_broker und Guardians-v2-Option review_scope.computer_use_only werden als konfigurierbare, standardmäßig deaktivierte Funktionen eingeführt. v0.150.1 berücksichtigt beibehaltene Bilder im Token-Budget der Remote-Kompaktierung.¹³²¹³³

v0.149.0 und v0.149.1 (20.–24. August 2026)

Die Genehmigungsrichtlinie untrusted wird eingestellt; ändern Sie Konfigurationen, die sie verwenden, auf on-request. Neu: ein interaktives Dashboard codex agents, /cd, /pwd und /cwd, codex queue zum Senden von Nachrichten an vorhandene lokale oder Remote-Sitzungen, weitere Vim-Änderungsbewegungen, ein umfassenderes codex doctor (Endpunktschutz, Netzwerk- und Proxyfehler, Status der Desktop-App, Verbindung zu Aktualisierungsdiensten) sowie die Reasoning-Aufwände max/ultra in den SDKs. Fortgesetzte und abgespaltene Threads stellen ihr Berechtigungsprofil wieder her. v0.149.1 ergänzt codex exec --thread-source <SOURCE> (user, subagent, memory_consolidation oder ein Funktionsname; threadSource im TypeScript-SDK).

Preise im selben Zeitraum: OpenAI senkte die Preise von GPT-5.6 Sol ab dem 21. August für drei Monate um mehr als 20 % (mindestens bis zum 21. November 2026). Zugleich sank der Codex-Credit-Satz für Sol von 125/12,5/750 auf 100/10/500 Credits pro 1 Mio. Eingabe-, zwischengespeicherte und Ausgabetokens.^120121126

v0.147.0 und v0.148.0 (7.–18. August 2026)

v0.147.0 entfernt codex exec --full-auto (seit v0.128 veraltet); verwenden Sie --sandbox workspace-write zusammen mit einem Genehmigungsflag oder -profil. Außerdem ergänzt es --approve-for-me, portable Agent Plugins mit katalogübergreifender Suche, das optionale MCP-Protokoll 2026-07-28 und Unterhaltungsabschnitte. v0.148.0 ergänzt /export für den Export nach Markdown, codex exec fork, geschätzte Credits oder Kosten in /status, Amazon Bedrock Runtime als integrierten Anbieter, asynchrone sowie MCP aufrufende hooks und Sandbox-Einschränkungen, die bei verweigerten oder nicht lesbaren Pfaden sicher fehlschlagen.¹¹⁶¹¹⁸

Frühere Releases (Mai–Juli 2026)

• v0.146.0 und v0.146.1 (29. Juli, 5. August): Konfigurierte Proxys decken jeden Transport ab; Agent-Plugins-Manifeste sowie die Marktplätze von Amazon Bedrock und Claude Code; Sitzungsbenennung mit Thread-Fixierung; vom Executor bereitgestellte skills; gehärtete Standards für automatische Reviews bei cyberfähigen Modellen.¹¹⁴¹¹⁵
• v0.145.0 (21. Juli): /import aus Cursor sowie Claude Code; Voice kehrt als gestreamte Echtzeit-V3-Unterhaltung zurück; die optionale Multi-Agent-v2-Erfahrung wird stabilisiert; experimenteller paginierter Thread-Verlauf und Amazon-Bedrock-Anmeldung; integrierte GPT-5.4-Auswahlen werden zu GPT-5.6 Terra und Luna migriert. v0.144.6 setzte die Kontextfenster von GPT-5.6 auf 272.000 Tokens.¹¹¹¹¹²
• v0.140.0 (15. Juni): /usage, codex delete und /delete, /import aus Claude Code, das vereinheitlichte Menü für @-Erwähnungen, Amazon-Bedrock-Authentifizierung per API-Schlüssel und verschlüsselter lokaler Speicher für Anmeldedaten von CLI sowie MCP-OAuth; die alten Voice-Steuerelemente von /realtime wurden entfernt.¹⁰²
• v0.139.0 (9. Juni): Der Code-Modus kann die Websuche direkt aufrufen, Tool-Schemata behalten oneOf/allOf, codex doctor meldet Details zu Editor und Pager, und Marktplatzquellen erscheinen in der Ausgabe von JSON.¹⁶⁵
• v0.138.0 (8. Juni): /app übergibt eine CLI-Sitzung an die Desktop-App, und der Aufgabentext zwischen übergeordnetem Agenten und Subagent wird in Multi-Agent v2 verschlüsselt.¹⁶⁶¹⁰⁸
• v0.137.0 (4. Juni): Multi-Agent v2, TUI-Tastenzuordnungen für F13–F24 und eine v1-Erweiterung für skills.¹⁶⁷
• v0.132.0 bis v0.135.0 (20.–28. Mai): Suche im lokalen Unterhaltungsverlauf, --profile als primäre Profilauswahl, standardmäßig aktivierte Ziele, Vererbung von Berechtigungsprofilen und verwaltete requirements.toml, Starten und Stoppen von codex remote-control, ausführlichere Ausgaben von codex doctor und /status, Vim-Textobjekte, benannte Berechtigungsprofile in /permissions, Authentifizierung für Python-SDK und Sandbox-Voreinstellungen sowie codex exec resume --output-schema. Das App-Update vom 21. Mai ergänzte Appshots, die allgemeine Verfügbarkeit des Zielmodus und optionales gesperrtes Computer Use.^{96979899100101176}

Das veraltete --full-auto ist seit v0.147.0 entfernt; js_repl bleibt ebenfalls entfernt.^86878991116

Stabilitätshinweis: Stable, dokumentierte Bereiche: der zentrale CLI und die TUI, Sandbox-System und Genehmigungsrichtlinien, config.toml, AGENTS.md, skills, hooks, Plugins, Multi-Agent-Tools, Ziele, Berechtigungsprofile, /voice und verwaltete worktrees (seit v0.156.0 standardmäßig aktiviert) sowie das Vollbildtranskript und der automatische Start des Hintergrundservers (seit v0.157.0 standardmäßig aktiviert). Browser, Computer Use und Appshots sind dokumentierte benutzerseitige Funktionen, deren Verfügbarkeit von Plattform und Tarif abhängt. Experimentell oder in Entwicklung: Codex Cloud, Code-Modus, experimentelle Kontextverwaltung, Memory v2, das lokale Nachrichtenforum für Agenten sowie alle Funktionen, die in diesem Leitfaden mit [EXPERIMENTAL] gekennzeichnet oder unter /experimental aufgeführt sind; sie können sich zwischen Releases ändern. Entfernt: --full-auto (v0.147.0), die Genehmigungsrichtlinie untrusted (v0.149.0), codex mcp-server (v0.154.0) und js_repl.

Alpha-Kanal: Alpha-Builds erscheinen mehrmals täglich, die Release-Texte der Alpha-Reihen sind Platzhalter, und regelmäßig werden außerplanmäßige Builds auf älteren Grundlagen erstellt (zuletzt: 0.155.0-alpha.16.4, 0.157.0-alpha.11.1, 0.158.0-alpha.15.1 und 0.158.0-alpha.2.1). Mindestens zweimal verwies das npm-Tag alpha auf einen solchen Build, sodass @alpha einen älteren Build als latest installierte. Die 0.158-Reihe lief von 0.158.0-alpha.2 (23. September) bis alpha.15 (25. September), ohne ein Stable-Release hervorzubringen; am 25. September wechselte das Tag alpha zur 0.159-Reihe, die derzeit bei 0.159.0-alpha.4 steht. Wenn Sie Alpha-Versionen verfolgen, prüfen Sie npm view @openai/codex dist-tags und installieren Sie eine genaue Version statt @alpha.¹⁷²¹⁷⁵ Eine datierte Historie dazu, wie die jüngsten Alpha-Reihen in Stable-Releases übergingen, finden Sie in ¹⁷³.

So funktioniert Codex: Das mentale Modell

Bevor Sie sich mit den Funktionen befassen, sollten Sie verstehen, wie die Architektur von Codex alles prägt, was Sie damit tun. 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. Mit Stand vom 23. September 2026 ist GPT-6 die aktuelle Generation: gpt-6-sol für alltägliche und komplexe Programmieraufgaben, gpt-6-astra für die anspruchsvollsten End-to-End-Aufgaben (und als gebündelter Standard von CLI, wenn kein Modell konfiguriert ist) sowie gpt-6-luna für klar umrissene Aufgaben mit hohem Volumen. Die GPT-5.6-Modelle (Sol, Terra, Luna) bleiben während der Einführung verfügbar; gpt-5.5 (400K Kontext in Codex, 1M in API) wird am 14. Oktober 2026 für die ChatGPT-Anmeldung aus Codex entfernt, während gpt-5.4 bereits am 31. August 2026 aus Codex entfernt wurde.^{83117146148149171} Diese Schicht liest Dateien, schreibt Patches, führt Shell-Befehle aus und analysiert Ihre Codebasis. Wenn der Kontext ausgeschöpft ist, komprimiert Codex die Unterhaltung, um Speicherplatz 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 Kernel-Ebene durch. Unter Linux filtern Landlock und seccomp den Zugriff auf das Dateisystem und Systemaufrufe. Die Sandbox arbeitet auf Kernel-Ebene, nicht innerhalb von Containern. Anschließend bestimmt die Genehmigungsrichtlinie, wann eine menschliche Bestätigung erforderlich ist.

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

Oberflächenschicht: CLI richtet sich an Terminal-Poweruser und die Automatisierung. Die Desktop-App dient der projektübergreifenden Verwaltung mehrerer Threads. Die IDE-Erweiterung unterstützt Bearbeitungs-, Kompilierungs- und Testschleifen. Cloud eignet sich für asynchrone Aufgaben, die unabhängig ausgeführt werden.

Die entscheidende Erkenntnis: Die meisten Benutzer verwenden nur eine Oberfläche. Poweruser nutzen alle fünf: Cloud für lang laufende Aufgaben, CLI für deterministische Repository-Operationen, die IDE-Erweiterung für enge Programmierschleifen, die Desktop-App für Planung und Koordination sowie die Browsererweiterung für Browserarbeitsabläufe mit Anmeldung.

Inhaltsverzeichnis

1. Wie installiere ich Codex?
2. Schnellstart: Ihre erste Sitzung
3. Zentrale Interaktionsoberflächen
4. Das Konfigurationssystem im Detail
5. Welches Modell sollte ich wählen?
6. Was kostet Codex?
7. Entscheidungsrahmen
8. Wie funktionieren 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. Best Practices und Anti-Patterns
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 die Codex CLI?

Seit v0.128.0 verfügt Codex über einen Befehl zur Selbstaktualisierung; alles Weitere erfolgt über den Paketmanager, mit dem Codex installiert wurde.⁸⁶ Seit v0.146.0 werden Release-Artefakte, Kanalmetadaten und Installer-Aliasse über die von OpenAI gehostete Release-Infrastruktur bereitgestellt, mit GitHub als Fallback.¹¹⁴ Wenn Ihr Netzwerk GitHub für Codex-Installationen und -Aktualisierungen auf der Zulassungsliste führt, fügen Sie auch den OpenAI-Release-Host hinzu — dank des Fallbacks führt ein fehlender Zulassungslisteneintrag zu einer unauffälligen Beeinträchtigung statt zu einem deutlichen Fehler.

# Check what you are running
codex --version                          # -> codex-cli 0.157.1
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

Das Anheften einer Version ist sinnvoll, wenn ein Release bei Ihnen Probleme verursacht. Codex folgt einer schnelllebigen stabilen Versionslinie, daher ist die Installation einer exakten Version der schnellste Weg zurück – melden Sie das Problem, heften Sie die Version an und arbeiten Sie weiter. Überprüfen Sie den erfolgreichen Rollback mit codex --version, da eine zweite, überschriebene Installation in Ihrem PATH unbemerkt weiterhin die alte Binärdatei ausführen kann (codex doctor weist unter Umgebung genau darauf hin).

Durch die Deinstallation des Pakets werden Ihre Daten nicht entfernt. Authentifizierungsdaten, Konfiguration und Sitzungsverlauf befinden sich in ~/.codex/. Belassen Sie den Ordner dort, um Anmeldungen und Verlauf bei einer Neuinstallation beizubehalten; löschen Sie ihn nur, wenn Sie wirklich von vorn beginnen möchten – rm -rf ~/.codex entfernt außerdem config.toml, auth.json und sämtliche gespeicherten Sitzungen.

Direktinstallationsskript (v0.106.0+)

Für macOS und Linux steht ein einzeiliges Installationsskript als GitHub-Release-Artefakt 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 herunterladen

Für Umgebungen ohne npm oder Homebrew können Sie plattformspezifische Binärdateien von 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 Anmeldedatenspeicher lässt sich über cli_auth_credentials_store in config.toml konfigurieren. Optionen: file (Standard), keyring (Schlüsselbund des Betriebssystems) oder auto (Schlüsselbund, falls verfügbar, ansonsten Datei).

Amazon-Bedrock-Anmeldung (v0.145.0, experimentell): Teams, deren Modellzugriff über Amazon Bedrock erfolgt, erhalten zusätzlich zur bestehenden verwalteten Authentifizierung mit API-Schlüssel (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 die Kompatibilität der Gesprächskomprimierung und des Multi-Agent-Betriebs mit Amazon-Bedrock-Modellen.¹³² v0.151.0 ergänzt geeignete TUI-Anmeldeabläufe um eine funktionsgesteuerte Amazon-Bedrock-Option: Beim Onboarding werden vorhandene AWS-Profile und Umgebungsanmeldedaten erkannt sowie die manuelle Einrichtung von Profilen, Zugriffsschlüsseln, Umgebungsvariablen und Bedrock-API-Schlüsseln angeboten. Außerdem wird die AWS-Region abgefragt, Geheimnisse werden während der Eingabe maskiert und der eingebettete Server wird neu gestartet, wenn sich der Anbieter ändert.¹³⁵ v0.152.0 zeigt den Fortschritt bei der Aktualisierung von Anmeldedaten an: Die TUI und codex exec zeigen den Fortschritt an, während ein Modellanbieter abgelaufene Anmeldedaten aktualisiert, einschließlich der erneuten Amazon-Bedrock-Sitzungsauthentifizierung. 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.157.1

Schnellstart: Ihre erste Sitzung

Beginnen Sie innerhalb von 5 Minuten produktiv zu arbeiten.

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

Nun sehen Sie die interaktive TUI. Codex liest Ihre Projektstruktur automatisch ein.

4. Eine Frage stellen:

> What does this project do? Summarize the architecture.

Codex liest wichtige Dateien und erläutert die Codebasis. Eine solche Frage nimmt keine Änderungen vor — Codex patcht Dateien nur, wenn Sie eine Änderung anfordern, und die Sandbox sowie die Genehmigungsrichtlinie bestimmen, wann zuvor Ihre Zustimmung eingeholt werden muss.

5. Eine Änderung vornehmen:

> Add input validation to the login endpoint

Codex schlägt Änderungen als Diff vor. Prüfen und genehmigen Sie diese 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

Sehen Sie sich 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 Arbeitsablauf (siehe Profile) - Probieren Sie codex exec für nicht interaktive Automatisierungen 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-Benutzeroberfläche)

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

Die Terminal-Benutzeroberfläche ist eine Vollbildanwendung mit folgenden Elementen:

• Eingabebereich: Geben Sie Prompts ein, hängen Sie mit @ Dateien an und führen Sie Shell-Befehle mit dem Präfix ! aus
• Ausgabebereich: Zeigt Modellantworten, Tool-Aufrufe und Befehlsausgaben als Stream an
• 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 den Füllstand Ihres Kontextfensters angibt. Wenn Sie die Statuszeile mit Skripten oder hooks auswerten, berücksichtigen Sie diese Formatänderung.⁸² Codex zeigt außerdem eine Aktualisierungsankündigung für CLI an, sobald eine neue Version verfügbar ist.

In der TUI verfügbare slash commands:

Neugestaltung der Arbeitsablaufauswahl (v0.129.0): Fortsetzen und Abzweigen sind über eine neu gestaltete Auswahl nun leichter erreichbar. Ein neuer Raw-Scrollback-Modus ermöglicht es zudem, durch das nicht gerenderte Transkript zu scrollen, wenn Sie Befehle oder Modellausgaben wortgetreu kopieren müssen. Das ist besonders hilfreich, wenn Sie eine lange Fehlerdiagnosesitzung sichten oder Ausgaben an ein anderes Tool weiterleiten.⁸⁹

Einheitliches Menü für @-Erwähnungen (v0.140.0): Wenn Sie im Eingabebereich @ eingeben, öffnet sich nun standardmäßig ein einheitliches Erwähnungsmenü für Dateien, Plugins und skills. Es ersetzt den bisherigen, auf Dateien beschränkten Ablauf zum Anhängen — mit nur einem Tastendruck können Sie auf beliebige Projektressourcen verweisen.¹⁰²

2. Codex Desktop App (macOS + Windows)

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

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

• Multitasking: Mehrere parallele Agenten gleichzeitig in verschiedenen Projekten ausführen
• Git-worktree-Isolierung: Jeder Thread arbeitet mit einer isolierten Kopie Ihres Repositorys
• Integrierte Diff-Prüfung: Änderungen bereitstellen, zurücksetzen und committen, ohne die App zu verlassen
• Integriertes Terminal: Thread-spezifisches Terminal zum Ausführen von Befehlen
• Abzweigen von Unterhaltungen: Unterhaltungen verzweigen, um Alternativen zu untersuchen
• Schwebende Pop-out-Fenster: Unterhaltungen in frei positionierbare Fenster auslagern
• Automatisierungen: Wiederkehrende Aufgaben planen (Issue-Triage, CI-Überwachung, Reaktion auf Warnmeldungen)
• Appshots: Das vorderste Mac-App-Fenster zusammen mit einem Screenshot und dem verfügbaren Text an einen Thread anhängen
• Browserkommentare in der App: Lokale oder öffentliche Seiten in der Vorschau anzeigen, Kommentare zu Elementen oder Bereichen hinterlassen und Codex präzises visuelles Feedback umsetzen lassen
• Computer Use: Codex für klar abgegrenzte GUI-Arbeiten zugelassene Mac-Apps bedienen lassen; die gesperrte Nutzung ist für geeignete Remote-Mac-Computer-Use-Durchgänge optional aktivierbar

ChatGPT Voice, unterstützt von GPT-Live (Desktop 26.715, 23. Juli 2026): Die Desktop-App lässt sich nun per Sprache steuern — besprechen Sie Ihre Arbeit und koordinieren Sie Aufgaben in Chat, Work und Codex, ohne zu tippen. Wenn Sie unter macOS Screen context 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. CLI besitzt eigene, separate Sprachfunktionen: Live-Unterhaltungen über /voice in der TUI (seit v0.156.0 standardmäßig aktiviert) und Diktieren über die Leertaste (in v0.105.0 experimentell hinzugefügt).¹¹³¹⁶⁹

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

Wann Sie die App statt CLI verwenden sollten: Nutzen Sie die Desktop-App, wenn Sie mehrere Arbeitsströme koordinieren oder eine visuelle Diff-Prüfung benötigen. Verwenden Sie CLI, wenn Sie Funktionen im Terminal kombinieren, Skripte einsetzen oder eine CI/CD-Integration nutzen möchten.

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

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

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

Installieren Sie die Erweiterung über den VS Code Marketplace oder die Erweiterungs-Stores von Cursor beziehungsweise Windsurf.³

4. Codex Cloud [EXPERIMENTAL]

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

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

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 zugänglich.⁴

5. Browser-Erweiterung (Chrome, Edge, Brave, Opera, Vivaldi)

Codex ist als Browser-Erweiterung für Google Chrome, Microsoft Edge, Brave, Opera und Vivaldi verfügbar und ergänzt CLI, Desktop-App, IDE-Erweiterung und Cloud um eine fünfte Oberfläche. Die Erweiterung wurde im Mai 2026 für Chrome veröffentlicht; mit dem Changelog vom 25. August 2026 kamen die vier weiteren Browser hinzu. Die Einrichtung erfolgt in der ChatGPT-Desktop-App unter Settings > Computer Use. Alle fünf unterstützen Tab-Erwähnungen und Browsersteuerung; Opera unterstützt keinen Seitenchat, weshalb Sie entsprechende Aufgaben aus der Desktop-App starten müssen. Die Erweiterung ist darauf ausgelegt, Ihre normale Browsernutzung zu begleiten, statt sie zu übernehmen: Codex arbeitet im Hintergrund parallel in mehreren Tabs, während Sie bestimmen, auf welche Websites zugegriffen werden darf.⁹⁰¹²⁷

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

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

Ausführliche Erläuterung des Konfigurationssystems

Codex verwendet TOML für die Konfiguration. Die Rangfolge ist dabei entscheidend, da sie bestimmt, welche Einstellungen bei Konflikten Vorrang haben.

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

1. Sitzungsbezogene Ü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 vom aktuellen Arbeitsverzeichnis 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 Unternehmensweite Bereitstellung.

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 Suche nach config.toml erfolgt ausschließlich im primären Ordner. Sekundäre Ordner stehen weiterhin für die Dateisuche sowie zum Lesen und Bearbeiten zur Verfügung, tragen jedoch keine Konfiguration bei. Eine .codex/config.toml in einem sekundären Ordner ist eine Datei, die Codex lesen kann, aber keine geladene Konfiguration. Dies betrifft den Projektgeltungsbereich der Desktop-App und ändert nichts an den oben beschriebenen Rangfolgeregeln – der CLI ermittelt die Projektkonfiguration weiterhin, indem er ausgehend vom aktuellen Arbeitsverzeichnis die Verzeichnishierarchie nach oben durchsucht.¹¹³

Vollständige Konfigurationsreferenz

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

# ─── Model Selection ───────────────────────────────────
model = "gpt-6-sol"                    # Docs' example default; unset = bundled default (gpt-6-astra)
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-6-sol"             # 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 hat den Typ 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 Befehle greifen direkt auf das Netzwerk zu. Websuche, Apps, MCP servers und 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 auch ohne features.network_proxy starten.¹³⁰

Profile

Benannte Konfigurationsvoreinstellungen für unterschiedliche Arbeitsweisen. 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 in config.toml und der Selektor profile = "<name>" auf oberster Ebene werden nicht mehr eingelesen. Eine verbliebene [profiles.<name>]-Tabelle führt dazu, dass --profile <name> den Start verweigert, bis Sie deren Schlüssel in die Profildatei verschoben haben.¹²²

# ~/.codex/fast.config.toml
model = "gpt-6-luna"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "low"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
personality = "pragmatic"

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

# ~/.codex/auto.config.toml
model = "gpt-6-sol"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "medium"
approval_policy = "never"
sandbox_mode = "workspace-write"

Eine Profildatei bildet eine Ebene oberhalb Ihrer grundlegenden Benutzerkonfiguration und unterhalb der Projekt- und CLI-Konfiguration. Sie muss daher 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. Für einzelne Sitzungen können Sie es mit --profile überschreiben.

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-Übertragungs-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 wie Ollama und 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 beliebige Konfigurationswerte ü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 Modell sollten Sie wählen?

Verfügbare Modelle (September 2026)

GPT-5.5 (23. April 2026) war beim Start OpenAIs empfohlene Wahl für die meisten Codex-Aufgaben: komplexe Programmieraufgaben, Computerbedienung, Wissensarbeit und Forschungsworkflows. 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 Abonnementstufen hinweg auszubalancieren; die API stellt die vollen 1M bereit. Preise (API): 5 $ für Eingabe / 30 $ für Ausgabe pro MTok (das Zweifache des GPT-5.4-Tarifs; OpenAI gibt nach Verbesserungen der Tokeneffizienz eine effektive Erhöhung um etwa 20 % an). Benchmarks: 82,7 % Terminal-Bench 2.0 (aktueller SOTA unter den öffentlich verfügbaren Modellen), 84,9 % GDPval (44 Berufe), 78,7 % OSWorld-Verified, 98,0 % Tau2-bench Telecom (ohne Prompt-Tuning). OpenAI setzte GPT-5.5 + Codex vor der Veröffentlichung intern ein, um die Bereitstellungsinfrastruktur neu zu schreiben – dadurch stieg die Geschwindigkeit der Tokengenerierung um 20 %.⁸³

GPT-5.5 wird am 14. Oktober 2026 aus Codex bei Anmeldung mit ChatGPT entfernt – laut Modelldokumentation gilt die Einstellung für ChatGPT, ChatGPT Work und Codex in allen Tarifen (einschließlich Consumer, Business, Enterprise und Edu), nicht jedoch für die OpenAI API.¹⁵⁵ Mit der Veröffentlichung von GPT-6 änderte sich die Empfehlung für den Ersatz: Wählen Sie in Plus, Pro, Business, Enterprise und Edu gpt-6-sol; in Free und Go wählen Sie in der Desktop-App gpt-6-luna, jeweils „wenn verfügbar“. Ersetzen Sie gpt-5.5 in Workspace-Standardeinstellungen, gespeicherten Modelleinstellungen, verwalteten Konfigurationen, benutzerdefinierten Agenten, geplanten Aufgaben und Skripten.¹⁷¹

GPT-5.4 und GPT-5.4 mini wurden am 31. August 2026 aus Codex bei Anmeldung mit ChatGPT entfernt.¹¹⁷ Die Modelldokumentation nennt jetzt gpt-6-sol und gpt-6-luna als Ersatz (in Enterprise und Edu muss ein Administrator Luna zunächst aktivieren); die Verwendung mit einem API-Schlüssel ist davon nicht betroffen.⁶⁴¹⁷¹ Die genaue Modellliste variiert je nach Konto und Rollout. Prüfen Sie Ihren lokalen Cache: ~/.codex/models_cache.json.

Hinweis zur Einstellung (11. März 2026): GPT-5.1-Modelle 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 über API und CLI bis zur Abschaltung am 23. Juli 2026 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 wird die GPT-5.5-Familie über kostenpflichtige Tarife hinaus einem breiteren Publikum zugänglich, während der Zugriff auf Codex CLI weiterhin ein berechtigtes Plus-/Pro-/Business-/Enterprise-/Edu-/Go-Abonnement oder einen API-Schlüssel erfordert.⁹²

GPT-5.4 mini (17. März 2026): Eine kleinere, schnellere Variante von GPT-5.4 mit einem Kontext von 400K zu 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, Dateiprüfung und Dokumentverarbeitung) parallel bearbeiten.⁷⁶

Bedrock GPT-5.6 (Sol, Terra, Luna) (v0.143.0, 8. Juli 2026): Codex erhielt erstklassige Unterstützung für drei auf Amazon Bedrock gehostete GPT-5.6-Modellvarianten, einschließlich Unterstützung für den Reasoning-Aufwand max. Für Teams, deren Modellzugriff über einen Bedrock-Anbieter erfolgt, lassen sie sich genauso auswählen wie andere Modelle benutzerdefinierter Anbieter (siehe Benutzerdefinierte Modellanbieter); die Aufwandsstufe max ist für die anspruchsvollsten Reasoning- und agentischen Arbeitslasten 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) fügt eine experimentelle Bedrock-Anmeldung mit Unterstützung für benutzerdefinierte Endpunkte und Authentifizierung hinzu, macht GPT-5.6 Sol zum Bedrock-Standardmodell und migriert gebündelte GPT-5.4-Modellauswahlen zu den entsprechenden Varianten Terra und Luna.¹¹²

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 für API vorgesehenen Katalogeintrag vor; OpenAI kündigte GPT-6-Astra am selben Tag an; und v0.153.4 fügte am 4. September den Eintrag zur Modellauswahl hinzu und stellte den gebündelten CLI-Standard um. Die Ankündigung beschreibt einen schrittweisen Rollout, der mit einer begrenzten Anzahl von Organisationen beginnt (zunächst Partner des Cybersicherheitsprogramms) und „in den kommenden Tagen“ auf ChatGPT Plus, Pro, Business und Enterprise sowie auf die OpenAI API und AWS ausgeweitet wird – diese Rollout-Fakten stammen aus Presseberichten (CNBC, Axios, Forbes, Al Jazeera, 9to5Mac).¹⁴⁵ Seit dem 4. September überholt: OpenAI kündigte auf X an, GPT-6 Astra sei „jetzt für alle Benutzer von Pro, Enterprise und Business Premium in ChatGPT Work und Codex verfügbar“ und „in der API live“; Plus und Business sollten innerhalb weniger Tage folgen. Codex-Leiter Tibo Sottiaux ergänzte noch am selben Abend: „Astra wurde jetzt auch für alle Plus- und Business-Benutzer ausgerollt.“ In der Praxis bleibt die Berechtigung uneinheitlich – Community-Berichte vom 5. September zeigen, dass Plus-Konten in Codex weiterhin nur GPT-5.6-Modelle sehen – und die unten zitierte Verfügbarkeitsangabe der Modelldokumentation ist unverändert, sodass sie weiterhin als maßgebliche Aussage aus erster Hand gilt.¹⁴⁹ Die Dokumentation aus erster Hand ist verfügbar: Die API-Modellseite führt gpt-6-astra als Flaggschiff auf, „Unser leistungsfähigstes Modell, entwickelt für die anspruchsvollste End-to-End-Arbeit“ – 10 $/MTok für Eingaben, 50 $/MTok für Ausgaben zu Standardtarifen für kurze Kontexte, ein Kontextfenster mit 1,05M Tokens und maximal 922.000 Eingabetokens, 128K maximale Ausgabetokens, Wissensstand vom 30. April 2026 – mit einer dokumentierten Stufe für lange Kontexte: Prompts mit mehr als 272K Eingabetokens werden für die gesamte Anfrage mit dem zweifachen Eingabe- und dem 1,5-fachen Ausgabepreis berechnet, laut Preisseite also mit 20 $/MTok für Eingaben und 75 $/MTok für Ausgaben. Damit liegt es über GPT-5.6 Terra (ausgewogen) und Luna (kostengünstig), und die Codex-Dokumentation bezeichnet Astra als das empfohlene Codex-Modell, dessen Verfügbarkeit „vom Rollout, Ihrer Anmeldemethode und Ihrem Client abhängt“; als berechtigt werden Pro-, Business- (100 $) und Enterprise-Konten genannt. Astras dokumentierte Codex-Reasoning-Stufen: Low, Medium, High, Extra High, Max, Ultra – die Modellseite der Dokumentation nennt Medium als Standard, während der gebündelte Katalog v0.153.4 default_reasoning_level auf low setzt. Betrachten Sie den tatsächlichen Standard daher als oberflächenabhängig und prüfen Sie in einer Sitzung /status; die Stufen sind beim erneuten Zugriff am 15. September unverändert, nun mit Beschreibungen für jede Stufe in der Modellauswahl (Ultra, wörtlich: „Maximales Reasoning mit automatischer Aufgabendelegierung“), und für die Stufen Max und Ultra liegt eine Bestätigung durch SDK vor – die Veröffentlichung Python SDK 0.154.0 (10. September 2026) fügt die Reasoning-Aufwandswerte max und ultra hinzu (#39662).^146148153 In der 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 blieb das Bedrock-Standardmodell, bis v0.157.0 es durch GPT-6 Sol ersetzte¹⁷⁴) und befindet sich seit v0.153.4 in der Modellauswahl sowie als gebündeltes Standardmodell, wenn kein Modell ausdrücklich konfiguriert wurde – eine minimale CLI-Version ist nicht dokumentiert, betrachten Sie diese Versionen daher als praktische Untergrenzen. Diese Standardumstellung ist eine Tatsache des gebündelten CLI-Katalogs und gilt nicht für alle Oberflächen – wobei die Cloud-Lücke inzwischen geschlossen wurde: Bei den Zugriffen am 4. und 7. September war Astra als nicht für Codex cloud verfügbar gekennzeichnet (GPT-5.6 Sol war dort verfügbar), während die Verfügbarkeitsmatrix beim erneuten Zugriff am 15. September Astra auch für Codex cloud als verfügbar auswies; auf der Seite steht weiterhin: „Derzeit können Sie das Standardmodell für Codex cloud-Chats nicht ändern.“ Rollout-Einschränkung: Die Berechtigung variiert je nach Konto, und ab CLI 0.153.4 enthält ein Konto außerhalb des Rollouts ein gebündeltes Standardmodell, das es noch nicht verwenden kann – legen Sie für eine deterministische Auswahl ein Modell in config.toml fest (oder übergeben Sie -m); seit v0.156.1 lautet das dokumentationseigene Beispiel model = "gpt-6-sol". Die Abrechnung für Astras Fast-Modus ist dokumentiert, obwohl die Modellseite keine Fast-Stufe aufführt: Die Codex-Geschwindigkeitsdokumentation setzt sie bei Anmeldung mit ChatGPT („sofern verfügbar“) mit dem 2,5-Fachen der Standard-Credits an, und die API-Preisseite nennt Fast-Modus-Tarife in Höhe des genau Zweifachen der jeweiligen Standardtarife (20 $/100 $ pro MTok für kurze Kontexte, 40 $/150 $ für lange Kontexte). Die Hälfte „2-fache Geschwindigkeit“ aus der Katalogzeichenfolge von v0.153.2 bleibt lediglich Anzeigetext des Katalogs – die Geschwindigkeitsseite nennt für Astra keinen Geschwindigkeitsmultiplikator.^145146147148 Teilweise überholt, 23. September 2026: Die Modelldokumentation bezeichnet Astra nicht mehr als das empfohlene Codex-Modell. Ihr Abschnitt „Empfohlene Modelle“ beginnt nun mit GPT-6 Sol und Luna, sieht Astra für „die anspruchsvollste End-to-End-Arbeit“ vor, kennzeichnet Astra als nicht für Codex cloud verfügbar und nennt Light (low) als Astras anfänglichen Aufwand, was dem gebündelten Katalog entspricht. Astra bleibt das gebündelte CLI-Standardmodell, wenn kein Modell konfiguriert ist.¹⁷¹

Power-Voreinstellungen unter Astra (Ergänzung der Dokumentation, spätestens am 6. September 2026): Der Abschnitt zur Modellauswahl in der Codex-Modelldokumentation 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 am 7. September nachweislich verfügbar war. Wörtlich: „Für berechtigte Pro-, Business- (100 $) und Enterprise-Konten aktualisiert der Astra-Rollout 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 Rollout-Phase variieren.“ Der vorherige Satz der Dokumentation weist darauf hin, dass die Abbildungen der Modellauswahl weiterhin GPT-5.6-Steuerelemente zeigen. Lesen Sie dies zusammen mit der obigen Modelltabelle: „Power“ bezeichnete GPT-5.6 Sol mit mittlerem Reasoning; bei einem berechtigten Konto umfasst dieselbe Voreinstellungsleiter nun Terra, Sol und Astra mit festen Reasoning-Stufen, wobei die Optionen weiterhin vom Tarif und der Rollout-Phase abhängen. Beim erneuten Zugriff am 15. September 2026 war der Absatz wörtlich unverändert.¹⁴⁶ Aktualisiert am 23. September 2026: Nach der Veröffentlichung von GPT-6 Sol und Luna führt die Dokumentation die sechs Power-Voreinstellungen als „Luna High, Sol Light (die anfängliche Voreinstellung), Sol Medium, Astra Light, Astra Medium und Astra Extra High“ auf, weist darauf hin, dass Astra Extra High in einigen kostenpflichtigen Tarifen fehlt, und empfiehlt den Einstieg bei Medium für Sol, High für Luna und Light (low) für Astra.¹⁷¹

Experimentelle kontextübergreifende Notizen (Astra, dokumentiert, Opt-in): Die Codex-Modelldokumentation 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 behält Notizen über Kontextfenster hinweg und kann frühere Nachrichten und Tool-Ergebnisse derselben Aufgabe durchsuchen. Dieses Experiment ist standardmäßig deaktiviert und zum Start weder mit Business oder Enterprise noch bei Anmeldung mit 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 Oberfläche features.context_management.experimental_mode, die mit v0.153.0 ausgeliefert wurde (siehe Kontextverwaltung) – die Dokumentationsseite verknüpft sie nun namentlich mit Astra sowie mit Plus- und Pro-Anmeldungen, während die Versionshinweise von v0.153.0 berechtigte Plus-, Pro- und Pro-Lite-Sitzungen nannten. v0.154.0 verschärft die Prüfung auf Codeebene: Die Berechtigung für das Experiment wird nun beim Sitzungsstart anhand der Fähigkeiten des aktiven Modells beschränkt (#43147). Beim erneuten Zugriff am 15. September 2026 war der Dokumentationsabschnitt wörtlich unverändert. Experimentell und standardmäßig deaktiviert; rechnen Sie damit, dass sich Verhalten und Berechtigung ändern.^140146152 v0.157.0: Der gebündelte Modellkatalog kennzeichnet GPT-6-Astra – oder irgendein anderes gebündeltes Modell – nicht mehr als Modell mit Unterstützung für experimentellen Kontext (#47397), und die CLI aktiviert das Experiment nur für ein entsprechend gekennzeichnetes Modell. Mit dem gebündelten Katalog bleibt der Opt-in daher wirkungslos; ob sich der an angemeldete Konten ausgelieferte Katalog unterscheidet, ist nicht dokumentiert. Die Modelldokumentation beschreibt den Opt-in weiterhin mit Stand vom 26. September 2026.¹⁷⁴

Flussdiagramm zur Modellauswahl

Is this a quick fix, extraction, or other well-defined repeatable task?
├─ Yes → gpt-6-luna (most efficient; docs suggest starting at High)
└─ No
   ├─ Do you need real-time pairing speed?
   │  ├─ Yes → gpt-5.3-codex-spark (near-instant, Pro only)
   │  └─ No
   │     ├─ Hardest end-to-end work across many steps and tools?
   │     │  ├─ Yes → gpt-6-astra (strongest; bundled default when no model is set)
   │     │  └─ No → gpt-6-sol (everyday and complex coding; start at Medium)
   └─ GPT-6 not yet available on your account? → gpt-5.6-sol

Reasoning-Aufwand

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

Die unterstützten Stufen hängen vom Modell ab. minimal ist nur für GPT-5-Modelle verfügbar. Nicht jedes Modell unterstützt alle Stufen.

Details zu persistent (v0.151.0): Bei Ausführungen mit dem Aufwand persistent sind standardmäßig die Erinnerung an die aktuelle Uhrzeit und das unterbrechbare Tool clock.sleep aktiviert (ausdrückliche Einstellungen für features.current_time_reminder und verwaltete Anforderungen bleiben erhalten). Zudem enthalten sie gebündelte Anweisungen zu Proaktivität und Folgeaktionen, die durch Modellmetadaten ü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.

Schnellsteuerung des Reasoning-Aufwands in der TUI (v0.124.0+).⁸⁵ In einer interaktiven TUI-Sitzung senkt Alt+, den Reasoning-Aufwand um eine Stufe und Alt+. erhöht ihn um eine Stufe – praktisch, wenn ein schwieriges Problem mitten in einer Sitzung vorübergehend eine Steigerung von medium → high → xhigh rechtfertigt, ohne /effort oder -c zu verwenden. Wenn Sie während einer Sitzung ein Modellupgrade akzeptieren, wird der Reasoning-Aufwand auf den Standardwert des neuen Modells zurückgesetzt, anstatt die vorherige Stufe zu übernehmen.

Modellwechsel

Wechseln Sie während einer Sitzung mit dem Slash Command /model das Modell oder legen Sie es pro Ausführung ü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 passenden 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 Lizenz und Monat gesenkt. Für Business- und Enterprise-Arbeitsbereiche sind nun reine Codex-Lizenzen mit nutzungsabhängiger Abrechnung verfügbar – ohne feste Lizenzgebühr und nach Tokenverbrauch abgerechnet.⁷⁹ Auf der Preisseite werden die Limits nun als modellspezifische Spannen veröffentlicht (siehe Tabelle oben), nicht mehr als die werblichen 2×-Multiplikatoren von der Einführung der Desktop-App im Februar 2026.¹⁶¹⁶²

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

Benutzerführung bei Nutzungslimits in der TUI (v0.152.0–v0.153.0): Das Erreichen eines Limits ist keine Sackgasse mehr. v0.152.0 zeigt über dem Eingabefeld Banner mit konkreten Handlungsmöglichkeiten 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. Weist das Banner darauf hin, wechselt Codex zum ersten verfügbaren Ausweichmodell, ohne andere Thread-Einstellungen zu ändern.¹³⁸ v0.153.0 führt frühere Warnungen für Plus- und Team-Tarife ein: Eine Warnung erscheint, sobald in einem Nutzungsfenster von ungefähr fünf Stunden weniger als die Hälfte des Kontingents verbleibt. Für andere Tarife und Fensterlängen gelten weiterhin die bisherigen Schwellenwerte von 75 %, 90 % und 95 %.¹⁴⁰

Guthabenkosten

Codex-Vorgänge verbrauchen Guthaben aus dem Kontingent Ihres Tarifs:

Die Preise gelten für Standard-Geschwindigkeit. Laut Preisseite bleiben die Preise für GPT-5.6 Sol, Terra und Luna nach der Einführung von GPT-6 „unverändert“. In der Praxis liegt die „GPT-5.6-Nutzung durchschnittlich bei 5–30 Guthabeneinheiten pro Nachricht“ (zum Zugangsstart im August nannte die Seite 5–40). Der Fast-Modus kostet für GPT-6 Astra, Sol und Luna, „sofern verfügbar“, das 2,5-Fache des Standard-Guthabenpreises. Zudem legt der enthaltene Modellkatalog in der TUI Fast als Standardstufe für GPT-6 Sol und Luna fest, sofern Sie service_tier nicht konfigurieren. Prüfen Sie deshalb /fast status, wenn das Guthaben schneller als erwartet aufgebraucht wird. Die Bilderzeugung verbraucht enthaltene Limits 3- bis 5-mal schneller als vergleichbare Interaktionen, die ausschließlich Text verwenden.¹⁶²¹⁷¹

Bei Enterprise- und Edu-Tarifen skaliert das Guthaben mit der vertraglichen Zuteilung. Prüfen Sie die aktuelle Nutzung mit /status in der TUI.

API-Abrechnung

Wenn Sie Codex über die API verwenden, berechnet OpenAI die Nutzung pro Token gemäß den regulären OpenAI-API-Preisen für das ausgewählte Modell, einschließlich etwaiger Rabatte für Prompt-Caching. Aktuelle API-Preise pro 1 Mio. Token: GPT-6 Sol $2 für Eingabe / $10 für Ausgabe, GPT-6 Luna $0,10 / $0,50, GPT-6 Astra $10 / $50. Bei allen drei Modellen kosten Prompts mit mehr als 272K Eingabe-Token für die gesamte Anfrage das 2-Fache des Eingabepreises und das 1,5-Fache des Ausgabepreises; der Fast-Modus kostet das 2-Fache.¹⁴⁶¹⁷¹ ChatGPT-Guthabenmultiplikatoren gelten nicht für die Anmeldung mit einem API-Schlüssel. Die aktuellen Preise finden Sie auf der offiziellen API-Preisseite.²⁰

Strategien zur Kostenoptimierung

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

Kostenbeispiele aus der Praxis

Repräsentative API-Kosten für häufige Aufgaben (Preismomentaufnahme für gpt-5.3-codex von Mitte 2026, mittlere Reasoning-Stufe – die relativen Größenordnungen lassen sich auf andere Modelle übertragen):

Die Kosten variieren je nach Reasoning-Stufe, Caching und Gesprächslänge. Verwenden Sie gpt-5.6-luna für Routineaufgaben, um die entsprechenden Ausgaben erheblich zu senken. Im Cache gespeicherte Eingabe-Token werden vergünstigt abgerechnet.

Verborgener Token-Zusatzaufwand

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

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

Kostenmanagement für Teams

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

Entscheidungsgrundlagen

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: Enter im Vergleich zu Tab

Faustregel: Enter = „Stopp, hören Sie sich das jetzt an.“ Tab = „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 veraltete Ein-Datei-Layout mit profile = "default" + [profiles.*] wird seit 0.134.0 nicht mehr gelesen¹²²):

# ~/.codex/fast.config.toml
model = "gpt-6-luna"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "low"

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

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

# ~/.codex/ci.config.toml
model = "gpt-6-luna"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "low"
sandbox_mode = "workspace-write"

Profil sitzungsweise wechseln: codex --profile careful

Wie funktioniert das Sandbox- und Genehmigungssystem?

Codex verwendet ein zweistufiges Sicherheitsmodell, das trennt, was technisch möglich ist, und wann Codex eine menschliche Genehmigung anfordert. Dieser Ansatz unterscheidet sich grundlegend vom Berechtigungssystem von Claude Code — Codex setzt Einschränkungen auf Ebene des Betriebssystemkernels durch.⁵ Siehe auch Unternehmensweite Bereitstellung zu requirements.toml-Einschränkungen, die Administratoren organisationsweit durchsetzen.

Härtung in v0.148.0: Sandbox-Einschränkungen sind unter Linux und Windows jetzt nach dem Prinzip Fail Closed umgesetzt — 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 eine Allowlist setzen (z. B. docker.sock, IPC-Sockets von Editoren), und die private DNS-Auflösung wird nicht mehr standardmäßig blockiert.⁸²
• Linux: Landlock für Dateisystemeinschränkungen und seccomp für die Filterung von Systemaufrufen. Ein eigenständiger Hilfsprozess (codex-linux-sandbox) bietet zusätzliche Isolation nach dem Defense-in-Depth-Prinzip.⁵ Bubblewrap (bwrap) wird mitgeliefert 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 Legacy-Kernelkonfigurationen.⁷⁵ v0.129.0 härtete den Sandbox-Start unter Linux und aktualisierte das mitgelieferte Bubblewrap einschließlich vorgelagerter Sicherheitspatches 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 (übernimmt Landlock und seccomp von Linux). v0.117.0 enthält Verbesserungen an der Restricted-Token-Sandbox für eine bessere Prozessisolation.⁷⁵ 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 zur containerbasierten Sandbox (Docker) ist die Sandbox auf Betriebssystemebene schneller, leichtgewichtiger und schwerer zu umgehen. Der Kernel setzt die Einschränkungen durch, 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 über zsh-Forking die Sandbox-Einschränkungen umgehen konnte.⁶⁰ Wenn Sie eine frühere Version verwenden, führen Sie sofort ein Upgrade durch. - Begrenzung der Eingabegröße (v0.106.0): Codex erzwingt jetzt eine Eingabeobergrenze von 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 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): hooks sind während Guardian-Prüfungssitzungen deaktiviert, damit hooks vor und 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, was die Kompatibilität mit Tools verbessert, die Geräteknoten erwarten.⁶¹

ReadOnlyAccess-Richtlinie (v0.100.0+): Eine konfigurierbare Richtlinienstruktur für eine granulare 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, um eine menschliche Bestätigung anzufordern:

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 über eine externe Sicherheitsgrenze verfügen.⁸⁷

Seit v0.150.0 können Sie ein Tastenkürzel festlegen, mit dem Sie im Eingabebereich zwischen den Berechtigungsmodi wechseln — konfigurieren Sie es über /keymap.¹³²

Eindeutige Genehmigungs-IDs (v0.104.0+)

Codex weist jetzt jedem Befehl innerhalb einer mehrstufigen Shell-Ausführung eine eigene Genehmigungs-ID zu. Genehmigungen sind dadurch 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: Benötigt ein Befehl Zugriff über den aktuellen Sandbox-Modus hinaus, kann Codex gezielt zusätzliche Berechtigungen anfordern, statt einen vollständigen Moduswechsel zu verlangen
• Granulare Ablehnung: Lehnen Sie einzelne Tool-Aufrufe mit einer Rückmeldung ab, damit Codex seinen Ansatz anpassen kann, statt denselben Befehl lediglich erneut zu versuchen

Berechtigungsanforderungen zur Laufzeit (v0.113.0+)

Codex enthält jetzt ein integriertes Tool namens request_permissions, mit dem das Modell zur Laufzeit zusätzliche Berechtigungen anfordern kann.⁶⁹ Wenn das Modell auf eine Aufgabe stößt, die erweiterte Zugriffsrechte erfordert, kann es über den TUI-Genehmigungsablauf gezielt bestimmte Berechtigungen anfordern (Dateisystempfade, Netzwerkzugriff usw.), statt stillschweigend zu scheitern oder vom Benutzer einen Neustart mit anderen Flags zu verlangen.

App-Genehmigungsmodus writes (v0.144.0+)

Apps und Konnektoren erhalten eine mittlere Genehmigungsstufe: Im App-Genehmigungsmodus writes können deklarierte schreibgeschützte Aktionen einer App ohne Nachfrage ausgeführt werden, während bei allen Schreibvorgängen weiterhin pausiert wird.¹⁰⁷ Zuvor waren App-Genehmigungen eher nach dem Alles-oder-nichts-Prinzip aufgebaut; writes entspricht dem Vertrauensmodell, das sich die meisten Betreiber für Integrationen tatsächlich wünschen — frei lesen, vor Änderungen fragen.

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üfungsdurchlauf bewertet und in Ihrem Namen genehmigt oder abgelehnt.¹¹⁶ Dies liegt zwischen „alles genehmigen“ (die von --full-auto geförderte Haltung, die inzwischen entfernt wurde) und „bei allem unterbrechen“ — die Anfragen bleiben als Entscheidungspunkte bestehen, werden jedoch von einem Prüfer beantwortet. Kombinieren Sie es mit den sichereren Standardeinstellungen für automatische Prüfungen aus v0.146.1, die dieses Flag übernimmt und die für cyberfähige Modelle gelten. Behandeln Sie dies wie jede Übertragung von Befugnissen: geeignet für lange unbeaufsichtigte Ausführungen, bei denen eine Unterbrechung zum Stillstand führt, ungeeignet für Sitzungen, die Anmeldedaten oder den Produktionszustand betreffen und bei denen Sie selbst die Prüfung übernehmen möchten.

Genehmigung für Eingaben in ein eskaliertes Terminal (v0.151.0)

Das standardmäßig deaktivierte Funktions-Flag write_stdin_approval verlangt eine erneute Genehmigung, bevor eine nicht leere Eingabe an ein eskaliertes Unified-Exec-Terminal gesendet wird. Diese Prüfungen werden über hooks, Guardian, den App-Server und die TUI als writeStdin-Genehmigungen weitergeleitet; Umgebung, Startverzeichnis und Eskalationsstatus des Terminals bleiben über mehrere Durchläufe hinweg bestehen, und die Prozessidentität wird nach der Genehmigung erneut validiert, bevor Bytes geschrieben werden. Die vollständig formatierte Aktion und der Genehmigungsgrund dürfen zusammen maximal 8.000 Byte umfassen — übergroße oder abgeschnittene Aktionen werden abgelehnt, bevor eine Genehmigung angefordert oder etwas an das Terminal übermittelt wird.¹³⁵

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

Berechtigungsprofile unterteilen die 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 macht Profile zu einer verwalteten Oberfläche: Auflistungs-APIs stellen Metadaten zu verfügbaren Profilen bereit, Profile können voneinander erben, eine verwaltete requirements.toml kann Berechtigungsanforderungen deklarieren, aktive Profile werden zur Laufzeit aktualisiert, und die Einrichtung der Windows-Sandbox verwendet jetzt das aufgelöste Profil statt 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 sensible Dateien und Globs, die selbst dann nicht lesbar sein sollen, wenn für das Projektstammverzeichnis Schreibzugriff besteht. Für einmalige Befehlsausnahmen sollten Sie Regeln bevorzugen, statt ein Profil umfassend zu erweitern.⁸⁷

v0.151.0: Wiederhergestellte App-Server-Threads behalten ihre Berechtigungsprofile, statt in ältere, durchlaufspezifische Sandbox-Überschreibungen umgewandelt zu werden — Profile bleiben beim Routing zwischen Durchläufen und bei kompatiblen Verzeichniswechseln mit /cd erhalten. Ein /cd, bei dem das wiederhergestellte Profil nicht sicher als älterer Sandbox-Modus abgebildet werden kann, wird abgelehnt, statt Einschränkungen stillschweigend zu lockern.¹³⁴

Hinweise zum veralteten --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 ist --full-auto als veraltet gekennzeichnet, und die aktuelle Hilfe von CLI führt es nicht mehr für interaktive Ausführungen 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 mechanisch — ersetzen Sie es durch --sandbox workspace-write (ergänzt um ein Genehmigungs-Flag oder Profil, falls Ihr alter Aufruf vom Genehmigungsverhalten von --full-auto abhing). Prüfen Sie vor dem Upgrade jede Automatisierung, die codex exec über die Shell aufruft: Der Fehler zeigt sich als defekte Pipeline, nicht als Veraltungswarnung.¹¹⁶

Sandbox-Zuverlässigkeit (v0.129.0): Die Härtung des Sandbox-Starts unter Linux reduziert Race Conditions auf langsamen Dateisystemen oder bei über Symlinks eingebundenen Checkouts; Verbesserungen an der Zuverlässigkeit der Windows-Sandbox beheben mehrere Abstürze in Sonderfällen bei lang laufenden Ausführungen; außerdem wurde das mitgelieferte Bubblewrap einschließlich vorgelagerter Sicherheitspatches auf 0.11.2 aktualisiert. Es sind keine Konfigurationsänderungen erforderlich. Führen Sie codex update aus, um diese Verbesserungen zu erhalten.⁸⁹

Empfohlene Konfigurationen

Tägliche Entwicklung (sichere Standardeinstellung):

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

Power-User (vollständiger Zugriff mit menschlicher Kontrolle):

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

Community-Beiträge empfehlen diese Kombination als „Sweet Spot“⁸; bevor Sie diesen Rat übernehmen, sollten Sie jedoch verstehen, was die Kombination tatsächlich bewirkt: Genehmigungsanfragen werden ausgelöst, wenn ein Befehl die Sandbox verlassen oder auf das Netzwerk zugreifen muss. danger-full-access hebt jedoch beide Grenzen auf, sodass bei on-request fast nichts mehr zu eskalieren bleibt. Das bedeutet maximale Berechtigungen bei minimalen Nachfragen und nicht maximale Berechtigungen mit menschlicher Prüfung jedes Befehls. Wenn Sie Letzteres wünschen, 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 einem Guardian-Subagenten (v0.115.0+)

Smart Approvals können Prüfungsanfragen an einen Guardian-Subagenten weiterleiten, 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 vorherige 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, bei denen Sie eine automatisierte, begründete Prüfung wünschen, statt pauschal approval_policy = "never" festzulegen.

Guardian-v2-Standardeinstellungen umgekehrt (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 es auf false, um den umfassenderen Prüfungsumfang für Tools beizubehalten — und features.guardianv2.transcript.include_images ist standardmäßig auf true gesetzt — setzen Sie es auf false, um Bilder aus Guardian-Transkripten herauszuhalten. Beide Funktionen wurden in v0.150.0 als konfigurierbare, standardmäßig deaktivierte Optionen eingeführt; seit v0.151.0 sind sie standardmäßig aktiviert.¹³⁵

Der Guardian-Prüfungsumfang richtet sich nach dem Genehmigungsmodus (v0.153.0): Zwei Modi überspringen jetzt Guardian-Arbeit, die das Ergebnis nicht beeinflussen kann. Im Modus Full Access (der bereits approvalPolicy: "never" mit uneingeschränkten Berechtigungen kombiniert) werden reine Bestätigungsanfragen von Guardian und MCP ohne synchrone Prüfung, Vorwärmen des Samplers oder Hintergrundbewertung genehmigt — ausstehende, fehlgeschlagene oder eingeschränkte Umgebungen gelten nicht als Full Access, und der aktive Berechtigungsstatus wird bei jedem Durchlauf neu bewertet, sodass ein bestehender Thread Full Access sicher aktivieren oder verlassen kann. Im Modus User approval (approvals_reviewer = "user") werden das Vorwärmen von Guardian und die asynchrone Bewertung übersprungen und gewöhnliche Ausführungsbestätigungen für node_repl.js automatisch akzeptiert, während Prüfungen sensibler Aktionen und Anfragen nach Benutzereingaben ihr bisheriges Verhalten beibehalten.¹⁴⁰ Dadurch wird eingeschränkt, wann Guardian ausgeführt wird, nicht jedoch die menschliche Genehmigungsebene: Das in diesem Leitfaden beschriebene Nachfrageverhalten für danger-full-access unter on-request ist Teil der Genehmigungsrichtlinie und damit ein separater Mechanismus. v0.152.1 ermöglicht Guardian-Genehmigungsprüfungen außerdem, die Node-REPL-Richtlinie aus den Modellmetadaten (auto_review.node_repl_policy) zu beziehen; fehlt dieses Feld, wird auf die mitgelieferte Richtlinie zurückgegriffen.¹³⁹

Die Computer-Use-Bewertung von Guardian berücksichtigt Modellanforderungen (v0.153.1): Ausschließlich auf Computer Use ausgerichtete Guardian-Bewertungen und schnelle Genehmigungsentscheidungen werden jetzt nur ausgeführt, wenn für das aktive Modell in seinen Metadaten node_repl_auto_review_required festgelegt ist. Frühere oder laufende Bewertungen werden ungültig, wenn bei einem Modellwechsel die Bewertung übersprungen wird — beim späteren Zurückwechseln zu einem geprüften Modell kann daher 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 ausschließlich über den Vergleich rust-v0.153.0…rust-v0.153.1 belegen.¹⁴²

Die Wiederverwendung der übergeordneten Komprimierung durch Guardian ist standardmäßig aktiviert (v0.156.0): #46522 stuft guardian_reuse_parent_compaction als stabile Funktion ein und aktiviert sie standardmäßig. Dadurch kann Guardian beim Neustart einer Prüfungssitzung die verschlüsselte Komprimierung des übergeordneten Threads wiederverwenden. Laut den Tests des PR werden zwischengespeicherte Prüfungssitzungen weiterhin ungültig, wenn sich der übergeordnete Verlauf ändert. So stellen Sie das vorherige Verhalten wieder her: Setzen Sie guardian_reuse_parent_compaction = false unter [features] in config.toml, oder führen Sie codex features disable guardian_reuse_parent_compaction aus.¹⁶⁹¹⁷¹

Der Guardian-Thread-Kontext ist standardmäßig aktiviert (v0.157.0): #47275 stuft guardianv2.thread_context als stabil ein und aktiviert ihn für synchrone und asynchrone Guardian-Prüfungen, sodass die Prüfungen Thread-eigenen Kontext verwenden. Die Funktion ist unabhängig vom Guardian-v2-Schalter enabled, und explizite Konfigurationen sowie Profilüberschreibungen bleiben erhalten. So deaktivieren Sie die Funktion: Setzen Sie thread_context = false unter [features.guardianv2] in config.toml.¹⁷⁴

Verschärfung des PowerShell-Klassifizierers (v0.142.2): PowerShell-Befehle mit ausführbaren AST-Bereichen, die der Sicherheitsklassifizierer nicht prüfen kann, erfordern jetzt eine Genehmigung, statt die automatische Genehmigung zu umgehen — damit wird eine Lücke geschlossen, durch die verschleierter oder dynamisch erzeugter PowerShell-Code die Klassifizierung unter Windows umgehen konnte.¹⁰⁵

Erweiterte Erkennung gefährlicher Befehle (v0.144.5): Die Erkennung identifiziert jetzt mehr erzwungene rm-Varianten, und bei abgelehnten Befehlen werden klarere Ablehnungsgründe zurückgegeben statt einer undurchsichtigen Verweigerung — nützlich, wenn Sie Genehmigungsrichtlinien abstimmen und wissen 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 wahr wurde. Konfigurierte Proxys werden jetzt bei Authentifizierung, Plugin-Downloads, MCP-Autorisierung, Remote-Ausführung, WebSocket-Verbindungen, HTTP-Weiterleitungen und LM-Studio-Verbindungen berücksichtigt — sieben Pfade, die den Versionshinweisen zufolge den Proxy zuvor ignorierten.¹¹⁴ Wenn Sie Codex vor v0.146.0 hinter einem Unternehmensproxy betrieben haben und Anmeldungen oder Plugin-Installationen fehlschlugen, während gewöhnliche Modellaufrufe funktionierten, ist diese Lücke die wahrscheinliche Erklärung.

Systemproxy unter macOS (v0.142.2+): Wenn respect_system_proxy aktiviert ist, berücksichtigen macOS-Authentifizierungsclients die Systemproxy-, PAC- und WPAD-Einstellungen — Unternehmens-Macs, deren Proxy-Konfiguration über Profile verteilt wird, benötigen daher für den Authentifizierungsverkehr keine Proxy-Umgebungsvariablen pro Shell mehr.¹⁰⁵ Seit v0.143.0 gilt dies auch für Windows und den Datenverkehr der Responses-API: Codex leitet sowohl Authentifizierungs- als auch Responses-API-Aufrufe über den macOS- oder Windows-Systemproxy, einschließlich der automatischen PAC- und WPAD-Konfiguration. Dadurch wird die letzte Lücke für streng abgeschottete Unternehmensnetzwerke unter 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 verweigerter Berechtigung fehlschlagen. Ist einer der Befehle erfolgreich, muss Ihre Sandbox-Konfiguration überprüft 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 Fähigkeiten von Codex, indem es eine Verbindung zu externen Tools und Diensten herstellt. 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 (entfernte Server).¹¹

MCP-Änderungen in v0.121.0: Tools werden jetzt mit einem Namespace registriert, sodass Tool-Namen in Auflistungen als <server>:<tool> statt als bloße Namen erscheinen — passen Sie alle Skripte oder Prompts an, die nach unqualifizierten Tool-Namen greppen. Ein neues Flag supports_parallel_tool_calls wird an eingebundene MCPs durchgereicht und ermöglicht die parallele Ausführung für Server, die entsprechende Unterstützung deklarieren. Sandbox-Statusmetadaten fließen nun durch die MCP-Tool-Metadaten, sodass Server ihr Verhalten anpassen können (z. B. warnen, wenn sie unter einer read-only-Sandbox laufen). Die benutzerdefinierte Anfrage codex/sandbox-state wurde entfernt — nutzen Sie stattdessen den Metadatenpfad. Phase 3 des MCP-Apps-Rollouts landet hier mit Tool-Call-Unterstützung; abgeflachte zurückgestellte Tool-Calls werden nun für Server unterstützt, die das Deferred-Call-Muster verwenden.⁸²

MCP-Änderungen in v0.142.2 (25. Juni 2026): MCP-Tools nutzen jetzt standardmäßig Tool-Suche, sofern unterstützt — statt jede Tool-Definition vorab zu laden, entdeckt Codex Tools bei Bedarf, was die Auffindbarkeit in tool-lastigen Setups verbessert und zugleich mit älteren Modellen und Anbietern kompatibel bleibt. Entfernte stdio-MCP-Server akzeptieren zudem absolute Arbeitsverzeichnisse im Pfadformat der entfernten Plattform (ein Windows-Pfad von einem macOS-Client aus oder umgekehrt).¹⁰⁵

MCP-Änderungen in v0.147.0 (7. August 2026): Codex ergänzt optionale Unterstützung für die MCP-Protokollrevision 2026-07-28 — paginierte Discovery (große Tool-Kataloge werden seitenweise übertragen statt in einer überdimensionierten Auflistung), Multi-Round-Anfragen (ein Server kann einen mehrstufigen Austausch innerhalb einer logischen Anfrage abwickeln) und nicht-blockierender Serverstart, wobei zwischengespeicherte MCP-Tools bereits verfügbar sind, bevor der Server vollständig gestartet ist, sodass ein langsamer Server den Sitzungsstart nicht mehr aufhält. Da die Unterstützung optional ist, funktionieren Server auf der älteren Revision unverändert weiter.¹¹⁶

MCP-Änderungen in v0.151.0 (29. August 2026): Optionale MCP-Server erhalten eine konfigurierbare Startkarenzzeit – mcp_optional_startup_grace_ms (Standard 1.000 ms) steuert, wie lange die Erfassung des Tool-Katalogs auf optionale Server wartet, 0 deaktiviert die gemeinsame Karenzzeit, sodass optionale Server auf ihr konfiguriertes startup_timeout_sec zurückfallen, und aktualisierte Werte greifen zur Laufzeit sowie bei MCP-Konfigurationsaktualisierungen. Erweiterungen können MCP-Tool-Ergebnisse außerdem prüfen oder ersetzen, bevor sie das Modell erreichen: ToolLifecycleContributor::on_mcp_tool_result läuft, bevor der MCP-Abschluss veröffentlicht und bevor das Ergebnis für das Modell aufbereitet wird — bei erfolgreichen wie bei fehlerhaften Ergebnissen gleichermaßen, auch über Code Mode.¹³⁴

MCP-Änderungen in v0.152.0 (1. September 2026): Drei additive Änderungen. openai/elicitation-Formularanfragen kommen hinzu: Codex signalisiert Formularunterstützung, wenn der Client eine objektwertige form-Capability deklariert, verarbeitet openai/elicitation/create-Anfragen und leitet deren Metadaten und opakes Schema über den App-Server als openaiForm weiter (unter Beibehaltung der x-openai-*-Annotationen); die Verarbeitung des älteren openai/form bleibt davon unabhängig, 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 ein positives output_token_limit (zum Beispiel [mcp_servers.context7.tools.search] mit output_token_limit = 2000); überschneiden sich Plugin- und Benutzerrichtlinien, gilt das restriktivste Limit, und das effektive Budget wird im Konversationsverlauf mitgeführt, sodass Tool-Ausgaben, Post-Tool-Hook-Antworten und fortgesetzte Sitzungen am selben Limit gekürzt werden – additiv neben dem globalen tool_output_token_limit. Servernamen im Package-Stil: MCP-Servernamen dürfen jetzt :, @, / und . enthalten (sodass npm:@modelcontextprotocol/server-sequential.thinking ein zulässiger Name ist), erhalten über mcp add/get/list/remove, Laufzeit-Tool-Namespaces und die OAuth-Anmeldedatensuche hinweg, wobei nicht-bloße Namen in den generierten config.toml-Wiederherstellungshinweisen in Anführungszeichen gesetzt werden.¹³⁸

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 (entfernt):

[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

In der Sitzung: /mcp zeigt aktive Server und verfügbare Tools an. /mcp verbose (ab v0.123.0)⁸⁴ liefert vollständige Server-Diagnosen, Ressourcen und Ressourcenvorlagen — nützlich, wenn ein Server nicht lädt oder Tools nicht dort erscheinen, wo sie erwartet werden. Einfaches /mcp bleibt schnell. Seit v0.144.0 können MCP-Tools ohne experimentelles Opt-in interaktiv eine Authentifizierung anfordern — ein Server, der mitten in der Sitzung Auth benötigt, fragt über den normalen Ablauf nach, statt so lange zu scheitern, bis Sie sich vorab mit codex mcp login authentifizieren.¹⁰⁷

Das Laden von Plugin-MCPs (ab v0.123.0) akzeptiert sowohl das Standardschema mcpServers als auch Server-Maps auf oberster Ebene in .mcp.json, sodass Plugins, die nach einer der beiden Konventionen erstellt wurden, sauber laden.⁸⁴

MCP-Benutzerverifizierung (v0.155.0, unterstützte Macs): Lokale TUI-Sitzungen auf unterstützten Macs können MCP-Anfragen mit Touch ID verifizieren, signiert von der Secure Enclave (#43624, #43712, #43715). Die Verifizierungsidentität ist auf den Workspace beschränkt, in dem sie registriert wurde (#43524), und die Verifizierung wird nativ in MCP-Tool-Fortsetzungen übernommen (#44346). Erstmals auf der Promotion-Checkliste zu v2.68 beobachtet, aus 0.154.0 mit dem alpha.7-Cluster herausgeschnitten, ausgeliefert in 0.155.0.¹⁵⁶

Codex ALS MCP-Server betreiben

Entfernt (v0.154.0, 9. September 2026). Der Befehl codex mcp-server und die eigenständige Binärdatei codex-mcp-server sind seit dem stabilen Release 0.154.0 nicht mehr vorhanden (#42993), womit die am 24. August 2026 angekündigte Deprecation abgeschlossen ist. Das offizielle Changelog (5. September 2026): „Der Befehl codex mcp-server und die eigenständige Binärdatei codex-mcp-server wurden nach ihrer Deprecation am 24. August 2026 entfernt. Aktualisieren Sie Integrationen, die einen der beiden Befehle starten, bevor Sie Codex aktualisieren.” Integrationen sollten auf das App-Server-Protokoll abzielen, die Schnittstelle hinter der VS Code-Erweiterung und der Desktop-App (Authentifizierung, Konversationsverlauf, Genehmigungen, gestreamte Agent-Ereignisse) – die der Entfernungseintrag selbst als experimentell bezeichnet und die „für Produktionslasten nicht unterstützt” ist – oder, von Claude Code aus, auf das Codex-Plugin für Claude Code: „Nutzen Sie Codex aus Claude Code heraus, um Code zu überprüfen oder Aufgaben zu delegieren.” Das Verbinden von Codex MIT externen MCP-Servern (codex mcp ..., /mcp) ist davon nicht betroffen.^125152153

Auf CLI 0.153.4 und früher existiert der Befehl weiterhin (deprecated seit dem 24. August 2026; seit v0.149.0 gibt er warning: `codex mcp-server` is deprecated and will be removed in a future release. auf stderr aus und startet dann trotzdem, PR #39657), sodass das Pinning per npm install -g @openai/codex@0.153.4 die Übergangslösung ist, falls eine Integration nicht sofort migriert werden kann:^12125148152

codex mcp-server                        # REMOVED in 0.154.0; works only on 0.153.x and earlier (deprecated, warns)

Auf 0.153.x und früher stellt der Server zwei Tools bereit: 1. codex(): Startet eine neue Sitzung mit Prompt-, Sandbox-, Modell- und Genehmigungsparametern 2. codex-reply(): Setzt eine bestehende Sitzung mit threadId und Prompt fort

Verwendung mit dem Agents SDK (Python) – nur CLI 0.153.4 oder früher:

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

async with MCPServerStdio(
    name="Codex CLI",
    params={"command": "npx", "args": ["-y", "@openai/codex@0.153.4", "mcp-server"]},  # pin: removed in 0.154.0
    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")

Bemerkenswerte MCP-Server

Praktische Muster

Muster 1: Kontextbewusste Entwicklung — Kombinieren Sie Context7 mit Ihrer Framework-Dokumentation, damit Codex stets aktuelle API-Referenzen zur Hand hat:

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

Muster 2: Ausgabelimits — MCP-Tool-Antworten werden standardmäßig bei etwa 25.000 Zeichen gekürzt. Nutzen Sie bei Tools, die große Datenmengen zurückgeben (Datenbankabfragen, Log-Erfassungen), enabled_tools, um auf bestimmte Tools einzuschränken und die Antworten fokussiert zu halten.

Muster 2a: Multimodale Tool-Ausgabe (v0.107.0) — Benutzerdefinierte Tools können nun multimodale Ausgaben (Bilder, Rich Content) zusätzlich zu Text zurückgeben. Damit können Tools, die visuelle Artefakte erzeugen — Screenshots, Diagramme, Chart-Renderings —, diese direkt zur Analyse an das Modell übergeben.⁶²

Muster 3: MCP-Governance im Unternehmen — Legen Sie per requirements.toml 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. Siehe Enterprise-Deployment für die vollständige Richtlinienkonfiguration.

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 einen Ansatz entwerfen, bevor Änderungen ausgeführt werden. Er ist standardmäßig aktiviert (seit v0.94.0).¹⁴ Unter Entscheidungsframeworks finden Sie den Entscheidungsbaum „Plan Mode oder direkte Ausführung“.

Plan Mode im Vergleich zum Tool update_plan (v0.152.0): Dabei handelt es sich um 2 verschiedene Dinge, von denen nur eines standardmäßig aktiviert ist. Der Plan Mode – der in diesem Abschnitt beschriebene Zusammenarbeitsmodus, 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 in v0.152.0 als Opt-in-Funktion eingeführt: tools.update_plan.enabled ist standardmäßig auf false gesetzt. Solange es deaktiviert ist, entfernt Codex außerdem die mitgelieferten update_plan-Anweisungen aus seinen Prompts für das Modell, den Zusammenarbeitsmodus, Multi-Agent, die Komprimierung, das Vorwärmen und die Zielfortsetzung. Benutzerdefinierte Basisanweisungen, Modellkataloganweisungen, Zusammenarbeitsrichtlinien und der Zieltext des Benutzers bleiben auch dann erhalten, wenn darin Planung erwähnt wird. 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 Schritte 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 neue Anweisungen einfügen, während Codex aktiv arbeitet, ohne die aktuelle Aufgabe zu unterbrechen.¹⁴

Dafür stehen 2 Eingabemethoden zur Verfügung:

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 seine Arbeit beendet hat, bevor Sie weitere Anweisungen geben, tippen Sie nach Abschluss des Turns einfach wie gewohnt weiter – ein besonderer Modus ist nicht erforderlich.

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

Syntaxhervorhebung (v0.105.0): Die TUI hebt nun die Syntax von abgegrenzten Codeblöcken und Diffs direkt im Text 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 Mikrofonberechtigungen.⁶¹ Seit v0.107.0 unterstützen Echtzeit-Sprachsitzungen die Auswahl von Mikrofon- und Lautsprechergeräten, sodass Sie bestimmte Hardware für die Audioein- und -ausgabe auswählen können.⁶² In v0.140.0 entfernt, in v0.145.0 zurückgekehrt: Die experimentellen /realtime-Sprachsteuerungen 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 Ausgaben von Audio-Tools in gängigen lokalen Audioformaten sowie gestreamte Echtzeitunterhaltungen mit V3.¹¹² v0.155.0 und v0.156.0: Live-Sprachunterhaltungen. Mit v0.155.0 (17. September 2026) wurde /voice als experimentelle Opt-in-Funktion eingeführt: eine Live-Unterhaltung mit gestreamtem Transkript und Mikrofonsteuerung, die in unterstützten Builds über /experimental aktiviert wird (#43581, #43651, #44331), einschließlich eines konfigurierbaren Tastenkürzels zum Stummschalten (#43690) und signierter Sprachressourcen in den macOS-Paketen (#43983). Mit v0.156.0 (22. September 2026) wurde die Funktion stabil und standardmäßig aktiviert (#44921). Im Änderungsprotokoll der Dokumentation wurde am selben Tag Folgendes angekündigt: „Sprachunterhaltungen sind standardmäßig aktiviert und bieten eine Umschaltung mit F8, eine Auswahl für /voice settings sowie mitgelieferte Audiolaufzeitumgebungen für Linux und Windows.“ Um die Funktion zu deaktivieren, setzen Sie realtime_conversation = false unter [features] in config.toml. In der Slash-Command-Referenz CLI ist /voice weiterhin nicht aufgeführt, und die Dokumentationsseite zur Sprachfunktion behandelt ChatGPT Voice in der Desktop-App – eine separate Oberfläche.¹⁵⁶¹⁶⁹

Weitere Verbesserungen: - Lange Links bleiben jetzt auch dann anklickbar, wenn sie über mehrere TUI-Zeilen umbrochen werden (v0.105.0)⁶¹ - Lokale Dateilinks werden mit verbesserter Formatierung dargestellt (v0.106.0)⁶⁰ - TUI-Markdown hält Weblinks über OSC-8-Metadaten anklickbar; Tabellen mit zu wenig Platz werden auf lesbare Schlüssel/Wert-Datensätze zurückgeführt, ohne Linkziele zu verlieren (v0.136.0)¹⁶⁸ - Markdown-Links erscheinen in unterstützten Terminals als anklickbare Beschriftungen; andernorts bleiben die sichtbaren URLs erhalten (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 dauerhaftes Speichersystem (ab 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 zu Beginn einer Sitzung und berücksichtigt sie in allen zukünftigen Sitzungen bei seinem Verhalten.

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.

Speicherverbesserungen (v0.101.0–v0.107.0)

• Bereinigung von Geheimnissen: Erinnerungen werden automatisch auf Geheimnisse geprüft, bevor sie auf die Festplatte geschrieben werden
• CWD-Berücksichtigung: Speicherdateien enthalten jetzt den Kontext des Arbeitsverzeichnisses, damit projektspezifische Informationen abgerufen werden können
• Ausschluss von Entwicklermeldungen: Entwickler- und Systemmeldungen 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 nutzt jetzt Diff-basiertes Vergessen, um veraltete Fakten zu entfernen. Dadurch bleibt der Speicherbestand langfristig schlank und relevant⁶⁰
• Nutzungsabhängige Auswahl (v0.106.0): Der Abruf aus dem Speicher berücksichtigt jetzt die Nutzung und priorisiert häufig aufgerufene sowie in letzter Zeit relevante Erinnerungen⁶⁰
• Konfigurierbare Erinnerungen (v0.107.0): Erinnerungen sind jetzt vollständig konfigurierbar. Mit codex debug clear-memories können Sie alle gespeicherten Erinnerungen zurücksetzen und neu beginnen – hilfreich beim Wechsel zwischen nicht zusammenhängenden Projekten oder wenn sich der Speicherzustand von der aktuellen Situation entfernt hat⁶²
• Modellupgrade für Phase 2 (v0.121.0): Das Modell für die Speicherkonsolidierung in Phase 2 ist jetzt gpt-5.4 und ersetzt den bisherigen Standard. Die Phase-2-Pipeline wird zwischen Sitzungen ausgeführt und verdichtet Transkripte aus Phase 1 zu dauerhaften Fakten; der Modellwechsel verbessert die Qualität des Abrufs bei gleichen Tokenkosten.⁸²
• TUI-Speichermenü (v0.121.0): Eine neue Benutzeroberfläche innerhalb der Sitzung 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, statt ungültig zu werden. Dadurch wird die Oberfläche für zukünftige Abrufe geleert, ohne die Sitzungswiedergabe zu beeinträchtigen.⁸²

Speicher im Vergleich zu AGENTS.md

Tipp: Verwenden Sie /m_update für Fakten, die unbegrenzt erhalten bleiben sollen. Sitzungsspezifischen Kontext können Sie Codex einfach direkt in der Unterhaltung mitteilen. Für einen im Team geteilten Kontext 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; Self-Managed GitLab erfordert Version 19.0 oder neuer.¹¹⁹

Status: Codex Cloud ist eine experimentelle Funktion. Schnittstellen, Preise und Verfügbarkeit können sich ändern. OpenAI verwaltet die Cloud-Umgebungen; 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 Terminalkonversation angesprochen werden: Verweisen Sie mit @-Erwähnungen auf andere Codex-Aufgaben und bitten Sie Agenten, Aufgaben zu lesen, zu erstellen oder ihnen Nachrichten zu senden.¹³² Informationen zur Integration von Codex in Ihre CI-Pipeline finden Sie auch 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 nun eingeschränkt, noch bevor die Authentifizierung 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). Zudem sind Weiterleitungen für das Backend der Cloud-Aufgaben und 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 einen Diff zur Überprüfung bereit
5. Übernehmen Sie die Ergebnisse mit codex apply <TASK_ID> lokal

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 das Internet verwenden, 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, sobald die Aufgabe abgeschlossen ist.

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 Benutzeroberflä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 direkt herunterladen: Codex.dmg (macOS) | Im Microsoft Store erhältlich (Windows)

Hauptfunktionen

Appshots, Browserkommentare und Computer Use

Mit den App-Aktualisierungen vom 21. Mai wird die Desktop-App zu einer leistungsfähigeren Kontextoberfläche und ist nicht länger nur ein 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 Bildschirms liegenden Text, den die App bereitstellt, und speichert den Anhang lokal im Sitzungsverlauf.⁹⁹

Verwenden Sie bei Web- und Frontend-Arbeiten zunächst den integrierten Browser, sofern für die Seite keine Anmeldung erforderlich ist: Er stellt Ihnen und Codex eine gemeinsame gerenderte Vorschau bereit, unterstützt Browseraktionen wie Klicken, Screenshots, das Herunterladen von Assets und die schreibgeschützte Prüfung mit JavaScript und ermöglicht Ihnen, Seitenbereiche mit Kommentaren zu markieren, die Codex im nächsten Vorgang bearbeiten kann.⁹⁹ Verwenden Sie für Websites, bei denen Sie angemeldet sind, weiterhin die Browsererweiterung (Chrome, Edge, Brave, Opera oder Vivaldi; Opera bietet keinen seitlichen Chat). 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. Nutzen Sie in der neuesten Desktop-App GPT-5.6 Sol oder GPT-5.6 Terra, da Website-Werkzeuge mit GPT-5.6 Luna sowie in Enterprise- oder Edu-Arbeitsbereichen nicht verfügbar sind.¹²⁷

Verwenden Sie Computer Use nur, wenn sich die Aufgabe weder durch eine strukturierte Integration noch über die Browservorschau verifizieren lässt. Die Funktion kann zugelassene Mac-Apps prüfen und bedienen, übernimmt für Dateiänderungen und Shell-Befehle jedoch die Genehmigungs- und Sandbox-Regeln von Codex. Auch die Nutzung im Sperrzustand bleibt eng begrenzt: Während aktiver, vertrauenswürdiger Computer Use-Vorgänge kann Codex nach dem Sperren des Macs vorübergehend auf zugelassene Apps zugreifen; dabei greifen Schutzmaßnahmen zur erneuten Sperrung und eine Erkennung lokaler Eingaben.⁹⁹

Thread-Modi

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

Mechanik 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 einen neuen Branch von Ihrem aktuellen HEAD aus 3. Sie führt den Agenten innerhalb des Worktrees aus – alle Dateiänderungen bleiben isoliert 4. Nach Abschluss zeigt sie eine Diff-Prü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-Zuständigkeit (v0.151.0): Das Verhalten verwalteter Worktrees wird von einem dedizierten Einstellungsparser aus der vorhandenen [desktop]-Konfiguration ermittelt. Der Worktree-Stammordner ist standardmäßig $CODEX_HOME/worktrees, die automatische Bereinigung ist standardmäßig aktiviert und 15 Worktrees werden aufbewahrt. Konfigurierte Stammordner, Bereinigungsoptionen und Aufbewahrungsanzahlen werden vor der Verwendung validiert. Jeder verwaltete verknüpfte Worktree kann außerdem in seinen Git-Metadaten einen versionierten codex-thread.json-Zuständigkeitsdatensatz enthalten, der ihn einem Thread zuordnet: Schreibvorgänge sind atomar und überschreiben nichts (wiederholte Zuordnungen sind idempotent, kollidierende Zuständigkeiten werden abgelehnt). Primäre, verschachtelte und nicht verwaltete Checkouts werden abgelehnt, bevor die Zuständigkeitsmetadaten verändert werden.¹³⁵

Verwaltete Worktrees erreichen in v0.154.0 experimentell die CLI: --worktree beim Start oder /worktree in der TUI erstellt einen isolierten Checkout für eine neue oder geforkte Sitzung, codex exec unterstützt verwaltete Worktrees für Automatisierungen, und mit TUI-Sitzungsbefehlen sowie einem Worktree-Browser können Sie Worktree-Sitzungen auflisten, durchsuchen und fortsetzen (#42196, #42366, #42652, #43069, #43120, #43286). v0.155.0 ergänzt die zugehörigen Verwaltungsfunktionen, während Worktrees weiterhin nicht standardmäßig aktiviert sind: In der Agentenübersicht lassen sich Worktree-Sitzungen ausblenden, archivieren und löschen, Zuständigkeitsdetails werden angezeigt und beim Löschen eines unveränderten verwalteten Worktrees wird eine Bestätigung angefordert (#43942, #44424, #44433). Die standardmäßige Aktivierung (#44870) wurde am 11. September gemergt, war jedoch NICHT Bestandteil der stabilen Version 0.155.0; dies wurde anhand der Abstammung zum Tag rust-v0.155.0 geprüft.¹⁵²¹⁵⁶

Verwaltete Worktrees werden in v0.156.0 zum Standard: #44870 stuft worktrees zu einer stabilen Funktion hoch, aktiviert sie standardmäßig und entfernt sie aus /experimental. Gleichzeitig ausgeliefert werden folgende Funktionen: Worktree-Sitzungen können eine Verbindung zu einem vorhandenen lokalen Daemon herstellen, statt einen eigenen zu starten (#46498), und sie lassen sich direkt aus der Agentenübersicht erstellen (#45276), die außerdem Registerkarten zum Filtern nach Status erhält (#46839). Falls Ihre Skripte oder Konfigurationen davon ausgehen, dass Worktrees nur auf Anforderung aktiviert werden, ändert Version 0.156.0 deren Verhalten. So deaktivieren Sie die Funktion: Legen Sie unter [features] in config.toml den Wert worktrees = false fest (für einen einzelnen Lauf: --disable worktrees). Ältere lokale Daemons: Falls die Erstellung eines Worktrees oder /cd mit „The local Codex service cannot check background terminals“ blockiert wird, führen Sie codex app-server daemon update aus und starten Sie Codex neu.¹⁶⁹¹⁷¹

Automatisierungen

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

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

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. Verfassen Sie den Prompt und wählen Sie den Ausführungsmodus (lokal oder Worktree) 5. Legen Sie die Reasoning-Stufe für den Automatisierungslauf fest (App v26.312)⁷² 6. Automatisierungen werden planmäßig ausgeführt und stellen die Ergebnisse zur Prüfung in eine Warteschlange

Beispiele für Anwendungsfälle: - Issue-Triage: Neue Issues automatisch kategorisieren und priorisieren - CI-Überwachung: Build-Fehler überwachen und Korrekturen vorschlagen - Reaktion auf Warnmeldungen: Mit einer Diagnoseanalyse auf Überwachungswarnungen reagieren - Abhängigkeitsaktualisierungen: Sicherheitspatches suchen und anwenden

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

Windows-Unterstützung

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

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/Aufträge.

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

Das TypeScript SDK bindet die Agentenfunktionen von Codex in benutzerdefinierte Anwendungen ein.¹⁹

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 (v0.132.0+): Anmeldung per API-Schlüssel, ChatGPT-Browser-/Gerätecode-Abläufe, Kontoprüfung und Abmeldung sind vollwertige SDK-Pfade.⁹⁷
• Komfortfunktion für reine Textdurchläufe (v0.132.0+): Python-Durchlauf-APIs akzeptieren einfache Zeichenfolgen und geben umfangreichere TurnResult-Metadaten mit erfassten Elementen, Zeitangaben und Nutzung zurück.⁹⁷
• outputSchema: Erzwingt eine JSON-förmige 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 können erneut geöffnet werden 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 arbeitsordnerspezifischer Auswahl pro Durchlauf, in v0.125.0 um persistente Umgebungen ergänzt), löst view_image Dateipfade nun über die ausgewählte Umgebung statt über das lokale Dateisystem des Orchestrators auf. Ein aus einer Remote-Umgebung angehängtes Bild wird relativ zum Arbeitsordner dieser Umgebung abgerufen und nicht relativ zum Host, auf dem das SDK ausgeführt wird.⁹¹

Thread- und Clientkonfiguration

// 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 variiert je nach Modell. Die aktuelle GPT-5.6-Familie (Sol, Terra, Luna) verwendet ein Fenster von 272K; GPT-5.5, das Flaggschiff der vorherigen Generation, bietet 400K in Codex (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 Kontextfenster 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: Hochwertige AGENTS.md-Dateien und lokale Dokumentation verringern den Erkundungsaufwand, der Kontext verbraucht
3. Hängen Sie mit @ bestimmte Dateien an: Verweisen Sie direkt auf Dateien, statt Codex zu bitten, sie zu suchen
4. Formulieren Sie zielgerichtete Prompts: Klar abgegrenzte Prompts mit genauen Dateiangaben verbrauchen weniger Kontext als ergebnisoffene Erkundungen

Experimentelle Kontextverwaltung (v0.153.0, standardmäßig deaktiviert): features.context_management.experimental_mode aktiviert einen koordinierten Kontextstapel – Kontext mit Token-Budget, Verlaufsnotizen und ein new_context-Tool – für geeignete ChatGPT-Plus-, Pro- und Pro-Lite-Sitzungen, die das Codex-Backend verwenden. Sitzungen mit API-Schlüssel, benutzerdefinierte Anbieter, Nicht-Codex-Endpunkte und temporäre strukturierte Threads sind ausgeschlossen. Die Funktion befindet sich ausdrücklich in Entwicklung: Betrachten Sie sie als Vorschau auf die künftige Kontextverwaltung und nicht als Grundlage für Workflows.¹⁴⁰ v0.154.0 ergänzt eine Funktionssperre: Die Eignung wird beim Sitzungsstart anhand der Funktionen des aktiven Modells bestimmt (#43147) – über dieselbe Schnittstelle, die in der Dokumentation zu den Codex-Modellen für die Plus- und Pro-Anmeldung namentlich Astra zuordnet (siehe den kontextübergreifenden Hinweis unter „Welches Modell sollte ich wählen?“).¹⁴⁶¹⁵² Seit v0.157.0 ist im mitgelieferten Katalog kein Modell als unterstützt gekennzeichnet (#47397), sodass die Einstellung mit diesem Katalog keine Wirkung hat.¹⁷⁴

Token-Effizienz

Geschwindigkeitsoptimierung

1. gpt-5.3-codex-spark: Variante mit geringerer Latenz für die interaktive Zusammenarbeit
2. --profile fast: Vorkonfiguriertes gpt-5.6-luna mit geringem Reasoning-Aufwand
3. Parallele Tool-Ausführung: Codex führt voneinander unabhängige Lese- und Prüfvorgänge gleichzeitig aus; strukturieren Sie Ihre Prompts entsprechend
4. Ergebnisorientierte Schleifen: Fordern Sie „implementieren, testen, korrigieren und beenden, sobald alles erfolgreich ist“ anstelle von Schritt-für-Schritt-Anweisungen an

Wie kann ich Probleme debuggen?

Häufige Probleme und Lösungen

Referenz der Fehlermeldungen

Was bewirkt codex doctor?

codex doctor ist der zentrale Befehl, den Sie ausführen sollten, bevor Sie einen Fehler melden oder eine fehlerhafte Installation untersuchen. Er erfasst die lokale Laufzeitumgebung, Konfiguration, Authentifizierung, das Terminal, Netzwerk und den Zustand in einem einzigen Bericht. Auch die Vorlage für Issues 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 einheitliche Abschnitte gegliedert, sodass Sie direkt zum benötigten Abschnitt springen können:¹⁶³

Jede Prüfung enthält eine Statusmarkierung – ✓ in Ordnung, ✗ 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 Support-Skript verwenden.¹⁶³

Der Funktionsumfang des Befehls ist mit mehreren Releases gewachsen: Er wurde in v0.131.0 eingeführt, erhielt in v0.135.0 Berichte zur Umgebung, zu Git, zum Terminal, App-Server und Thread-Bestand und wurde in v0.139.0 um Details zu Editor und Pager ergänzt, wobei sensible Werte in JSON unkenntlich gemacht werden.^96176165

Verwenden Sie ihn zuerst, nicht zuletzt. Die meisten Meldungen, dass „Codex nicht funktioniert“, lassen sich auf eine Ursache zurückführen, die doctor bereits benennt: einen veralteten Authentifizierungsmodus, eine config.toml, die nicht geparst werden konnte, oder eine zweite Installation, die jene 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-Diagnosen innerhalb einer 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 Flag auf oberster Ebene. Verwenden Sie die oben aufgeführten Debug-Unterbefehle und TUI-Diagnosen.

Saubere Neuinstallation

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

Dabei bleibt ~/.codex/ mit Authentifizierungsdaten, Konfiguration und Sitzungen erhalten. Informationen zum Festlegen einer exakten Version, zum Downgrade nach einem fehlerhaften Release oder zum vollständigen Löschen des Zustands finden Sie unter Codex CLI aktualisieren, herabstufen 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 Issues 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 Sicherheitsprüfungen für Anwendungen.⁷⁷ Die Funktion ist über Codex Web für Kunden mit ChatGPT Pro, Enterprise, Business und Edu verfügbar.

Funktionsweise: Codex Security analysiert Repositorys, um ein projektspezifisches Bedrohungsmodell zu erstellen, identifiziert anhand ihrer realen Auswirkungen klassifizierte Sicherheitslücken und unterzieht die Ergebnisse in einer Sandbox-Umgebung Belastungstests, um sie zu validieren. Der Agent hebt zuverlässigere Befunde samt Korrekturen hervor und reduziert so die durch unbedeutende Fehler verursachte Flut an Meldungen.

Leistung: Während der Forschungsvorschau untersuchte Codex Security 1,2 Millionen Commits und identifizierte 10.561 Sicherheitslücken mit hohem Schweregrad. Die Präzision verbesserte sich im Laufe der Zeit: Das Rauschen sank um 84 %, die überhöhte Einstufung des Schweregrads um mehr als 90 % und die Rate falsch positiver Meldungen um die Hälfte. Das System hat reale Sicherheitslücken 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 Rechner vor Codex; Codex Security schützt Ihre Codebasis vor Sicherheitslücken.

Enterprise-Bereitstellung

Administratorkontrollen (requirements.toml)

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

v0.146.0 führt die Erkennung von Enterprise-Tarifen sowie Administratorkontrollen für In-App-Updates ein.¹¹⁴ In einer verwalteten Geräteflotte entscheidet damit nicht mehr jeder Entwickler selbst, wann er CLI nach dem Erscheinen einer neuen Version aktualisiert, sondern der Administrator bestimmt den Zeitpunkt der Einführung. In den Versionshinweisen wird diese Kontrolle angekündigt, ohne den zugehörigen requirements.toml-Schlüssel zu veröffentlichen. Betrachten Sie daher den genauen Namen der Einstellung 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"