Konfigurationsreferenz

Vollständige Referenz für Codex config.toml und requirements.toml

Verwenden Sie diese Seite als durchsuchbare Referenz für Codex-Konfigurationsdateien. Konzeptionelle Anleitungen und Beispiele finden Sie zunächst unter Grundlagen der Konfiguration und Erweiterte Konfiguration.

Einstellungen für den lokalen Computerzugriff mit Work Cloud

Wenn der lokale Computerzugriff mit Work Cloud aktiviert ist, koordiniert die Cloud von OpenAI die Aufgabe, während unterstützte Tools in der Cloud oder auf einem verbundenen Computer ausgeführt werden. Anforderungen legen Grenzen fest; Konfigurationswerte geben Standardwerte vor.

Verwenden Sie die Richtlinien-API, um Einstellungen für Global zu verwalten. Einstellungen für Local oder Codex Cloud verwalten Sie über die Agent Security-Oberfläche. Bestehende API-Workflows für Global bleiben nach der Migration verfügbar. Testen Sie Ihre Skripte und Terraform-Integrationen und vergewissern Sie sich, dass Richtlinienzuweisungen und Reihenfolge unverändert sind. Die Unterstützung eines Feldes in requirements.toml allein gewährleistet keine API-Kompatibilität.

Einstellung oder Einstellungsgruppe Geltungsbereich beim lokalen Computerzugriff mit Work Cloud Hinweise
Genehmigungsrichtlinien und Prüfanforderungen Global-Richtlinie für den Orchestrator, wenn verwaltete Richtlinien aktiviert sind Belassen Sie Genehmigungs- und Prüfkontrollen in Global. Umgebungsspezifische Überschreibungen können die Kontrollen des Orchestrators nicht ändern. Für die lokale Ausführung und die Ausführung in Cloud-Containern gelten separate Richtlinienbereiche.
Verwaltete Apps, MCP server, Plugins, Marktplätze und Befehlsregeln Global-Richtlinie Belassen Sie diese Kontrollen auf globaler Ebene. Werten Sie das Vorhandensein eines Feldes in einem Schema nicht als Beleg dafür, dass es pro Umgebung bearbeitet werden kann.
Datei-, Sandbox- und übertragbare Netzwerkanforderungen Lokale Ausführung Bei der lokalen Ausführung haben MDM-Anforderungen und bisherige Anforderungen für verwaltete Geräte Vorrang vor Agent Security. Die Systemanforderungsdatei des Geräts ist Agent Security nachgeordnet. Die neue Enterprise-Konfiguration über requirements.toml gilt nicht für Work-Cloud-Container, für die weiterhin die bestehenden Work Cloud-Richtlinien gelten.
Plattformspezifische Kontrollen für die Ausführungsinstanz Computer, auf dem der Schritt ausgeführt wird Die Unterstützung hängt von der Ausführungsinstanz und der Plattform ab.
Verwaltete Hooks Sofern aktiviert: von Administratoren definierte MCP-Hooks, die bei unterstützten Lebenszyklus- und Tool-Ereignissen auf dem Cloud-Koordinator (Orchestrator) ausgeführt werden. Bevor Sie sich auf diese Hooks verlassen, testen Sie die Callback-Verbindung, prüfen Sie, welche Ereignisse sie empfängt, und kontrollieren Sie, wie sich Fehler auf die Aufgabe auswirken. MCP-Hooks liefern keinen vollständigen Audit-Trail für die Compliance API. Befehls-Hooks sowie Hooks aus der lokalen Konfiguration oder aus Plugins werden bei der Cloud-Orchestrierung nicht unterstützt, auch wenn Tools lokal ausgeführt werden. Bestehende unterstützte Hooks gelten weiterhin für rein lokale Work- und Codex-Threads, bei denen sowohl Orchestrierung als auch Ausführung lokal erfolgen.
Proxy-Listener-Adressen, Ports und Prozesseinstellungen Keine übertragbare Umgebungsrichtlinie Verwaltete HTTP/SOCKS-Listener-Ports und Proxy-Listener außerhalb von Loopback werden von der Cloud-Laufzeitumgebung nicht unterstützt; die Unterstützung von Socket-Regeln hängt vom Ausführungspfad ab. Die benutzerdefinierte Proxy-Konfiguration ist von den unterstützten Zielbeschränkungen getrennt.
App-spezifische Einstellungen und gewöhnliche lokale Standardwerte Werden nicht zwangsläufig von der Cloud-Koordination berücksichtigt Von der App durchgesetzte Kontrollen können wirksam bleiben, auch wenn der lokale Computerzugriff mit Work Cloud sie nicht berücksichtigt. Die Bereitstellung über die Cloud und das Verhalten des Cloud-Browsers müssen separat validiert werden.

Agent Security-Anforderungen für den lokalen Computerzugriff mit Work Cloud

Für Work mit lokalem Zugriff und dots gilt die unterstützte Global-Richtlinie für den gemeinsam genutzten Cloud-Orchestrator, wenn verwaltete Richtlinien aktiviert sind. Für den verbundenen Computer gelten die Anforderungen an die lokale Ausführung. Work-Cloud-Container und dots-Cloud-Computer verwenden ihre eigene Ausführungskonfiguration und eigene Anforderungen. Testen Sie lokale Kontrollen und Cloud-Kontrollen separat.

In der Agent Security-Oberfläche verfügbar

  • Zulässige Genehmigungsrichtlinien
  • Zulässige Websuchmodi

Über TOML konfiguriert

  • allowed_approvals_reviewers
  • auto_review
  • guardian_policy_config
  • apps
  • mcp_servers
  • plugins
  • rules

Diese Orchestrator-Anforderungen verbleiben in Global. Sie konfigurieren weder Berechtigungen für gemeinsam genutzte Cloud-Funktionen noch machen sie lokale Ausführungseinstellungen auf Work-Cloud-Container oder dots-Cloud-Computer übertragbar.

Kompatibilitätsgrenzen des lokalen Computerzugriffs mit Work Cloud

Die Unterstützung hängt vom Feld, der Art der Richtlinienbereitstellung und dem Ausführungsort der Aufgabe ab. Prüfen Sie die für das Mitglied wirksame Richtlinie, bevor Sie die Synchronisierung aktivieren. Einige Kontrollen müssen in Ihrer Bereitstellung getestet werden, wie in der Tabelle angegeben.

Innerhalb einer Richtlinie gilt folgende Rangfolge von der höchsten zur niedrigsten Priorität: betriebssystemspezifische Umgebungsüberschreibung → betriebssystemübergreifende Umgebungsüberschreibung → Global. Eine Richtlinie mit höherer Priorität hat auch dann Vorrang, wenn eine Richtlinie mit niedrigerer Priorität spezifischer ist.

Bei der lokalen Ausführung haben MDM-Anforderungen und ältere Anforderungen für verwaltete Geräte Vorrang vor Agent Security, das wiederum Vorrang vor der Systemanforderungsdatei des Geräts hat. Für einige Anforderungen, darunter Netzwerkanforderungen, gelten feldspezifische Zusammenführungsregeln und Laufzeitbeschränkungen. Beispiele finden Sie unter Verwaltete Konfiguration.

Einstellung oder Gruppe Kompatibilität mit lokalem Computerzugriff über Work Cloud Hinweise für Administratoren
sqlite_home, log_dir, model_catalog_json Als verwaltete Cloud-Überschreibungen nicht unterstützt. Lokale Pfade können Cloud-Speicher oder Protokolle nicht verlagern. Ein lokaler Modellkatalog wird nicht übernommen.
model_provider, model_providers In verwalteten Anforderungen oder Konfigurationen für lokalen Computerzugriff über Work Cloud nicht unterstützt. Benutzerdefinierte Inferenz-Gateways und Anbieterverbindungen werden über diese Felder nicht übernommen. Dies ist von der Modellauswahl unabhängig.
enforce_residency Blockiert lokalen Computerzugriff über Work Cloud, wenn die Einstellung in einer beliebigen Cloud-Richtlinie aktiviert ist. Wenn enforce_residency in einer beliebigen Cloud-Richtlinie aktiviert ist, wird Allow local computer access sowohl für Work als auch für dots deaktiviert. Diese Schutzmaßnahme konfiguriert weder die Datenresidenz des Arbeitsbereichs noch deaktiviert sie für sich genommen Work Cloud oder dots.
application.network.enabled und application.network.domains Vom lokalen Computerzugriff über Work Cloud nicht unterstützt. Verwenden Sie diese Beschränkungen für Anwendungsziele nicht zur Steuerung des Netzwerkzugriffs von Befehlen beim lokalen Computerzugriff über Work Cloud.
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions Die Übermittlung von Cloud-Richtlinien muss validiert werden. Lokaler Computerzugriff über Work Cloud weist diese Schlüssel für verwaltete Anforderungen zurück. Browserbeschränkungen werden auf App-Seite geprüft. Das belegt weder die Übermittlung über die Cloud noch die Durchsetzung im Cloud-Browser. additional_developer_instructions erfordert Unterstützung durch den Orchestrator.
experimental_network und permissions.<profile>.network Teilweise. Unterstützte Ziel- und Executor-Beschränkungen unterscheiden sich von einer benutzerdefinierten Proxy-Konfiguration. Verwaltete HTTP/SOCKS-Listener-Ports und Proxy-Listener an Nicht-Loopback-Adressen werden von der Cloud-Laufzeit nicht unterstützt; die Unterstützung von Socket-Regeln hängt vom Ausführungspfad ab. Das Zusammenführungsverhalten bei lokaler Ausführung ist davon unabhängig. Beschränkungen des Netzwerkzugriffs von Befehlen deaktivieren weder gehostete Suche noch MCP- oder App-Tools.
Funktionen / feature_requirements, Modelle, computer_use Teilweise. Eingestellte Schalter wie tool_search = false, tool_search_always_defer_mcp_tools = false, js_repl = true und remote_control = true werden zurückgewiesen. Einige Einstellungen zur Computernutzung müssen noch durchgängig validiert werden.
browser_use, allow_appshots, Feedback, allow_remote_control, Beschränkungen für Marketplace-Quellen Die App oder der App-Server setzt diese Kontrollen auf einigen Übermittlungswegen für Richtlinien durch. App-Kontrollen können weiterhin gelten, wenn der lokale Computerzugriff über Work Cloud ein Feld ignoriert. Website-Regeln für Desktop-Browser gelten nicht für Work-Cloud-Container. Validieren Sie die tatsächliche Oberfläche und den Übermittlungsweg der Richtlinie.

Das Konfigurationsschema enthält Schlüssel, die möglicherweise beim lokalen Computerzugriff über Work Cloud nicht funktionieren oder keine umgebungsspezifischen Überschreibungen unterstützen. Informationen zur globalen Basiskonfiguration und zur Rangfolge finden Sie unter Verwaltete Konfiguration.

config.toml

Die Konfiguration auf Benutzerebene befindet sich in ~/.codex/config.toml. Sie können außerdem projektspezifische Überschreibungen in .codex/config.toml-Dateien hinzufügen. Codex lädt projektspezifische Konfigurationsdateien nur, wenn Sie dem Projekt vertrauen.

Die projektspezifische Konfiguration kann keine maschinenlokalen Anbieter-, Authentifizierungs-, vom Host verwalteten App-Anforderungsmetadaten-, Benachrichtigungs-, Konfigurationsprofilauswahl- oder Telemetrie-Routing-Schlüssel überschreiben. Codex ignoriert openai_base_url, chatgpt_base_url, apps_mcp_product_sku, model_provider, model_providers, notify, profile, profiles, experimental_realtime_ws_base_url und otel, wenn sie in einer projektlokalen .codex/config.toml vorkommen; legen Sie Anbieter-, Benachrichtigungs- und Telemetrie-Schlüssel stattdessen in der Konfiguration auf Benutzerebene ab. Konfigurations-Profildateien befinden sich neben config.toml als $CODEX_HOME/profile-name.config.toml; wählen Sie eine davon mit --profile profile-name aus.

Ziehen Sie für Sandbox- und Genehmigungsschlüssel (approval_policy, sandbox_mode und sandbox_workspace_write.*) zusätzlich zu dieser Referenz die Seiten Sandbox und Genehmigungen, Geschützte Pfade in beschreibbaren Stammverzeichnissen und Netzwerkzugriff heran. Informationen zu Beta-Berechtigungsprofilen finden Sie unter Berechtigungen.

Codex und ChatGPT Work unterstützen approval_policy = "untrusted" nicht mehr. Entfernen Sie die Einstellung oder wählen Sie eine unterstützte Richtlinie. Projekteinträge mit trust_level = "untrusted" in der benutzerspezifischen ~/.codex/config.toml werden weiterhin unterstützt. Unter Von der eingestellten Genehmigungsrichtlinie untrusted migrieren finden Sie Beispiele und Hinweise zu den Vor- und Nachteilen der Genehmigungsoptionen.

Setzen Sie model auf ein Modell, das für Ihr angemeldetes Konto oder Ihren Arbeitsbereich verfügbar ist. Lesen Sie die Hinweise zur Verfügbarkeit von GPT-6.1 Sol, bevor Sie den Beispielwert verwenden.

Schlüssel Typ / Werte Details
agents table Multi-Agent-Einstellungen und benutzerdefinierte Rollendeklarationen. Namen skalarer Einstellungen sind reserviert und können nicht als benutzerdefinierte Rollennamen verwendet werden.
agents.<name>.config_file string (path) Pfad zu einer TOML-Konfigurationsebene für diese Rolle; relative Pfade werden ausgehend von der Konfigurationsdatei aufgelöst, die die Rolle deklariert.
agents.<name>.description string Rollenanweisungen, die Codex bei der Auswahl und beim Start dieses Agententyps angezeigt werden.
agents.default_subagent_model string Standardmodell für gestartete Agenten. Ein beim Start explizit angegebenes Modell hat Vorrang.
agents.default_subagent_reasoning_effort string Standardmäßiger Reasoning-Aufwand für gestartete Agenten. Ein beim Start explizit angegebener Aufwand hat Vorrang.
agents.enabled boolean Aktiviert oder deaktiviert Multi-Agent-Tools (Standard: true).
agents.interrupt_message boolean Zeichnet eine für das Modell sichtbare Nachricht auf, wenn ein Agenten-Turn unterbrochen wird (Standard: true).
agents.max_concurrent_threads_per_session number Maximale Anzahl gleichzeitig geöffneter Threads gestarteter Agenten, ohne den primären Thread. Ohne Angabe wählt Codex den Standardwert.
agents.max_threads number Veralteter Alias für agents.max_concurrent_threads_per_session.
allow_login_shell boolean Erlaubt shellbasierten Tools die Verwendung der Login-Shell-Semantik. Standardmäßig true; bei false werden login = true-Anfragen abgelehnt, und bei ausgelassenem login werden standardmäßig Nicht-Login-Shells verwendet.
analytics.enabled boolean Aktiviert oder deaktiviert Analysen für diesen Computer bzw. dieses Profil. Ohne Angabe gilt der Standardwert des Clients.
approval_policy on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } } Steuert, wann Codex vor der Ausführung von Befehlen zur Genehmigung pausiert. Sie können auch approval_policy = { granular = { ... } } verwenden, um bestimmte Anfragekategorien zuzulassen oder automatisch abzulehnen, während andere Anfragen interaktiv bleiben. untrusted wird nicht unterstützt und on-failure ist veraltet; verwenden Sie on-request für interaktive Ausführungen oder never für nicht interaktive Ausführungen.
approval_policy.granular.mcp_elicitations boolean Bei true dürfen MCP-Elicitation-Anfragen angezeigt werden, statt automatisch abgelehnt zu werden.
approval_policy.granular.request_permissions boolean Bei true dürfen Anfragen des Tools request_permissions angezeigt werden.
approval_policy.granular.rules boolean Bei true dürfen Genehmigungsanfragen angezeigt werden, die durch execpolicy-Regeln vom Typ prompt ausgelöst werden.
approval_policy.granular.sandbox_approval boolean Bei true dürfen Genehmigungsanfragen zur Erweiterung der Sandbox-Berechtigungen angezeigt werden.
approval_policy.granular.skill_approval boolean Bei true dürfen Genehmigungsanfragen für Skill-Skripte angezeigt werden.
approvals_reviewer user | auto_review Legt fest, wer entsprechende Genehmigungsanfragen unter on-request oder granularen Genehmigungsrichtlinien prüft. Standardmäßig user; auto_review verwendet den Prüfer-Subagenten. Diese Einstellung ändert weder das Sandboxing noch die Prüfung von Aktionen, die innerhalb der Sandbox bereits erlaubt sind.
apps._default.approvals_reviewer user | auto_review Standardprüfer für Genehmigungsanfragen von App-Tools, sofern nicht pro App überschrieben. Ohne Angabe übernehmen Apps den Wert von approvals_reviewer auf oberster Ebene.
apps._default.default_tools_approval_mode auto | prompt | writes | approve Standardmäßiges Genehmigungsverhalten für App-Tools ohne Überschreibung auf App- oder Tool-Ebene.
apps._default.destructive_enabled boolean Standardmäßiges Zulassen oder Ablehnen von App-Tools mit destructive_hint = true.
apps._default.enabled boolean Standardmäßiger Aktivierungsstatus für alle Apps, sofern er nicht pro App überschrieben wird.
apps._default.open_world_enabled boolean Standardmäßiges Zulassen oder Ablehnen von App-Tools mit open_world_hint = true.
apps.<id>.approvals_reviewer user | auto_review Prüfer für Genehmigungsanfragen der Tools dieser App. Überschreibt apps._default.approvals_reviewer.
apps.<id>.default_tools_approval_mode auto | prompt | writes | approve Standardmäßiges Genehmigungsverhalten für Tools dieser App, sofern keine Überschreibung auf Tool-Ebene vorhanden ist.
apps.<id>.default_tools_enabled boolean Standardmäßiger Aktivierungsstatus für Tools dieser App, sofern keine Überschreibung auf Tool-Ebene vorhanden ist.
apps.<id>.destructive_enabled boolean Erlaubt oder blockiert Tools dieser App, die destructive_hint = true ausweisen.
apps.<id>.enabled boolean Aktiviert oder deaktiviert eine bestimmte App bzw. einen bestimmten Connector anhand der ID (Standard: true).
apps.<id>.open_world_enabled boolean Erlaubt oder blockiert Tools dieser App, die open_world_hint = true ausweisen.
apps.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Überschreibung des Genehmigungsverhaltens für ein einzelnes App-Tool.
apps.<id>.tools.<tool>.enabled boolean Überschreibung des Aktivierungsstatus für ein einzelnes App-Tool (z. B. repos/list).
auto_review.extra_policy string Zusätzliche lokale Markdown-Richtlinie für die automatische Prüfung, die zusammen mit der Hauptrichtlinie einbezogen wird. Die verwaltete Einstellung guardian_extra_policy hat Vorrang. Leere Werte werden ignoriert.
auto_review.policy string Lokale Richtlinienanweisungen in Markdown für die automatische Prüfung. Die verwaltete Einstellung guardian_policy_config hat Vorrang. Leere Werte werden ignoriert.
background_terminal_max_timeout number Maximales Abfragefenster in Millisekunden für leere write_stdin-Abfragen (Terminalabfragen im Hintergrund). Standard: 300000 (5 Minuten). Ersetzt den älteren Schlüssel background_terminal_timeout.
browser_use.allow_history_access boolean Setzen Sie den Wert auf false, um den Zugriff auf den Browserverlauf einzuschränken. Verwaltete Vorgaben können diese Einschränkung erzwingen.
browser_use.default_origin_policy table Standardeinschränkungen für Browser-Origins. Unterstützt access, uploads, downloads und full_cdp_access, jeweils mit dem Wert allow oder deny.
browser_use.origins.<origin> table Browsereinschränkungen pro Origin mit denselben Feldern wie browser_use.default_origin_policy. Geben Sie ein HTTP- oder HTTPS-Schema und optional einen Port an; lassen Sie Pfade, Abfragen und Fragmente weg. Lokale Werte können verwaltete Verbote nicht lockern.
chatgpt_base_url string Überschreibt die Basis-URL, die beim ChatGPT-Anmeldevorgang verwendet wird.
check_for_update_on_startup boolean Prüft beim Start auf Codex-Updates (setzen Sie den Wert nur dann auf false, wenn Updates zentral verwaltet werden).
cli_auth_credentials_store file | keyring | auto | ephemeral Steuert, wo die CLI zwischengespeicherte Anmeldedaten ablegt.
compact_prompt string Direkte Überschreibung des Prompts für die Verlaufskomprimierung.
computer_use.default_app_access allow | deny Standardrichtlinie für den Zugriff auf native Apps durch Computer Use. App-spezifische Einträge können eine Richtlinie festlegen; lokale Konfigurationen können verwaltete Einschränkungen nicht lockern.
computer_use.macos.bundle_ids map<string, allow | deny> Zugriff auf native macOS-Apps, zugeordnet über die Bundle-Kennung.
computer_use.windows.always_allowed_app_ids array<string> Kennungen von Windows-Apps, die Computer Use ohne Rückfrage öffnen darf. Apps, die nicht in der Liste stehen, erfordern eine Genehmigung; entfernen Sie gespeicherte Einträge in den Computer Use-Einstellungen der ChatGPT-Desktop-App.
computer_use.windows.aumids map<string, allow | deny> Zugriff auf paketierte Windows-Apps, zugeordnet über die Application User Model ID (AUMID).
computer_use.windows.exes array<table> Zugriffsregeln für ausführbare Windows-Dateien. Jede Regel erfordert publisher_name, product_name und access (allow oder deny); binary_name ist optional.
default_permissions string Name des standardmäßigen Berechtigungsprofils für Tool-Aufrufe in der Sandbox. Integriert sind :read-only, :workspace und :danger-full-access; benutzerdefinierte Profilnamen erfordern entsprechende [permissions.&lt;name&gt;]-Tabellen. Kombinieren Sie dies nicht mit sandbox_mode oder [sandbox_workspace_write].
desktop.custom_file_handlers.<id> table Nur auf Benutzerebene. Definiert ein zusätzliches Ziel für Öffnen in in der ChatGPT-Desktop-App. Beispiele und Einschränkungen für Handler-IDs finden Sie unter Benutzerdefinierte Datei-Handler hinzufügen.
desktop.custom_file_handlers.<id>.args array<string> Argumente, die zwischen dem Befehl und der Dateieingabe eingefügt werden (Standard: []).
desktop.custom_file_handlers.<id>.command string Pfad zur ausführbaren Datei oder Befehlsname für Erkennung und Start. Erforderlich.
desktop.custom_file_handlers.<id>.icon string Pfad zu einer mitgelieferten Ressource, Base64-kodierte data:image/...-URL, Datei-URI oder absoluter lokaler Pfad für das Handler-Symbol. Erforderlich; bei nicht unterstützten Quellen wird das Standardsymbol von VS Code verwendet.
desktop.custom_file_handlers.<id>.input path | json_argument | json_stdin Legt fest, wie die App Dateieingaben an den Handler sendet (Standard: path).
desktop.custom_file_handlers.<id>.label string Anzeigename in den Menüs Öffnen in. Erforderlich.
desktop.custom_file_handlers.<id>.supports_ssh boolean Bietet den Handler für Dateien in SSH-Arbeitsbereichen an (Standard: false).
developer_instructions string Zusätzliche Entwickleranweisungen, die in die Sitzung eingefügt werden (optional).
disable_paste_burst boolean Deaktiviert die Erkennung schubweise eingefügter Texte in der TUI.
experimental_compact_prompt_file string (path) Lädt die Überschreibung des Komprimierungs-Prompts aus einer Datei (experimentell).
experimental_use_unified_exec_tool boolean Veralteter Name zum Aktivieren von unified exec; verwenden Sie vorzugsweise [features].unified_exec oder codex --enable unified_exec.
features.apps boolean Aktiviert App-Integrationen (Connectors) (stabil; standardmäßig aktiviert). Der Datenverkehr von Apps und Connectors wird weder durch den Netzwerkproxy für Sandbox-Befehle noch durch dessen Domain-Zulassungsliste gesteuert.
features.code_mode.direct_only_tool_namespaces array<string> Tool-Namensräume, die der Codemodus nur über direkte Tool-Aufrufe verwenden kann.
features.code_mode.enabled boolean Aktiviert die Funktionskonfiguration für den Codemodus. Diese Funktion befindet sich in Entwicklung und ist standardmäßig deaktiviert.
features.code_mode.excluded_tool_namespaces array<string> Tool-Namensräume, die der Codemodus von den Anweisungen für verschachtelte Codemodus-Tools und von der Bereitstellung im Executor ausschließt.
features.context_management.experimental_mode boolean Experimentelle Einstellung zur Kontextverwaltung. Die Funktion ist derzeit nicht verfügbar.
features.enable_request_compression boolean Komprimiert Streaming-Anfragetexte mit zstd, sofern unterstützt (stabil; standardmäßig aktiviert).
features.fast_mode boolean Aktiviert die Auswahl von Servicestufen aus dem Modellkatalog in der TUI, einschließlich Befehlen für die Fast-Stufe, wenn das aktive Modell diese unterstützt (stabil; standardmäßig aktiviert).
features.goals boolean Aktiviert dauerhaft gespeicherte Ziele und automatische Fortsetzung (stabil; standardmäßig aktiviert).
features.hooks boolean Aktiviert Lebenszyklus-Hooks, die aus hooks.json oder einer direkt eingebetteten [hooks]-Konfiguration geladen werden. features.codex_hooks ist ein veralteter Alias.
features.memories boolean Aktiviert Erinnerungen (standardmäßig deaktiviert).
features.multi_agent boolean Aktiviert Tools für die Zusammenarbeit mehrerer Agenten (spawn_agent, send_input, resume_agent, wait_agent und close_agent) (stabil; standardmäßig aktiviert).
features.network_proxy boolean | table Startet den Netzwerkproxy für Sandbox-Befehle (experimentell; standardmäßig deaktiviert). Erforderlich, um Domainregeln von Berechtigungsprofilen durchzusetzen, sofern nicht aktivierte, administrativ verwaltete experimental_network-Vorgaben den Proxy starten. Verwenden Sie eine Tabelle, wenn Sie Richtlinienoptionen auf Funktionsebene wie domains festlegen. Filtert weder Websuche noch Apps, MCP oder andere gehostete Tools.
features.network_proxy.allow_local_binding boolean Erlaubt umfassenderen Zugriff auf lokale und private Netzwerke. Standardmäßig false; Zulassungsregeln für exakte lokale IP-Literale oder localhost können weiterhin bestimmte lokale Ziele erlauben.
features.network_proxy.allow_upstream_proxy boolean Erlaubt die Verkettung über einen in der Umgebung festgelegten vorgeschalteten Proxy. Standardmäßig true.
features.network_proxy.dangerously_allow_all_unix_sockets boolean Erlaubt beliebige Unix-Socket-Ziele statt eines auf die Zulassungsliste beschränkten Zugriffs. Standardmäßig false; verwenden Sie dies nur in streng kontrollierten Umgebungen.
features.network_proxy.dangerously_allow_non_loopback_proxy boolean Erlaubt Listener-Adressen außerhalb von Loopback. Standardmäßig false; die Aktivierung kann Proxy-Listener über localhost hinaus zugänglich machen.
features.network_proxy.domains map<string, allow | deny> Domainrichtlinie für Netzwerkzugriff in der Sandbox. Standardmäßig nicht gesetzt; dadurch sind keine externen Ziele erlaubt, bis Sie allow-Regeln hinzufügen. Unterstützt exakte Hosts, *.example.com nur für Subdomains, **.example.com für die Stammdomain samt Subdomains sowie globale *-Zulassungsregeln. Bevorzugen Sie eng gefasste Regeln, da * ausgehenden Zugriff auf öffentliche Ziele umfassend öffnet. Fügen Sie deny-Regeln für blockierte Ziele hinzu; bei Konflikten hat deny Vorrang.
features.network_proxy.enable_socks5 boolean Stellt SOCKS5-Unterstützung bereit. Standardmäßig true.
features.network_proxy.enable_socks5_udp boolean Erlaubt UDP über SOCKS5. Standardmäßig true.
features.network_proxy.enabled boolean Startet den Netzwerkproxy für Sandbox-Befehle, wenn der Netzwerkzugriff für Befehle aktiviert ist. Standardmäßig false; bei deaktiviertem Proxy werden Domainregeln von Berechtigungsprofilen nicht durchgesetzt.
features.network_proxy.proxy_url string HTTP-Listener-URL für Netzwerkzugriff in der Sandbox. Standardmäßig "http://127.0.0.1:3128".
features.network_proxy.socks_url string SOCKS5-Listener-URL. Standardmäßig "http://127.0.0.1:8081".
features.network_proxy.unix_sockets map<string, allow | deny> Unix-Socket-Richtlinie für Netzwerkzugriff in der Sandbox. Standardmäßig nicht gesetzt; fügen Sie allow-Einträge für erlaubte Sockets hinzu.
features.personality boolean Aktiviert Steuerelemente zur Persönlichkeitsauswahl (stabil; standardmäßig aktiviert).
features.prevent_idle_sleep boolean Verhindert, dass der Computer während eines laufenden Turns in den Ruhezustand wechselt (experimentell; standardmäßig deaktiviert).
features.remote_plugin boolean Aktiviert den Remote-Plugin-Katalog (stabil; standardmäßig aktiviert).
features.rollout_budget.enabled boolean Aktiviert die Erfassung des Rollout-Budgets. Diese Funktion befindet sich in Entwicklung und ist standardmäßig deaktiviert. Wenn sie aktiviert ist, ist features.rollout_budget.limit_tokens erforderlich.
features.rollout_budget.limit_tokens integer Positives Token-Limit für die Erfassung des Rollout-Budgets. Erforderlich, wenn das Rollout-Budget aktiviert ist.
features.rollout_budget.prefill_token_weight number Endlicher, nicht negativer Multiplikator für Prefill-Tokens bei der Berechnung des Rollout-Budgets. Standardmäßig 1.0.
features.rollout_budget.reminder_interval_tokens integer Positives Token-Intervall zwischen Erinnerungen an das Rollout-Budget. Standardmäßig 10 % von limit_tokens, mindestens jedoch 1 Token.
features.rollout_budget.sampling_token_weight number Endlicher, nicht negativer Multiplikator für generierte Tokens bei der Berechnung des Rollout-Budgets. Standardmäßig 1.0.
features.shell_snapshot boolean Erstellt einen Snapshot der Shell-Umgebung, um wiederholte Befehle zu beschleunigen (stabil; standardmäßig aktiviert).
features.shell_tool boolean Aktiviert das Standardtool shell zur Befehlsausführung (stabil; standardmäßig aktiviert).
features.skill_mcp_dependency_install boolean Erlaubt Rückfragen und die Installation fehlender MCP-Abhängigkeiten für Skills (stabil; standardmäßig aktiviert).
features.unified_exec boolean Verwendet das einheitliche PTY-gestützte exec-Tool (stabil; außer unter Windows standardmäßig aktiviert).
features.web_search boolean Veralteter Schalter; verwenden Sie vorzugsweise die Einstellung web_search auf oberster Ebene.
features.web_search_cached boolean Veralteter Schalter. Wenn web_search nicht gesetzt ist, wird true auf web_search = "cached" abgebildet.
features.web_search_request boolean Veralteter Schalter. Wenn web_search nicht gesetzt ist, wird true auf web_search = "live" abgebildet.
feedback.enabled boolean Aktiviert das Senden von Feedback über /feedback in allen lokalen Clients (Standard: true).
file_opener vscode | vscode-insiders | windsurf | cursor | none URI-Schema zum Öffnen von Quellenverweisen aus der Codex-Ausgabe (Standard: vscode).
forced_chatgpt_workspace_id string (uuid) Beschränkt ChatGPT-Anmeldungen auf eine bestimmte Arbeitsbereichskennung.
forced_login_method chatgpt | api Beschränkt Codex auf eine bestimmte Authentifizierungsmethode.
hide_agent_reasoning boolean Unterdrückt Reasoning-Ereignisse sowohl in der TUI als auch in der Ausgabe von codex exec.
history.max_bytes number Begrenzt, falls gesetzt, die Größe der Verlaufsdatei in Bytes durch Entfernen der ältesten Einträge.
history.persistence save-all | none Steuert, ob Codex Sitzungsprotokolle in history.jsonl speichert.
hooks table Direkt in config.toml konfigurierte Lebenszyklus-Hooks. Verwendet dasselbe Ereignisschema wie hooks.json; Beispiele und unterstützte Ereignisse finden Sie in der Anleitung zu Hooks.
hooks.<Event> array<table> Matcher-Gruppen für Hook-Ereignisse wie PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop oder Interrupt.
hooks.<Event>[].hooks array<table> Hook-Handler für eine Matcher-Gruppe. Befehls- und MCP-Tool-Hooks werden unterstützt, während Prompt- und Agenten-Hook-Handler geparst, aber übersprungen werden.
hooks.<Event>[].hooks[].additionalContextLimit integer Ungefährer Token-Schwellenwert pro Handler, ab dem übergroße additionalContext auf dem Datenträger gespeichert werden und dem Modell eine kürzere Vorschau angezeigt wird. Standardmäßig 2500; 0 übergibt den vollständigen Kontext direkt an das Modell. Siehe Große Hook-Ausgaben.
hooks.<Event>[].hooks[].async boolean Führt einen Befehls-Hook im Hintergrund aus, ohne den auslösenden Vorgang zu verzögern. Standardmäßig false; SessionEnd wird immer synchron ausgeführt. Siehe Hooks im Hintergrund ausführen.
hooks.<Event>[].hooks[].commandWindows string Befehlsüberschreibung für Befehls-Hooks ausschließlich unter Windows. Der TOML-Alias command_windows wird ebenfalls akzeptiert.
instructions string Für zukünftige Verwendung reserviert; verwenden Sie vorzugsweise model_instructions_file oder AGENTS.md.
log_dir string (path) Verzeichnis, in das Codex Protokolldateien schreibt; standardmäßig $CODEX_HOME/log. Wenn Sie diese Einstellung explizit setzen, wird auch das optionale TUI-Klartextprotokoll codex-tui.log in diesem Verzeichnis aktiviert.
marketplaces.<name>.ref string Optionaler Git-Branch, -Tag oder -Commit für den Marktplatz.
marketplaces.<name>.source string Speicherort des Git-Repositorys oder lokales Stammverzeichnis des Marktplatzes. Verwenden Sie für eine lokale Quelle einen absoluten Pfad; das Verzeichnis enthält .agents/plugins/marketplace.json.
marketplaces.<name>.source_type git | local Quelltyp für einen konfigurierten Plugin-Marktplatz. Marktplätze können in der systemweiten, cloudverwalteten, benutzerspezifischen oder zu einem vertrauenswürdigen Projekt gehörenden config.toml definiert werden.
marketplaces.<name>.sparse_paths array<string> Optionale Sparse-Checkout-Pfade für einen Git-Marktplatz. Nehmen Sie den Marktplatzkatalog und alle darin referenzierten lokalen Plugin-Verzeichnisse auf.
mcp_oauth_callback_port integer Optionaler globaler fester Port für den lokalen HTTP-Callback-Server bei der MCP-OAuth-Anmeldung. Ein serverspezifischer Wert für oauth.callback_port hat Vorrang. Ist keiner der beiden Werte gesetzt, bindet Codex an einen vom Betriebssystem gewählten kurzlebigen Port.
mcp_oauth_callback_url string Optionale Callback-Basis-URL für die MCP-OAuth-Anmeldung, etwa eine Devbox-Ingress-URL. Neu hinzugefügte vorab registrierte Clients verwenden diese URL unverändert, wenn der Autorisierungsserver die Identifizierung des Ausstellers unterstützt; bestehende Clients ohne gespeicherten Callback hängen eine serverspezifische Callback-ID an. Ohne Unterstützung für die Ausstelleridentifizierung greift jeder vorab registrierte MCP server, dessen konfigurierter Callback die erforderliche ID nicht enthält, auf diese URL mit angehängter ID zurück. Ports in Callback-URLs bestimmen nicht den Listener-Port.
mcp_oauth_credentials_store auto | file | keyring Bevorzugter Speicher für MCP-OAuth-Anmeldedaten.
mcp_optional_startup_grace_ms integer (milliseconds) Gemeinsame Wartezeit für optionale MCP server beim Aufbau des anfänglichen Tool-Katalogs. Standardmäßig 1000. Setzen Sie den Wert auf 0, um stattdessen für jeden Server dessen startup_timeout_sec abzuwarten.
mcp_servers.<id>.args array<string> Argumente, die an den Befehl des STDIO MCP server übergeben werden.
mcp_servers.<id>.auth oauth | chatgpt Authentifizierungsfallback für einen HTTP MCP server nach konfigurierten Bearer-Tokens und Authorization-Headern. oauth (Standard) verwendet gespeicherte MCP-OAuth-Anmeldedaten, sofern verfügbar. chatgpt verwendet die aktuelle ChatGPT-Sitzung für die vertrauenswürdige ChatGPT-Origin des Erstanbieters und greift anschließend auf gespeicherte OAuth-Anmeldedaten zurück. Beide Modi können eine Verbindung ohne Authentifizierung herstellen, wenn keine Anmeldedatenquelle verfügbar ist.
mcp_servers.<id>.bearer_token_env_var string Umgebungsvariable, aus der das Bearer-Token für einen HTTP MCP server bezogen wird.
mcp_servers.<id>.command string Startbefehl für einen STDIO MCP server.
mcp_servers.<id>.cwd string Arbeitsverzeichnis für den Prozess des STDIO MCP server.
mcp_servers.<id>.default_tools_approval_mode auto | prompt | writes | approve Standardmäßiges Genehmigungsverhalten für MCP-Tools auf diesem Server, sofern keine Überschreibung auf Tool-Ebene vorhanden ist.
mcp_servers.<id>.disabled_tools array<string> Sperrliste, die für den MCP server nach enabled_tools angewendet wird.
mcp_servers.<id>.enabled boolean Deaktiviert einen MCP server, ohne seine Konfiguration zu entfernen.
mcp_servers.<id>.enabled_tools array<string> Zulassungsliste der vom MCP server bereitgestellten Tool-Namen.
mcp_servers.<id>.env map<string,string> Umgebungsvariablen, die an den STDIO MCP server weitergegeben werden.
mcp_servers.<id>.env_http_headers map<string,string> HTTP-Header für einen HTTP MCP server, deren Werte aus Umgebungsvariablen stammen.
mcp_servers.<id>.env_vars array<string | { name = string, source = "local" | "remote" }> Zusätzliche Umgebungsvariablen, die für einen STDIO MCP server zugelassen werden sollen. Zeichenfolgeneinträge verwenden standardmäßig source = "local"; verwenden Sie source = "remote" nur mit Executor-gestütztem Remote-STDIO.
mcp_servers.<id>.experimental_environment local | remote Experimenteller Ausführungsort für einen MCP server. remote startet STDIO-Server über eine Remote-Executor-Umgebung; die Remote-Ausführung mit Streamable HTTP ist nicht implementiert.
mcp_servers.<id>.http_headers map<string,string> Statische HTTP-Header, die jeder MCP-HTTP-Anfrage beigefügt werden.
mcp_servers.<id>.http_headers_helper string (command) Lokaler Befehl, der ein JSON-Objekt mit HTTP-Headernamen und -werten ausgibt. Wird nur für lokal verbundene HTTP MCP server unterstützt. Explizite Bearer-Tokens und OAuth-Anmeldedaten haben Vorrang vor Authorization-Headern, die der Hilfsbefehl bereitstellt.
mcp_servers.<id>.oauth_resource string Optionaler OAuth-Ressourcenparameter gemäß RFC 8707, der bei der MCP-Anmeldung übermittelt wird.
mcp_servers.<id>.oauth.callback_port integer Fester Listener-Port für den OAuth-Callback dieses MCP server. Überschreibt mcp_oauth_callback_port. Konfigurieren Sie bei einem direkten Loopback-Callback mit explizitem URL-Port denselben Listener-Port.
mcp_servers.<id>.oauth.callback_url string Serverspezifischer OAuth-Callback. Vorab registrierte Clients verwenden ihn erneut, wenn die Identifizierung des Ausstellers unterstützt wird oder die URL bereits mit der serverspezifischen Callback-ID endet. Andernfalls verwendet Codex den globalen oder standardmäßigen Callback mit angehängter ID. Clients ohne vorab registrierte ID verwenden diesen Callback bei der Clientregistrierung.
mcp_servers.<id>.oauth.client_id string Vorab registrierte OAuth-Client-ID für die Autorisierung und den Token-Austausch mit diesem MCP server.
mcp_servers.<id>.required boolean Bei true schlägt der Start bzw. die Wiederaufnahme fehl, wenn dieser aktivierte MCP server nicht initialisiert werden kann.
mcp_servers.<id>.scopes array<string> OAuth-Berechtigungsbereiche, die bei der Authentifizierung bei diesem MCP server angefordert werden.
mcp_servers.<id>.startup_timeout_ms number Alias für startup_timeout_sec in Millisekunden.
mcp_servers.<id>.startup_timeout_sec number Überschreibt das standardmäßige Startzeitlimit von 10 Sekunden für einen MCP server.
mcp_servers.<id>.tool_timeout_sec number Überschreibt das standardmäßige Zeitlimit von 60 Sekunden pro Tool für einen MCP server.
mcp_servers.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Überschreibung des Genehmigungsverhaltens für ein einzelnes MCP-Tool auf diesem Server.
mcp_servers.<id>.tools.<tool>.output_token_limit integer (positive) Token-Budget für die Ausgabe eines einzelnen MCP-Tools vor dem standardmäßigen Serialisierungszuschlag von 20 %. Überschreibt das standardmäßige Budget des Modells für die Ausgabekürzung dieses Tools.
mcp_servers.<id>.url string Endpunkt für einen MCP server mit Streamable HTTP.
memories.consolidation_model string Optionale Modellüberschreibung für die globale Erinnerungskonsolidierung.
memories.disable_on_external_context boolean Bei true werden Threads, die externen Kontext wie MCP-Tool-Aufrufe, Websuche oder Tool-Suche verwenden, von der Erinnerungsgenerierung ausgeschlossen. Standardmäßig false. Veralteter Alias: memories.no_memories_if_mcp_or_web_search.
memories.extract_model string Optionale Modellüberschreibung für die Erinnerungsextraktion pro Thread.
memories.generate_memories boolean Bei false werden neu erstellte Threads nicht als Eingaben für die Erinnerungsgenerierung gespeichert. Standardmäßig true.
memories.max_raw_memories_for_consolidation number Maximale Anzahl neuerer Roherinnerungen, die für die globale Konsolidierung aufbewahrt werden. Standardmäßig 256, begrenzt auf 4096.
memories.max_rollout_age_days number Maximales Alter von Threads, die für die Erinnerungsgenerierung berücksichtigt werden. Standardmäßig 30, begrenzt auf den Bereich 0-90.
memories.max_rollouts_per_startup number Maximale Anzahl von Rollout-Kandidaten, die pro Startdurchlauf verarbeitet werden. Standardmäßig 16, begrenzt auf 128.
memories.max_unused_days number Maximale Anzahl von Tagen seit der letzten Verwendung einer Erinnerung, bevor sie nicht mehr für die Konsolidierung infrage kommt. Standardmäßig 30, begrenzt auf den Bereich 0-365.
memories.min_rate_limit_remaining_percent number Erforderlicher verbleibender Mindestprozentsatz in den Codex-Ratenlimitfenstern, bevor die Erinnerungsgenerierung beginnt. Standardmäßig 25, begrenzt auf den Bereich 0-100.
memories.min_rollout_idle_hours number Minimale Inaktivitätsdauer, bevor ein Thread für die Erinnerungsgenerierung berücksichtigt wird. Standardmäßig 6, begrenzt auf den Bereich 1-48.
memories.use_memories boolean Bei false fügt Codex keine vorhandenen Erinnerungen in zukünftige Sitzungen ein. Standardmäßig true.
model string Zu verwendendes Modell (z. B. gpt-6.1-sol).
model_auto_compact_token_limit number Token-Schwellenwert, der die automatische Verlaufskomprimierung auslöst (ohne Angabe gelten die Modellstandardwerte).
model_auto_compact_token_limit_scope total | body_after_prefix Steuert, ob der Schwellenwert für die automatische Komprimierung den gesamten aktiven Kontext (total, Standard) oder nur den Zuwachs nach dem übernommenen Präfix des Komprimierungsfensters (body_after_prefix) berücksichtigt.
model_catalog_json string (path) Optionaler Pfad zu einem JSON-Modellkatalog, der beim Start geladen wird. Eine ausgewählte $CODEX_HOME/profile-name.config.toml-Profildatei kann dies für das jeweilige Profil überschreiben.
model_context_window number Anzahl der Tokens im Kontextfenster, die dem aktiven Modell zur Verfügung stehen.
model_instructions_file string (path) Ersatz für integrierte Anweisungen anstelle von AGENTS.md.
model_provider string Anbieter-ID aus model_providers (Standard: openai).
model_providers.<id> table Benutzerdefinierte Anbieterdefinition. Integrierte Anbieter-IDs (openai, ollama und lmstudio) sind reserviert und können nicht überschrieben werden.
model_providers.<id>.auth table Befehlsgestützte Bearer-Token-Konfiguration für einen benutzerdefinierten Anbieter. Kombinieren Sie sie nicht mit env_key, experimental_bearer_token oder requires_openai_auth.
model_providers.<id>.auth.args array<string> Argumente, die an den Token-Befehl übergeben werden.
model_providers.<id>.auth.command string Befehl, der ausgeführt wird, wenn Codex ein Bearer-Token benötigt. Der Befehl muss das Token auf stdout ausgeben.
model_providers.<id>.auth.cwd string (path) Arbeitsverzeichnis für den Token-Befehl.
model_providers.<id>.auth.refresh_interval_ms number Intervall in Millisekunden, in dem Codex das Token proaktiv aktualisiert (Standard: 300000). Setzen Sie den Wert auf 0, um es nur nach einem erneuten Authentifizierungsversuch zu aktualisieren.
model_providers.<id>.auth.timeout_ms number Maximale Laufzeit des Token-Befehls in Millisekunden (Standard: 5000).
model_providers.<id>.base_url string API-Basis-URL für den Modellanbieter.
model_providers.<id>.env_http_headers map<string,string> HTTP-Header, deren Werte aus Umgebungsvariablen stammen, sofern diese vorhanden sind.
model_providers.<id>.env_key string Umgebungsvariable, die den API key des Anbieters bereitstellt.
model_providers.<id>.env_key_instructions string Optionale Einrichtungshinweise für den API key des Anbieters.
model_providers.<id>.experimental_bearer_token string Direktes Bearer-Token für den Anbieter (nicht empfohlen; verwenden Sie env_key).
model_providers.<id>.http_headers map<string,string> Statische HTTP-Header, die Anbieteranfragen hinzugefügt werden.
model_providers.<id>.name string Anzeigename für einen benutzerdefinierten Modellanbieter.
model_providers.<id>.query_params map<string,string> Zusätzliche Abfrageparameter, die an Anbieteranfragen angehängt werden.
model_providers.<id>.request_max_retries number Anzahl der Wiederholungsversuche für HTTP-Anfragen an den Anbieter (Standard: 4).
model_providers.<id>.requires_openai_auth boolean Der Anbieter verwendet die OpenAI-Authentifizierung (standardmäßig false).
model_providers.<id>.stream_idle_timeout_ms number Inaktivitätszeitlimit für SSE-Streams in Millisekunden (Standard: 300000).
model_providers.<id>.stream_max_retries number Anzahl der Wiederholungsversuche bei SSE-Streaming-Unterbrechungen (Standard: 5).
model_providers.<id>.supports_standalone_web_search boolean Weist Unterstützung für einen kompatiblen eigenständigen Websuchendpunkt aus (Standard: false). Die eigenständige Suche befindet sich weiterhin in Entwicklung und ist standardmäßig deaktiviert; Anbieterkompatibilität allein aktiviert sie nicht.
model_providers.<id>.supports_websockets boolean Gibt an, ob dieser Anbieter den WebSocket-Transport der Responses API unterstützt.
model_providers.<id>.wire_api responses Vom Anbieter verwendetes Protokoll. responses ist der einzige unterstützte Wert und wird ohne Angabe als Standard verwendet.
model_providers.amazon-bedrock.aws.profile string AWS-Profilname, den der integrierte Anbieter amazon-bedrock verwendet.
model_providers.amazon-bedrock.aws.region string AWS-Region, die der integrierte Anbieter amazon-bedrock verwendet.
model_reasoning_effort string Vom ausgewählten Modell unterstützter Reasoning-Aufwand, etwa low, medium, high, xhigh, max oder ultra. Verfügbare Stufen hängen vom Modell und vom Client ab.
model_reasoning_summary auto | concise | detailed | none Wählt den Detailgrad von Reasoning-Zusammenfassungen oder deaktiviert Zusammenfassungen vollständig.
model_supports_reasoning_summaries boolean Erzwingt, dass Codex Reasoning-Metadaten sendet oder nicht sendet.
model_verbosity low | medium | high Optionale Überschreibung der Ausführlichkeit für die GPT-5 Responses API; ohne Angabe wird der Standardwert des ausgewählten Modells bzw. der ausgewählten Voreinstellung verwendet.
notice.hide_full_access_warning boolean Erfasst die Bestätigung der Warnung vor Vollzugriff.
notice.hide_gpt-5.1-codex-max_migration_prompt boolean Erfasst die Bestätigung des Hinweises zur gpt-5.1-codex-max-Migration.
notice.hide_gpt5_1_migration_prompt boolean Erfasst die Bestätigung des Hinweises zur GPT-5.1-Migration.
notice.hide_rate_limit_model_nudge boolean Erfasst die Deaktivierung der Erinnerung an einen Modellwechsel bei Erreichen des Ratenlimits.
notice.hide_world_writable_warning boolean Erfasst die Bestätigung der Windows-Warnung zu allgemein beschreibbaren Verzeichnissen.
notice.model_migrations map<string,string> Erfasst bestätigte Modellmigrationen als Zuordnungen von alt->neu.
notify array<string> Befehl für Benachrichtigungen; erhält eine JSON-Nutzlast von Codex.
openai_base_url string Überschreibung der Basis-URL für den integrierten Modellanbieter openai.
oss_provider lmstudio | ollama Standardmäßiger lokaler Anbieter bei Ausführung mit --oss (ohne Angabe erfolgt standardmäßig eine Rückfrage).
otel.environment string Umgebungstag für ausgegebene OpenTelemetry-Ereignisse (Standard: dev).
otel.exporter none | otlp-http | otlp-grpc Wählt den OpenTelemetry-Exporter aus und legt gegebenenfalls Endpunktmetadaten fest.
otel.exporter.<id>.endpoint string Exporter-Endpunkt für OTEL-Protokolle.
otel.exporter.<id>.headers map<string,string> Statische Header für OTEL-Exporter-Anfragen.
otel.exporter.<id>.protocol binary | json Vom OTLP/HTTP-Exporter verwendetes Protokoll.
otel.exporter.<id>.tls.ca-certificate string Pfad zum CA-Zertifikat für TLS des OTEL-Exporters.
otel.exporter.<id>.tls.client-certificate string Pfad zum Clientzertifikat für TLS des OTEL-Exporters.
otel.exporter.<id>.tls.client-private-key string Pfad zum privaten Clientschlüssel für TLS des OTEL-Exporters.
otel.log_user_prompt boolean Aktiviert den Export unverarbeiteter Benutzer-Prompts mit OpenTelemetry-Protokollen.
otel.metrics_exporter none | statsig | otlp-http | otlp-grpc Wählt den OpenTelemetry-Metrikexporter aus (standardmäßig statsig).
otel.trace_exporter none | otlp-http | otlp-grpc Wählt den OpenTelemetry-Trace-Exporter aus und legt gegebenenfalls Endpunktmetadaten fest.
otel.trace_exporter.<id>.endpoint string Trace-Exporter-Endpunkt für OTEL-Protokolle.
otel.trace_exporter.<id>.headers map<string,string> Statische Header für OTEL-Trace-Exporter-Anfragen.
otel.trace_exporter.<id>.protocol binary | json Vom OTLP/HTTP-Trace-Exporter verwendetes Protokoll.
otel.trace_exporter.<id>.tls.ca-certificate string Pfad zum CA-Zertifikat für TLS des OTEL-Trace-Exporters.
otel.trace_exporter.<id>.tls.client-certificate string Pfad zum Clientzertifikat für TLS des OTEL-Trace-Exporters.
otel.trace_exporter.<id>.tls.client-private-key string Pfad zum privaten Clientschlüssel für TLS des OTEL-Trace-Exporters.
permissions.<name>.description string Menschenlesbare Beschreibung dieses benannten Profils. Ein Profil übernimmt die Beschreibung seines übergeordneten Profils nicht über extends.
permissions.<name>.extends string Optionales übergeordnetes Profil, das vor diesem benannten Profil angewendet wird. Setzen Sie den Wert auf ein anderes benanntes Profil, :read-only oder :workspace; :danger-full-access, nicht definierte übergeordnete Profile und Zyklen werden abgelehnt.
permissions.<name>.filesystem table Benanntes Dateisystem-Berechtigungsprofil. Jeder Schlüssel ist ein absoluter Pfad oder ein spezielles Token wie :minimal oder :workspace_roots.
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob> "read" | "write" | "deny" Begrenzter Dateisystemzugriff relativ zu jedem wirksamen Arbeitsbereichsstammverzeichnis. Verwenden Sie "." für das Stammverzeichnis selbst; Glob-Unterpfade wie "**/*.env" können mit "deny" Lesezugriffe verweigern.
permissions.<name>.filesystem.<path-or-glob> "read" | "write" | "deny" | table Gewährt direkten Zugriff für einen Pfad, ein Glob-Muster oder ein spezielles Token oder beschränkt verschachtelte Einträge auf dieses Stammverzeichnis. Verwenden Sie "deny", um Lesezugriffe auf übereinstimmende Pfade zu verweigern.
permissions.<name>.filesystem.glob_scan_max_depth number Maximale Tiefe für die Auflösung von Glob-Mustern, die Lesezugriff verweigern, auf Plattformen, die vor dem Sandbox-Start einen Snapshot der Treffer erstellen. Muss, falls gesetzt, mindestens 1 betragen.
permissions.<name>.network.allow_local_binding boolean Erlaubt umfassenderen Zugriff auf lokale und private Netzwerke über den Netzwerkzugriff der Sandbox. Zulassungsregeln für exakte lokale IP-Literale oder localhost können weiterhin bestimmte lokale Ziele erlauben, wenn dieser Wert auf false bleibt.
permissions.<name>.network.allow_upstream_proxy boolean Erlaubt die Verkettung des Netzwerkzugriffs in der Sandbox über einen weiteren vorgeschalteten Proxy.
permissions.<name>.network.dangerously_allow_all_unix_sockets boolean Erlaubt beliebige Unix-Socket-Ziele statt der standardmäßig eingeschränkten Menge. Verwenden Sie dies nur in streng kontrollierten Umgebungen.
permissions.<name>.network.dangerously_allow_non_loopback_proxy boolean Erlaubt Bind-Adressen außerhalb von Loopback für Netzwerk-Listener der Sandbox. Die Aktivierung kann Listener über localhost hinaus zugänglich machen.
permissions.<name>.network.domains table Domainregeln für Sandbox-Befehle. Sie werden nur durchgesetzt, wenn features.network_proxy oder aktivierte, administrativ verwaltete Netzwerkvorgaben den Proxy aktivieren. Unterstützt exakte Hosts, *.example.com, **.example.com und globale *-Zulassungsregeln; deny hat Vorrang. Schränkt weder Websuche noch Apps oder MCP server ein.
permissions.<name>.network.domains.<pattern> allow | deny Erlaubt oder verweigert einen exakten Host oder ein begrenztes Platzhaltermuster wie *.example.com oder **.example.com.
permissions.<name>.network.enable_socks5 boolean Stellt SOCKS5-Unterstützung bereit, wenn dieses Berechtigungsprofil Netzwerkzugriff in der Sandbox aktiviert.
permissions.<name>.network.enable_socks5_udp boolean Erlaubt UDP über den SOCKS5-Listener, wenn dieser aktiviert ist.
permissions.<name>.network.enabled boolean Aktiviert den Netzwerkzugriff für Befehle in diesem Berechtigungsprofil. Dadurch wird der Netzwerkproxy nicht gestartet. Ohne features.network_proxy oder aktivierte, administrativ verwaltete Netzwerkvorgaben erfolgt der Netzwerkzugriff von Befehlen direkt, und die Domainregeln des Profils werden nicht durchgesetzt.
permissions.<name>.network.mode limited | full Netzwerkproxy-Modus für den Datenverkehr von Unterprozessen.
permissions.<name>.network.proxy_url string HTTP-Listener-URL, die verwendet wird, wenn dieses Berechtigungsprofil Netzwerkzugriff in der Sandbox aktiviert.
permissions.<name>.network.socks_url string SOCKS5-Proxy-Endpunkt dieses Berechtigungsprofils.
permissions.<name>.network.unix_sockets table Überschreibungen der Unix-Socket-Zulassungsliste für Netzwerkzugriff in der Sandbox. Verwenden Sie Socket-Pfade als Schlüssel; allow fügt einen Pfad hinzu, deny lehnt ihn ab.
permissions.<name>.network.unix_sockets.<path> allow | deny Fügt mit allow einen absoluten Unix-Socket-Pfad zur wirksamen Zulassungsliste hinzu oder lehnt ihn mit deny ab. Abgelehnte Einträge werden aus der wirksamen Zulassungsliste ausgeschlossen.
permissions.<name>.workspace_roots table Im Profil definierte Arbeitsbereichsstammverzeichnisse, auf die neben den zur Laufzeit festgelegten Arbeitsbereichsstammverzeichnissen der Sitzung die Dateisystemregeln von :workspace_roots angewendet werden.
permissions.<name>.workspace_roots.<path> boolean Nimmt einen Pfad bei true in die Menge der Arbeitsbereichsstammverzeichnisse des Profils auf. Deaktivierte Einträge bleiben inaktiv.
personality none | friendly | pragmatic Standardkommunikationsstil für Modelle, die supportsPersonality unterstützen; kann pro Thread oder Turn oder über /personality überschrieben werden.
plan_mode_reasoning_effort string Überschreibung des Reasoning-Aufwands speziell für den Planungsmodus mit einer vom ausgewählten Modell unterstützten Stufe. Ohne Angabe verwendet der Planungsmodus seinen integrierten Standardwert.
plugins.<plugin>.enabled boolean Aktiviert oder deaktiviert ein Plugin aus einem lokalen Marktplatz über einen plugin-name@marketplace-name-Schlüssel. Wird aus der wirksamen zusammengeführten Konfiguration gelesen; Einstellungen vertrauenswürdiger Projekte können Benutzer-, cloudverwaltete und Systemstandardwerte überschreiben. Eine Marktplatzaktualisierung kann konfigurierte Plugins installieren oder aktualisieren, auch wenn sie deaktiviert sind. Dies überschreibt keine vom Arbeitsbereich verwalteten Aktivierungszustände.
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode auto | prompt | writes | approve Standardmäßiges Genehmigungsverhalten für Tools auf einem von einem Plugin bereitgestellten MCP server.
plugins.<plugin>.mcp_servers.<server>.disabled_tools array<string> Sperrliste, die nach enabled_tools auf einen von einem Plugin bereitgestellten MCP server angewendet wird.
plugins.<plugin>.mcp_servers.<server>.enabled boolean Aktiviert oder deaktiviert einen mit einem installierten Plugin gebündelten MCP server, ohne das Plugin-Manifest zu ändern.
plugins.<plugin>.mcp_servers.<server>.enabled_tools array<string> Zulassungsliste der Tools, die von einem durch ein Plugin bereitgestellten MCP server verfügbar gemacht werden.
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode auto | prompt | writes | approve Überschreibung des Genehmigungsverhaltens für ein einzelnes von einem Plugin bereitgestelltes MCP-Tool.
project_doc_fallback_filenames array<string> Zusätzliche Dateinamen, die geprüft werden, wenn AGENTS.md fehlt.
project_doc_max_bytes number Maximale Anzahl von Bytes, die beim Erstellen der Projektanweisungen aus AGENTS.md gelesen werden.
project_root_markers array<string> Liste von Dateinamen, die das Projektstammverzeichnis kennzeichnen; wird bei der Suche nach dem Projektstammverzeichnis in übergeordneten Verzeichnissen verwendet.
projects.<path>.trust_level string Kennzeichnet ein Projekt oder einen Worktree als vertrauenswürdig oder nicht vertrauenswürdig ("trusted" | "untrusted"). Nicht vertrauenswürdige Projekte überspringen projektbezogene .codex/-Ebenen, einschließlich projektlokaler Konfiguration, Hooks und Regeln.
review_model string Optionale Modellüberschreibung für /review (standardmäßig das Modell der aktuellen Sitzung).
sandbox_mode read-only | workspace-write | danger-full-access Sandbox-Richtlinie für Dateisystem- und Netzwerkzugriff während der Befehlsausführung.
sandbox_workspace_write.exclude_slash_tmp boolean Schließt /tmp im workspace-write-Modus von den beschreibbaren Stammverzeichnissen aus.
sandbox_workspace_write.exclude_tmpdir_env_var boolean Schließt $TMPDIR im workspace-write-Modus von den beschreibbaren Stammverzeichnissen aus.
sandbox_workspace_write.network_access boolean Erlaubt ausgehenden Netzwerkzugriff innerhalb der workspace-write-Sandbox.
sandbox_workspace_write.writable_roots array<string> Zusätzliche beschreibbare Stammverzeichnisse bei sandbox_mode = "workspace-write".
service_tier string Bevorzugte Servicestufe für neue Turns. Verwenden Sie fast oder eine andere vom aktiven Modell unterstützte Stufe; fast wird dem Anfragewert priority zugeordnet.
shell_environment_policy.exclude array<string> Veraltete Ausschlussmuster für Umgebungsvariablen. Verwenden Sie shell_environment_policy.filters für neue Konfigurationen; kombinieren Sie nicht beide Formen in derselben Ebene.
shell_environment_policy.experimental_use_profile boolean Verwendet beim Start von Unterprozessen das Shell-Profil des Benutzers.
shell_environment_policy.filters map<string, include | exclude> Kanonische Musterfilter für Umgebungsvariablen ohne Unterscheidung zwischen Groß- und Kleinschreibung. Einschließende Einträge erstellen eine Zulassungsliste und können ausgeschlossene Werte nicht wiederherstellen. Explizite set-Werte werden nach den Ausschlüssen angewendet. Kombinieren Sie Filter nicht mit veralteten exclude- oder include_only-Arrays in derselben Ebene.
shell_environment_policy.ignore_default_excludes boolean Behält Variablen mit KEY, SECRET oder TOKEN im Namen bei, bevor andere Filter ausgeführt werden (Standard: true). Setzen Sie den Wert auf false, um automatische Ausschlüsse anhand von Geheimnisnamen anzuwenden.
shell_environment_policy.include_only array<string> Veraltete Zulassungsliste mit Mustern für Umgebungsvariablen. Verwenden Sie shell_environment_policy.filters für neue Konfigurationen; kombinieren Sie nicht beide Formen in derselben Ebene.
shell_environment_policy.inherit all | core | none Grundlegende Vererbung der Umgebung beim Start von Unterprozessen.
shell_environment_policy.set map<string,string> Explizite Umgebungswerte, die nach den Ausschlüssen eingefügt werden; einschließende Filter können sie weiterhin entfernen.
show_raw_agent_reasoning boolean Zeigt unverarbeitete Reasoning-Inhalte an, wenn das aktive Modell sie ausgibt.
skills.config array<object> In config.toml gespeicherte Überschreibungen des Aktivierungsstatus einzelner Skills.
skills.config.<index>.enabled boolean Aktiviert oder deaktiviert den referenzierten Skill.
skills.config.<index>.path string (path) Pfad zu einem Skill-Ordner mit SKILL.md.
skills.max_context_tokens integer (positive) Token-Budget für den Katalog verfügbarer Skills. Standardmäßig 2 % des Kontextfensters des Modells. Explizite Werte sind auf 10000 Tokens begrenzt.
sqlite_home string (path) Verzeichnis, in dem Codex die SQLite-basierte Zustandsdatenbank für Agentenaufträge und andere fortsetzbare Laufzeitzustände speichert.
suppress_unstable_features_warning boolean Unterdrückt die Warnung, die bei aktivierten Funktionsschaltern für Funktionen in Entwicklung erscheint.
tool_output_token_limit number Token-Budget für das Speichern einzelner Tool- und Funktionsausgaben im Verlauf.
tool_suggest.disabled_tools array<table> Deaktiviert Vorschläge für bestimmte auffindbare Connectors oder Plugins. Jeder Eintrag verwendet type = "connector" oder "plugin" sowie eine id.
tool_suggest.discoverables array<table> Erlaubt Tool-Vorschläge für weitere auffindbare Connectors oder Plugins. Jeder Eintrag verwendet type = "connector" oder "plugin" sowie eine id.
tools.view_image boolean Aktiviert das Tool view_image zum Anhängen lokaler Bilder.
tools.web_search boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } } Optionale Konfiguration des Websuchtools. In Objektform lassen sich die Größe des Suchkontexts, zulässige Suchdomains und der ungefähre Benutzerstandort festlegen. Diese Suchdomainfilter sind von den Netzwerk-Domainregeln für Sandbox-Befehle getrennt und schränken weder Connectors noch MCP server ein.
tui table TUI-spezifische Optionen, etwa zum Aktivieren integrierter Desktop-Benachrichtigungen.
tui.alternate_screen auto | always | never Steuert die Verwendung des alternativen Bildschirmpuffers für die TUI (Standard: auto; auto verzichtet in Zellij darauf, um den Scrollverlauf zu erhalten).
tui.animations boolean Aktiviert Terminalanimationen (Willkommensbildschirm, Schimmereffekt, Ladeanimation) (Standard: true).
tui.keymap.<context>.<action> string | array<string> Tastenkombination für eine TUI-Aktion. Unterstützte Kontexte sind global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list und approval. Bestimmte Aktionen des Eingabeeditors greifen auf passende tui.keymap.global-Belegungen zurück; kontextspezifische Belegungen haben Vorrang, sofern sie unterstützt werden.
tui.keymap.<context>.<action> = [] empty array Hebt die Tastenbelegung der Aktion in diesem Tastaturbelegungskontext auf. Tastennamen verwenden normalisierte Zeichenfolgen wie ctrl-a, shift-enter, page-down oder minus.
tui.model_availability_nux.<model> integer Interner Zustand der Starttooltips, zugeordnet über den Modell-Slug.
tui.notification_condition unfocused | always Steuert, ob TUI-Benachrichtigungen nur bei nicht fokussiertem Terminal oder unabhängig vom Fokus ausgelöst werden. Standardmäßig unfocused.
tui.notification_method auto | osc9 | bel Benachrichtigungsmethode für Terminalbenachrichtigungen (Standard: auto).
tui.notifications boolean | array<string> Aktiviert TUI-Benachrichtigungen; optional auf bestimmte Ereignistypen beschränkt.
tui.raw_output_mode boolean Startet die TUI im unverarbeiteten Scrollverlaufsmodus, um das Auswählen und Kopieren im Terminal zu erleichtern (Standard: false). Sie können ihn mit /raw oder der standardmäßigen Tastenkombination alt-r umschalten.
tui.resume_cwd current | session Arbeitsverzeichnis beim Wiederaufnehmen oder Abzweigen einer Sitzung. Ohne Angabe fordert Codex Sie zur Auswahl auf, wenn Ihr aktuelles Verzeichnis vom gespeicherten Verzeichnis der Sitzung abweicht.
tui.show_tooltips boolean Zeigt Einführungstooltips auf dem TUI-Willkommensbildschirm an (Standard: true).
tui.status_line array<string> | null Geordnete Liste der Elementkennungen für die Statuszeile im TUI-Fußbereich. null deaktiviert die Statuszeile.
tui.terminal_title array<string> | null Geordnete Liste der Elementkennungen für den Titel des Terminalfensters bzw. Tabs. Standardmäßig ["spinner", "project"]; null deaktiviert Titelaktualisierungen.
tui.theme string Überschreibung des Designs für die Syntaxhervorhebung (Designname in kebab-case).
tui.vim_mode_default boolean Startet den Eingabeeditor im Vim-Normalmodus statt im Einfügemodus (Standard: false). Sie können den Modus weiterhin pro Sitzung mit /vim umschalten.
web_search disabled | cached | indexed | live Websuchmodus (Standard: "cached"; cached verwendet einen von OpenAI gepflegten Index ohne externen Webzugriff; indexed erlaubt externen Zugriff nur, wenn der Suchindex ihn freigibt; bei Verwendung von --yolo oder einer anderen Sandbox-Einstellung mit Vollzugriff gilt standardmäßig "live"). Verwenden Sie "live" für uneingeschränkten Live-Abruf oder "disabled", um das Tool zu entfernen.
windows_wsl_setup_acknowledged boolean Erfasst die Bestätigung der Windows-Einführung (nur Windows).
windows.sandbox unelevated | elevated | mxc Nativer Sandbox-Modus ausschließlich für die native Ausführung von Codex unter Windows.

Das aktuelle JSON-Schema für config.toml finden Sie hier.

Um beim Bearbeiten von config.toml in VS Code oder Cursor Autovervollständigung und Diagnosen zu erhalten, können Sie die Erweiterung Even Better TOML installieren und diese Zeile am Anfang Ihrer config.toml einfügen:

#:schema https://developers.openai.com/codex/config-schema.json

Hinweis: Benennen Sie experimental_instructions_file in model_instructions_file um. Codex stuft den alten Schlüssel als veraltet ein; aktualisieren Sie bestehende Konfigurationen auf den neuen Namen.

requirements.toml

requirements.toml ist eine administrativ erzwungene Konfigurationsdatei, die sicherheitsrelevante Einstellungen einschränkt, welche Benutzer nicht überschreiben können. Details, Speicherorte und Beispiele finden Sie unter Administrativ erzwungene Anforderungen.

Für Benutzer von ChatGPT Business und Enterprise kann Codex außerdem aus der Cloud abgerufene Anforderungen anwenden. Details zur Rangfolge finden Sie auf der Sicherheitsseite.

Verwenden Sie [features] in requirements.toml, um Laufzeit-Feature-Flags anhand derselben kanonischen Schlüssel festzuschreiben, die config.toml verwendet. Anforderungen können auch dokumentierte, nur für die App bestimmte Schlüssel enthalten, die nicht in config.toml gehören. Ausgelassene Schlüssel bleiben uneingeschränkt.

Einige verwaltete Anforderungen erzwingen einen exakten Konfigurationswert anstelle einer Zulassungsliste. Benutzer können einen erzwungenen Pfad, eine Aktualisierungspräferenz, eine Login-Shell-Richtlinie, eine Feedback-Einstellung oder eine Einstellung für den privaten Windows-Desktop nicht überschreiben.

Verwaltete Zulassungslisten für Berechtigungsprofile erfordern Codex 0.138.0 oder höher. Codex 0.137.0 und frühere Versionen ignorieren allowed_permission_profiles und verwaltete default_permissions.

Verwenden Sie allowed_sandbox_modes mit sandbox_mode. Für Berechtigungsprofil-Bereitstellungen verwenden Sie allowed_permission_profiles mit verwaltetem default_permissions.

Ein untrusted-Eintrag in allowed_approval_policies ist weiterhin gültig für das strengere Genehmigungsverhalten, das Codex ableitet, wenn ein Projekt trust_level = "untrusted" verwendet. Er erlaubt es nicht, explizit approval_policy = "untrusted" festzulegen.

Die Tabelle [models.new_thread] stellt verwaltete Standardwerte bereit, erzwingt sie jedoch nicht. Wenn Sie das Modell oder den Reasoning-Aufwand explizit mit --model, --config oder --profile überschreiben, ignoriert Codex sowohl model als auch model_reasoning_effort in [models.new_thread]. service_tier ist davon unabhängig.

Die Browseranforderungen decken drei separate Oberflächen ab. in_app_browser steuert den Browserbereich, den eine Person öffnet und direkt verwendet. browser_use steuert agentengesteuerte Arbeit in einem Browser. computer_use steuert agentengesteuerte Arbeit in nativen Desktop-Apps.

Die verschachtelten Richtlinienwerte für Browser Use und Computer Use gewähren nicht von sich aus Zugriff. Ein ursprungs- oder app-spezifisches allow kann den Fallback für dieselbe Richtlinienquelle außer Kraft setzen, aber die üblichen Funktions-, Genehmigungs- und sonstigen Richtlinienprüfungen gelten weiterhin. Wenn sowohl verwaltete Anforderungen als auch config.toml gelten, setzt sich ein deny aus einer der beiden Quellen durch.

Schlüssel Typ / Werte Details
additional_developer_instructions string Verwaltete Entwickleranweisungen, die als separate Entwicklernachricht hinzugefügt werden. Codex lehnt Anweisungen ab, die einschließlich Kontextmarkierungen ein Limit von schätzungsweise 10.000 Tokens überschreiten.
allow_appshots boolean Setzen Sie den Wert auf false, um Appshots für verwaltete Benutzer zu deaktivieren. Fehlt die Einstellung, werden Appshots durch Vorgaben nicht eingeschränkt und unterliegen der normalen Produktverfügbarkeit.
allow_browser_and_computer_use boolean Setzen Sie den Wert auf false, um sowohl agentengesteuertes Browser Use als auch Computer Use in nativen Apps zu blockieren. Der Wert true oder das Weglassen der Einstellung aktiviert keine der beiden Funktionen; die übrigen Funktions-, Richtlinien- und Genehmigungsprüfungen gelten weiterhin.
allow_login_shell boolean Verbindlich festlegen, ob Shell-Tools eine Login-Shell starten dürfen.
allow_managed_hooks_only boolean Bei true überspringt Codex Benutzer-, Projekt-, Sitzungs- und Plugin-Hooks, lässt jedoch verwaltete Hooks aus requirements.toml und anderen verwalteten Konfigurationsebenen weiterhin zu.
allow_remote_control boolean Setzen Sie den Wert auf false, um die Gerätefernsteuerung für verwaltete Benutzer zu deaktivieren. Fehlt die Einstellung, wird die Gerätefernsteuerung durch Vorgaben nicht eingeschränkt und unterliegt der normalen Produktverfügbarkeit.
allowed_approval_policies array<string> Zulässige Genehmigungsrichtlinien, etwa on-request, never und granular. Nehmen Sie untrusted auf, um die strengere Richtlinie zuzulassen, die aus einem nicht vertrauenswürdigen Projekt abgeleitet wird; sie kann nicht direkt mit approval_policy ausgewählt werden.
allowed_approvals_reviewers array<string> Zulässige Werte für approvals_reviewer, etwa user und auto_review.
allowed_chatgpt_workspaces array<string> Die ChatGPT-Anmeldung einschließlich Codex-Zugriffstokens auf die aufgeführten Workspace-IDs beschränken. Eine leere Liste deaktiviert die ChatGPT-Anmeldung; die API-Authentifizierung bleibt verfügbar, sofern sie zulässig ist. Wird über die lokale Datei mit Systemvorgaben oder macOS MDM festgelegt; in der Cloud verwaltete Werte werden ignoriert.
allowed_login_methods array<string> chatgpt, api oder beides zulassen. Wenn diese Einstellung fehlt, schränkt sie die Anmeldemethoden nicht ein. Wenn sie gesetzt ist, muss die Liste mindestens eine Methode enthalten. api erlaubt die API-Authentifizierung, einschließlich Amazon Bedrock. Wird über die lokale Datei mit Systemvorgaben oder macOS MDM festgelegt. In der Cloud verwaltete Werte werden ignoriert.
allowed_permission_profiles table<boolean> Vollständige Liste der zulässigen Berechtigungsprofile. Profile mit dem Wert true sind zulässig. Profile, die fehlen oder auf false gesetzt sind, werden abgelehnt, einschließlich Profilen, die in zukünftigen Versionen hinzukommen. Beim Zusammenführen von Vorgabenquellen werden Einträge anhand des Profilnamens zugeordnet.
allowed_permission_profiles.<name> boolean Ein integriertes oder benutzerdefiniertes Berechtigungsprofil zulassen oder ablehnen, das in einer geladenen Konfiguration oder Vorgabenquelle definiert ist. Eine spätere Vorgabenquelle mit höherer Priorität kann mit false ein Profil deaktivieren, das eine frühere Quelle mit niedrigerer Priorität zugelassen hat.
allowed_sandbox_modes array<string> Zulässige Werte für sandbox_mode.
allowed_web_search_modes array<string> Zulässige Werte für web_search (disabled, cached, indexed, live). disabled ist immer zulässig; eine leere Liste lässt effektiv nur disabled zu.
apps table Verwaltete App-Vorgaben mit der App-ID als Schlüssel. Vorgaben können eine App deaktivieren oder das Genehmigungsverhalten für einzelne Tools einschränken.
apps.<id>.enabled boolean Setzen Sie den Wert auf false, um eine App zu deaktivieren. Eine deaktivierende Vorgabe bleibt beim Zusammenführen mehrerer Vorgabenquellen einschränkend wirksam.
apps.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Den verwalteten Genehmigungsmodus für ein einzelnes App-Tool festlegen.
auto_review table Verwaltete Vorgaben für die automatische Prüfung.
auto_review.ignore_rules array<string> Vollständige Modell-Slugs, für die Codex allow-Präfixregeln in der Richtlinie zur Befehlsausführung ignoriert. Der Slug muss exakt übereinstimmen, einschließlich seines Anbieter-Namespace, sofern vorhanden; anders als required_on_models akzeptiert diese Einstellung keinen Alias ohne Namespace. Verbots- und Netzwerkregeln gelten weiterhin.
auto_review.required_on_models array<string> Modell-Slugs, für die die automatische Prüfung verwendet werden muss. Slugs dürfen nicht leer sein, keine Anbieter-Namespaces enthalten und keine führenden oder nachgestellten Leerzeichen aufweisen. Listen aus mehreren Vorgabenquellen werden zusammengeführt.
browser_use table Verwaltete Vorgaben für agentengesteuertes Browser Use.
browser_use.allow_global_persistent_approval boolean Setzen Sie den Wert auf false, um zu verhindern, dass Browser Use Always allow-Genehmigungen erstellt oder berücksichtigt, die alle Websites abdecken, beispielsweise eine Erlaubnis für Downloads von beliebigen Websites. Vorhandene gespeicherte Genehmigungen werden ignoriert, nicht gelöscht. Der Wert true oder das Weglassen der Einstellung erstellt keine Genehmigung.
browser_use.allow_history_access boolean Setzen Sie den Wert auf false, um zu verhindern, dass Browser Use den Browserverlauf liest. Der Wert true oder das Weglassen der Einstellung belässt die normalen Verlaufseinstellungen und Verfügbarkeitsprüfungen unverändert.
browser_use.default_origin_policy table Fallback für jede Browser Use-Einstellung, wenn kein passender Eintrag unter browser_use.origins sie definiert. Eine passende Origin-Regel ersetzt den Fallback für diese Quelle. Codex wendet anschließend das strengere Ergebnis aus verwalteten Vorgaben und Benutzerkonfiguration an.
browser_use.default_origin_policy.access allow | deny Verwenden Sie deny, um Browser Use für Origins zu blockieren, für die der Fallback gilt. Eine abgelehnte Origin blockiert dort auch Uploads, Downloads, vollständigen Browser-Debugging-Zugriff und die automatische Prüfung. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren.
browser_use.default_origin_policy.access_approval_lifetime turn | thread Legen Sie fest, wie lange eine nicht dauerhafte Genehmigung für den Websitezugriff gilt: turn beschränkt sie auf den aktuellen Dialogschritt, und thread behält sie für den Rest des aktuellen Threads bei. persistent_approval steuert separat, ob Always allow verfügbar ist. Der Produktstandard ist thread.
browser_use.default_origin_policy.auto_review allow | deny Verwenden Sie deny, um die automatische Prüfung für Origins zu überspringen, für die der Fallback gilt, und stattdessen den Benutzer um Genehmigung zu bitten. allow lässt die automatische Prüfung verfügbar, sofern andere Einstellungen sie zulassen.
browser_use.default_origin_policy.downloads allow | deny Verwenden Sie deny, um Downloads über Browser Use für Origins zu blockieren, für die der Fallback gilt. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren.
browser_use.default_origin_policy.full_cdp_access allow | deny Verwenden Sie deny, um den vollständigen Zugriff über das Chrome DevTools Protocol (CDP) für Origins zu blockieren, für die der Fallback gilt. allow lässt lediglich die normalen Opt-in- und Genehmigungsprüfungen fortfahren.
browser_use.default_origin_policy.persistent_approval boolean Setzen Sie den Wert auf false, um zu verhindern, dass Browser Use eine Always allow-Genehmigung für Origins speichert oder berücksichtigt, für die der Fallback gilt. Genehmigungen für den aktuellen Dialogschritt oder Thread können weiterhin gelten. true macht Always allow verfügbar, sofern dies ansonsten zulässig ist, erstellt jedoch keine Genehmigung.
browser_use.default_origin_policy.uploads allow | deny Verwenden Sie deny, um Uploads über Browser Use für Origins zu blockieren, für die der Fallback gilt. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren.
browser_use.disable_auto_review boolean Setzen Sie den Wert auf true, um die automatische Prüfung für Browser Use zu überspringen und stattdessen den Benutzer um Genehmigung zu bitten. Der Wert false oder das Weglassen der Einstellung lässt die automatische Prüfung verfügbar, sofern andere Einstellungen sie zulassen.
browser_use.origins map<string, table> Origin-spezifische Browser Use-Richtlinien. Schlüssel verwenden &lt;scheme&gt;://&lt;host-pattern&gt;[:&lt;port&gt;] mit http oder https. Verwenden Sie einen exakten Host, *.example.com nur für Subdomains oder **.example.com für die Basisdomain und ihre Subdomains. Andere *-Platzhalter können Punkte einschließen, sodass region*.example.com auch auf region.api.example.com zutrifft; ein Host mit dem Wert * trifft auf jeden Host für dieses Schema zu. Schemata und vom Standard abweichende Ports sind relevant; explizite Standardports werden bei der Normalisierung entfernt. Pfade, Abfragen, eingebettete Benutzernamen oder Passwörter sowie Platzhalter in Schemata oder Ports sind ungültig. Setzen Sie das Muster in TOML in Anführungszeichen, beispielsweise [browser_use.origins."https://**.example.com"].
browser_use.origins.<pattern> table Richtlinie für Origins, die diesem Muster entsprechen. Wenn mehrere Muster zutreffen, verwendet Codex für jede Funktion den restriktivsten Wert: deny vor allow, false vor true und turn vor thread.
browser_use.origins.<pattern>.access allow | deny Verwenden Sie deny, um Browser Use für passende Origins zu blockieren. Die Ablehnung blockiert dort auch Uploads, Downloads, vollständigen Browser-Debugging-Zugriff und die automatische Prüfung. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren.
browser_use.origins.<pattern>.access_approval_lifetime turn | thread Legen Sie fest, wie lange eine nicht dauerhafte Genehmigung für den Websitezugriff auf passende Origins gilt: turn beschränkt sie auf den aktuellen Dialogschritt, und thread behält sie für den Rest des aktuellen Threads bei. persistent_approval steuert separat, ob Always allow verfügbar ist.
browser_use.origins.<pattern>.auto_review allow | deny Verwenden Sie deny, um die automatische Prüfung für passende Origins zu überspringen und stattdessen den Benutzer um Genehmigung zu bitten. allow lässt die automatische Prüfung verfügbar, sofern andere Einstellungen sie zulassen.
browser_use.origins.<pattern>.downloads allow | deny Verwenden Sie deny, um Downloads über Browser Use für passende Origins zu blockieren. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren.
browser_use.origins.<pattern>.full_cdp_access allow | deny Verwenden Sie deny, um den vollständigen Zugriff über das Chrome DevTools Protocol (CDP) für passende Origins zu blockieren. allow lässt lediglich die normalen Opt-in- und Genehmigungsprüfungen fortfahren.
browser_use.origins.<pattern>.persistent_approval boolean Setzen Sie den Wert auf false, um zu verhindern, dass Browser Use eine Always allow-Genehmigung für passende Origins speichert oder berücksichtigt. Genehmigungen für den aktuellen Dialogschritt oder Thread können weiterhin gelten. true macht Always allow verfügbar, sofern dies ansonsten zulässig ist, erstellt jedoch keine Genehmigung.
browser_use.origins.<pattern>.uploads allow | deny Verwenden Sie deny, um Uploads über Browser Use für passende Origins zu blockieren. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren.
chatgpt_base_url string Die Basis-URL des ChatGPT-Dienstes vor der Authentifizierung und dem Abruf der Cloud-Richtlinien verbindlich festlegen. Dies konfiguriert nicht alle Netzwerkziele von Codex. Wird über die lokale Datei mit Systemvorgaben oder macOS MDM festgelegt; in der Cloud verwaltete Werte werden ignoriert.
check_for_update_on_startup boolean Verbindlich festlegen, ob Codex beim Start nach Updates sucht.
cli_auth_credentials_store file | keyring | auto | ephemeral Den CLI-Anmeldedatenspeicher verbindlich festlegen, bevor die Authentifizierung geladen wird. file verwendet CODEX_HOME/auth.json; keyring erfordert den Anmeldedatenspeicher des Betriebssystems; auto greift auf eine Datei zurück, wenn der Anmeldedatenspeicher nicht verfügbar ist; ephemeral hält Anmeldedaten für den aktuellen Prozess im Arbeitsspeicher. Wird über die lokale Datei mit Systemvorgaben oder macOS MDM festgelegt; in der Cloud verwaltete Werte werden ignoriert.
computer_use table Verwaltete Vorgaben für agentengesteuerte Arbeit in nativen Desktop-Apps. Sowohl verwaltete App-Regeln als auch App-Regeln aus config.toml werden durchgesetzt; eine App muss von jeder Richtlinienquelle zugelassen werden.
computer_use.allow_locked_computer_use boolean Setzen Sie den Wert auf false, um zu verhindern, dass Benutzer Locked Use auf einem verwalteten macOS-Gerät aktivieren. Diese Vorgabe entfernt die Steuerelemente zur Aktivierung; sie deaktiviert Locked Use nicht, wenn es bereits aktiviert ist. Fehlt die Einstellung, gilt die normale Produktverfügbarkeit.
computer_use.allow_persistent_approval boolean Setzen Sie den Wert auf false, um die Option zum sitzungsübergreifenden Speichern von App-Genehmigungen zu entfernen. Genehmigungen für die aktuelle Sitzung bleiben verfügbar. Der Wert true oder das Weglassen der Einstellung genehmigt keine App.
computer_use.default_app_access allow | deny Fallback-Zugriff für native Apps, auf die keine plattformspezifische Regel zutrifft. deny blockiert den Zugriff. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren. Der Produktstandard ist allow.
computer_use.macos table Computer Use-App-Regeln für macOS.
computer_use.macos.bundle_ids map<string, allow | deny> Exakte macOS-Bundle-IDs allow oder deny zuordnen. Eine passende Regel ersetzt computer_use.default_app_access innerhalb derselben Richtlinienquelle. Eine Ablehnung durch verwaltete Vorgaben oder die Benutzerkonfiguration blockiert den Zugriff weiterhin.
computer_use.macos.bundle_ids.<bundle-id> allow | deny Verwenden Sie deny, um die exakte Bundle-ID zu blockieren. allow überschreibt nur den Standardwert dieser Richtlinienquelle und erfordert weiterhin, dass jede andere Richtlinienquelle und der normale Genehmigungsablauf die App zulassen.
computer_use.windows table Computer Use-App-Regeln für paketierte und nicht paketierte Windows-Apps.
computer_use.windows.aumids map<string, allow | deny> Exakte, registrierte Application User Model IDs (AUMIDs) für signierte paketierte Apps allow oder deny zuordnen. Eine passende Regel ersetzt computer_use.default_app_access innerhalb derselben Richtlinienquelle.
computer_use.windows.aumids.<aumid> allow | deny Verwenden Sie deny, um die exakte Identität der paketierten App zu blockieren. allow überschreibt nur den Standardwert dieser Richtlinienquelle und erfordert weiterhin, dass jede andere Richtlinienquelle und der normale Genehmigungsablauf die App zulassen.
computer_use.windows.exes array<table> Regeln für signierte, nicht paketierte ausführbare Windows-Dateien. Regeln gleichen den verifizierten Herausgeber und die signierten Versionsinformationen der ausführbaren Datei ab, nicht ihren Pfad oder aktuellen Dateinamen. Eine passende Ablehnung hat Vorrang vor passenden Erlaubnissen. Nicht signierte ausführbare Dateien verwenden computer_use.default_app_access; ausführbare Dateien, deren signierte Identität nicht eindeutig verifiziert werden kann, werden blockiert.
computer_use.windows.exes[].access allow | deny Erforderliche Zugriffsentscheidung für passende ausführbare Dateien. deny blockiert den Zugriff. allow überschreibt nur den Standardwert dieser Richtlinienquelle und erfordert weiterhin, dass jede andere Richtlinienquelle und der normale Genehmigungsablauf die App zulassen.
computer_use.windows.exes[].binary_name string Optionaler Wert für OriginalFilename aus den signierten Versionsinformationen der ausführbaren Datei. Der Abgleich unterscheidet nicht zwischen Groß- und Kleinschreibung. Wenn eine passende Herausgeber- und Produktregel diesen Wert erfordert, die ausführbare Datei ihn aber nicht bereitstellt, blockiert Computer Use die ausführbare Datei.
computer_use.windows.exes[].product_name string Erforderlicher exakter Wert für ProductName aus den signierten Versionsinformationen der ausführbaren Datei.
computer_use.windows.exes[].publisher_name string Erforderlicher exakter Herausgebername aus dem vertrauenswürdigen Signaturzertifikat der ausführbaren Datei, formatiert als Windows-X.500-Distinguished-Name.
default_permissions string Verwaltetes Standardberechtigungsprofil. Das Profil muss durch allowed_permission_profiles zugelassen sein. Legen Sie dies explizit fest, um ein vorhersehbares Verhalten zu gewährleisten; fehlt die Einstellung, verwendet Codex nur dann standardmäßig :workspace, wenn sowohl :workspace als auch :read-only explizit zugelassen sind.
enforce_residency string Für den Codex-Dienstverkehr eine unterstützte Datenresidenz vorschreiben. Akzeptiert derzeit us.
experimental_network table Vom Administrator verwaltete Netzwerkvorgaben für lokale Befehle in der Sandbox, die aus requirements.toml durchgesetzt werden. Wenn diese Vorgaben aktiviert sind, können sie den Netzwerkproxy für Befehle ohne features.network_proxy starten. Browser-Tools prüfen verwaltete Netzwerkverbote und exklusive Positivlisten separat. Diese Vorgaben leiten weder Browserdatenverkehr durch den Proxy noch steuern sie Websuche, Apps, MCP server, Datenverkehr nativer Apps oder anderen funktionsspezifischen Datenverkehr. Auf unterstützten verwalteten Codex Cloud-Ausführungspfaden beschränken diese Vorgaben den Netzwerkzugriff von Befehlen zusammen mit separaten Interneteinstellungen der Cloud-Umgebung. Eine genehmigte vollständige Sandbox-Eskalation kann den Befehlsproxy umgehen, sofern die Richtlinie dies zulässt. Work Cloud übernimmt diese Vorgaben nicht.
experimental_network.allow_local_binding boolean Umfassenderen Zugriff auf lokale/private Netzwerke aus der Sandbox zulassen. Auf dem unterstützten Codex Cloud-Proxy-Pfad kann ein expliziter falscher Wert den Zugriff über einen vorgeschalteten Proxy verhindern, selbst wenn eine Domain zugelassen ist. Der Standardwert ist nur dann wahr, wenn keine anwendbare Vorgabe, kein ausgewähltes Netzwerkprofil und keine Proxy-Funktionseinstellung einen Wert vorgibt. Ein geerbter falscher Wert bleibt explizit. Eine unterstützte Cloud-Überschreibung mit höherer Priorität kann ihn ändern, ohne Global für Local zu erweitern oder Domain-Erlaubniseinträge hinzuzufügen. Prüfen Sie die Unterstützung durch die Ausführungskomponente. Wenden Sie diesen Cloud-Standardwert nicht auf Local an.
experimental_network.allow_upstream_proxy boolean Zulassen, dass Sandbox-Netzwerkverbindungen über einen vorgeschalteten Proxy aus der Umgebung weitergeleitet werden.
experimental_network.allowed_domains array<string> Administrator-Erlaubnisregeln für den Netzwerkzugriff von Sandbox-Befehlen, während der verwaltete Netzwerkproxy aktiviert ist. Diese Regeln gelten nicht für Websuche, Apps oder MCP server. Kombinieren Sie dies nicht mit experimental_network.domains.
experimental_network.dangerously_allow_all_unix_sockets boolean Beliebige Unix-Socket-Ziele statt ausschließlich Zugriff gemäß Positivliste zulassen. Nur in streng kontrollierten Umgebungen verwenden.
experimental_network.dangerously_allow_non_loopback_proxy boolean Listener-Adressen außerhalb von Loopback für [experimental_network]-Vorgaben zulassen. Die Aktivierung kann Listener über localhost hinaus erreichbar machen.
experimental_network.denied_domains array<string> Als Liste strukturierte Administrator-Verbotsregeln für den Netzwerkzugriff in der Sandbox. Kombinieren Sie dies nicht mit experimental_network.domains.
experimental_network.domains map<string, allow | deny> Als Zuordnung strukturierte Administrator-Domainrichtlinie für den Netzwerkzugriff in der Sandbox. Unterstützt exakte Hosts, *.example.com nur für Subdomains, **.example.com für die Basisdomain samt Subdomains sowie globale *-Erlaubnisregeln. Bevorzugen Sie eingegrenzte Regeln, da * ausgehenden Zugriff auf öffentliche Ziele weitgehend öffnet. Umgebungsregeln können denselben Domain-Schlüssel aus Global innerhalb einer Richtlinie ersetzen. Werte mit höherer Priorität ersetzen denselben Schlüssel, während andere geerbte Schlüssel erhalten bleiben. Nach dem Zusammenführen blockiert ein anderes zutreffendes deny, einschließlich eines geerbten Platzhalters, eine Anfrage weiterhin. Leere Umgebungszuordnungen löschen keine Global-Regeln. Prüfen Sie die Unterstützung durch die Ausführungskomponente. Kombinieren Sie dies nicht mit experimental_network.allowed_domains oder experimental_network.denied_domains.
experimental_network.domains.<pattern> allow | deny Netzwerkzugriff aus der Sandbox für das passende Domainmuster zulassen oder ablehnen. Eine Verbotsregel hat Vorrang, wenn mehrere Muster zutreffen.
experimental_network.enabled boolean Netzwerkvorgaben für die Sandbox aktivieren. Dies gewährt keinen Netzwerkzugriff, wenn die aktive Sandbox den Netzwerkzugriff für Befehle deaktiviert hält.
experimental_network.http_port integer Port des Loopback-HTTP-Listeners für [experimental_network]-Vorgaben.
experimental_network.managed_allowed_domains_only boolean Wenn Netzwerkvorgaben aktiviert sind und dieser Wert wahr ist, können die normale Benutzerkonfiguration und domainspezifische Genehmigungen die verwaltete Proxy-Positivliste nicht erweitern. Ohne wirksame konfigurierte oder geerbte Erlaubniseinträge haben normale verwaltete Befehle keine zulässigen Ziele. Eine reine Verbotsrichtlinie erlaubt nicht den Zugriff auf das übrige Internet. Dies deckt nicht jedes Tool oder eine genehmigte vollständige Sandbox-Eskalation ab.
experimental_network.socks_port integer Port des Loopback-SOCKS5-Listeners für [experimental_network]-Vorgaben.
experimental_network.unix_sockets map<string, allow | deny> Vom Administrator verwaltete Unix-Socket-Positivliste für den Netzwerkzugriff in der Sandbox unter macOS. Pfade müssen absolut sein.
experimental_network.unix_sockets.<path> allow | deny Unter macOS fügt allow einen absoluten Unix-Socket-Pfad zur Positivliste hinzu; deny lässt ihn aus. Ein deny-Eintrag kann einen Socket nicht blockieren, wenn die Option zum Zulassen aller Unix-Sockets aktiviert ist.
features table Verbindlich festgelegte Funktionswerte. Verwenden Sie für Laufzeitfunktionen die kanonischen Namen aus config.toml; dokumentierte Vorgabenschlüssel, die nur für die App gelten, werden hier ebenfalls unterstützt.
features.<name> boolean Vorschreiben, dass eine dokumentierte Laufzeit- oder App-Funktion aktiviert oder deaktiviert bleibt.
features.apps boolean Die Verfügbarkeit der Apps-Integration für verwaltete Benutzer verbindlich aktivieren oder deaktivieren.
features.browser_use boolean Setzen Sie den Wert in requirements.toml auf false, um agentengesteuertes Browser Use zu deaktivieren.
features.browser_use_external boolean Setzen Sie den Wert in requirements.toml auf false, um zu verhindern, dass Codex unterstützte Browser über die ChatGPT-Browsererweiterung bedient, einschließlich vorhandener Tabs und angemeldeter Sitzungen.
features.browser_use_full_cdp_access boolean Setzen Sie den Wert in requirements.toml auf false, um den vollständigen Zugriff über das Chrome DevTools Protocol in der lokalen Laufzeit einschließlich des Browser Developer mode zu deaktivieren und zu verhindern, dass die ChatGPT-Desktop-App die entsprechende Einstellung aktiviert. Fehlt die Einstellung, gilt die normale Produktverfügbarkeit.
features.computer_use boolean Setzen Sie den Wert in requirements.toml auf false, um Computer Use, Record & Replay sowie zugehörige Installations- oder Aktivierungsabläufe zu deaktivieren.
features.fast_mode boolean Die kanonische Funktion fast_mode für verwaltete Benutzer verbindlich aktivieren oder deaktivieren.
features.guardian_approval boolean Die Verfügbarkeit von Guardian-Genehmigungen für verwaltete Benutzer verbindlich aktivieren oder deaktivieren.
features.in_app_browser boolean Setzen Sie den Wert in requirements.toml auf false, um den integrierten Browserbereich zu deaktivieren, den Benutzer direkt öffnen und steuern.
features.in_app_chat boolean Setzen Sie den Wert auf false, um die Ansichten für ChatGPT- und ChatGPT Work-Unterhaltungen sowie die zugehörige Oberfläche für Cloud-Automatisierungen in der ChatGPT-Desktop-App auszublenden. Diese Einstellung blockiert weder ChatGPT Voice noch beendet sie bestehende Cloud-Aufgaben. Der Wert true umgeht keine Konto-, Workspace-Berechtigungs- oder Rollout-Prüfungen.
features.in_app_dictation boolean Setzen Sie den Wert auf false, um die integrierte Diktierfunktion der Desktop-App zu deaktivieren. Der Wert true umgeht keine anderen Verfügbarkeitsprüfungen.
features.in_app_local_automation boolean Setzen Sie den Wert auf false, um lokale geplante Aufgaben in der Desktop-App zu deaktivieren. Der Wert true umgeht keine anderen Verfügbarkeitsprüfungen.
features.in_app_updates boolean Setzen Sie den Wert in requirements.toml auf false, um In-App-Updates zu deaktivieren. Updates bleiben standardmäßig aktiviert, wenn diese Vorgabe fehlt.
features.memories boolean Die Verfügbarkeit von Memories für verwaltete Benutzer verbindlich aktivieren oder deaktivieren.
features.multi_agent boolean Die Verfügbarkeit der Multi-Agent-Funktion für verwaltete Benutzer verbindlich aktivieren oder deaktivieren.
features.plugin_sharing boolean Setzen Sie den Wert in cloudverwaltetem requirements.toml auf false, um die Workspace-Freigabe für lokal erstellte Plugins zu deaktivieren.
features.plugins boolean Die Verfügbarkeit von Plugins für verwaltete Benutzer verbindlich aktivieren oder deaktivieren.
features.realtime_conversation boolean Setzen Sie den Wert auf false, um den experimentellen Befehl /voice in der Codex CLI zu deaktivieren. Verlassen Sie sich nicht auf diese Einstellung, um ChatGPT Voice in der Desktop-App oder Sprachsitzungen über app-server zu blockieren. Der Wert true umgeht keine Client- oder Rollout-Prüfungen.
features.remote_plugin boolean Die Verfügbarkeit des Remote-Plugin-Katalogs für verwaltete Benutzer verbindlich aktivieren oder deaktivieren.
features.workspace_dependencies boolean Die Verfügbarkeit der mitgelieferten Laufzeit für Workspace-Abhängigkeiten für verwaltete Benutzer verbindlich aktivieren oder deaktivieren.
feedback table Verwaltete Feedback-Einstellungen.
feedback.enabled boolean Verbindlich festlegen, ob Benutzer in den Codex-Clients Feedback senden können.
guardian_extra_policy string Zusätzliche verwaltete Markdown-Richtlinie für die automatische Prüfung, die zusammen mit der Hauptrichtlinie einbezogen wird. Diese hat Vorrang vor lokalem [auto_review].extra_policy. Leere Werte werden ignoriert.
guardian_policy_config string Verwaltete Richtlinienanweisungen in Markdown für die automatische Prüfung. Diese haben Vorrang vor lokalem [auto_review].policy. Leere Werte werden ignoriert.
hooks table Vom Administrator erzwungene verwaltete Lebenszyklus-Hooks. Erfordert ein Verzeichnis für verwaltete Hooks und verwendet dasselbe Ereignisschema wie inline definiertes [hooks] in config.toml.
hooks.<Event> array<table> Matcher-Gruppen für ein Hook-Ereignis wie PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit oder Stop.
hooks.<Event>[].hooks array<table> Hook-Handler für eine Matcher-Gruppe. Befehls- und MCP-Tool-Hooks werden unterstützt, während Prompt- und Agent-Hook-Handler geparst, aber übersprungen werden.
hooks.<Event>[].hooks[].additionalContextLimit integer Ungefährer Token-Schwellenwert pro Handler, ab dem übergroßes additionalContext auf der Festplatte gespeichert und dem Modell eine kürzere Vorschau angezeigt wird. Standardwert ist 2500; 0 übergibt den vollständigen Kontext direkt an das Modell. Siehe Umfangreiche Hook-Ausgaben.
hooks.<Event>[].hooks[].async boolean Einen Befehls-Hook im Hintergrund ausführen, ohne den auslösenden Vorgang zu verzögern. Standardwert ist false; SessionEnd wird immer synchron ausgeführt. Siehe Hooks im Hintergrund ausführen.
hooks.<Event>[].hooks[].commandWindows string Befehlsüberschreibung für Befehls-Hooks, die nur unter Windows gilt. Der TOML-Alias command_windows wird ebenfalls akzeptiert.
hooks.managed_dir string (absolute path) Verzeichnis mit verwalteten Hook-Skripten unter macOS und Linux. Codex prüft vor dem Laden verwalteter Hooks, ob der Pfad absolut ist und das Verzeichnis existiert.
hooks.windows_managed_dir string (absolute path) Verzeichnis mit verwalteten Hook-Skripten unter Windows. Codex prüft vor dem Laden verwalteter Hooks, ob der Pfad absolut ist und das Verzeichnis existiert.
in_app_browser table Vorgaben für den integrierten Browserbereich. Diese Einstellungen steuern nicht das agentengesteuerte Browser Use.
in_app_browser.allow_external_browser_settings_import boolean Setzen Sie den Wert auf false, um zu verhindern, dass Benutzer Einstellungen oder Browserdaten aus einem externen Browser in den integrierten Browser importieren. Der Wert true oder das Weglassen der Einstellung lässt den Import verfügbar, sofern andere Produktprüfungen ihn zulassen. Dies ist eine ausschließlich verwaltete Einstellung ohne Überschreibung durch config.toml.
log_dir string (path) Verzeichnis verbindlich festlegen, in das Codex lokale Protokolldateien schreibt.
marketplaces table Administratorvorgaben für Plugin-Marktplatzquellen. Regeln werden wirksam, wenn restrict_to_allowed_sources den Wert true hat.
marketplaces.allowed_sources table Zulässige Marktplatzquellen mit vom Administrator gewählten Regelnamen als Schlüssel. Unterschiedliche Namen werden über Vorgabenebenen hinweg zusammengeführt; für Felder unter demselben Namen gilt die normale Ebenenpriorität.
marketplaces.allowed_sources.<name> table Eine Regel für eine zulässige Quelle. Der endgültige Wert von source nach dem Zusammenführen der Vorgaben bestimmt, welche Felder derselben Ebene Codex interpretiert.
marketplaces.allowed_sources.<name>.host_pattern string Regulärer Ausdruck, der bei source = "host_pattern" erforderlich ist. Codex gleicht ihn mit dem in Kleinbuchstaben umgewandelten Hostnamen ab, der aus einer Git-Quelle im HTTPS-, SSH- oder SCP-Stil ausgelesen wurde. Verwenden Sie ^ und $, um eine Übereinstimmung mit dem gesamten Hostnamen zu verlangen.
marketplaces.allowed_sources.<name>.path string (absolute path) Lokales Marktplatzverzeichnis, das bei source = "local" erforderlich ist. Codex verlangt einen absoluten Pfad und vergleicht Pfade nach der Normalisierung.
marketplaces.allowed_sources.<name>.ref string Optionale exakte Git-Referenz für eine git-Regel. Fehlt sie, erlaubt die Regel jede Referenz für das passende Repository.
marketplaces.allowed_sources.<name>.source git | host_pattern | local Matcher-Typ für die Marktplatzquelle. Verwenden Sie git für ein einzelnes Repository, host_pattern für Git-Hosts, die anhand eines regulären Ausdrucks abgeglichen werden, oder local für ein einzelnes Verzeichnis.
marketplaces.allowed_sources.<name>.url string Git-Repository-URL, die bei source = "git" erforderlich ist. Codex normalisiert die konfigurierten und zulässigen URLs, bevor es eine exakte Repository-Übereinstimmung verlangt.
marketplaces.restrict_to_allowed_sources boolean Bei true müssen konfigurierte Marktplatzquellen beim Hinzufügen von Marktplätzen, Installieren von Plugins, Aktualisieren und Laden zur Laufzeit mit allowed_sources übereinstimmen. Von OpenAI kuratierte Git-Kataloge, einschließlich des API key-Katalogs, müssen ebenfalls mit der Positivliste übereinstimmen. Gebündelte und remote installierte Workspace-Plugins sind von dieser Richtlinie für kuratierte Git-Quellen getrennt.
mcp_servers table Positivliste der MCP server, die aktiviert werden dürfen. Sowohl der Servername (&lt;id&gt;) als auch seine Identität müssen übereinstimmen, damit der MCP server aktiviert werden kann. Jeder konfigurierte MCP server, der nicht in der Positivliste enthalten ist oder dessen Identität abweicht, wird deaktiviert.
mcp_servers.<id>.identity table Identitätsregel für einen einzelnen MCP server. Setzen Sie entweder command (stdio) oder url (streamable HTTP).
mcp_servers.<id>.identity.command string | table Einen stdio MCP server anhand einer exakten Befehlszeichenfolge zulassen oder mit einer Matcher-Tabelle eine exakte ausführbare Datei und geordnete Argument-Matcher vorschreiben. Die Zeichenfolgenform prüft weder Argumente noch cwd, env oder env_vars.
mcp_servers.<id>.identity.command.args array<table> Geordnete Argument-Matcher für einen stdio-Server. Die konfigurierte Argumentliste muss dieselbe Länge haben, und jede Position muss übereinstimmen. Befehls-Matcher prüfen weder cwd noch env oder env_vars.
mcp_servers.<id>.identity.command.args[].expression string Regulärer Ausdruck, den ein Argument-Matcher vom Typ regex verwendet. Der Ausdruck muss gültig sein und auf den vollständigen Argumentwert zutreffen.
mcp_servers.<id>.identity.command.args[].match exact | prefix | regex Abgleichsoperation für diese Argumentposition.
mcp_servers.<id>.identity.command.args[].value string Wert, den ein Argument-Matcher vom Typ exact oder prefix verwendet.
mcp_servers.<id>.identity.command.executable string Ausführbare Datei, mit der das konfigurierte command des stdio-Servers exakt übereinstimmen muss.
mcp_servers.<id>.identity.url string | table Einen MCP server mit streamable HTTP anhand einer exakten URL-Zeichenfolge zulassen oder eine Wert-Matcher-Tabelle vom Typ exact, prefix oder regex verwenden.
mcp_servers.<id>.identity.url.expression string Regulärer Ausdruck, den ein URL-Matcher vom Typ regex verwendet. Der Ausdruck muss gültig sein und auf den vollständigen URL-Wert zutreffen.
mcp_servers.<id>.identity.url.match exact | prefix | regex Abgleichsoperation für die konfigurierte URL des MCP server.
mcp_servers.<id>.identity.url.value string Wert, den ein URL-Matcher vom Typ exact oder prefix verwendet.
model_catalog_json string (path) JSON-Modellkatalog verbindlich festlegen, den Codex beim Start verwendet.
model_provider string Die Modellanbieter-ID verbindlich festlegen und dabei die lokale und die Sitzungskonfiguration überschreiben.
model_providers map<string, table> Verwaltete Modellanbieterdefinitionen. Jeder Eintrag ersetzt den gesamten konfigurierten Anbieter mit derselben ID; Felder werden nicht mit der Definition des Benutzers zusammengeführt. Anbieter mit anderen IDs bleiben verfügbar.
model_providers.<id> table Vollständige verwaltete Anbieterdefinition. Verwendet dieselben Anbieterfelder wie config.toml, einschließlich name, base_url sowie Authentifizierungs- und Transporteinstellungen.
models table Enthält die Tabelle [models.new_thread].
models.new_thread table Optionale Standardwerte, die beim Start eines neuen lokalen Threads gelten. Sie haben Vorrang vor Benutzer- und Projektstandardwerten, können aber durch explizite Überschreibungen ersetzt werden.
models.new_thread.model string Standardmodell für neue Threads. Eine explizite Überschreibung des Modells oder des Reasoning-Aufwands führt dazu, dass beide Felder ignoriert werden.
models.new_thread.model_reasoning_effort string Standardmäßiger Reasoning-Aufwand für neue Threads. Eine explizite Überschreibung des Modells oder des Reasoning-Aufwands führt dazu, dass beide Felder ignoriert werden.
models.new_thread.service_tier string Standard-Service-Tier für neue Threads. Eine explizite Überschreibung des Service-Tiers führt dazu, dass dieses Feld ignoriert wird.
permissions table Vom Administrator definierte Berechtigungsprofile mit dem Profilnamen als Schlüssel. Verwendet dieselben Profilfelder wie config.toml.
permissions.<name> table Vom Administrator definiertes Berechtigungsprofil. Der Name darf weder mit : beginnen noch den reservierten Namen filesystem verwenden oder ein Profil aus einer geladenen Konfiguration duplizieren. Verwendet dieselben Profilfelder wie config.toml; das vollständige Profilschema finden Sie im Leitfaden zu Berechtigungen.
permissions.filesystem.deny_read array<string> Vom Administrator erzwungene Leseverbote für das Dateisystem. Einträge können Pfade oder Glob-Muster sein; Benutzer können sie nicht durch lokale Konfiguration abschwächen.
plugins table Plugin-spezifische Positivlisten für MCP server mit der Plugin-ID als Schlüssel. Wenn diese Tabelle vorhanden ist, werden mit Plugins gebündelte Server ohne passenden Plugin- und Servereintrag deaktiviert.
plugins.<plugin>.mcp_servers table Positivliste für MCP server, die mit einem Plugin gebündelt sind. Vorgaben für Plugin-Server verwenden dieselben exakten Identitäts- und Matcher-Formen wie mcp_servers-Vorgaben auf oberster Ebene.
plugins.<plugin>.mcp_servers.<server>.identity table Identitätsregel für einen mit einem Plugin gebündelten MCP server. Setzen Sie entweder command (stdio) oder url (streamable HTTP).
plugins.<plugin>.mcp_servers.<server>.identity.command string | table Den stdio MCP server eines Plugins anhand einer exakten Befehlszeichenfolge zulassen oder mit einer Matcher-Tabelle eine exakte ausführbare Datei und geordnete Argument-Matcher vorschreiben.
plugins.<plugin>.mcp_servers.<server>.identity.command.args array<table> Geordnete Argument-Matcher für einen mit einem Plugin gebündelten stdio-Server. Die konfigurierte Argumentliste muss dieselbe Länge haben, und jede Position muss übereinstimmen.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression string Regulärer Ausdruck, den ein Argument-Matcher vom Typ regex verwendet. Der Ausdruck muss auf den vollständigen Argumentwert zutreffen.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match exact | prefix | regex Abgleichsoperation für diese Argumentposition.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value string Wert, den ein Argument-Matcher vom Typ exact oder prefix verwendet.
plugins.<plugin>.mcp_servers.<server>.identity.command.executable string Ausführbare Datei, mit der der konfigurierte Befehl des mit dem Plugin gebündelten stdio-Servers exakt übereinstimmen muss.
plugins.<plugin>.mcp_servers.<server>.identity.url string | table Den MCP server eines Plugins mit streamable HTTP anhand einer exakten URL-Zeichenfolge zulassen oder eine Wert-Matcher-Tabelle vom Typ exact, prefix oder regex verwenden.
plugins.<plugin>.mcp_servers.<server>.identity.url.expression string Regulärer Ausdruck, den ein URL-Matcher vom Typ regex verwendet. Der Ausdruck muss auf den vollständigen URL-Wert zutreffen.
plugins.<plugin>.mcp_servers.<server>.identity.url.match exact | prefix | regex Abgleichsoperation für die URL des mit dem Plugin gebündelten MCP server.
plugins.<plugin>.mcp_servers.<server>.identity.url.value string Wert, den ein URL-Matcher vom Typ exact oder prefix verwendet.
remote_sandbox_config array<table> Hostspezifische Sandbox-Vorgaben. Der erste Eintrag, dessen hostname_patterns mit dem ermittelten Hostnamen übereinstimmen, überschreibt allowed_sandbox_modes auf oberster Ebene für diese Vorgabenquelle. Hostspezifische Einträge überschreiben derzeit nur Sandbox-Modi.
remote_sandbox_config[].allowed_sandbox_modes array<string> Zulässige Sandbox-Modi, die gelten, wenn dieser hostspezifische Eintrag zutrifft.
remote_sandbox_config[].hostname_patterns array<string> Hostnamenmuster ohne Unterscheidung zwischen Groß- und Kleinschreibung. Unterstützt * für eine beliebige Zeichenfolge und ? für ein einzelnes Zeichen.
rules table Vom Administrator erzwungene Befehlsregeln, die mit .rules-Dateien zusammengeführt werden. Vorgabenregeln müssen einschränkend sein.
rules.prefix_rules array<table> Liste der erzwungenen Präfixregeln. Jede Regel muss pattern und decision enthalten.
rules.prefix_rules[].decision prompt | forbidden Erforderlich. Vorgabenregeln können nur eine Rückfrage verlangen oder etwas verbieten, aber nichts erlauben.
rules.prefix_rules[].justification string Optionale, nicht leere Begründung, die in Genehmigungsanfragen oder Ablehnungsmeldungen angezeigt wird.
rules.prefix_rules[].pattern array<table> Befehlspräfix, ausgedrückt als Muster-Tokens. Jedes Token setzt entweder token oder any_of.
rules.prefix_rules[].pattern[].any_of array<string> Eine Liste zulässiger alternativer Tokens an dieser Position.
rules.prefix_rules[].pattern[].token string Ein einzelnes wörtliches Token an dieser Position.
sqlite_home string (path) Verzeichnis verbindlich festlegen, in dem Codex den SQLite-basierten Laufzeitzustand speichert.
windows table Vorgaben für die native Windows-Sandbox.
windows.allowed_sandbox_implementations array<string> Zulässige ältere Implementierungen der nativen Windows-Sandbox (elevated und unelevated). Die Liste darf nicht leer sein. Wenn beide zulässig sind und kein Modus ausgewählt ist, bevorzugt Codex elevated. Diese Liste schränkt die Sandbox mxc nicht ein, wenn sie verfügbar ist.