Auf dieser Seite kannst du die Einstellungen für die Codex-Konfigurationsdateien nachschlagen und durchsuchen. Eine Einführung mit Beispielen findest du in den Grundlagen der Konfiguration und in der erweiterten Konfiguration.
Einstellungen für den Zugriff auf lokale Computer mit Work Cloud
Wenn der Zugriff auf lokale Computer mit Work Cloud aktiviert ist, koordiniert die Cloud von OpenAI die Aufgabe. Unterstützte Tools laufen in der Cloud oder auf einem verbundenen Computer. Anforderungen legen Grenzen fest. Konfigurationswerte geben Standardeinstellungen vor.
Verwalte die Einstellungen für Global über die Richtlinien-API. Für die Einstellungen von Lokal und Codex Cloud verwendest du die Oberfläche von Agent Security. Bestehende API-Workflows für Global bleiben nach der Migration verfügbar. Teste deine Skripte und Terraform-Integrationen und prüfe, ob die Richtlinien weiterhin gleich zugewiesen und in derselben Reihenfolge angewendet werden. Allein daraus, dass ein Feld in requirements.toml unterstützt wird, lässt sich keine API-Kompatibilität ableiten.
| Einstellung oder Gruppe | Geltungsbereich beim Zugriff auf lokale Computer mit Work Cloud | Hinweise |
|---|---|---|
| Genehmigungsrichtlinien und Prüfanforderungen | Globale Orchestratorrichtlinie, wenn die verwaltete Richtlinie aktiviert ist | Belasse die Einstellungen für Genehmigungen und Überprüfungen in Global. Umgebungsspezifische Einstellungen können die Orchestratoreinstellungen nicht überschreiben. Für die lokale Ausführung und die Ausführung in Cloud-Containern gelten getrennte Richtlinienbereiche. |
| Verwaltete Apps, MCP-Server, Plugins, Marketplaces und Befehlsregeln | Globale Richtlinie | Verwalte diese Einstellungen global. Ein Feld im Schema allein belegt nicht, dass du es für jede Umgebung einzeln bearbeiten kannst. |
| Anforderungen für Dateien, Sandbox und umgebungsübergreifenden Netzwerkzugriff | Lokale Ausführung | Bei lokaler Ausführung haben MDM und ältere Anforderungen für verwaltete Geräte Vorrang vor Agent Security. Agent Security hat wiederum Vorrang vor der Systemanforderungsdatei des Geräts. Die neue Unternehmenskonfiguration in requirements.toml gilt nicht für Cloud-Container von Work. Für sie gelten weiterhin die bisherigen Richtlinien von Work Cloud. |
| Plattformspezifische Einstellungen für den Executor | Computer, der den Schritt ausführt | Die Unterstützung hängt vom Executor und von der Plattform ab. |
| Verwaltete Hooks | Wo aktiviert, laufen administrativ definierte MCP-Hooks für unterstützte Lebenszyklus- und Tool-Ereignisse auf dem Cloud-Koordinator (Orchestrator). | Bevor du dich auf diese Hooks verlässt, teste die Callback-Verbindung. Prüfe, welche Ereignisse sie empfängt und wie sich Fehler auf die Aufgabe auswirken. MCP-Hooks liefern kein vollständiges Auditprotokoll für die Compliance API. Bei Cloud-Orchestrierung werden Befehls-Hooks, Hooks aus der lokalen Konfiguration und Plugin-Hooks auch dann nicht unterstützt, wenn Tools lokal laufen. Bisher unterstützte Hooks gelten weiterhin für Threads in Work und Codex, bei denen sowohl die Orchestrierung als auch die Ausführung lokal erfolgen. |
| Adressen und Ports von Proxy-Listenern sowie Prozesseinstellungen | Keine umgebungsübergreifende Richtlinie | Die Cloud-Laufzeit unterstützt weder verwaltete HTTP-/SOCKS-Listener-Ports noch Proxy-Listener an anderen Adressen als Loopback. Ob Socket-Regeln unterstützt werden, hängt vom Ausführungspfad ab. Eine eigene Proxy-Konfiguration ist unabhängig von den unterstützten Beschränkungen für Netzwerkziele. |
| Reine App-Einstellungen und gewöhnliche lokale Standardwerte | Werden von der Cloud-Koordination nicht zwingend ausgewertet | Von der App durchgesetzte Regeln können auch dann wirksam bleiben, wenn der Zugriff auf lokale Computer mit Work Cloud sie nicht auswertet. Prüfe die Bereitstellung über die Cloud und das Verhalten des Cloud-Browsers separat. |
Anforderungen von Agent Security für den Zugriff auf lokale Computer mit Work Cloud
Bei Work mit lokalem Zugriff und bei dots gilt die unterstützte globale Richtlinie für den gemeinsamen Cloud-Orchestrator, sofern die verwaltete Richtlinie aktiviert ist. Die Anforderungen für die lokale Ausführung gelten für den verbundenen Computer. Cloud-Container von Work und Cloud-Computer von dots verwenden jeweils eigene Ausführungskonfigurationen und Anforderungen. Teste die lokalen und die Cloud-Einstellungen getrennt.
In der Oberfläche von Agent Security verfügbar
- Zulässige Genehmigungsrichtlinien
- Zulässige Modi für die Websuche
Über TOML konfigurierbar
allowed_approvals_reviewersauto_reviewguardian_policy_configappsmcp_serverspluginsrules
Diese Orchestratoranforderungen bleiben in Global. Sie konfigurieren keine Berechtigungen für gemeinsam genutzte Cloud-Funktionen. Lokale Ausführungseinstellungen lassen sich damit auch nicht auf Cloud-Container von Work oder Cloud-Computer von dots übertragen.
Kompatibilitätsgrenzen beim Zugriff auf lokale Computer mit Work Cloud
Die Unterstützung hängt vom Feld, vom Bereitstellungsweg der Richtlinie und vom Ausführungsort der Aufgabe ab. Prüfe die für das Mitglied wirksame Richtlinie, bevor du die Synchronisierung aktivierst. Die Tabelle gibt an, welche Einstellungen du in deiner Bereitstellung testen musst.
Innerhalb einer Richtlinie gilt folgende Rangfolge, beginnend mit der höchsten Priorität: Umgebungseinstellung für ein bestimmtes Betriebssystem → Umgebungseinstellung für alle Betriebssysteme → Global. Eine Richtlinie mit höherer Priorität hat auch dann Vorrang, wenn eine nachrangige Richtlinie spezifischer ist.
Bei lokaler Ausführung haben MDM und ältere Anforderungen für verwaltete Geräte Vorrang vor Agent Security. Agent Security hat wiederum Vorrang vor der Systemanforderungsdatei des Geräts. Für manche Anforderungen, darunter Netzwerkanforderungen, gelten je nach Feld eigene Regeln für die Zusammenführung und eigene Laufzeitbeschränkungen. Beispiele findest du in der verwalteten Konfiguration.
| Einstellung oder Gruppe | Kompatibilität beim Zugriff auf lokale Computer mit Work Cloud | Hinweise zur Administration |
|---|---|---|
sqlite_home, log_dir, model_catalog_json |
Als verwaltete Cloud-Überschreibungen nicht unterstützt. | Mit lokalen Pfaden kannst du weder Cloud-Speicher noch Cloud-Protokolle verlagern. Ein lokaler Modellkatalog wird nicht übernommen. |
model_provider, model_providers |
In verwalteten Anforderungen und Konfigurationen für den Zugriff auf lokale Computer mit Work Cloud nicht unterstützt. | Eigene Inferenz-Gateways und Anbieterverbindungen werden über diese Felder nicht übernommen. Die Modellauswahl ist davon unabhängig. |
enforce_residency |
Blockiert den Zugriff auf lokale Computer mit Work Cloud, sobald die Einstellung in einer Cloud-Richtlinie aktiviert ist. | Ist enforce_residency in mindestens einer Cloud-Richtlinie aktiviert, ist „Zugriff auf lokale Computer erlauben“ sowohl für Work als auch für dots deaktiviert. Diese Schutzmaßnahme legt keine Datenresidenz für den Workspace fest und deaktiviert für sich genommen weder Work Cloud noch dots. |
application.network.enabled und application.network.domains |
Beim Zugriff auf lokale Computer mit Work Cloud nicht unterstützt. | Verwende diese Beschränkungen für Netzwerkziele von Apps nicht, um den Netzwerkzugriff von Befehlen beim Zugriff auf lokale Computer mit Work Cloud zu steuern. |
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions |
Die Bereitstellung der Richtlinie über die Cloud muss geprüft werden. Beim Zugriff auf lokale Computer mit Work Cloud werden diese Schlüssel für verwaltete Anforderungen abgelehnt. | Die App prüft Browserbeschränkungen. Daraus folgt weder, dass die Cloud diese Beschränkungen bereitstellt, noch, dass der Cloud-Browser sie durchsetzt. additional_developer_instructions erfordert Unterstützung durch den Orchestrator. |
experimental_network und permissions.<profile>.network |
Teilweise unterstützt. Die unterstützten Beschränkungen für Netzwerkziele und Executor sind von einer eigenen Proxy-Konfiguration zu unterscheiden. | Die Cloud-Laufzeit unterstützt weder verwaltete HTTP-/SOCKS-Listener-Ports noch Proxy-Listener an anderen Adressen als Loopback. Die Unterstützung für Socket-Regeln hängt vom Ausführungspfad ab. Für die Zusammenführung bei lokaler Ausführung gelten eigene Regeln. Netzwerkbeschränkungen für Befehle deaktivieren weder die gehostete Suche noch MCP- oder App-Tools. |
Funktionen / feature_requirements, Modelle, computer_use |
Teilweise unterstützt. | Nicht mehr unterstützte Schalter wie tool_search = false, tool_search_always_defer_mcp_tools = false, js_repl = true und remote_control = true werden abgelehnt. Einige Einstellungen für die Computernutzung müssen noch durchgängig getestet werden. |
browser_use, allow_appshots, Feedback, allow_remote_control, Beschränkungen für Marketplace-Quellen |
Bei bestimmten Bereitstellungswegen setzt die App oder der App Server diese Regeln durch. | App-Regeln können auch dann gelten, wenn der Zugriff auf lokale Computer mit Work Cloud ein Feld ignoriert. Site-Regeln für Desktop-Browser gelten nicht für Cloud-Container von Work. Prüfe die konkrete Oberfläche und den tatsächlichen Bereitstellungsweg der Richtlinie. |
Das Konfigurationsschema enthält Schlüssel, die beim Zugriff auf lokale Computer mit Work Cloud möglicherweise nicht funktionieren oder keine umgebungsspezifischen Überschreibungen unterstützen. Die globalen Grundeinstellungen und die Rangfolge findest du in der verwalteten Konfiguration.
config.toml
Deine benutzerspezifische Konfiguration liegt in ~/.codex/config.toml. In .codex/config.toml-Dateien kannst du außerdem abweichende Werte für einzelne Projekte festlegen. Codex lädt die Konfigurationsdateien eines Projekts nur, wenn du dem Projekt vertraust.
Die Projektkonfiguration kann weder gerätelokale Einstellungen für Anbieter und Authentifizierung noch die vom Host verwalteten Metadaten für App-Anfragen überschreiben. Das gilt auch für die Schlüssel für Benachrichtigungen, die Auswahl des Konfigurationsprofils und die Weiterleitung von Telemetriedaten. 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 in einer projektlokalen .codex/config.toml. Lege Schlüssel für Anbieter, Benachrichtigungen und Telemetrie in deiner benutzerspezifischen Konfiguration fest. Profildateien liegen neben config.toml und haben den Pfad $CODEX_HOME/profile-name.config.toml. Mit --profile profile-name wählst du ein Profil aus.
Für Sandbox- und Genehmigungsschlüssel (approval_policy, sandbox_mode und sandbox_workspace_write.*) lies ergänzend Sandbox und Genehmigungen, Geschützte Pfade in beschreibbaren Stammverzeichnissen und Netzwerkzugriff. Informationen zu den Berechtigungsprofilen in der Betaversion findest du unter Berechtigungen.
Codex und ChatGPT Work unterstützen approval_policy = "untrusted" nicht mehr. Entferne die Einstellung oder wähle eine unterstützte Richtlinie. Projekteinträge mit trust_level = "untrusted" in deiner benutzerspezifischen ~/.codex/config.toml werden weiterhin unterstützt. Beispiele und Hinweise zum Abwägen der Genehmigungsoptionen findest du unter Migration von der eingestellten Genehmigungsrichtlinie untrusted.
Setze model auf ein Modell, das für dein angemeldetes Konto oder deinen Workspace verfügbar ist. Prüfe die Verfügbarkeit von GPT-6.1 Sol, bevor du den Beispielwert verwendest.
| Key | Typ / Werte | Details |
|---|---|---|
agents | table | Einstellungen für mehrere Agenten und Definitionen eigener Rollen. Namen skalarer Einstellungen sind reserviert und können nicht als eigene Rollennamen verwendet werden. |
agents.<name>.config_file | string (path) | Pfad zur TOML-Konfigurationsebene dieser Rolle. Relative Pfade beziehen sich auf das Verzeichnis der Konfigurationsdatei, die die Rolle definiert. |
agents.<name>.description | string | Rollenbeschreibung, die Codex bei der Auswahl und beim Starten dieses Agententyps erhält. |
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. Eine explizite Angabe beim Start hat Vorrang. |
agents.enabled | boolean | Aktiviert oder deaktiviert Tools für die Zusammenarbeit mehrerer Agenten. Standard ist true. |
agents.interrupt_message | boolean | Erfasst eine für das Modell sichtbare Nachricht, wenn ein Arbeitsschritt eines Agenten unterbrochen wird. Standard ist true. |
agents.max_concurrent_threads_per_session | number | Höchstzahl gleichzeitig offener Threads gestarteter Agenten. Der Haupt-Thread zählt nicht mit. Ohne Angabe wählt Codex den Standardwert. |
agents.max_threads | number | Älterer Alias für agents.max_concurrent_threads_per_session. |
allow_login_shell | boolean | Erlaubt Shell-Tools, eine Login-Shell zu verwenden. Standard ist true. Bei false werden Anfragen mit login = true abgelehnt. Ohne Angabe von login wird dann eine Shell ohne Login verwendet. |
allow_symlinked_codex_home | boolean | Unter macOS darf Codex beim Auflösen der Pfade beschreibbarer Sandbox-Stammverzeichnisse symbolischen Links folgen, wenn das jeweilige Stammverzeichnis $CODEX_HOME ist oder darunter liegt. Codex liest diese Einstellung nur beim Start aus $CODEX_HOME/config.toml auf dem ausführenden Host. Wenn du sie aktivierst, vertraust du auch Linkzielen außerhalb dieses Verzeichnisses und Zielen, die sich zwischen Befehlen ändern. Dadurch kommen keine weiteren beschreibbaren Stammverzeichnisse hinzu. Standard ist false. |
analytics.enabled | boolean | Aktiviert oder deaktiviert Analysen für dieses Gerät oder Profil. Mit false deaktivierst du den integrierten Statsig-Metrikexporter. Explizit konfigurierte OTLP-Metrikexporter bleiben aktiv. 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 } } | Legt fest, wann Codex vor der Ausführung eines Befehls auf eine Genehmigung wartet. Mit approval_policy = { granular = { ... } } kannst du bestimmte Kategorien von Rückfragen zulassen oder automatisch ablehnen. Andere Rückfragen bleiben interaktiv. untrusted wird nicht unterstützt, on-failure ist veraltet. Verwende on-request für interaktive und never für nicht interaktive Ausführungen. |
approval_policy.granular.mcp_elicitations | boolean | Bei true kann Codex Anfragen zur MCP-Elizitation anzeigen, anstatt sie automatisch abzulehnen. |
approval_policy.granular.request_permissions | boolean | Bei true kann Codex Anfragen des Tools request_permissions anzeigen. |
approval_policy.granular.rules | boolean | Bei true kann Codex Genehmigungsanfragen anzeigen, die durch prompt-Regeln der Befehlsrichtlinie execpolicy ausgelöst werden. |
approval_policy.granular.sandbox_approval | boolean | Bei true kann Codex für die Ausführung außerhalb der Sandbox eine Genehmigung anfordern. |
approval_policy.granular.skill_approval | boolean | Bei true kann Codex Genehmigungsanfragen für Skill-Skripte anzeigen. |
approvals_reviewer | user | auto_review | Legt fest, wer unter on-request oder granularen Genehmigungsrichtlinien die dafür vorgesehenen Anfragen prüft. Standard ist user. Bei auto_review übernimmt ein Subagent die Prüfung. Die Einstellung ändert das Sandboxing nicht und löst keine Prüfung von Aktionen aus, die innerhalb der Sandbox bereits erlaubt sind. |
apps._default.approvals_reviewer | user | auto_review | Legt fest, wer Genehmigungsanfragen für App-Tools standardmäßig prüft. Der Wert lässt sich pro App überschreiben. Ohne Angabe übernehmen Apps den übergeordneten Wert von approvals_reviewer. |
apps._default.default_tools_approval_mode | auto | prompt | writes | approve | Standardverhalten bei Genehmigungen für App-Tools, für die weder auf App- noch auf Tool-Ebene eine abweichende Einstellung gilt. |
apps._default.destructive_enabled | boolean | Legt fest, ob App-Tools mit destructive_hint = true standardmäßig erlaubt sind. |
apps._default.enabled | boolean | Legt fest, ob Apps standardmäßig aktiviert sind. Der Wert lässt sich pro App überschreiben. |
apps._default.open_world_enabled | boolean | Legt fest, ob App-Tools mit open_world_hint = true standardmäßig erlaubt sind. |
apps.<id>.approvals_reviewer | user | auto_review | Legt fest, wer Genehmigungsanfragen für die Tools dieser App prüft. Überschreibt apps._default.approvals_reviewer. |
apps.<id>.default_tools_approval_mode | auto | prompt | writes | approve | Standardverhalten bei Genehmigungen für die Tools dieser App. Der Wert lässt sich pro Tool überschreiben. |
apps.<id>.default_tools_enabled | boolean | Legt fest, ob die Tools dieser App standardmäßig aktiviert sind. Der Wert lässt sich pro Tool überschreiben. |
apps.<id>.destructive_enabled | boolean | Erlaubt oder blockiert Tools dieser App, die destructive_hint = true angeben. |
apps.<id>.enabled | boolean | Aktiviert oder deaktiviert eine bestimmte App bzw. einen Konnektor anhand der ID. Standard ist true. |
apps.<id>.omit_tools_from | array<string> | Blendet die Tools dieser App in den angegebenen Bereichen direct, deferred oder code_mode aus. Ausschlüsse für die App und den MCP-Server gelten gemeinsam. |
apps.<id>.open_world_enabled | boolean | Erlaubt oder blockiert Tools dieser App, die open_world_hint = true angeben. |
apps.<id>.tools.<tool>.approval_mode | auto | prompt | writes | approve | Überschreibt das Genehmigungsverhalten für ein einzelnes App-Tool. |
apps.<id>.tools.<tool>.enabled | boolean | Aktiviert oder deaktiviert ein einzelnes App-Tool, zum Beispiel repos/list, unabhängig vom Standardwert. |
auto_review.policy | string | Markdown-Text, der die Standardrichtlinie für die automatische Überprüfung ersetzt. Die verwaltete Einstellung guardian_policy_config hat Vorrang. Leere Werte werden ignoriert. |
background_terminal_max_timeout | number | Maximale Wartezeit in Millisekunden für leere write_stdin-Abfragen beim Abfragen des Hintergrundterminals. Standard ist 300000 (5 Minuten). Ersetzt den älteren Schlüssel background_terminal_timeout. |
browser_use.allow_history_access | boolean | Setze den Wert auf false, um den Zugriff auf den Browserverlauf einzuschränken. Verwaltete Anforderungen können diese Beschränkung erzwingen. |
browser_use.default_origin_policy | table | Standardbeschrä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. Gib das Schema HTTP oder HTTPS und optional einen Port an. Lass Pfade, Abfragen und Fragmente weg. Lokale Werte können verwaltete Verbote nicht lockern. |
chatgpt_base_url | string | Überschreibt die Basis-URL für die ChatGPT-Anmeldung. |
check_for_update_on_startup | boolean | Prüft beim Start, ob Updates für Codex verfügbar sind. Setze den Wert nur dann auf false, wenn Updates zentral verwaltet werden. |
cli_auth_credentials_store | file | keyring | auto | ephemeral | Legt fest, wo die CLI zwischengespeicherte Anmeldedaten ablegt. |
compact_prompt | string | Direkt in der Konfiguration angegebener Ersatz für den Prompt zur Kontextverdichtung des Verlaufs. |
computer_use.default_app_access | allow | deny | Standardrichtlinie für den Zugriff auf native Apps bei der Computernutzung. App-spezifische Einträge können eine eigene Richtlinie vorgeben. Die lokale Konfiguration kann verwaltete Beschränkungen nicht lockern. |
computer_use.macos.bundle_ids | map<string, allow | deny> | Zugriff auf native macOS-Apps, jeweils anhand der Bundle-ID. |
computer_use.windows.always_allowed_app_ids | array<string> | Kennungen der Windows-Apps, die bei der Computernutzung ohne Rückfrage geöffnet werden dürfen. Andere Apps erfordern eine Genehmigung. Gespeicherte Einträge kannst du in der ChatGPT-Desktop-App in den Einstellungen für die Computernutzung entfernen. |
computer_use.windows.aumids | map<string, allow | deny> | Zugriff auf paketierte Windows-Apps, jeweils anhand der 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 Standardberechtigungsprofils für Tool-Aufrufe in der Sandbox. Integriert sind :read-only, :workspace und :danger-full-access. Eigene Profilnamen benötigen passende Tabellen [permissions.<name>]. Nicht mit sandbox_mode oder [sandbox_workspace_write] kombinieren. |
desktop.custom_file_handlers.<id> | table | Nur auf Benutzerebene verfügbar. Definiert ein zusätzliches Ziel für „Öffnen in“ in der ChatGPT-Desktop-App. Beispiele und Vorgaben für Handler-IDs findest du unter Eigene Datei-Handler hinzufügen. |
desktop.custom_file_handlers.<id>.args | array<string> | Argumente zwischen dem Befehl und der Dateieingabe. Standard ist []. |
desktop.custom_file_handlers.<id>.command | string | Pfad zur ausführbaren Datei oder Name des Befehls, den die App erkennen und starten soll. Erforderlich. |
desktop.custom_file_handlers.<id>.icon | string | Pfad zu einer mitgelieferten Ressource, Base64-codierte data:image/...-URL, Datei-URI oder absoluter lokaler Pfad zum Handler-Symbol. Erforderlich. Bei nicht unterstützten Quellen erscheint das Standardsymbol von VS Code. |
desktop.custom_file_handlers.<id>.input | path | json_argument | json_stdin | Legt fest, wie die App die Dateieingabe an den Handler übergibt. Standard ist path. |
desktop.custom_file_handlers.<id>.label | string | Anzeigename im Menü „Öffnen in“. Erforderlich. |
desktop.custom_file_handlers.<id>.supports_ssh | boolean | Bietet den Handler für Dateien in SSH-Workspaces an. Standard ist false. |
developer_instructions | string | Zusätzliche Entwickleranweisungen, die Codex in die Sitzung einfügt (optional). |
disable_paste_burst | boolean | Ältere Ausweicheinstellung für tui.disable_paste_burst. Verwende bevorzugt die Einstellung unter [tui]. |
experimental_compact_prompt_file | string (path) | Lädt einen eigenen Prompt für die Kontextverdichtung aus einer Datei (experimentell). |
experimental_use_unified_exec_tool | boolean | Älterer Name zum Aktivieren der einheitlichen Befehlsausführung. Verwende bevorzugt [features].unified_exec oder codex --enable unified_exec. |
features.apps | boolean | Aktiviert App-Integrationen über Konnektoren (stabil, standardmäßig aktiviert). Weder der Netzwerkproxy für Sandbox-Befehle noch seine Liste zulässiger Domains steuert den Datenverkehr von Apps und Konnektoren. |
features.code_mode.direct_only_tool_namespaces | array<string> | Tool-Namespaces, die im Codemodus nur über direkte Tool-Aufrufe verfügbar sind. |
features.code_mode.enabled | boolean | Aktiviert die Funktionskonfiguration für den Codemodus. Die Funktion ist in Entwicklung und standardmäßig deaktiviert. |
features.code_mode.excluded_tool_namespaces | array<string> | Tool-Namespaces, die der Codemodus in den Anweisungen für verschachtelte Tool-Aufrufe auslässt und dem Executor nicht zur Verfügung stellt. |
features.context_management.experimental_mode | boolean | Experimentelle Einstellung für die Kontextverwaltung. Die Funktion ist derzeit nicht verfügbar. |
features.enable_request_compression | boolean | Komprimiert den Inhalt von Streaming-Anfragen mit zstd, sofern unterstützt (stabil, standardmäßig aktiviert). |
features.fast_mode | boolean | Aktiviert die vom aktiven Modell angebotenen Einstellungen für den Schnellmodus (stabil, standardmäßig aktiviert), unabhängig von features.ultrafast_mode. Die Verfügbarkeit hängt weiterhin vom Modell und vom Konto ab. |
features.gateway_setup_wizard | boolean | Bietet dir bei der CLI-Anmeldung die Einrichtung eines eigenen Gateways an, wenn du einen Anbieter auswählen kannst. Standard ist false. Siehe Verbindung zu einem Gateway herstellen. |
features.goals | boolean | Aktiviert dauerhaft gespeicherte Ziele und die automatische Fortsetzung (stabil, standardmäßig aktiviert). |
features.hooks | boolean | Aktiviert Lebenszyklus-Hooks aus hooks.json oder aus dem direkt konfigurierten Abschnitt [hooks]. features.codex_hooks ist ein veralteter Alias. |
features.memories | boolean | Aktiviert Erinnerungen. Standardmäßig deaktiviert. |
features.multi_agent | boolean | Aktiviert die Tools für die Zusammenarbeit mehrerer Agenten ( spawn_agent, send_input, resume_agent, wait_agent und close_agent). Die Funktion ist stabil und 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 der Proxy nicht bereits durch aktivierte, administrativ verwaltete Anforderungen in network_proxy startet. Verwende eine Tabelle für Richtlinienoptionen auf Funktionsebene wie domains. Der Proxy filtert weder die Websuche noch Apps, MCP oder andere gehostete Tools. |
features.network_proxy.allow_local_binding | boolean | Erlaubt weitergehenden Zugriff auf lokale oder private Netze. Standard ist false. Freigaberegeln für eine exakt angegebene lokale IP-Adresse oder localhost können dennoch einzelne lokale Ziele erlauben. |
features.network_proxy.allow_upstream_proxy | boolean | Erlaubt die Weiterleitung über einen in der Umgebung festgelegten vorgeschalteten Proxy. Standard ist true. |
features.network_proxy.dangerously_allow_all_unix_sockets | boolean | Erlaubt beliebige Unix-Socket-Ziele über die Liste zulässiger Sockets hinaus. Standard ist false. Verwende diese Einstellung nur in streng kontrollierten Umgebungen. |
features.network_proxy.dangerously_allow_non_loopback_proxy | boolean | Erlaubt Listener-Adressen außerhalb von Loopback. Standard ist false. Bei Aktivierung können Proxy-Listener auch außerhalb von localhost erreichbar sein. |
features.network_proxy.domains | map<string, allow | deny> | Domainrichtlinie für Netzwerkzugriffe aus der Sandbox. Standardmäßig nicht gesetzt. Externe Ziele sind erst zulässig, wenn du allow-Regeln hinzufügst. Unterstützt exakte Hostnamen, *.example.com nur für Subdomains, **.example.com für die Basisdomain und ihre Subdomains sowie globale *-Freigaben. Verwende möglichst eng gefasste Regeln, da * ausgehende Zugriffe auf das öffentliche Netz weitgehend freigibt. Füge deny-Regeln für gesperrte Ziele hinzu. Bei Konflikten hat deny Vorrang. |
features.network_proxy.enable_socks5 | boolean | Stellt SOCKS5 bereit. Standard ist true. |
features.network_proxy.enable_socks5_udp | boolean | Erlaubt UDP über SOCKS5. Standard ist true. |
features.network_proxy.enabled | boolean | Startet den Netzwerkproxy für Sandbox-Befehle, wenn Befehle auf das Netzwerk zugreifen dürfen. Standard ist false. Solange der Proxy deaktiviert ist, werden Domainregeln von Berechtigungsprofilen nicht durchgesetzt. |
features.network_proxy.proxy_url | string | URL des HTTP-Listeners für Netzwerkzugriffe aus der Sandbox. Standard ist "http://127.0.0.1:3128". |
features.network_proxy.socks_url | string | URL des SOCKS5-Listeners. Standard ist "http://127.0.0.1:8081". |
features.network_proxy.unix_sockets | map<string, allow | deny> | Richtlinie für Unix-Sockets bei Netzwerkzugriffen aus der Sandbox. Standardmäßig nicht gesetzt. Füge für erlaubte Sockets allow-Einträge hinzu. |
features.personality | boolean | Entfernter Funktionsschalter. Codex akzeptiert ihn aus Kompatibilitätsgründen und ignoriert seinen Wert. |
features.prefer_mxc | boolean | Bevorzugt MXC für die lokale Ausführung unter Windows, sofern die nativen Funktionen und die Richtlinie dies zulassen. Andernfalls gelten die konfigurierte ältere Sandbox und deren Setup. In der eigenständigen CLI standardmäßig deaktiviert. Die Desktop-App kann die Funktion über die Rollout-Konfiguration aktivieren. Ein fehlgeschlagener Befehl löst keinen Wechsel zur älteren Sandbox aus. |
features.prevent_idle_sleep | boolean | Verhindert, dass das Gerät während eines laufenden Arbeitsschritts in den Ruhezustand wechselt (experimentell, standardmäßig deaktiviert). |
features.remote_plugin | boolean | Aktiviert den Remote-Katalog für Plugins (stabil, standardmäßig aktiviert). |
features.rollout_budget.enabled | boolean | Aktiviert die Erfassung des Token-Budgets pro Rollout. Die Funktion ist in Entwicklung und standardmäßig deaktiviert. Wenn du sie aktivierst, lege sowohl limit_tokens als auch reminder_at_remaining_tokens fest. |
features.rollout_budget.limit_tokens | integer | Positive Token-Obergrenze für das Rollout-Budget. Bei aktiviertem Rollout-Budget erforderlich. |
features.rollout_budget.prefill_token_weight | number | Endlicher, nicht negativer Gewichtungsfaktor für Prefill-Token im Rollout-Budget. Standard ist 1.0. |
features.rollout_budget.reminder_at_remaining_tokens | array<integer> | Codex sendet für jede Schwelle eine Erinnerung, sobald das verbleibende gewichtete Token-Budget die Schwelle unterschreitet. Gib die Liste an, wenn die Budgeterfassung aktiviert ist. Jeder Wert muss positiv und kleiner als limit_tokens sein. |
features.rollout_budget.sampling_token_weight | number | Endlicher, nicht negativer Gewichtungsfaktor für beim Sampling erzeugte Token im Rollout-Budget. Standard ist 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 Tools 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.ultrafast_mode | boolean | Aktiviert die Einstellungen für den ultraschnellen Modus (stabil, standardmäßig aktiviert), unabhängig von features.fast_mode. Die Verfügbarkeit hängt weiterhin vom Modell und vom Konto ab. |
features.unified_exec | boolean | Ermöglicht die Wiederaufnahme der Befehlsausführung (stabil, auf allen Plattformen aktiviert). Eine Deaktivierung in der Benutzerkonfiguration wird ignoriert. Verwaltete Anforderungen können fortsetzbare Prozesse und write_stdin deaktivieren. exec_command bleibt für die einmalige Ausführung verfügbar. |
features.view_image | boolean | Aktiviert das integrierte Tool view_image zum Öffnen lokaler Bilder. Standard ist true. |
features.web_search | boolean | Veralteter Schalter. Verwende bevorzugt die übergeordnete Einstellung web_search. |
features.web_search_cached | boolean | Veralteter Schalter. Wenn web_search nicht gesetzt ist, entspricht true der Einstellung web_search = "cached". |
features.web_search_request | boolean | Veralteter Schalter. Wenn web_search nicht gesetzt ist, entspricht true der Einstellung web_search = "live". |
feedback.enabled | boolean | Erlaubt das Senden von Feedback über /feedback in allen lokalen Clients. Standard ist true. |
file_opener | vscode | vscode-insiders | windsurf | cursor | none | URI-Schema zum Öffnen von Quellenverweisen aus der Codex-Ausgabe. Standard ist vscode. |
forced_chatgpt_workspace_id | string (uuid) | Beschränkt ChatGPT-Anmeldungen auf den Workspace mit der angegebenen Kennung. |
forced_login_method | chatgpt | api | Beschränkt Codex auf eine bestimmte Authentifizierungsmethode. |
goals.max_goal_token_budget | integer (positive) | Legt das Standard-Token-Budget für neue Ziele und zugleich das größte Budget fest, das ein Ziel anfordern kann. Ohne Angabe gilt für Ziele keine konfigurierte Obergrenze. |
hide_agent_reasoning | boolean | Blendet Reasoning-Ereignisse in der TUI und in der Ausgabe von codex exec aus. |
history.max_bytes | number | Begrenzt bei Angabe die Größe der Verlaufsdatei in Bytes. Dazu entfernt Codex die ältesten Einträge. |
history.persistence | save-all | none | Legt fest, ob Codex Sitzungsprotokolle in history.jsonl speichert. |
hooks | table | Direkt in config.toml konfigurierte Lebenszyklus-Hooks. Es gilt dasselbe Ereignisschema wie in hooks.json. Beispiele und unterstützte Ereignisse findest du im Leitfaden zu Hooks. |
hooks.<Event> | array<table> | Gruppen von Abgleichregeln für Hook-Ereignisse wie PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop oder Interrupt. |
hooks.<Event>[].hooks | array<table> | Hook-Handler für eine Gruppe von Abgleichregeln. Befehls-Hooks und MCP-Tool-Hooks werden unterstützt. Prompt- und Agenten-Hook-Handler werden eingelesen, bei der Ausführung aber übersprungen. |
hooks.<Event>[].hooks[].additionalContextLimit | integer | Ungefährer Token-Schwellenwert pro Handler. Ist additionalContext größer, speichert Codex den Inhalt auf dem Datenträger und zeigt dem Modell eine kürzere Vorschau. Standard ist 2500. Bei 0 erhält das Modell direkt den vollständigen Kontext. 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. Standard ist false. SessionEnd läuft immer synchron. Siehe Hooks im Hintergrund ausführen. |
hooks.<Event>[].hooks[].commandWindows | string | Abweichender Befehl für Befehls-Hooks unter Windows. In TOML ist auch der Alias command_windows zulässig. |
instructions | string | Für die künftige Verwendung reserviert. Verwende bevorzugt model_instructions_file oder AGENTS.md. |
log_dir | string (path) | Verzeichnis für die Protokolldateien von Codex. Standard ist $CODEX_HOME/log. Wenn du ein Verzeichnis explizit angibst, aktiviert Codex dort auch das optionale TUI-Klartextprotokoll codex-tui.log. |
marketplaces.<name>.ref | string | Optionaler Git-Branch, Tag oder Commit für den Marketplace. |
marketplaces.<name>.source | string | Adresse des Git-Repositorys oder lokales Stammverzeichnis des Marketplace. Gib für lokale Quellen einen absoluten Pfad an. Das Verzeichnis enthält .agents/plugins/marketplace.json. |
marketplaces.<name>.source_type | git | local | Quelltyp eines konfigurierten Plugin-Marketplace. Marketplaces lassen sich in der config.toml des Systems, der Cloud-Verwaltung, des Benutzerkontos oder eines vertrauenswürdigen Projekts definieren. |
marketplaces.<name>.sparse_paths | array<string> | Optionale Pfade für einen Sparse Checkout eines Git-Marketplace. Nimm den Marketplace-Katalog und alle darin referenzierten lokalen Plugin-Verzeichnisse auf. |
mcp_oauth_callback_port | integer | Optionaler globaler fester Port des lokalen HTTP-Callback-Servers für die MCP-OAuth-Anmeldung. Ein serverspezifischer oauth.callback_port hat Vorrang. Ohne beide Angaben verwendet Codex einen vom Betriebssystem zugewiesenen temporären Port. |
mcp_oauth_callback_url | string | Optionale Basis-URL für den Callback bei der MCP-OAuth-Anmeldung, etwa die Ingress-URL einer Devbox. 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 greifen vorab registrierte MCP-Server auf diese URL mit angehängter ID zurück, wenn die erforderliche ID in ihrem konfigurierten Callback fehlt. Der Port der Callback-URL legt den Listener-Port nicht fest. |
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 Erstellen des ersten Tool-Katalogs. Standard ist 1000. Bei 0 wartet Codex für jeden Server entsprechend dessen startup_timeout_sec. |
mcp_servers.<id>.args | array<string> | Argumente für den Startbefehl des MCP-Servers mit stdio. |
mcp_servers.<id>.auth | oauth | chatgpt | Authentifizierungsverfahren für einen MCP-HTTP-Server, wenn kein konfiguriertes Bearer-Token und kein Authorization-Header greift. oauth (Standard) verwendet gespeicherte MCP-OAuth-Anmeldedaten, sofern vorhanden. chatgpt verwendet für den vertrauenswürdigen Origin von ChatGPT die aktuelle ChatGPT-Sitzung und greift andernfalls auf gespeicherte OAuth-Anmeldedaten zurück. Liefert keine Quelle Anmeldedaten, ist in beiden Modi eine Verbindung ohne Authentifizierung möglich. |
mcp_servers.<id>.bearer_token_env_var | string | Umgebungsvariable, die das Bearer-Token für einen MCP-HTTP-Server liefert. |
mcp_servers.<id>.command | string | Befehl zum Starten eines MCP-Servers mit stdio. |
mcp_servers.<id>.cwd | string | Arbeitsverzeichnis des MCP-Serverprozesses mit stdio. |
mcp_servers.<id>.default_tools_approval_mode | auto | prompt | writes | approve | Standardverhalten bei Genehmigungen für MCP-Tools auf diesem Server. Der Wert lässt sich pro Tool überschreiben. |
mcp_servers.<id>.disabled_tools | array<string> | Liste gesperrter Tools. Sie wird für den MCP-Server nach enabled_tools angewendet. |
mcp_servers.<id>.enabled | boolean | Ermöglicht es, einen MCP-Server zu deaktivieren, ohne seine Konfiguration zu entfernen. |
mcp_servers.<id>.enabled_tools | array<string> | Liste der Namen von Tools, die der MCP-Server bereitstellen darf. |
mcp_servers.<id>.env | map<string,string> | Umgebungsvariablen, die an den MCP-Server mit stdio weitergegeben werden. |
mcp_servers.<id>.env_http_headers | map<string,string> | HTTP-Header für einen MCP-HTTP-Server, deren Werte aus Umgebungsvariablen stammen. |
mcp_servers.<id>.env_vars | array<string | { name = string, source = "local" | "remote" }> | Weitere zulässige Umgebungsvariablen für einen MCP-Server mit stdio. Für Einträge als Zeichenfolge gilt standardmäßig source = "local". Verwende source = "remote" nur, wenn stdio über einen Remote-Executor läuft. |
mcp_servers.<id>.environment_id | string | Ausführungsumgebung für den MCP-Server. Standard ist local. Gib die ID eines konfigurierten Executors an, um dort einen stdio-Server auszuführen oder eine Verbindung zu einem Server mit Streamable HTTP aufzubauen. |
mcp_servers.<id>.http_headers | map<string,string> | Statische HTTP-Header, die mit jeder MCP-HTTP-Anfrage gesendet werden. |
mcp_servers.<id>.http_headers_helper | string (command) | Lokaler Befehl, der die Namen und Werte von HTTP-Headern als JSON-Objekt ausgibt. Nur für lokal verbundene MCP-HTTP-Server unterstützt. Explizite Bearer-Token und OAuth-Anmeldedaten haben Vorrang vor Authorization-Headern aus diesem Befehl. |
mcp_servers.<id>.oauth_resource | string | Optionaler OAuth-Ressourcenparameter nach RFC 8707 für die MCP-Anmeldung. |
mcp_servers.<id>.oauth.callback_port | integer | Fester Listener-Port für den OAuth-Callback dieses MCP-Servers. Überschreibt mcp_oauth_callback_port. Bei einem direkten Loopback-Callback mit explizitem Port in der URL konfigurierst du denselben Port für den Listener. |
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 hängt Codex diese ID an den globalen Callback oder den Standard-Callback an. 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>.oauth.client_secret | string | OAuth-Client-Secret für den Token-Austausch mit einem vorab registrierten Client. Erfordert eine nicht leere oauth.client_id. Auch das Secret darf nicht leer sein. Es wird in der Konfiguration gespeichert. |
mcp_servers.<id>.omit_tools_from | array<string> | Blendet die Tools dieses Servers in ausgewählten Bereichen für das Modell aus. Wähle direct (anfangs verfügbare Tools), deferred (Tool-Suche) oder code_mode (Skripte im Codemodus). Verwende disabled_tools, um ein Tool zu sperren. Eine leere Liste hebt geerbte Ausschlüsse auf. |
mcp_servers.<id>.required | boolean | Schreibt vor, dass dieser aktivierte Server beim Start bereit sein muss. Bei startup_readiness = "catalog" kann ein gültiger zwischengespeicherter Katalog diese Anforderung erfüllen. |
mcp_servers.<id>.scopes | array<string> | OAuth-Berechtigungsbereiche, die Codex bei der Anmeldung anfordert. Ohne Angabe verwendet Codex die Berechtigungsbereiche aus der ersten Authentifizierungsaufforderung und greift ersatzweise auf die Metadaten der geschützten Ressource zurück. |
mcp_servers.<id>.startup_readiness | connection | catalog | Bei connection (Standard) muss beim Start eine Verbindung bestehen. Bei catalog genügt für den Start ein gültiger zwischengespeicherter Tool-Katalog, während die Verbindung aufgebaut wird. Tool-Aufrufe erfordern weiterhin eine aktive Verbindung. |
mcp_servers.<id>.startup_timeout_ms | number | Alias für startup_timeout_sec mit Angabe in Millisekunden. |
mcp_servers.<id>.startup_timeout_sec | number | Überschreibt das standardmäßige Zeitlimit von 10 Sekunden für den Start eines MCP-Servers. |
mcp_servers.<id>.supports_parallel_tool_calls | boolean | Kennzeichnet jedes Tool dieses Servers als sicher für die parallele Ausführung. Aktiviere die Einstellung nur, wenn der Server gleichzeitige Aufrufe aller seiner Tools verarbeiten kann. Standard ist false. |
mcp_servers.<id>.tool_input_schema_max_bytes | integer (positive) | Codex kürzt das Eingabeschema jedes gewöhnlichen MCP-Tools, wenn es diese Anzahl von UTF-8-Bytes überschreitet. Standard sind 5.000 Bytes. Einen explizit angegebenen Wert verwendet der Codemodus auch bei der Darstellung der Tool-Eingabetypen. |
mcp_servers.<id>.tool_timeout_sec | number | Überschreibt das standardmäßige Zeitlimit von 60 Sekunden pro Tool eines MCP-Servers. |
mcp_servers.<id>.tools.<tool>.approval_mode | auto | prompt | writes | approve | Überschreibt das Genehmigungsverhalten 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 üblichen Aufschlag von 20 % für die Serialisierung. Ersetzt für dieses Tool das Standardbudget des Modells für das Kürzen von Ausgaben. |
mcp_servers.<id>.url | string | Endpunkt eines MCP-Servers mit Streamable HTTP. |
memories.consolidation_model | string | Optionales abweichendes Modell für die globale Zusammenführung von Erinnerungen. |
memories.consolidation_service_tier | string | Servicestufe für die globale Zusammenführung von Erinnerungen. Voreingestellt ist default (Standard). |
memories.disable_on_external_context | boolean | Bei true erstellt Codex keine Erinnerungen aus Threads, die externen Kontext wie MCP-Tool-Aufrufe, die Websuche oder die Tool-Suche nutzen. Standard ist false. Älterer Alias: memories.no_memories_if_mcp_or_web_search. |
memories.dual_write | boolean | Wenn v1 ausgewählt ist, schreibt Codex bei true in beide Speicher und liest weiterhin aus v1. Wenn v2 ausgewählt ist, schreibt Codex nur in v2. |
memories.extract_model | string | Optionales abweichendes Modell zum Extrahieren von Erinnerungen aus einzelnen Threads. |
memories.generate_memories | boolean | Bei false speichert Codex neu erstellte Threads nicht als Grundlage für Erinnerungen. Standard ist true. |
memories.max_raw_memories_for_consolidation | number | Höchstzahl der jüngsten unverarbeiteten Erinnerungen, die Codex für die globale Zusammenführung aufbewahrt. Standard ist 256, Obergrenze ist 4096. |
memories.max_rollout_age_days | number | Höchstalter der Threads in Tagen, die für die Erstellung von Erinnerungen infrage kommen. Standard ist 30. Werte werden auf den Bereich von 0 bis 90 begrenzt. |
memories.max_rollouts_per_startup | number | Höchstzahl der Rollout-Kandidaten, die Codex pro Startdurchlauf verarbeitet. Standard ist 16, Obergrenze ist 128. |
memories.max_unused_days | number | Höchstzahl der Tage seit der letzten Nutzung einer Erinnerung, bis sie nicht mehr für die Zusammenführung infrage kommt. Standard ist 30. Werte werden auf den Bereich von 0 bis 365 begrenzt. |
memories.min_rate_limit_remaining_percent | number | Mindestanteil des Ratenlimits in Prozent, der in den Zeitfenstern von Codex noch verfügbar sein muss, bevor Codex Erinnerungen erstellt. Standard ist 25. Werte werden auf den Bereich von 0 bis 100 begrenzt. |
memories.min_rollout_idle_hours | number | Mindestdauer der Inaktivität in Stunden, bevor ein Thread für die Erstellung von Erinnerungen infrage kommt. Standard ist 6. Werte werden auf den Bereich von 1 bis 48 begrenzt. |
memories.use_memories | boolean | Bei false fügt Codex vorhandene Erinnerungen nicht in künftige Sitzungen ein. Standard ist true. |
memories.version | v1 | v2 | Wählt den lokalen Speicher für Erinnerungen. Sind Erinnerungen aktiviert, verwendet Codex bei einem neuen Codex-Stammverzeichnis standardmäßig v2. Existiert $CODEX_HOME/memories/, gilt v1. Mit der expliziten Einstellung dual_write = false bleibt v1 der Standard. |
model | string | Modell, das Codex verwenden soll, zum Beispiel gpt-6.1-sol. |
model_auto_compact_token_limit | number | Token-Schwelle für die automatische Kontextverdichtung des Verlaufs. Ohne Angabe gelten die Standardwerte des Modells. |
model_auto_compact_token_limit_scope | total | body_after_prefix | Legt fest, welche Token für die Schwelle der automatischen Kontextverdichtung zählen: der gesamte aktive Kontext ( total, Standard) oder nur der Zuwachs nach dem übernommenen Präfix des Verdichtungsfensters (body_after_prefix). |
model_catalog_json | string (path) | Optionaler Pfad zu einem JSON-Modellkatalog, den Codex beim Start lädt. In der ausgewählten Profildatei $CODEX_HOME/profile-name.config.toml kannst du den Pfad für das jeweilige Profil überschreiben. |
model_context_window | number | Anzahl der Token, die dem aktiven Modell im Kontextfenster zur Verfügung stehen. |
model_instructions_file | string (path) | Datei, mit der du die integrierten Anweisungen ersetzen kannst, anstatt AGENTS.md zu verwenden. |
model_post_turn_compact_threshold_percent | integer (0–100) | Codex verdichtet den Verlauf nach einer abschließenden Antwort, wenn der aktive Kontext diesen Prozentsatz des nutzbaren Kontextfensters erreicht. Lass die Einstellung weg oder setze sie auf 0, um die Kontextverdichtung am Ende eines Gesprächsschritts zu deaktivieren. Die üblichen Schwellen für die automatische Kontextverdichtung gelten weiterhin. |
model_provider | string | Anbieter-ID aus model_providers. Der Standardwert ist openai. |
model_providers.<id> | table | Definition eines eigenen Anbieters. Die integrierten Anbieter-IDs ( openai, ollama und lmstudio) sind reserviert und lassen sich nicht überschreiben. |
model_providers.<id>.auth | table | Konfiguriert einen Befehl zum Abrufen eines Bearer-Tokens für einen eigenen Anbieter. Nicht mit env_key, experimental_bearer_token oder requires_openai_auth kombinieren. |
model_providers.<id>.auth.args | array<string> | Argumente für den Befehl zum Abrufen des Tokens. |
model_providers.<id>.auth.command | string | Befehl, den Codex ausführt, wenn es ein Bearer-Token benötigt. Der Befehl muss das Token auf stdout ausgeben. |
model_providers.<id>.auth.cwd | string (path) | Arbeitsverzeichnis für den Befehl zum Abrufen des Tokens. |
model_providers.<id>.auth.refresh_interval_ms | number | Intervall in Millisekunden, in dem Codex das Token vorsorglich erneuert. Standard ist 300000. Bei 0 erneuert Codex das Token nur nach einem erneuten Authentifizierungsversuch. |
model_providers.<id>.auth.timeout_ms | number | Maximale Laufzeit des Befehls zum Abrufen des Tokens in Millisekunden. Standard ist 5000. |
model_providers.<id>.base_url | string | Basis-URL der API des Modellanbieters. |
model_providers.<id>.capabilities.external_web_access | boolean | Legt fest, ob die vom Anbieter gehostete Websuche auf das aktuelle Web zugreifen kann. Ohne Angabe gelten die Standardwerte des Anbieters. Einstellungen für das Modell und den aktuellen Gesprächsschritt können den Zugriff weiter einschränken. |
model_providers.<id>.capabilities.remote_compaction | unsupported | v2 | Protokoll des Anbieters für die Kontextverdichtung. Bei unsupported erfolgt sie lokal. Bei v2 werden Anforderungen zur Kontextverdichtung über Responses gesendet. Ohne Angabe gelten die Standardwerte des Anbieters. Einstellungen für das Modell und den aktuellen Gesprächsschritt können die Unterstützung weiter einschränken. |
model_providers.<id>.env_http_headers | map<string,string> | HTTP-Header, deren Werte aus den jeweiligen Umgebungsvariablen stammen, sofern diese vorhanden sind. |
model_providers.<id>.env_key | string | Umgebungsvariable, die den API-Schlüssel des Anbieters liefert. |
model_providers.<id>.env_key_instructions | string | Optionale Hinweise zum Einrichten des API-Schlüssels für den Anbieter. |
model_providers.<id>.experimental_bearer_token | string | Direkt angegebenes Bearer-Token für den Anbieter. Davon wird abgeraten. Verwende env_key. |
model_providers.<id>.gateway_oauth.credential_export | table | Verwendet einen Befehl als Quelle für die Gateway-Anmeldedaten. Gib für command eine ausführbare Datei an, die genau ein Zugriffstoken ausgibt. Die Felder args und timeout_ms (Standardwert 30000) sind optional. Lass die OAuth-Client-ID und die Endpunkteinstellungen weg, wenn du diese Tabelle verwendest. |
model_providers.<id>.gateway_oauth.device_authorization_url | string | Optionaler Endpunkt für die Geräteautorisierung, wenn du dich über SSH oder aus einem Terminal ohne Browser beim Gateway anmeldest. |
model_providers.<id>.http_headers | map<string,string> | Statische HTTP-Header für Anfragen an den Anbieter. |
model_providers.<id>.model_catalog_url | string | Vollständige URL eines Modellkatalogs im nativen Codex-Format. Codex kann den Katalog mit vorhandenen OAuth-Anmeldedaten des Gateways abrufen, wenn Schema, Host und Port der URL mit denen von base_url übereinstimmen. Ohne Angabe verwendet der Anbieter sein Standardverfahren zur Modellerkennung. |
model_providers.<id>.name | string | Anzeigename eines eigenen Modellanbieters. |
model_providers.<id>.query_params | map<string,string> | Zusätzliche Abfrageparameter für Anfragen an den Anbieter. |
model_providers.<id>.request_max_retries | number | Anzahl der Wiederholungsversuche für HTTP-Anfragen an den Anbieter. Standard ist 4. |
model_providers.<id>.requires_openai_auth | boolean | Gibt an, ob der Anbieter die OpenAI-Authentifizierung verwendet. Standard ist false. |
model_providers.<id>.stream_idle_timeout_ms | number | Zeitlimit für inaktive SSE-Streams in Millisekunden. Standard ist 300000. |
model_providers.<id>.stream_max_retries | number | Anzahl der Wiederholungsversuche bei unterbrochenen SSE-Streams. Standard ist 5. |
model_providers.<id>.supports_standalone_web_search | boolean | Meldet Unterstützung für einen kompatiblen eigenständigen Endpunkt für die Websuche. Standard ist false. Die eigenständige Suche ist noch in Entwicklung und standardmäßig deaktiviert. Die Kompatibilität des Anbieters allein aktiviert sie nicht. |
model_providers.<id>.supports_websockets | boolean | Gibt an, ob der Anbieter den WebSocket-Transport der Responses API unterstützt. |
model_providers.<id>.wire_api | responses | Protokoll des Anbieters. responses ist der einzige unterstützte Wert und gilt auch ohne explizite Angabe. |
model_providers.amazon-bedrock.aws.profile | string | Name des AWS-Profils für den integrierten Anbieter amazon-bedrock. |
model_providers.amazon-bedrock.aws.region | string | AWS-Region für den integrierten Anbieter amazon-bedrock. |
model_providers.gcp.base_url | string | Überschreibt den integrierten Endpunkt für Google Cloud Vertex AI. Ohne Angabe setzt Codex ihn aus Projekt-ID und Standort zusammen. |
model_providers.gcp.credential_file | string (absolute path) | Pfad zu einer Datei mit Google Application Default Credentials (ADC). Überschreibt GOOGLE_APPLICATION_CREDENTIALS ausschließlich für den Authentifizierungsbefehl des Anbieters. |
model_providers.gcp.location | string | Google-Cloud-Standort für den Vertex-AI-Endpunkt. Hat Vorrang vor GOOGLE_CLOUD_LOCATION. Standard ist global. |
model_providers.gcp.project_id | string | Google-Cloud-Projekt-ID für den Vertex-AI-Endpunkt. Hat Vorrang vor GOOGLE_CLOUD_PROJECT. |
model_reasoning_effort | string | Vom ausgewählten Modell angebotener Reasoning-Aufwand, zum Beispiel low, medium, high, xhigh, max oder ultra. Welche Stufen verfügbar sind, hängt vom Modell und vom Client ab. |
model_reasoning_summary | auto | concise | detailed | none | Legt fest, wie ausführlich Reasoning-Zusammenfassungen sind, oder deaktiviert sie vollständig. |
model_verbosity | low | medium | high | Optionale Einstellung für die Ausführlichkeit von Antworten der GPT-5 Responses API. Ohne Angabe gilt der Standard des ausgewählten Modells oder der Voreinstellung. |
notice.hide_full_access_warning | boolean | Speichert, ob die Warnung zum Vollzugriff bestätigt wurde. |
notice.hide_gpt-5.1-codex-max_migration_prompt | boolean | Speichert, ob der Hinweis zur Migration auf gpt-5.1-codex-max bestätigt wurde. |
notice.hide_gpt5_1_migration_prompt | boolean | Speichert, ob der Hinweis zur Migration auf GPT-5.1 bestätigt wurde. |
notice.hide_rate_limit_model_nudge | boolean | Speichert, ob die Erinnerung an einen Modellwechsel beim Erreichen des Ratenlimits abgewählt wurde. |
notice.hide_world_writable_warning | boolean | Speichert, ob die Windows-Warnung zu Verzeichnissen mit Schreibzugriff für alle bestätigt wurde. |
notice.model_migrations | map<string,string> | Speichert bestätigte Modellmigrationen als Zuordnungen vom alten zum neuen Modell. |
notify | array<string> | Befehl, den Codex für Benachrichtigungen aufruft und dem es die Daten im JSON-Format übergibt. |
openai_base_url | string | Abweichende Basis-URL für den integrierten Modellanbieter openai. |
oss_provider | lmstudio | ollama | Lokaler Standardanbieter für die Ausführung mit --oss. Ohne Angabe fragt Codex nach dem Anbieter. |
otel.environment | string | Umgebungskennzeichnung für ausgegebene OpenTelemetry-Ereignisse. Standard ist dev. |
otel.exporter | none | otlp-http | otlp-grpc | Wählt den OpenTelemetry-Exporter und ermöglicht die Angabe von Metadaten zum Endpunkt. |
otel.exporter.<id>.endpoint | string | Endpunkt des Exporters für OTEL-Protokolle. |
otel.exporter.<id>.headers | map<string,string> | Statische Header für Anfragen des OTEL-Exporters. |
otel.exporter.<id>.protocol | binary | json | Protokoll des OTLP/HTTP-Exporters. |
otel.exporter.<id>.tls.ca-certificate | string | Pfad zum CA-Zertifikat für TLS beim OTEL-Exporter. |
otel.exporter.<id>.tls.client-certificate | string | Pfad zum Clientzertifikat für TLS beim OTEL-Exporter. |
otel.exporter.<id>.tls.client-private-key | string | Pfad zum privaten Clientschlüssel für TLS beim OTEL-Exporter. |
otel.log_agent_responses | boolean | Sendet den Text der abschließenden Antworten des Hauptagenten und der gestarteten Subagenten an den konfigurierten OTLP-Protokollexporter. Standard ist false. Der Text kann sensible Daten enthalten. Pro Antwort werden höchstens 64 KiB exportiert. |
otel.log_guardian_assessments | boolean | Sendet abgeschlossene automatische Prüfungen von Genehmigungsanfragen an den konfigurierten OTLP-Protokollexporter. Standard ist false. Die Prüfbegründungen können sensible Daten enthalten und sind auf jeweils 64 KiB begrenzt. |
otel.log_user_prompt | boolean | Erlaubt ausdrücklich den Export unverarbeiteter Benutzerprompts mit OpenTelemetry-Protokollen. |
otel.metrics_exporter | none | statsig | otlp-http | otlp-grpc | Wählt den OpenTelemetry-Metrikexporter. Der Standardexporter statsig richtet sich nach analytics.enabled. Explizit konfigurierte OTLP-Exporter arbeiten unabhängig davon. Mit none deaktivierst du den Metrikexport. |
otel.span_attributes | map<string,string> | Fügt jedem exportierten Trace-Span Zeichenfolgenattribute hinzu. |
otel.tool_result.max_bytes | integer (nonnegative) | Höchstzahl der UTF-8-Bytes, die Codex pro Tool-Ergebnis vor dem Kürzungshinweis ins Protokoll schreibt. Standard ist 2048. Die Einstellung betrifft nur die protokollierte Ausgabe. |
otel.trace_exporter | none | otlp-http | otlp-grpc | Wählt den OpenTelemetry-Trace-Exporter und ermöglicht die Angabe von Metadaten zum Endpunkt. |
otel.trace_exporter.<id>.endpoint | string | Endpunkt des Trace-Exporters für OTEL-Protokolle. |
otel.trace_exporter.<id>.headers | map<string,string> | Statische Header für Anfragen des OTEL-Trace-Exporters. |
otel.trace_exporter.<id>.protocol | binary | json | Protokoll des OTLP/HTTP-Trace-Exporters. |
otel.trace_exporter.<id>.tls.ca-certificate | string | Pfad zum CA-Zertifikat für TLS beim OTEL-Trace-Exporter. |
otel.trace_exporter.<id>.tls.client-certificate | string | Pfad zum Clientzertifikat für TLS beim OTEL-Trace-Exporter. |
otel.trace_exporter.<id>.tls.client-private-key | string | Pfad zum privaten Clientschlüssel für TLS beim OTEL-Trace-Exporter. |
otel.tracestate | map<string,map<string,string>> | Setzt bei der Weitergabe des Trace-Kontexts Felder in W3C-tracestate-Einträgen. Jeder Eintrag ordnet Feldnamen Zeichenfolgenwerte zu. |
permissions.<name>.description | string | Lesbare Beschreibung des benannten Profils. Über extends erbt ein Profil die Beschreibung seines übergeordneten Profils nicht. |
permissions.<name>.extends | string | Optionales übergeordnetes Profil, das vor diesem benannten Profil angewendet wird. Gib ein anderes benanntes Profil, :read-only oder :workspace an. Codex lehnt :danger-full-access, nicht definierte übergeordnete Profile und zyklische Verweise ab. |
permissions.<name>.filesystem | table | Benanntes Berechtigungsprofil für das Dateisystem. 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" | Dateisystemzugriff relativ zu jedem wirksamen Workspace-Stammverzeichnis. Verwende "." für das Stammverzeichnis selbst. Für Unterpfade mit Glob-Mustern wie "**/*.env" kannst du mit "deny" das Lesen untersagen. |
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. Alternativ kannst du unter diesem Stammverzeichnis verschachtelte Einträge definieren. Mit "deny" untersagst du das Lesen passender Pfade. |
permissions.<name>.filesystem.glob_scan_max_depth | number | Maximale Suchtiefe beim Auflösen von Glob-Mustern für Leseverbote auf Plattformen, die Treffer vor dem Start der Sandbox erfassen. Falls gesetzt, muss der Wert mindestens 1 sein. |
permissions.<name>.network.allow_local_binding | boolean | Erlaubt aus der Sandbox weitergehenden Zugriff auf lokale oder private Netze. Freigaberegeln für eine exakt angegebene lokale IP-Adresse oder localhost können einzelne lokale Ziele auch dann erlauben, wenn der Wert false bleibt. |
permissions.<name>.network.allow_upstream_proxy | boolean | Erlaubt die Weiterleitung von Netzwerkzugriffen aus der Sandbox über einen weiteren vorgeschalteten Proxy. |
permissions.<name>.network.dangerously_allow_all_unix_sockets | boolean | Erlaubt beliebige Unix-Socket-Ziele über die standardmäßig eingeschränkte Auswahl hinaus. Verwende diese Einstellung nur in streng kontrollierten Umgebungen. |
permissions.<name>.network.dangerously_allow_non_loopback_proxy | boolean | Erlaubt Netzwerk-Listenern der Sandbox, sich an Adressen außerhalb von Loopback zu binden. Bei Aktivierung können Listener auch außerhalb von localhost erreichbar sein. |
permissions.<name>.network.domains | table | Domainregeln für Sandbox-Befehle. Sie werden nur durchgesetzt, wenn features.network_proxy oder aktivierte administrativ verwaltete Netzwerkanforderungen den Proxy einschalten. Unterstützt exakte Hostnamen, *.example.com, **.example.com und globale *-Freigaben. deny hat Vorrang. Die Regeln beschränken weder die Websuche noch Apps oder MCP-Server. |
permissions.<name>.network.domains.<pattern> | allow | deny | Erlaubt oder sperrt einen exakten Hostnamen oder ein begrenztes Platzhaltermuster wie *.example.com oder **.example.com. |
permissions.<name>.network.enable_socks5 | boolean | Stellt SOCKS5 bereit, wenn dieses Berechtigungsprofil Netzwerkzugriffe aus 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 startet der Netzwerkproxy nicht. Ohne features.network_proxy oder aktivierte administrativ verwaltete Netzwerkanforderungen greifen Befehle direkt auf das Netzwerk zu. Die Domainregeln des Profils werden dann nicht durchgesetzt. |
permissions.<name>.network.mode | limited | full | Modus des Netzwerkproxys für den Datenverkehr von Unterprozessen. |
permissions.<name>.network.proxy_url | string | URL des HTTP-Listeners, wenn dieses Berechtigungsprofil Netzwerkzugriffe aus der Sandbox aktiviert. |
permissions.<name>.network.socks_url | string | SOCKS5-Proxy-Endpunkt für dieses Berechtigungsprofil. |
permissions.<name>.network.unix_sockets | table | Abweichende Einträge für die Liste zulässiger Unix-Sockets bei Netzwerkzugriffen aus der Sandbox. Verwende Socket-Pfade als Schlüssel. allow fügt einen Pfad hinzu, deny weist ihn zurück. |
permissions.<name>.network.unix_sockets.<path> | allow | deny | Nimmt mit allow einen absoluten Unix-Socket-Pfad in die wirksame Liste zulässiger Sockets auf oder weist ihn mit deny zurück. Zurückgewiesene Einträge fehlen in der wirksamen Liste. |
permissions.<name>.workspace_roots | table | Im Profil definierte Workspace-Stammverzeichnisse. Für sie gelten ebenso wie für die zur Laufzeit bestimmten Stammverzeichnisse der Sitzung die Dateisystemregeln von :workspace_roots. |
permissions.<name>.workspace_roots.<path> | boolean | Bei true wird der Pfad als Workspace-Stammverzeichnis in das Profil aufgenommen. Deaktivierte Einträge bleiben inaktiv. |
personality | none | friendly | pragmatic | Veraltete Kompatibilitätseinstellung. Mit friendly und pragmatic lässt sich kein Stil mehr auswählen. Bei none entfällt der integrierte Abschnitt zur Persönlichkeit in den Modellanweisungen. Explizit überschriebene Anweisungen bleiben unverändert. |
plan_mode_reasoning_effort | string | Abweichender Reasoning-Aufwand für den Planungs-Modus. Wähle eine vom ausgewählten Modell unterstützte Stufe. Ohne Angabe verwendet der Planungs-Modus seine integrierte Voreinstellung. |
plugins._default.enabled | boolean | Legt fest, ob installierte Plugins standardmäßig aktiviert sind. Für Plugins, die ihre Quelle aktiviert, überschreibt ein expliziter Wert für plugins.<plugin>.enabled diesen Standard. Lass die Tabelle weg, um die Aktivierungseinstellungen der Quelle oder des Kontos zu übernehmen. |
plugins.<plugin>.enabled | boolean | Aktiviert oder deaktiviert ein Plugin aus einem lokalen Marketplace über den Schlüssel plugin-name@marketplace-name. Maßgeblich ist die zusammengeführte Konfiguration. Einstellungen vertrauenswürdiger Projekte können Standardwerte aus Benutzer-, Cloud- und Systemkonfigurationen überschreiben. Beim Aktualisieren des Marketplace können konfigurierte Plugins auch dann installiert oder aktualisiert werden, wenn sie deaktiviert sind. Im Workspace verwaltete Aktivierungseinstellungen haben weiterhin Bestand. |
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode | auto | prompt | writes | approve | Standardverhalten bei Genehmigungen für Tools auf einem von einem Plugin bereitgestellten MCP-Server. |
plugins.<plugin>.mcp_servers.<server>.disabled_tools | array<string> | Liste gesperrter Tools für einen von einem Plugin bereitgestellten MCP-Server. Sie wird nach enabled_tools angewendet. |
plugins.<plugin>.mcp_servers.<server>.enabled | boolean | Aktiviert oder deaktiviert einen MCP-Server, den ein installiertes Plugin mitliefert, ohne das Plugin-Manifest zu ändern. |
plugins.<plugin>.mcp_servers.<server>.enabled_tools | array<string> | Liste der Tools, die ein von einem Plugin bereitgestellter MCP-Server anbieten darf. |
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode | auto | prompt | writes | approve | Überschreibt das Genehmigungsverhalten für ein einzelnes MCP-Tool eines Plugins. |
project_doc_fallback_filenames | array<string> | Weitere Dateinamen, nach denen Codex sucht, wenn AGENTS.md fehlt. |
project_doc_max_bytes | number | Maximale Anzahl von Bytes, die Codex beim Zusammenstellen der Projektanweisungen aus AGENTS.md liest. |
project_root_markers | array<string> | Dateinamen, die das Projektstammverzeichnis kennzeichnen. Codex sucht danach in übergeordneten Verzeichnissen, um das Projektstammverzeichnis zu ermitteln. |
projects.<path>.trust_level | string | Kennzeichnet ein Projekt oder einen Worktree als vertrauenswürdig oder nicht vertrauenswürdig ( "trusted" | "untrusted"). Bei nicht vertrauenswürdigen Projekten überspringt Codex die projektspezifischen .codex/-Ebenen einschließlich lokaler Konfiguration, Hooks und Regeln. |
review_model | string | Optionales Modell für /review. Standardmäßig wird das Modell der aktuellen Sitzung verwendet. |
sandbox_mode | read-only | workspace-write | danger-full-access | Sandbox-Richtlinie für den Zugriff auf Dateisystem und Netzwerk bei der Ausführung von Befehlen. |
sandbox_workspace_write.exclude_slash_tmp | boolean | Schließt /tmp im Modus workspace-write von den beschreibbaren Stammverzeichnissen aus. |
sandbox_workspace_write.exclude_tmpdir_env_var | boolean | Schließt $TMPDIR im Modus workspace-write von den beschreibbaren Stammverzeichnissen aus. |
sandbox_workspace_write.network_access | boolean | Erlaubt ausgehenden Netzwerkzugriff aus 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 Gesprächsschritte. Verwende fast oder eine andere vom aktiven Modell angebotene Stufe. fast entspricht dem Wert priority in der Anfrage. |
shell_environment_policy.exclude | array<string> | Ältere Ausschlussmuster für Umgebungsvariablen. Verwende für neue Konfigurationen shell_environment_policy.filters. Kombiniere beide Formen nicht auf derselben Ebene. |
shell_environment_policy.experimental_use_profile | boolean | Verwendet beim Starten von Unterprozessen das Shell-Profil des Benutzerkontos. |
shell_environment_policy.filters | map<string, include | exclude> | Kanonische Muster zum Filtern von Umgebungsvariablen ohne Unterscheidung zwischen Groß- und Kleinschreibung. Einschlussregeln bilden eine Liste zulässiger Variablen und können ausgeschlossene Werte nicht wiederherstellen. Explizite set-Werte gelten nach den Ausschlüssen. Kombiniere die Filter nicht auf derselben Ebene mit den älteren Arrays exclude oder include_only. |
shell_environment_policy.ignore_default_excludes | boolean | Behält Variablen, deren Name KEY, SECRET oder TOKEN enthält, bevor andere Filter greifen. Standard ist true. Mit false schließt Codex Variablen mit solchen Namen automatisch aus. |
shell_environment_policy.include_only | array<string> | Ältere Liste zulässiger Muster für Umgebungsvariablen. Verwende für neue Konfigurationen shell_environment_policy.filters. Kombiniere beide Formen nicht auf derselben Ebene. |
shell_environment_policy.inherit | all | core | none | Legt fest, welche Umgebung neu gestartete Unterprozesse grundsätzlich erben. |
shell_environment_policy.set | map<string,string> | Explizite Umgebungswerte, die nach Anwendung der Ausschlussregeln gesetzt werden. Einschlussfilter können sie weiterhin entfernen. |
show_raw_agent_reasoning | boolean | Zeigt unverarbeitete Reasoning-Inhalte an, wenn das aktive Modell sie ausgibt. |
skills.bundled.enabled | boolean | Lädt die mit Codex gelieferten System-Skills. Standard ist true. Setze den Wert in der Konfiguration eines vertrauenswürdigen Projekts auf false, um die mitgelieferten Skills für dieses Projekt zu deaktivieren. |
skills.config | array<object> | Aktiviert oder deaktiviert Skills anhand ihres Namens oder Pfads. Treffen mehrere Regeln auf einen Skill zu, gilt die letzte passende Regel. |
skills.config.<index>.enabled | boolean | Aktiviert oder deaktiviert den angegebenen Skill. |
skills.config.<index>.name | string | Erfasst alle Skills mit genau diesem Namen. Gib für jeden Eintrag entweder name oder path an. |
skills.config.<index>.path | string (path) | Absoluter Pfad zu einer einzelnen SKILL.md-Datei. |
skills.include_instructions | boolean | Nimmt die automatischen Skill-Anweisungen in den Modellkontext auf. Standard ist true. |
skills.max_context_tokens | integer (positive) | Token-Budget für den Katalog der verfügbaren Skills. Standard sind 2 % des Kontextfensters des Modells. Explizite Werte sind auf 10000 Token begrenzt. |
sqlite_home | string (path) | Verzeichnis für die SQLite-Datenbank, in der Codex den Zustand von Agentenaufgaben und anderen fortsetzbaren Laufzeitvorgängen speichert. |
suppress_unstable_features_warning | boolean | Blendet die Warnung aus, die bei aktivierten Funktionsschaltern für Funktionen in Entwicklung erscheint. |
thread_unload_delay_secs | integer (nonnegative) | Wartezeit in Sekunden, bevor der App Server einen inaktiven Thread ohne Abonnements aus dem Speicher entfernt. Bei 0 entfernt er ihn, sobald beide Bedingungen erfüllt sind. Standard sind 60 Sekunden. |
tool_output_token_limit | number | Token-Budget für das Speichern einzelner Tool- oder Funktionsausgaben im Verlauf. |
tool_suggest.disabled_tools | array<table> | Deaktiviert Vorschläge für bestimmte auffindbare Konnektoren oder Plugins. Jeder Eintrag enthält type = "connector" oder "plugin" sowie eine id. |
tool_suggest.discoverables | array<table> | Erlaubt Tool-Vorschläge für weitere auffindbare Konnektoren oder Plugins. Jeder Eintrag enthält type = "connector" oder "plugin" sowie eine id. |
tools.web_search | boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } } | Optionale Konfiguration für das Tool zur Websuche. In der Objektform kannst du die Größe des Suchkontexts, zulässige Suchdomains und den ungefähren Standort der suchenden Person festlegen. Diese Domainfilter sind unabhängig von den Netzwerkregeln für Sandbox-Befehle und beschränken weder Konnektoren noch MCP-Server. |
tui | table | Optionen für die Terminaloberfläche (TUI), etwa zum Aktivieren integrierter Desktop-Benachrichtigungen. |
tui.alternate_screen | auto | always | never | Steuert die Verwendung des alternativen Bildschirmpuffers in der TUI. Standard ist auto. In Zellij verzichtet auto auf den alternativen Puffer, damit der Terminalverlauf erhalten bleibt. |
tui.animations | boolean | Aktiviert Terminalanimationen wie Startbildschirm, Schimmereffekt und Ladeanzeige. Standard ist true. |
tui.auto_recap | boolean | Erstellt automatisch Gesprächszusammenfassungen, wenn das Terminal nicht im Fokus ist. Standard ist true. Mit false deaktivierst du automatische Zusammenfassungen. /recap bleibt verfügbar. |
tui.collapse_turn_details | boolean | Fasst Tool-Aufrufe zusammen und klappt abgeschlossene Aktivitäten in der Vollbildansicht des Gesprächsverlaufs unter dem jeweiligen Prompt ein. Die Antworten bleiben sichtbar. Standard ist false. |
tui.disable_paste_burst | boolean | Deaktiviert in der TUI die Erkennung schnell hintereinander eingefügter Zeichen. Standard ist false. Hat Vorrang vor der älteren übergeordneten Einstellung disable_paste_burst. |
tui.keymap.<context>.<action> | string | array<string> | Tastenkürzel für eine TUI-Aktion. Unterstützte Kontexte sind unter anderem global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list und approval. Bestimmte Editoraktionen greifen auf passende Belegungen aus tui.keymap.global zurück. Unterstützte kontextspezifische Belegungen haben Vorrang. |
tui.keymap.<context>.<action> = [] | empty array | Hebt die Tastenbelegung für diese Aktion im jeweiligen Kontext auf. Verwende normalisierte Tastennamen wie ctrl-a, shift-enter, page-down oder minus. |
tui.model_availability_nux.<model> | integer | Interner Status des beim Start angezeigten Tooltips, zugeordnet über den Modell-Slug. |
tui.notification_condition | unfocused | always | Legt fest, ob die TUI nur dann benachrichtigt, wenn das Terminal nicht im Fokus ist, oder unabhängig vom Fokus. Standard ist unfocused. |
tui.notification_method | auto | osc9 | bel | Verfahren für Terminalbenachrichtigungen. Standard ist auto. |
tui.notifications | boolean | array<string> | Aktiviert TUI-Benachrichtigungen, optional nur für bestimmte Ereignistypen. |
tui.presets.<digit>.input | string | Speichert einen Prompt oder Slash-Befehl auf einem der zehn Plätze ( 0–9), die /presets anzeigt. Gib nicht leeren Text mit höchstens 8.000 UTF-8-Bytes an. Shell-Befehle, die mit ! beginnen, werden nicht unterstützt. |
tui.presets.<digit>.label | string | Optionaler Name für die Voreinstellung im Auswahlmenü und in den Hinweisen zu Tastenkürzeln. |
tui.raw_output_mode | boolean | Startet die TUI mit unverarbeitetem Terminalverlauf, sodass sich Text im Terminal leichter auswählen und kopieren lässt. Standard ist false. Mit /raw oder dem standardmäßigen Tastenkürzel alt-r kannst du umschalten. |
tui.resume_cwd | current | session | Arbeitsverzeichnis beim Fortsetzen oder Forken einer Sitzung. Ohne Angabe fragt Codex nach deiner Auswahl, wenn dein aktuelles Verzeichnis vom gespeicherten Sitzungsverzeichnis abweicht. |
tui.show_server_version_notice | boolean | Zeigt Hinweise auf Versionsunterschiede beim verbundenen App Server. Standard ist true. Kompatibilitätsfehler und Versionsstatus bleiben unabhängig davon sichtbar. |
tui.show_tooltips | boolean | Zeigt auf dem TUI-Startbildschirm Tipps für den Einstieg an. Standard ist true. |
tui.status_line | array<string> | null | Geordnete Liste der Elementkennungen für die Statuszeile am unteren Rand der TUI. null deaktiviert die Statuszeile. |
tui.terminal_title | array<string> | null | Geordnete Liste der Elementkennungen für den Titel des Terminalfensters oder Tabs. Standard ist ["spinner", "project"]. null deaktiviert Titelaktualisierungen. |
tui.theme | string | Abweichendes Farbschema für die Syntaxhervorhebung. Gib den Namen in kebab-case an. |
tui.vim_mode_default | boolean | Startet den Editor im Vim-Normalmodus statt im Einfügemodus. Standard ist false. Mit /vim kannst du die Einstellung weiterhin pro Sitzung umschalten. |
web_search | disabled | cached | indexed | live | Modus für die Websuche. Standard ist "cached". Im Modus cached nutzt Codex einen von OpenAI gepflegten Index ohne externen Webzugriff. Im Modus indexed ist externer Zugriff nur über die Zugriffskontrolle des Suchindex möglich. Bei --yolo oder einer anderen Sandbox-Einstellung mit Vollzugriff ist "live" der Standard. Verwende "live" für den uneingeschränkten Live-Abruf oder "disabled", um das Tool zu entfernen. |
windows.sandbox | mxc | elevated | unelevated | Native Sandbox-Implementierung für Windows. Die explizite Auswahl von mxc schlägt fehl, wenn MXC nicht verfügbar oder durch verwaltete Anforderungen untersagt ist. Verwende features.prefer_mxc zusammen mit einer älteren Implementierung, damit Codex automatisch MXC auswählt und bei Bedarf auf die ältere Implementierung zurückgreift. |
agentstableagents.<name>.config_filestring (path)agents.<name>.descriptionstringagents.default_subagent_modelstringagents.default_subagent_reasoning_effortstringagents.enabledbooleanagents.interrupt_messagebooleanagents.max_concurrent_threads_per_sessionnumberagents.max_threadsnumberagents.max_concurrent_threads_per_session.allow_login_shellbooleantrue. Bei false werden Anfragen mit login = true abgelehnt. Ohne Angabe von login wird dann eine Shell ohne Login verwendet.allow_symlinked_codex_homeboolean$CODEX_HOME ist oder darunter liegt. Codex liest diese Einstellung nur beim Start aus $CODEX_HOME/config.toml auf dem ausführenden Host. Wenn du sie aktivierst, vertraust du auch Linkzielen außerhalb dieses Verzeichnisses und Zielen, die sich zwischen Befehlen ändern. Dadurch kommen keine weiteren beschreibbaren Stammverzeichnisse hinzu. Standard ist false.analytics.enabledbooleanfalse deaktivierst du den integrierten Statsig-Metrikexporter. Explizit konfigurierte OTLP-Metrikexporter bleiben aktiv. Ohne Angabe gilt der Standardwert des Clients.approval_policyon-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }approval_policy = { granular = { ... } } kannst du bestimmte Kategorien von Rückfragen zulassen oder automatisch ablehnen. Andere Rückfragen bleiben interaktiv. untrusted wird nicht unterstützt, on-failure ist veraltet. Verwende on-request für interaktive und never für nicht interaktive Ausführungen.approval_policy.granular.mcp_elicitationsbooleantrue kann Codex Anfragen zur MCP-Elizitation anzeigen, anstatt sie automatisch abzulehnen.approval_policy.granular.request_permissionsbooleantrue kann Codex Anfragen des Tools request_permissions anzeigen.approval_policy.granular.rulesbooleantrue kann Codex Genehmigungsanfragen anzeigen, die durch prompt-Regeln der Befehlsrichtlinie execpolicy ausgelöst werden.approval_policy.granular.sandbox_approvalbooleantrue kann Codex für die Ausführung außerhalb der Sandbox eine Genehmigung anfordern.approval_policy.granular.skill_approvalbooleantrue kann Codex Genehmigungsanfragen für Skill-Skripte anzeigen.approvals_revieweruser | auto_reviewon-request oder granularen Genehmigungsrichtlinien die dafür vorgesehenen Anfragen prüft. Standard ist user. Bei auto_review übernimmt ein Subagent die Prüfung. Die Einstellung ändert das Sandboxing nicht und löst keine Prüfung von Aktionen aus, die innerhalb der Sandbox bereits erlaubt sind.apps._default.approvals_revieweruser | auto_reviewapprovals_reviewer.apps._default.default_tools_approval_modeauto | prompt | writes | approveapps._default.destructive_enabledbooleandestructive_hint = true standardmäßig erlaubt sind.apps._default.enabledbooleanapps._default.open_world_enabledbooleanopen_world_hint = true standardmäßig erlaubt sind.apps.<id>.approvals_revieweruser | auto_reviewapps._default.approvals_reviewer.apps.<id>.default_tools_approval_modeauto | prompt | writes | approveapps.<id>.default_tools_enabledbooleanapps.<id>.destructive_enabledbooleandestructive_hint = true angeben.apps.<id>.enabledbooleanapps.<id>.omit_tools_fromarray<string>direct, deferred oder code_mode aus. Ausschlüsse für die App und den MCP-Server gelten gemeinsam.apps.<id>.open_world_enabledbooleanopen_world_hint = true angeben.apps.<id>.tools.<tool>.approval_modeauto | prompt | writes | approveapps.<id>.tools.<tool>.enabledbooleanrepos/list, unabhängig vom Standardwert.auto_review.policystringguardian_policy_config hat Vorrang. Leere Werte werden ignoriert.background_terminal_max_timeoutnumberwrite_stdin-Abfragen beim Abfragen des Hintergrundterminals. Standard ist 300000 (5 Minuten). Ersetzt den älteren Schlüssel background_terminal_timeout.browser_use.allow_history_accessbooleanfalse, um den Zugriff auf den Browserverlauf einzuschränken. Verwaltete Anforderungen können diese Beschränkung erzwingen.browser_use.default_origin_policytableaccess, uploads, downloads und full_cdp_access, jeweils mit dem Wert allow oder deny.browser_use.origins.<origin>tablebrowser_use.default_origin_policy. Gib das Schema HTTP oder HTTPS und optional einen Port an. Lass Pfade, Abfragen und Fragmente weg. Lokale Werte können verwaltete Verbote nicht lockern.chatgpt_base_urlstringcheck_for_update_on_startupbooleancli_auth_credentials_storefile | keyring | auto | ephemeralcompact_promptstringcomputer_use.default_app_accessallow | denycomputer_use.macos.bundle_idsmap<string, allow | deny>computer_use.windows.always_allowed_app_idsarray<string>computer_use.windows.aumidsmap<string, allow | deny>computer_use.windows.exesarray<table>publisher_name, product_name und access (allow oder deny). binary_name ist optional.default_permissionsstring:read-only, :workspace und :danger-full-access. Eigene Profilnamen benötigen passende Tabellen [permissions.<name>]. Nicht mit sandbox_mode oder [sandbox_workspace_write] kombinieren.desktop.custom_file_handlers.<id>tabledesktop.custom_file_handlers.<id>.argsarray<string>[].desktop.custom_file_handlers.<id>.commandstringdesktop.custom_file_handlers.<id>.iconstringdata:image/...-URL, Datei-URI oder absoluter lokaler Pfad zum Handler-Symbol. Erforderlich. Bei nicht unterstützten Quellen erscheint das Standardsymbol von VS Code.desktop.custom_file_handlers.<id>.inputpath | json_argument | json_stdinpath.desktop.custom_file_handlers.<id>.labelstringdesktop.custom_file_handlers.<id>.supports_sshbooleanfalse.developer_instructionsstringdisable_paste_burstbooleantui.disable_paste_burst. Verwende bevorzugt die Einstellung unter [tui].experimental_compact_prompt_filestring (path)experimental_use_unified_exec_toolboolean[features].unified_exec oder codex --enable unified_exec.features.appsbooleanfeatures.code_mode.direct_only_tool_namespacesarray<string>features.code_mode.enabledbooleanfeatures.code_mode.excluded_tool_namespacesarray<string>features.context_management.experimental_modebooleanfeatures.enable_request_compressionbooleanfeatures.fast_modebooleanfeatures.ultrafast_mode. Die Verfügbarkeit hängt weiterhin vom Modell und vom Konto ab.features.gateway_setup_wizardbooleanfalse. Siehe Verbindung zu einem Gateway herstellen.features.goalsbooleanfeatures.hooksbooleanhooks.json oder aus dem direkt konfigurierten Abschnitt [hooks]. features.codex_hooks ist ein veralteter Alias.features.multi_agentbooleanspawn_agent, send_input, resume_agent, wait_agent und close_agent). Die Funktion ist stabil und standardmäßig aktiviert.features.network_proxyboolean | tablenetwork_proxy startet. Verwende eine Tabelle für Richtlinienoptionen auf Funktionsebene wie domains. Der Proxy filtert weder die Websuche noch Apps, MCP oder andere gehostete Tools.features.network_proxy.allow_local_bindingbooleanfalse. Freigaberegeln für eine exakt angegebene lokale IP-Adresse oder localhost können dennoch einzelne lokale Ziele erlauben.features.network_proxy.allow_upstream_proxybooleantrue.features.network_proxy.dangerously_allow_all_unix_socketsbooleanfalse. Verwende diese Einstellung nur in streng kontrollierten Umgebungen.features.network_proxy.dangerously_allow_non_loopback_proxybooleanfalse. Bei Aktivierung können Proxy-Listener auch außerhalb von localhost erreichbar sein.features.network_proxy.domainsmap<string, allow | deny>allow-Regeln hinzufügst. Unterstützt exakte Hostnamen, *.example.com nur für Subdomains, **.example.com für die Basisdomain und ihre Subdomains sowie globale *-Freigaben. Verwende möglichst eng gefasste Regeln, da * ausgehende Zugriffe auf das öffentliche Netz weitgehend freigibt. Füge deny-Regeln für gesperrte Ziele hinzu. Bei Konflikten hat deny Vorrang.features.network_proxy.enable_socks5booleantrue.features.network_proxy.enable_socks5_udpbooleantrue.features.network_proxy.enabledbooleanfalse. Solange der Proxy deaktiviert ist, werden Domainregeln von Berechtigungsprofilen nicht durchgesetzt.features.network_proxy.proxy_urlstring"http://127.0.0.1:3128".features.network_proxy.socks_urlstring"http://127.0.0.1:8081".features.network_proxy.unix_socketsmap<string, allow | deny>allow-Einträge hinzu.features.personalitybooleanfeatures.prefer_mxcbooleanfeatures.prevent_idle_sleepbooleanfeatures.remote_pluginbooleanfeatures.rollout_budget.enabledbooleanlimit_tokens als auch reminder_at_remaining_tokens fest.features.rollout_budget.limit_tokensintegerfeatures.rollout_budget.prefill_token_weightnumber1.0.features.rollout_budget.reminder_at_remaining_tokensarray<integer>limit_tokens sein.features.rollout_budget.sampling_token_weightnumber1.0.features.shell_snapshotbooleanfeatures.shell_toolbooleanfeatures.skill_mcp_dependency_installbooleanfeatures.ultrafast_modebooleanfeatures.fast_mode. Die Verfügbarkeit hängt weiterhin vom Modell und vom Konto ab.features.unified_execbooleanwrite_stdin deaktivieren. exec_command bleibt für die einmalige Ausführung verfügbar.features.view_imagebooleanview_image zum Öffnen lokaler Bilder. Standard ist true.features.web_searchbooleanweb_search.features.web_search_cachedbooleanweb_search nicht gesetzt ist, entspricht true der Einstellung web_search = "cached".features.web_search_requestbooleanweb_search nicht gesetzt ist, entspricht true der Einstellung web_search = "live".feedback.enabledboolean/feedback in allen lokalen Clients. Standard ist true.file_openervscode | vscode-insiders | windsurf | cursor | nonevscode.forced_chatgpt_workspace_idstring (uuid)forced_login_methodchatgpt | apigoals.max_goal_token_budgetinteger (positive)hide_agent_reasoningbooleancodex exec aus.history.max_bytesnumberhistory.persistencesave-all | nonehookstableconfig.toml konfigurierte Lebenszyklus-Hooks. Es gilt dasselbe Ereignisschema wie in hooks.json. Beispiele und unterstützte Ereignisse findest du im Leitfaden zu Hooks.hooks.<Event>array<table>PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop oder Interrupt.hooks.<Event>[].hooksarray<table>hooks.<Event>[].hooks[].additionalContextLimitintegeradditionalContext größer, speichert Codex den Inhalt auf dem Datenträger und zeigt dem Modell eine kürzere Vorschau. Standard ist 2500. Bei 0 erhält das Modell direkt den vollständigen Kontext. Siehe Große Hook-Ausgaben.hooks.<Event>[].hooks[].asyncbooleanfalse. SessionEnd läuft immer synchron. Siehe Hooks im Hintergrund ausführen.hooks.<Event>[].hooks[].commandWindowsstringcommand_windows zulässig.instructionsstringmodel_instructions_file oder AGENTS.md.log_dirstring (path)$CODEX_HOME/log. Wenn du ein Verzeichnis explizit angibst, aktiviert Codex dort auch das optionale TUI-Klartextprotokoll codex-tui.log.marketplaces.<name>.refstringmarketplaces.<name>.sourcestringmarketplaces.<name>.source_typegit | localmarketplaces.<name>.sparse_pathsarray<string>mcp_oauth_callback_portintegeroauth.callback_port hat Vorrang. Ohne beide Angaben verwendet Codex einen vom Betriebssystem zugewiesenen temporären Port.mcp_oauth_callback_urlstringmcp_oauth_credentials_storeauto | file | keyringmcp_optional_startup_grace_msinteger (milliseconds)1000. Bei 0 wartet Codex für jeden Server entsprechend dessen startup_timeout_sec.mcp_servers.<id>.argsarray<string>mcp_servers.<id>.authoauth | chatgptoauth (Standard) verwendet gespeicherte MCP-OAuth-Anmeldedaten, sofern vorhanden. chatgpt verwendet für den vertrauenswürdigen Origin von ChatGPT die aktuelle ChatGPT-Sitzung und greift andernfalls auf gespeicherte OAuth-Anmeldedaten zurück. Liefert keine Quelle Anmeldedaten, ist in beiden Modi eine Verbindung ohne Authentifizierung möglich.mcp_servers.<id>.bearer_token_env_varstringmcp_servers.<id>.commandstringmcp_servers.<id>.cwdstringmcp_servers.<id>.default_tools_approval_modeauto | prompt | writes | approvemcp_servers.<id>.disabled_toolsarray<string>enabled_tools angewendet.mcp_servers.<id>.enabledbooleanmcp_servers.<id>.enabled_toolsarray<string>mcp_servers.<id>.envmap<string,string>mcp_servers.<id>.env_http_headersmap<string,string>mcp_servers.<id>.env_varsarray<string | { name = string, source = "local" | "remote" }>source = "local". Verwende source = "remote" nur, wenn stdio über einen Remote-Executor läuft.mcp_servers.<id>.environment_idstringlocal. Gib die ID eines konfigurierten Executors an, um dort einen stdio-Server auszuführen oder eine Verbindung zu einem Server mit Streamable HTTP aufzubauen.mcp_servers.<id>.http_headersmap<string,string>mcp_servers.<id>.http_headers_helperstring (command)mcp_servers.<id>.oauth_resourcestringmcp_servers.<id>.oauth.callback_portintegermcp_oauth_callback_port. Bei einem direkten Loopback-Callback mit explizitem Port in der URL konfigurierst du denselben Port für den Listener.mcp_servers.<id>.oauth.callback_urlstringmcp_servers.<id>.oauth.client_idstringmcp_servers.<id>.oauth.client_secretstringoauth.client_id. Auch das Secret darf nicht leer sein. Es wird in der Konfiguration gespeichert.mcp_servers.<id>.omit_tools_fromarray<string>direct (anfangs verfügbare Tools), deferred (Tool-Suche) oder code_mode (Skripte im Codemodus). Verwende disabled_tools, um ein Tool zu sperren. Eine leere Liste hebt geerbte Ausschlüsse auf.mcp_servers.<id>.requiredbooleanstartup_readiness = "catalog" kann ein gültiger zwischengespeicherter Katalog diese Anforderung erfüllen.mcp_servers.<id>.scopesarray<string>mcp_servers.<id>.startup_readinessconnection | catalogconnection (Standard) muss beim Start eine Verbindung bestehen. Bei catalog genügt für den Start ein gültiger zwischengespeicherter Tool-Katalog, während die Verbindung aufgebaut wird. Tool-Aufrufe erfordern weiterhin eine aktive Verbindung.mcp_servers.<id>.startup_timeout_msnumberstartup_timeout_sec mit Angabe in Millisekunden.mcp_servers.<id>.startup_timeout_secnumbermcp_servers.<id>.supports_parallel_tool_callsbooleanfalse.mcp_servers.<id>.tool_input_schema_max_bytesinteger (positive)mcp_servers.<id>.tool_timeout_secnumbermcp_servers.<id>.tools.<tool>.approval_modeauto | prompt | writes | approvemcp_servers.<id>.tools.<tool>.output_token_limitinteger (positive)mcp_servers.<id>.urlstringmemories.consolidation_modelstringmemories.consolidation_service_tierstringdefault (Standard).memories.disable_on_external_contextbooleantrue erstellt Codex keine Erinnerungen aus Threads, die externen Kontext wie MCP-Tool-Aufrufe, die Websuche oder die Tool-Suche nutzen. Standard ist false. Älterer Alias: memories.no_memories_if_mcp_or_web_search.memories.dual_writebooleanv1 ausgewählt ist, schreibt Codex bei true in beide Speicher und liest weiterhin aus v1. Wenn v2 ausgewählt ist, schreibt Codex nur in v2.memories.extract_modelstringmemories.generate_memoriesbooleanfalse speichert Codex neu erstellte Threads nicht als Grundlage für Erinnerungen. Standard ist true.memories.max_raw_memories_for_consolidationnumber256, Obergrenze ist 4096.memories.max_rollout_age_daysnumber30. Werte werden auf den Bereich von 0 bis 90 begrenzt.memories.max_rollouts_per_startupnumber16, Obergrenze ist 128.memories.max_unused_daysnumber30. Werte werden auf den Bereich von 0 bis 365 begrenzt.memories.min_rate_limit_remaining_percentnumber25. Werte werden auf den Bereich von 0 bis 100 begrenzt.memories.min_rollout_idle_hoursnumber6. Werte werden auf den Bereich von 1 bis 48 begrenzt.memories.use_memoriesbooleanfalse fügt Codex vorhandene Erinnerungen nicht in künftige Sitzungen ein. Standard ist true.memories.versionv1 | v2v2. Existiert $CODEX_HOME/memories/, gilt v1. Mit der expliziten Einstellung dual_write = false bleibt v1 der Standard.modelstringgpt-6.1-sol.model_auto_compact_token_limitnumbermodel_auto_compact_token_limit_scopetotal | body_after_prefixtotal, Standard) oder nur der Zuwachs nach dem übernommenen Präfix des Verdichtungsfensters (body_after_prefix).model_catalog_jsonstring (path)$CODEX_HOME/profile-name.config.toml kannst du den Pfad für das jeweilige Profil überschreiben.model_context_windownumbermodel_instructions_filestring (path)AGENTS.md zu verwenden.model_post_turn_compact_threshold_percentinteger (0–100)0, um die Kontextverdichtung am Ende eines Gesprächsschritts zu deaktivieren. Die üblichen Schwellen für die automatische Kontextverdichtung gelten weiterhin.model_providerstringmodel_providers. Der Standardwert ist openai.model_providers.<id>tableopenai, ollama und lmstudio) sind reserviert und lassen sich nicht überschreiben.model_providers.<id>.authtableenv_key, experimental_bearer_token oder requires_openai_auth kombinieren.model_providers.<id>.auth.argsarray<string>model_providers.<id>.auth.commandstringmodel_providers.<id>.auth.cwdstring (path)model_providers.<id>.auth.refresh_interval_msnumber0 erneuert Codex das Token nur nach einem erneuten Authentifizierungsversuch.model_providers.<id>.auth.timeout_msnumbermodel_providers.<id>.base_urlstringmodel_providers.<id>.capabilities.external_web_accessbooleanmodel_providers.<id>.capabilities.remote_compactionunsupported | v2unsupported erfolgt sie lokal. Bei v2 werden Anforderungen zur Kontextverdichtung über Responses gesendet. Ohne Angabe gelten die Standardwerte des Anbieters. Einstellungen für das Modell und den aktuellen Gesprächsschritt können die Unterstützung weiter einschränken.model_providers.<id>.env_http_headersmap<string,string>model_providers.<id>.env_keystringmodel_providers.<id>.env_key_instructionsstringmodel_providers.<id>.experimental_bearer_tokenstringenv_key.model_providers.<id>.gateway_oauth.credential_exporttablecommand eine ausführbare Datei an, die genau ein Zugriffstoken ausgibt. Die Felder args und timeout_ms (Standardwert 30000) sind optional. Lass die OAuth-Client-ID und die Endpunkteinstellungen weg, wenn du diese Tabelle verwendest.model_providers.<id>.gateway_oauth.device_authorization_urlstringmodel_providers.<id>.http_headersmap<string,string>model_providers.<id>.model_catalog_urlstringbase_url übereinstimmen. Ohne Angabe verwendet der Anbieter sein Standardverfahren zur Modellerkennung.model_providers.<id>.namestringmodel_providers.<id>.query_paramsmap<string,string>model_providers.<id>.request_max_retriesnumbermodel_providers.<id>.requires_openai_authbooleanmodel_providers.<id>.stream_idle_timeout_msnumbermodel_providers.<id>.stream_max_retriesnumbermodel_providers.<id>.supports_standalone_web_searchbooleanmodel_providers.<id>.supports_websocketsbooleanmodel_providers.<id>.wire_apiresponsesresponses ist der einzige unterstützte Wert und gilt auch ohne explizite Angabe.model_providers.amazon-bedrock.aws.profilestringamazon-bedrock.model_providers.amazon-bedrock.aws.regionstringamazon-bedrock.model_providers.gcp.base_urlstringmodel_providers.gcp.credential_filestring (absolute path)GOOGLE_APPLICATION_CREDENTIALS ausschließlich für den Authentifizierungsbefehl des Anbieters.model_providers.gcp.locationstringGOOGLE_CLOUD_LOCATION. Standard ist global.model_providers.gcp.project_idstringGOOGLE_CLOUD_PROJECT.model_reasoning_effortstringlow, medium, high, xhigh, max oder ultra. Welche Stufen verfügbar sind, hängt vom Modell und vom Client ab.model_reasoning_summaryauto | concise | detailed | nonemodel_verbositylow | medium | highnotice.hide_full_access_warningbooleannotice.hide_gpt-5.1-codex-max_migration_promptbooleannotice.hide_gpt5_1_migration_promptbooleannotice.hide_rate_limit_model_nudgebooleannotice.hide_world_writable_warningbooleannotice.model_migrationsmap<string,string>notifyarray<string>openai_base_urlstringopenai.oss_providerlmstudio | ollama--oss. Ohne Angabe fragt Codex nach dem Anbieter.otel.environmentstringdev.otel.exporternone | otlp-http | otlp-grpcotel.exporter.<id>.endpointstringotel.exporter.<id>.headersmap<string,string>otel.exporter.<id>.protocolbinary | jsonotel.exporter.<id>.tls.ca-certificatestringotel.exporter.<id>.tls.client-certificatestringotel.exporter.<id>.tls.client-private-keystringotel.log_agent_responsesbooleanfalse. Der Text kann sensible Daten enthalten. Pro Antwort werden höchstens 64 KiB exportiert.otel.log_guardian_assessmentsbooleanfalse. Die Prüfbegründungen können sensible Daten enthalten und sind auf jeweils 64 KiB begrenzt.otel.log_user_promptbooleanotel.metrics_exporternone | statsig | otlp-http | otlp-grpcstatsig richtet sich nach analytics.enabled. Explizit konfigurierte OTLP-Exporter arbeiten unabhängig davon. Mit none deaktivierst du den Metrikexport.otel.span_attributesmap<string,string>otel.tool_result.max_bytesinteger (nonnegative)2048. Die Einstellung betrifft nur die protokollierte Ausgabe.otel.trace_exporternone | otlp-http | otlp-grpcotel.trace_exporter.<id>.endpointstringotel.trace_exporter.<id>.headersmap<string,string>otel.trace_exporter.<id>.protocolbinary | jsonotel.trace_exporter.<id>.tls.ca-certificatestringotel.trace_exporter.<id>.tls.client-certificatestringotel.trace_exporter.<id>.tls.client-private-keystringotel.tracestatemap<string,map<string,string>>permissions.<name>.descriptionstringextends erbt ein Profil die Beschreibung seines übergeordneten Profils nicht.permissions.<name>.extendsstring:read-only oder :workspace an. Codex lehnt :danger-full-access, nicht definierte übergeordnete Profile und zyklische Verweise ab.permissions.<name>.filesystemtable:minimal oder :workspace_roots.permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>"read" | "write" | "deny""." für das Stammverzeichnis selbst. Für Unterpfade mit Glob-Mustern wie "**/*.env" kannst du mit "deny" das Lesen untersagen.permissions.<name>.filesystem.<path-or-glob>"read" | "write" | "deny" | table"deny" untersagst du das Lesen passender Pfade.permissions.<name>.filesystem.glob_scan_max_depthnumber1 sein.permissions.<name>.network.allow_local_bindingbooleanlocalhost können einzelne lokale Ziele auch dann erlauben, wenn der Wert false bleibt.permissions.<name>.network.allow_upstream_proxybooleanpermissions.<name>.network.dangerously_allow_all_unix_socketsbooleanpermissions.<name>.network.dangerously_allow_non_loopback_proxybooleanpermissions.<name>.network.domainstablefeatures.network_proxy oder aktivierte administrativ verwaltete Netzwerkanforderungen den Proxy einschalten. Unterstützt exakte Hostnamen, *.example.com, **.example.com und globale *-Freigaben. deny hat Vorrang. Die Regeln beschränken weder die Websuche noch Apps oder MCP-Server.permissions.<name>.network.domains.<pattern>allow | deny*.example.com oder **.example.com.permissions.<name>.network.enable_socks5booleanpermissions.<name>.network.enable_socks5_udpbooleanpermissions.<name>.network.enabledbooleanfeatures.network_proxy oder aktivierte administrativ verwaltete Netzwerkanforderungen greifen Befehle direkt auf das Netzwerk zu. Die Domainregeln des Profils werden dann nicht durchgesetzt.permissions.<name>.network.modelimited | fullpermissions.<name>.network.proxy_urlstringpermissions.<name>.network.socks_urlstringpermissions.<name>.network.unix_socketstableallow fügt einen Pfad hinzu, deny weist ihn zurück.permissions.<name>.network.unix_sockets.<path>allow | denyallow einen absoluten Unix-Socket-Pfad in die wirksame Liste zulässiger Sockets auf oder weist ihn mit deny zurück. Zurückgewiesene Einträge fehlen in der wirksamen Liste.permissions.<name>.workspace_rootstable:workspace_roots.permissions.<name>.workspace_roots.<path>booleantrue wird der Pfad als Workspace-Stammverzeichnis in das Profil aufgenommen. Deaktivierte Einträge bleiben inaktiv.personalitynone | friendly | pragmaticfriendly und pragmatic lässt sich kein Stil mehr auswählen. Bei none entfällt der integrierte Abschnitt zur Persönlichkeit in den Modellanweisungen. Explizit überschriebene Anweisungen bleiben unverändert.plan_mode_reasoning_effortstringplugins._default.enabledbooleanplugins.<plugin>.enabled diesen Standard. Lass die Tabelle weg, um die Aktivierungseinstellungen der Quelle oder des Kontos zu übernehmen.plugins.<plugin>.enabledbooleanplugin-name@marketplace-name. Maßgeblich ist die zusammengeführte Konfiguration. Einstellungen vertrauenswürdiger Projekte können Standardwerte aus Benutzer-, Cloud- und Systemkonfigurationen überschreiben. Beim Aktualisieren des Marketplace können konfigurierte Plugins auch dann installiert oder aktualisiert werden, wenn sie deaktiviert sind. Im Workspace verwaltete Aktivierungseinstellungen haben weiterhin Bestand.plugins.<plugin>.mcp_servers.<server>.default_tools_approval_modeauto | prompt | writes | approveplugins.<plugin>.mcp_servers.<server>.disabled_toolsarray<string>enabled_tools angewendet.plugins.<plugin>.mcp_servers.<server>.enabledbooleanplugins.<plugin>.mcp_servers.<server>.enabled_toolsarray<string>plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_modeauto | prompt | writes | approveproject_doc_fallback_filenamesarray<string>AGENTS.md fehlt.project_doc_max_bytesnumberAGENTS.md liest.project_root_markersarray<string>projects.<path>.trust_levelstring"trusted" | "untrusted"). Bei nicht vertrauenswürdigen Projekten überspringt Codex die projektspezifischen .codex/-Ebenen einschließlich lokaler Konfiguration, Hooks und Regeln.review_modelstring/review. Standardmäßig wird das Modell der aktuellen Sitzung verwendet.sandbox_moderead-only | workspace-write | danger-full-accesssandbox_workspace_write.exclude_slash_tmpboolean/tmp im Modus workspace-write von den beschreibbaren Stammverzeichnissen aus.sandbox_workspace_write.exclude_tmpdir_env_varboolean$TMPDIR im Modus workspace-write von den beschreibbaren Stammverzeichnissen aus.sandbox_workspace_write.network_accessbooleansandbox_workspace_write.writable_rootsarray<string>sandbox_mode = "workspace-write".service_tierstringfast oder eine andere vom aktiven Modell angebotene Stufe. fast entspricht dem Wert priority in der Anfrage.shell_environment_policy.excludearray<string>shell_environment_policy.filters. Kombiniere beide Formen nicht auf derselben Ebene.shell_environment_policy.experimental_use_profilebooleanshell_environment_policy.filtersmap<string, include | exclude>set-Werte gelten nach den Ausschlüssen. Kombiniere die Filter nicht auf derselben Ebene mit den älteren Arrays exclude oder include_only.shell_environment_policy.ignore_default_excludesbooleanshell_environment_policy.include_onlyarray<string>shell_environment_policy.filters. Kombiniere beide Formen nicht auf derselben Ebene.shell_environment_policy.inheritall | core | noneshell_environment_policy.setmap<string,string>show_raw_agent_reasoningbooleanskills.bundled.enabledbooleantrue. Setze den Wert in der Konfiguration eines vertrauenswürdigen Projekts auf false, um die mitgelieferten Skills für dieses Projekt zu deaktivieren.skills.configarray<object>skills.config.<index>.enabledbooleanskills.config.<index>.namestringname oder path an.skills.config.<index>.pathstring (path)SKILL.md-Datei.skills.include_instructionsbooleantrue.skills.max_context_tokensinteger (positive)10000 Token begrenzt.sqlite_homestring (path)suppress_unstable_features_warningbooleanthread_unload_delay_secsinteger (nonnegative)0 entfernt er ihn, sobald beide Bedingungen erfüllt sind. Standard sind 60 Sekunden.tool_output_token_limitnumbertool_suggest.disabled_toolsarray<table>type = "connector" oder "plugin" sowie eine id.tool_suggest.discoverablesarray<table>type = "connector" oder "plugin" sowie eine id.tools.web_searchboolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } }tuitabletui.alternate_screenauto | always | nevertui.animationsbooleantui.auto_recapbooleanfalse deaktivierst du automatische Zusammenfassungen. /recap bleibt verfügbar.tui.collapse_turn_detailsbooleanfalse.tui.disable_paste_burstbooleandisable_paste_burst.tui.keymap.<context>.<action>string | array<string>global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list und approval. Bestimmte Editoraktionen greifen auf passende Belegungen aus tui.keymap.global zurück. Unterstützte kontextspezifische Belegungen haben Vorrang.tui.keymap.<context>.<action> = []empty arrayctrl-a, shift-enter, page-down oder minus.tui.model_availability_nux.<model>integertui.notification_conditionunfocused | alwaysunfocused.tui.notification_methodauto | osc9 | beltui.notificationsboolean | array<string>tui.presets.<digit>.inputstring0–9), die /presets anzeigt. Gib nicht leeren Text mit höchstens 8.000 UTF-8-Bytes an. Shell-Befehle, die mit ! beginnen, werden nicht unterstützt.tui.presets.<digit>.labelstringtui.raw_output_modeboolean/raw oder dem standardmäßigen Tastenkürzel alt-r kannst du umschalten.tui.resume_cwdcurrent | sessiontui.show_server_version_noticebooleantui.show_tooltipsbooleantui.status_linearray<string> | nullnull deaktiviert die Statuszeile.tui.terminal_titlearray<string> | null["spinner", "project"]. null deaktiviert Titelaktualisierungen.tui.themestringtui.vim_mode_defaultboolean/vim kannst du die Einstellung weiterhin pro Sitzung umschalten.web_searchdisabled | cached | indexed | live"cached". Im Modus cached nutzt Codex einen von OpenAI gepflegten Index ohne externen Webzugriff. Im Modus indexed ist externer Zugriff nur über die Zugriffskontrolle des Suchindex möglich. Bei --yolo oder einer anderen Sandbox-Einstellung mit Vollzugriff ist "live" der Standard. Verwende "live" für den uneingeschränkten Live-Abruf oder "disabled", um das Tool zu entfernen.windows.sandboxmxc | elevated | unelevatedmxc schlägt fehl, wenn MXC nicht verfügbar oder durch verwaltete Anforderungen untersagt ist. Verwende features.prefer_mxc zusammen mit einer älteren Implementierung, damit Codex automatisch MXC auswählt und bei Bedarf auf die ältere Implementierung zurückgreift.Das aktuelle JSON-Schema für config.toml findest du hier.
Wenn du beim Bearbeiten von config.toml in VS Code oder Cursor Autovervollständigung und Diagnosemeldungen nutzen möchtest, installiere die Erweiterung Even Better TOML und füge am Anfang deiner config.toml folgende Zeile ein:
#:schema https://developers.openai.com/codex/config-schema.json
Hinweis: Benenne experimental_instructions_file in model_instructions_file um. Der alte Schlüssel ist in Codex veraltet. Verwende in bestehenden Konfigurationen den neuen Namen.
requirements.toml
In requirements.toml legt die Administration verbindliche Grenzen für sicherheitsrelevante Einstellungen fest. Diese Grenzen lassen sich in der Benutzerkonfiguration nicht überschreiben. Details, Speicherorte und Beispiele findest du unter Administrativ durchgesetzte Anforderungen.
Bei ChatGPT Business und Enterprise kann Codex auch Anforderungen anwenden, die es aus der Cloud abruft. Die Rangfolge ist auf der Seite zur Sicherheit beschrieben. Wie du CLI-Richtlinien über einen eigenen HTTPS-Endpunkt bereitstellst, erfährst du unter Codex-Konfiguration für dein Team selbst hosten.
Mit [features] in requirements.toml kannst du Funktionsschalter für die Laufzeit verbindlich festlegen. Verwende dafür dieselben kanonischen Schlüssel wie in config.toml. Die Anforderungen können auch dokumentierte Schlüssel enthalten, die nur für die App gelten und nicht in config.toml gehören. Für ausgelassene Schlüssel gibt es dadurch keine Beschränkung.
Einige verwaltete Anforderungen schreiben einen konkreten Konfigurationswert vor, statt eine Liste zulässiger Werte festzulegen. Ist ein Pfad, eine Update-Einstellung, eine Richtlinie für Login-Shells oder eine Feedback-Einstellung verbindlich vorgegeben, lässt sich der Wert in der Benutzerkonfiguration nicht überschreiben.
Verwaltete Listen zulässiger Berechtigungsprofile erfordern Codex 0.138.0 oder neuer. Codex 0.137.0 und ältere Versionen ignorieren allowed_permission_profiles und die verwaltete Einstellung default_permissions.
Verwende allowed_sandbox_modes zusammen mit sandbox_mode. Wenn du Berechtigungsprofile bereitstellst, verwende allowed_permission_profiles mit der verwalteten Einstellung default_permissions.
Ein Eintrag untrusted in allowed_approval_policies ist weiterhin gültig. Er erlaubt das strengere Genehmigungsverhalten, das Codex für ein Projekt mit trust_level = "untrusted" ableitet. Damit lässt sich approval_policy = "untrusted" nicht explizit festlegen.
Die Tabelle [models.new_thread] legt verwaltete Standardwerte fest, die du überschreiben kannst. Wenn du das Modell oder den Reasoning-Aufwand explizit über --model, --config oder --profile überschreibst, ignoriert Codex sowohl model als auch model_reasoning_effort in [models.new_thread]. service_tier ist davon unabhängig.
Die Browseranforderungen betreffen drei getrennte Bereiche. in_app_browser steuert den Browserbereich, den du selbst öffnest und bedienst. browser_use steuert die Arbeit eines Agenten im Browser. computer_use steuert die Arbeit eines Agenten in nativen Desktop-Apps.
Die verschachtelten Richtlinienwerte für Browser und Computernutzung gewähren für sich genommen keinen Zugriff. Ein allow für einen bestimmten Origin oder eine bestimmte App kann den Standardwert derselben Richtlinienquelle überschreiben. Die üblichen Prüfungen für Funktionen, Genehmigungen und weitere Richtlinien gelten weiterhin. Wenn sowohl verwaltete Anforderungen als auch config.toml gelten, hat ein deny aus einer der beiden Quellen Vorrang.
| Key | Typ / Werte | Details |
|---|---|---|
additional_developer_instructions | string | Verwaltete Entwickleranweisungen, die als eigene Entwicklernachricht eingefügt werden. Codex lehnt Anweisungen ab, deren geschätzter Umfang einschließlich Kontextmarkierungen 10.000 Token überschreitet. |
allow_appshots | boolean | Mit false deaktivierst du Appshots für verwaltete Konten. Ohne Angabe beschränken die Anforderungen Appshots nicht. Es gilt die reguläre Produktverfügbarkeit. |
allow_browser_and_computer_use | boolean | Mit false sperrst du sowohl die Browsersteuerung durch Agenten als auch die Computernutzung in nativen Apps. Mit true oder ohne Angabe wird keine der beiden Funktionen aktiviert. Die übrigen Funktions-, Richtlinien- und Genehmigungsprüfungen gelten weiterhin. |
allow_login_shell | boolean | Legt verbindlich fest, ob Shell-Tools eine Login-Shell starten dürfen. |
allow_managed_hooks_only | boolean | Bei true überspringt Codex Benutzer-, Projekt-, Sitzungs- und Plugin-Hooks. Verwaltete Hooks aus requirements.toml und anderen verwalteten Konfigurationsebenen bleiben zulässig. |
allow_remote_control | boolean | Mit false deaktivierst du die Fernsteuerung von Geräten für verwaltete Konten. Ohne Angabe beschränken die Anforderungen die Fernsteuerung nicht. Es gilt die reguläre Produktverfügbarkeit. |
allowed_approval_policies | array<string> | Zulässige Genehmigungsrichtlinien wie on-request, never und granular. Nimm untrusted auf, um die strengere Richtlinie zu erlauben, die Codex für ein nicht vertrauenswürdiges Projekt ableitet. Sie lässt sich nicht direkt mit approval_policy auswählen. |
allowed_approvals_reviewers | array<string> | Zulässige Werte für approvals_reviewer, zum Beispiel user und auto_review. |
allowed_chatgpt_workspaces | array<string> | Beschränkt die ChatGPT-Anmeldung einschließlich Codex-Zugriffstoken auf die aufgeführten Workspace-IDs. Eine leere Liste deaktiviert die ChatGPT-Anmeldung. Die API-Authentifizierung bleibt verfügbar, sofern sie erlaubt ist. Lege die Einstellung in der lokalen Systemanforderungsdatei oder per macOS-MDM fest. In der Cloud verwaltete Werte werden ignoriert. |
allowed_login_methods | array<string> | Erlaubt chatgpt, api oder beide Methoden. Ohne Angabe schränkt diese Einstellung die Anmeldemethoden nicht ein. Gibst du eine Liste an, muss sie mindestens eine Methode enthalten. api erlaubt die API-Authentifizierung, auch für Amazon Bedrock. Lege die Einstellung in der lokalen Systemanforderungsdatei oder per macOS-MDM fest. In der Cloud verwaltete Werte werden ignoriert. |
allowed_permission_profiles | table<boolean> | Vollständige Liste zulässiger Berechtigungsprofile. Profile mit true sind erlaubt. Ausgelassene Profile und Profile mit false sind gesperrt, auch solche, die erst in späteren Versionen hinzukommen. Beim Zusammenführen mehrerer Anforderungsquellen werden Einträge anhand des Profilnamens zugeordnet. |
allowed_permission_profiles.<name> | boolean | Erlaubt oder sperrt ein integriertes oder eigenes Berechtigungsprofil aus einer geladenen Konfigurations- oder Anforderungsquelle. Eine spätere Anforderungsquelle mit höherer Priorität kann mit false ein Profil deaktivieren, das eine frühere Quelle mit niedrigerer Priorität erlaubt 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 erlaubt. Bei einer leeren Liste ist effektiv nur disabled zulässig. |
application | table | Verwaltete Anforderungen für die Desktop-App. |
application.network | table | Zielbeschränkungen für Netzwerkanfragen der Desktop-App. Sie gelten unabhängig vom Netzwerkzugriff für Befehle und von den Origin-Regeln des Browsers. Die Ziele nativer Module oder gestarteter Prozesse werden dadurch nicht eingeschränkt. |
application.network.domains | table<allow | deny> | Regeln für exakte Domains bei Anfragen der Desktop-App. Bei aktiver Richtlinie sind HTTPS- und WSS-Anfragen nur an explizit erlaubte Domains zulässig. Subdomains sind nicht automatisch freigegeben. |
application.network.domains.<domain> | allow | deny | Erlaubt oder sperrt eine exakte Domain. Verwende Domainnamen ohne URL-Schema, Port oder Platzhalter. |
application.network.enabled | boolean | Ist die Tabelle vorhanden, gilt standardmäßig true. Bei true benötigen externe Anfragen der Desktop-App eine explizit erlaubte Domain. Bei einer leeren Domainzuordnung ist kein externes Ziel zulässig. Fehlt die Netzwerkrichtlinie der App oder gilt false, schränkt diese Richtlinie die Ziele nicht ein. |
application.storage | table | Gibt auf Desktop-Versionen mit Unterstützung für verwalteten Speicher die Speicherorte für neu angelegte Inhalte vor. Jeder Pfad überschreibt unabhängig von den anderen die jeweilige lokale Einstellung. Die Speichereinstellungen schränken den Dateisystemzugriff nicht ein. |
application.storage.default_project_parent | string (absolute path) | Übergeordnetes Verzeichnis für neue lokale Projekte, die du mit „Von Grund auf beginnen“ erstellst. |
application.storage.projectless_workspace_root | string (absolute path) | Stammverzeichnis für neue Chats, die du ohne Projekt erstellst. |
apps | table | Verwaltete App-Anforderungen, zugeordnet über die App-Kennung. Sie können eine App deaktivieren oder das Genehmigungsverhalten einzelner Tools einschränken. |
apps.<id>.enabled | boolean | Mit false deaktivierst du eine App. Diese Sperre bleibt beim Zusammenführen mehrerer Anforderungsquellen wirksam. |
apps.<id>.tools.<tool>.approval_mode | auto | prompt | writes | approve | Legt den verwalteten Genehmigungsmodus für ein einzelnes App-Tool fest. |
auto_review | table | Verwaltete Anforderungen an die automatische Überprü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. Gib den Slug exakt an, einschließlich eines vorhandenen Anbieter-Namespace. Anders als required_on_models akzeptiert diese Einstellung keinen Alias ohne Namespace. Verbots- und Netzwerkregeln gelten weiterhin. |
auto_review.required_on_models | array<string> | Slugs der Modelle, für die die automatische Überprüfung vorgeschrieben ist. Slugs dürfen weder leer sein noch Anbieter-Namespaces oder Leerraum am Anfang oder Ende enthalten. Listen aus mehreren Anforderungsquellen werden zusammengeführt. |
browser_use | table | Verwaltete Anforderungen für die Browsersteuerung durch Agenten. |
browser_use.allow_global_persistent_approval | boolean | Mit false verhinderst du, dass der Browser Genehmigungen vom Typ Always allow erstellt oder berücksichtigt, die für alle Sites gelten, etwa für Downloads von beliebigen Sites. Bereits gespeicherte Genehmigungen werden ignoriert, bleiben aber gespeichert. Mit true oder ohne Angabe wird keine Genehmigung erteilt. |
browser_use.allow_history_access | boolean | Mit false verhinderst du, dass Agenten über den Browser den Browserverlauf lesen. Mit true oder ohne Angabe gelten die üblichen Verlaufseinstellungen und Verfügbarkeitsprüfungen. |
browser_use.allow_webmcp | boolean | Erlaubt Site-Tools (WebMCP) über die Workspace-Richtlinie bei dafür vorgesehenen verwalteten Plänen. Sowohl true als auch ein nicht gesetzter Wert erlauben den Zugriff über diese Richtlinie. Mit false deaktivierst du diesen Zugangsweg. Über den Rollout für ihr Konto können Personen weiterhin Zugriff haben. Browsereinstellungen und Site-Berechtigungen gelten. |
browser_use.default_origin_policy | table | Standardwert für jede Browsereinstellung, die kein passender Eintrag unter browser_use.origins definiert. Eine passende Origin-Regel ersetzt den Standardwert dieser Quelle. Anschließend wendet Codex das strengere Ergebnis aus verwalteten Anforderungen und Benutzerkonfiguration an. |
browser_use.default_origin_policy.access | allow | deny | Mit deny sperrst du die Browsersteuerung für Origins, für die der Standardwert gilt. Damit sind dort auch Uploads, Downloads, voller Zugriff auf die Browser-Debugging-Funktionen und automatische Überprüfungen gesperrt. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu. |
browser_use.default_origin_policy.access_approval_lifetime | turn | thread | Legt die Gültigkeitsdauer einer vorübergehenden Genehmigung für den Site-Zugriff fest. Bei turn gilt sie nur für den aktuellen Gesprächsschritt, bei thread für den Rest des aktuellen Threads. persistent_approval steuert separat, ob Always allow verfügbar ist. Der Produktstandard ist thread. |
browser_use.default_origin_policy.auto_review | allow | deny | Mit deny überspringt Codex die automatische Überprüfung für Origins, für die der Standardwert gilt, und fordert stattdessen eine Genehmigung an. Bei allow bleibt die automatische Überprüfung verfügbar, sofern andere Einstellungen sie zulassen. |
browser_use.default_origin_policy.downloads | allow | deny | Mit deny sperrst du Downloads durch Agenten im Browser für Origins, für die der Standardwert gilt. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu. |
browser_use.default_origin_policy.full_cdp_access | allow | deny | Mit deny sperrst du den Vollzugriff über das Chrome DevTools Protocol (CDP) für Origins, für die der Standardwert gilt. allow lässt lediglich die üblichen Prüfungen zur ausdrücklichen Aktivierung und Genehmigung zu. |
browser_use.default_origin_policy.persistent_approval | boolean | Mit false verhinderst du, dass der Browser für Origins, für die der Standardwert gilt, eine Genehmigung vom Typ Always allow speichert oder berücksichtigt. Genehmigungen für den aktuellen Gesprächsschritt oder Thread können weiterhin gelten. true macht Always allow verfügbar, sofern die übrigen Einstellungen es zulassen, erteilt aber keine Genehmigung. |
browser_use.default_origin_policy.uploads | allow | deny | Mit deny sperrst du Uploads durch Agenten im Browser für Origins, für die der Standardwert gilt. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu. |
browser_use.disable_auto_review | boolean | Mit true überspringst du die automatische Überprüfung für Browseraktionen. Stattdessen wird die Person, die den Browser nutzt, um Genehmigung gebeten. Mit false oder ohne Angabe bleibt die automatische Überprüfung verfügbar, sofern andere Einstellungen sie zulassen. |
browser_use.extension | table | Verwaltete Einstellungen für die Browsersteuerung durch Agenten in unterstützten Chromium-Erweiterungen. |
browser_use.extension.request_headers | array<table> | Fügt Anfragen aus Tabs, die ein Agent über eine unterstützte Chromium-Erweiterung steuert, bis zu 16 HTTP-Header hinzu. Mit einer leeren Liste werden keine verwalteten Header gesendet. |
browser_use.extension.request_headers[].name | string | Name des Headers. Reservierte Namen, darunter Authorization und Cookie, sind unzulässig. In Namen und Werten ist {{session_id}} der einzige unterstützte Platzhalter. |
browser_use.extension.request_headers[].value | string | Header-Wert, der mit passenden Browseranfragen gesendet wird. |
browser_use.origins | map<string, table> | Origin-spezifische Browserrichtlinien. Schlüssel haben die Form <scheme>://<host-pattern>[:<port>] mit http oder https. Verwende einen exakten Hostnamen, *.example.com nur für Subdomains oder **.example.com für die Basisdomain und ihre Subdomains. Andere *-Platzhalter können auch Punkte einschließen. Deshalb passt region*.example.com auch auf region.api.example.com. Der Host * passt auf jeden Host mit dem angegebenen Schema. Das Schema und vom Standard abweichende Ports sind für den Abgleich relevant. Explizite Standardports werden bei der Normalisierung entfernt. Pfade, Abfragen, eingebettete Benutzernamen oder Passwörter sowie Platzhalter für Schema oder Port sind ungültig. Setze das Muster in TOML in Anführungszeichen, zum Beispiel [browser_use.origins."https://**.example.com"]. |
browser_use.origins.<pattern> | table | Richtlinie für Origins, die diesem Muster entsprechen. Treffen mehrere Muster zu, verwendet Codex für jede Funktion den strengsten Wert: deny vor allow, false vor true und turn vor thread. |
browser_use.origins.<pattern>.access | allow | deny | Mit deny sperrst du die Browsersteuerung für passende Origins. Damit sind dort auch Uploads, Downloads, voller Zugriff auf die Browser-Debugging-Funktionen und automatische Überprüfungen gesperrt. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu. |
browser_use.origins.<pattern>.access_approval_lifetime | turn | thread | Legt die Gültigkeitsdauer einer vorübergehenden Genehmigung für den Site-Zugriff auf passende Origins fest. Bei turn gilt sie nur für den aktuellen Gesprächsschritt, bei thread für den Rest des aktuellen Threads. persistent_approval steuert separat, ob Always allow verfügbar ist. |
browser_use.origins.<pattern>.auto_review | allow | deny | Mit deny überspringt Codex die automatische Überprüfung für passende Origins und fordert stattdessen eine Genehmigung an. Bei allow bleibt die automatische Überprüfung verfügbar, sofern andere Einstellungen sie zulassen. |
browser_use.origins.<pattern>.downloads | allow | deny | Mit deny sperrst du Downloads durch Agenten im Browser für passende Origins. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu. |
browser_use.origins.<pattern>.full_cdp_access | allow | deny | Mit deny sperrst du den Vollzugriff über das Chrome DevTools Protocol (CDP) für passende Origins. allow lässt lediglich die üblichen Prüfungen zur ausdrücklichen Aktivierung und Genehmigung zu. |
browser_use.origins.<pattern>.persistent_approval | boolean | Mit false verhinderst du, dass der Browser für passende Origins eine Genehmigung vom Typ Always allow speichert oder berücksichtigt. Genehmigungen für den aktuellen Gesprächsschritt oder Thread können weiterhin gelten. true macht Always allow verfügbar, sofern die übrigen Einstellungen es zulassen, erteilt aber keine Genehmigung. |
browser_use.origins.<pattern>.uploads | allow | deny | Mit deny sperrst du Uploads durch Agenten im Browser für passende Origins. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu. |
chatgpt_base_url | string | Gibt die Basis-URL des ChatGPT-Dienstes vor der Authentifizierung und dem Abruf der Cloud-Richtlinie verbindlich vor. Damit legst du nicht alle Netzwerkziele von Codex fest. Lege die Einstellung in der lokalen Systemanforderungsdatei oder per macOS-MDM fest. In der Cloud verwaltete Werte werden ignoriert. |
check_for_update_on_startup | boolean | Legt verbindlich fest, ob Codex beim Start nach Updates sucht. |
cli_auth_credentials_store | file | keyring | auto | ephemeral | Gibt den Speicher für CLI-Anmeldedaten verbindlich vor, 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 Speicher nicht verfügbar ist. ephemeral hält die Anmeldedaten für den aktuellen Prozess im Arbeitsspeicher. Lege die Einstellung in der lokalen Systemanforderungsdatei oder per macOS-MDM fest. In der Cloud verwaltete Werte werden ignoriert. |
computer_use | table | Verwaltete Anforderungen für die Arbeit von Agenten in nativen Desktop-Apps. Sowohl die verwalteten App-Regeln als auch die App-Regeln in config.toml werden durchgesetzt. Jede Richtlinienquelle muss die App zulassen. |
computer_use.allow_locked_computer_use | boolean | Mit false verhinderst du, dass die Computernutzung bei gesperrtem Gerät auf einem verwalteten macOS-Gerät aktiviert wird. Die Anforderung entfernt die Bedienelemente zur Aktivierung. Eine bereits aktivierte Nutzung bei gesperrtem Gerät bleibt aktiv. Ohne Angabe gilt die reguläre Produktverfügbarkeit. |
computer_use.allow_persistent_approval | boolean | Mit false entfernst du die Option, App-Genehmigungen sitzungsübergreifend zu speichern. Genehmigungen für die aktuelle Sitzung bleiben verfügbar. Mit true oder ohne Angabe wird keine App genehmigt. |
computer_use.default_app_access | allow | deny | Standardzugriff für native Apps, auf die keine plattformspezifische Regel zutrifft. deny sperrt den Zugriff. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu. Der Produktstandard ist allow. |
computer_use.macos | table | App-Regeln für die Computernutzung unter macOS. |
computer_use.macos.bundle_ids | map<string, allow | deny> | Ordnet exakten macOS-Bundle-IDs allow oder deny zu. Eine passende Regel ersetzt computer_use.default_app_access innerhalb derselben Richtlinienquelle. Ein Verbot in den verwalteten Anforderungen oder der Benutzerkonfiguration sperrt den Zugriff weiterhin. |
computer_use.macos.bundle_ids.<bundle-id> | allow | deny | Mit deny sperrst du genau diese Bundle-ID. allow überschreibt nur den Standardwert dieser Richtlinienquelle. Auch alle anderen Richtlinienquellen und das übliche Genehmigungsverfahren müssen die App zulassen. |
computer_use.windows | table | Regeln für die Computernutzung mit paketierten und nicht paketierten Windows-Apps. |
computer_use.windows.aumids | map<string, allow | deny> | Ordnet exakten, registrierten Application User Model IDs (AUMIDs) signierter, paketierter Apps allow oder deny zu. Eine passende Regel ersetzt computer_use.default_app_access innerhalb derselben Richtlinienquelle. |
computer_use.windows.aumids.<aumid> | allow | deny | Mit deny sperrst du genau diese Identität einer paketierten App. allow überschreibt nur den Standardwert dieser Richtlinienquelle. Auch alle anderen Richtlinienquellen und das übliche Genehmigungsverfahren müssen die App zulassen. |
computer_use.windows.exes | array<table> | Regeln für signierte, nicht paketierte ausführbare Windows-Dateien. Für den Abgleich zählen der verifizierte Herausgeber und die signierten Versionsinformationen. Der Pfad und der aktuelle Dateiname spielen keine Rolle. Ein passendes Verbot hat Vorrang vor passenden Freigaben. Für unsignierte Dateien gilt computer_use.default_app_access. Lässt sich die signierte Identität einer Datei nicht eindeutig verifizieren, wird die Datei gesperrt. |
computer_use.windows.exes[].access | allow | deny | Erforderliche Zugriffsentscheidung für passende ausführbare Dateien. deny sperrt den Zugriff. allow überschreibt nur den Standardwert dieser Richtlinienquelle. Auch alle anderen Richtlinienquellen und das übliche Genehmigungsverfahren müssen die App zulassen. |
computer_use.windows.exes[].binary_name | string | Optionaler OriginalFilename aus den signierten Versionsinformationen der ausführbaren Datei. Groß- und Kleinschreibung spielen beim Abgleich keine Rolle. Verlangt eine passende Regel für Herausgeber und Produkt diesen Wert und fehlt er in der Datei, wird die Datei für die Computernutzung gesperrt. |
computer_use.windows.exes[].product_name | string | Erforderlicher exakter 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. |
config_server | table | Bindet Codex an einen Konfigurationsserver an. Lege diese Einstellung in den lokal administrierten Anforderungen fest. |
config_server | table | Bindet Codex über lokal verwaltete Anforderungen an einen Konfigurationsserver an. Von diesem Server ruft Codex sein Richtlinienpaket ab. Eine Cloud-Richtlinie kann ihren eigenen Server nicht konfigurieren. |
config_server.base_url | string (HTTPS URL) | Basis-URL des von der Administration festgelegten Konfigurationsservers. Codex hängt /codex/config/bundle an diese URL an. |
config_server.base_url | string | Erforderliche HTTPS-Basis-URL. Codex hängt /codex/config/bundle an. Lass Anmeldedaten, Abfrageparameter und Fragmente in der Basis-URL weg. |
config_server.oauth | table | Optionale Einstellungen für die Unternehmensanmeldung. Lass diese Tabelle weg, um das Konfigurationspaket ohne Anmeldedaten abzurufen. |
config_server.oauth | table | OAuth-Einstellungen für die Anmeldung beim Konfigurationsserver. Erforderlich sind authorization_url, token_url und eine nicht leere client_id. Optional sind device_authorization_url, resource, scopes (standardmäßig eine leere Liste) und redirect_port (ungleich null). Alle Endpunkt-URLs müssen HTTPS verwenden. |
config_server.oauth.authorization_url | string (HTTPS URL) | Autorisierungsendpunkt für die Unternehmensanmeldung im Browser. Bei konfiguriertem OAuth erforderlich. |
config_server.oauth.client_id | string | Öffentliche, für Codex registrierte OAuth-Client-ID. Bei konfiguriertem OAuth erforderlich. |
config_server.oauth.redirect_port | number | Optionaler Port für den Browser-Callback auf 127.0.0.1. Standardmäßig wählt Codex einen freien Port. |
config_server.oauth.resource | string | Optionale OAuth-Ressourcenkennung für Identitätsanbieter, die eine solche Kennung verlangen. |
config_server.oauth.scopes | array<string> | Optionale OAuth-Berechtigungen, die Codex beim Identitätsanbieter anfordert. |
config_server.oauth.token_url | string (HTTPS URL) | Token-Endpunkt für die Unternehmensanmeldung und die Token-Erneuerung. Bei konfiguriertem OAuth erforderlich. |
default_permissions | string | Verwaltetes Standardberechtigungsprofil. Das Profil muss in allowed_permission_profiles erlaubt sein. Lege es für vorhersehbares Verhalten explizit fest. Ohne Angabe verwendet Codex :workspace nur dann als Standard, wenn sowohl :workspace als auch :read-only explizit erlaubt sind. |
enforce_residency | string | Schreibt für den Datenverkehr des Codex-Dienstes eine unterstützte Region für die Datenresidenz vor. Derzeit ist us zulässig. |
features | table | Verbindlich festgelegte Funktionswerte. Verwende für Laufzeitfunktionen die kanonischen Namen aus config.toml. Dokumentierte Anforderungsschlüssel, die nur für die App gelten, werden hier ebenfalls unterstützt. |
features.<name> | boolean | Schreibt vor, dass eine dokumentierte Laufzeit- oder App-Funktion aktiviert bzw. deaktiviert bleibt. |
features.api_key_cyber_access_programs | boolean | Erlaubt Codex bei der Authentifizierung per API-Schlüssel, in Anfragen an den integrierten OpenAI-Anbieter ein explizit ausgewähltes Cyber-Zugangsprogramm anzugeben. Das Konto und das Modell müssen bereits Zugriff auf das Programm haben. |
features.apps | boolean | Legt verbindlich fest, ob die Integration von Apps für verwaltete Konten verfügbar ist. |
features.browser_annotation_api | boolean | Mit false sperrst du im integrierten Browser die von Websites bereitgestellten Anpassungen für Anmerkungen. Du kannst Seiten weiterhin selbst mit Anmerkungen versehen. Mit true lässt du Anpassungen zu, sofern die App und das Konto sie unterstützen. |
features.browser_use | boolean | Setze den Wert auf false in requirements.toml, um die Browsersteuerung durch Agenten zu deaktivieren. |
features.browser_use_external | boolean | Setze den Wert auf false in requirements.toml, um zu verhindern, dass Codex unterstützte Browser über die ChatGPT-Browsererweiterung steuert. Das gilt auch für bereits geöffnete Tabs und angemeldete Sitzungen. |
features.browser_use_full_cdp_access | boolean | Setze den Wert auf false in requirements.toml, um den Vollzugriff über das Chrome DevTools Protocol in der lokalen Laufzeit einschließlich des Browser-Entwicklermodus zu deaktivieren. Die ChatGPT-Desktop-App kann die entsprechende Einstellung dann nicht aktivieren. Ohne Angabe gilt die reguläre Produktverfügbarkeit. |
features.computer_use | boolean | Setze den Wert auf false in requirements.toml, um die Computernutzung, „Aufzeichnen und Wiedergeben“ sowie die zugehörigen Installations- und Aktivierungsvorgänge zu deaktivieren. |
features.fast_mode | boolean | Erlaubt oder sperrt den Schnellmodus für verwaltete Konten. Ältere Versionen des App Servers steuern mit dieser Einstellung auch den ultraschnellen Modus. |
features.guardian_approval | boolean | Legt verbindlich fest, ob Genehmigungen durch Guardian für verwaltete Konten verfügbar sind. |
features.in_app_browser | boolean | Setze den Wert auf false in requirements.toml, um den integrierten Browserbereich zu deaktivieren, den Personen selbst öffnen und bedienen. |
features.in_app_chat | boolean | Mit false blendest du in der ChatGPT-Desktop-App die Gesprächsansichten von ChatGPT und ChatGPT Work sowie die zugehörige Oberfläche für Cloud-Automatisierungen aus. ChatGPT Voice bleibt davon unberührt und bestehende Cloud-Aufgaben laufen weiter. true umgeht keine Prüfungen zu Konto, Workspace-Berechtigungen oder Rollout. |
features.in_app_dictation | boolean | Mit false deaktivierst du die Diktierfunktion in der Desktop-App. true umgeht keine anderen Verfügbarkeitsprüfungen. |
features.in_app_local_automation | boolean | Mit false deaktivierst du lokale geplante Aufgaben in der Desktop-App. true umgeht keine anderen Verfügbarkeitsprüfungen. |
features.in_app_updates | boolean | Setze den Wert auf false in requirements.toml, um Updates innerhalb der App zu deaktivieren. Ohne diese Anforderung bleiben Updates standardmäßig aktiviert. |
features.in_app_voice | boolean | Mit false deaktivierst du die Echtzeit-Sprachfunktion von Codex in der Desktop-App. Die Diktierfunktion verwaltest du separat mit features.in_app_dictation. |
features.memories | boolean | Legt verbindlich fest, ob Erinnerungen für verwaltete Konten verfügbar sind. |
features.multi_agent | boolean | Legt verbindlich fest, ob verwaltete Konten mehrere Agenten einsetzen können. |
features.plugin_sharing | boolean | Setze den Wert in der cloudverwalteten requirements.toml auf false, um das Teilen lokal erstellter Plugins im Workspace zu deaktivieren. |
features.plugins | boolean | Legt verbindlich fest, ob Plugins für verwaltete Konten verfügbar sind. |
features.realtime_conversation | boolean | Mit false deaktivierst du den experimentellen Befehl /voice in der Codex CLI. Verlass dich nicht auf diese Einstellung, um ChatGPT Voice in der Desktop-App oder Sprachsitzungen des App Servers zu sperren. true umgeht keine Client- oder Rollout-Prüfungen. |
features.remote_plugin | boolean | Legt verbindlich fest, ob der Remote-Katalog für Plugins für verwaltete Konten verfügbar ist. |
features.standalone_web_search | boolean | Experimentell. Mit true behält die Desktop-App ihre native Konfiguration für die Websuche bei, wenn andernfalls die gehostete Suche über MCP verfügbar wäre. |
features.ultrafast_mode | boolean | Erlaubt oder sperrt den ultraschnellen Modus für verwaltete Konten. Unterstützt der App Server getrennte Geschwindigkeitseinstellungen, gilt dies auch bei deaktiviertem Schnellmodus. Die Verfügbarkeit hängt vom Modell und vom Konto ab. |
features.workspace_dependencies | boolean | Legt verbindlich fest, ob die mitgelieferte Laufzeit für Workspace-Abhängigkeiten für verwaltete Konten verfügbar ist. |
feedback | table | Verwaltete Feedback-Einstellungen. |
feedback.enabled | boolean | Legt verbindlich fest, ob Personen in den Codex-Clients Feedback senden können. |
guardian_policy_config | string | Verwalteter Markdown-Text, der die Standardrichtlinie für die automatische Überprüfung ersetzt. Er hat Vorrang vor der lokalen Einstellung [auto_review].policy. Leere Werte werden ignoriert. |
hooks | table | Administrativ durchgesetzte Lebenszyklus-Hooks. Sie benötigen ein verwaltetes Hook-Verzeichnis und verwenden dasselbe Ereignisschema wie direkt konfigurierte [hooks] in config.toml. |
hooks.<Event> | array<table> | Gruppen von Abgleichregeln für ein Hook-Ereignis wie PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit oder Stop. |
hooks.<Event>[].hooks | array<table> | Hook-Handler für eine Gruppe von Abgleichregeln. Befehls-Hooks und MCP-Tool-Hooks werden unterstützt. Prompt- und Agenten-Hook-Handler werden eingelesen, bei der Ausführung aber übersprungen. |
hooks.<Event>[].hooks[].additionalContextLimit | integer | Ungefährer Token-Schwellenwert pro Handler. Ist additionalContext größer, speichert Codex den Inhalt auf dem Datenträger und zeigt dem Modell eine kürzere Vorschau. Standard ist 2500. Bei 0 erhält das Modell direkt den vollständigen Kontext. 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. Standard ist false. SessionEnd läuft immer synchron. Siehe Hooks im Hintergrund ausführen. |
hooks.<Event>[].hooks[].commandWindows | string | Abweichender Befehl für Befehls-Hooks unter Windows. In TOML ist auch der Alias command_windows zulässig. |
hooks.managed_dir | string (absolute path) | Verzeichnis für verwaltete Hook-Skripte unter macOS und Linux. Bevor Codex die Hooks lädt, prüft es, ob der Pfad absolut ist und das Verzeichnis existiert. |
hooks.windows_managed_dir | string (absolute path) | Verzeichnis für verwaltete Hook-Skripte unter Windows. Bevor Codex die Hooks lädt, prüft es, ob der Pfad absolut ist und das Verzeichnis existiert. |
in_app_browser | table | Anforderungen an den integrierten Browserbereich. Diese Einstellungen steuern nicht die Arbeit von Agenten im Browser. |
in_app_browser.allow_external_browser_settings_import | boolean | Mit false verhinderst du den Import von Einstellungen oder Browserdaten aus einem externen Browser in den integrierten Browser. Mit true oder ohne Angabe bleibt der Import verfügbar, sofern die übrigen Produktprüfungen ihn zulassen. Diese Einstellung lässt sich nur administrativ verwalten und nicht in config.toml überschreiben. |
log_dir | string (path) | Gibt verbindlich das Verzeichnis für die lokalen Protokolldateien von Codex vor. |
marketplaces | table | Administrative Anforderungen an Quellen für Plugin-Marketplaces. Die Regeln greifen, wenn restrict_to_allowed_sources auf true steht. |
marketplaces.allowed_sources | table | Zulässige Marketplace-Quellen, zugeordnet über administrativ gewählte Regelnamen. Unterschiedliche Namen werden über die Anforderungsebenen hinweg gesammelt. Für Felder unter demselben Namen gilt die übliche Rangfolge der Ebenen. |
marketplaces.allowed_sources.<name> | table | Regel für eine zulässige Quelle. Der Wert von source nach dem Zusammenführen der Anforderungen bestimmt, welche weiteren Felder dieses Eintrags Codex auswertet. |
marketplaces.allowed_sources.<name>.host_pattern | string | Bei source = "host_pattern" erforderlicher regulärer Ausdruck. Codex gleicht ihn mit dem kleingeschriebenen Hostnamen aus einer Git-Quelle im HTTPS-, SSH- oder SCP-Format ab. Verwende ^ und $, damit der gesamte Hostname übereinstimmen muss. |
marketplaces.allowed_sources.<name>.path | string (absolute path) | Bei source = "local" erforderliches lokales Marketplace-Verzeichnis. Codex verlangt einen absoluten Pfad und vergleicht die Pfade nach der Normalisierung. |
marketplaces.allowed_sources.<name>.ref | string | Optionale exakte Git-Referenz für eine git-Regel. Ohne Angabe erlaubt die Regel jede Referenz im passenden Repository. |
marketplaces.allowed_sources.<name>.source | git | host_pattern | local | Abgleichverfahren für die Marketplace-Quelle. Verwende git für ein einzelnes Repository, host_pattern für Git-Hosts, die einem regulären Ausdruck entsprechen, oder local für ein einzelnes Verzeichnis. |
marketplaces.allowed_sources.<name>.url | string | Bei source = "git" erforderliche URL des Git-Repositorys. Codex normalisiert die konfigurierte und die zulässige URL und verlangt anschließend eine exakte Übereinstimmung des Repositorys. |
marketplaces.restrict_to_allowed_sources | boolean | Bei true müssen konfigurierte Marketplace-Quellen zu allowed_sources passen, wenn ein Marketplace hinzugefügt, ein Plugin installiert, eine Aktualisierung durchgeführt oder ein Plugin zur Laufzeit geladen wird. Auch von OpenAI kuratierte Git-Kataloge einschließlich des Katalogs für API-Schlüssel müssen auf der Freigabeliste stehen. Mitgelieferte und remote installierte Workspace-Plugins fallen nicht unter diese Richtlinie für kuratierte Git-Quellen. |
mcp_servers | table | Liste der MCP-Server, die aktiviert werden dürfen. Sowohl der Servername ( <id>) als auch die Identität müssen übereinstimmen. Konfigurierte MCP-Server ohne passenden Listeneintrag oder mit abweichender Identität werden deaktiviert. |
mcp_servers.<id>.identity | table | Identitätsregel für einen einzelnen MCP-Server. Setze entweder command (stdio) oder url (Streamable HTTP). |
mcp_servers.<id>.identity.command | string | table | Erlaubt einen MCP-Server mit stdio anhand der exakten Befehlszeichenfolge. Alternativ kannst du in einer Abgleichtabelle eine exakte ausführbare Datei und geordnete Abgleichregeln für Argumente verlangen. Bei einer Zeichenfolge prüft Codex weder Argumente noch cwd, env oder env_vars. |
mcp_servers.<id>.identity.command.args | array<table> | Geordnete Abgleichregeln für die Argumente eines stdio-Servers. Die konfigurierte Argumentliste muss dieselbe Länge haben und an jeder Position zur Regel passen. Befehlsregeln prüfen weder cwd noch env oder env_vars. |
mcp_servers.<id>.identity.command.args[].expression | string | Regulärer Ausdruck für eine Argumentregel vom Typ regex. Der Ausdruck muss gültig sein und den gesamten Argumentwert erfassen. |
mcp_servers.<id>.identity.command.args[].match | exact | prefix | regex | Abgleichverfahren für das Argument an dieser Position. |
mcp_servers.<id>.identity.command.args[].value | string | Vergleichswert für eine Argumentregel vom Typ exact oder prefix. |
mcp_servers.<id>.identity.command.executable | string | Ausführbare Datei, mit der der konfigurierte command des stdio-Servers exakt übereinstimmen muss. |
mcp_servers.<id>.identity.url | string | table | Erlaubt einen MCP-Server mit Streamable HTTP anhand der exakten URL oder einer Abgleichtabelle vom Typ exact, prefix oder regex. |
mcp_servers.<id>.identity.url.expression | string | Regulärer Ausdruck für eine URL-Regel vom Typ regex. Der Ausdruck muss gültig sein und die gesamte URL erfassen. |
mcp_servers.<id>.identity.url.match | exact | prefix | regex | Abgleichverfahren für die konfigurierte URL des MCP-Servers. |
mcp_servers.<id>.identity.url.value | string | Vergleichswert für eine URL-Regel vom Typ exact oder prefix. |
model_catalog_json | string (path) | Gibt verbindlich den JSON-Modellkatalog vor, den Codex beim Start verwendet. |
model_provider | string | Gibt die ID des Modellanbieters verbindlich vor und überschreibt die lokale Konfiguration und die Sitzungskonfiguration. |
model_providers | map<string, table> | Verwaltete Definitionen von Modellanbietern. Jeder Eintrag ersetzt die gesamte Konfiguration des Anbieters mit derselben ID. Einzelne Felder werden nicht mit der Benutzerdefinition 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 beim Start eines neuen lokalen Threads. Sie haben Vorrang vor Benutzer- und Projektstandardwerten, lassen sich aber durch explizite Angaben überschreiben. |
models.new_thread.model | string | Standardmodell für neue Threads. Überschreibst du das Modell oder den Reasoning-Aufwand explizit, ignoriert Codex beide Felder. |
models.new_thread.model_reasoning_effort | string | Standardmäßiger Reasoning-Aufwand für neue Threads. Überschreibst du das Modell oder den Reasoning-Aufwand explizit, ignoriert Codex beide Felder. |
models.new_thread.service_tier | string | Standardmäßige Servicestufe für neue Threads. Gibst du die Servicestufe explizit vor, ignoriert Codex dieses Feld. |
network_proxy | table | Administrativ verwaltete Netzwerkanforderungen für lokale Sandbox-Befehle. Codex 0.166.0 akzeptiert [network_proxy] und den Alias [experimental_network]. Verwende pro Anforderungsebene nur einen der beiden Namen. Behalte in veröffentlichten Richtlinien den Alias bei, bis alle Clients und Richtlinienvalidatoren den neuen Namen unterstützen. Sind die Anforderungen aktiviert, können sie den Netzwerkproxy für Befehle ohne features.network_proxy starten. Browser-Tools prüfen verwaltete Netzwerkverbote und ausschließliche Freigabelisten separat. Diese Anforderungen leiten den Browserverkehr nicht über den Proxy und steuern weder Websuche, Apps und MCP-Server noch den Datenverkehr nativer Apps oder anderer einzelner Funktionen. Auf unterstützten verwalteten Ausführungspfaden in Codex Cloud beschränken sie den Netzwerkzugriff von Befehlen zusammen mit den separaten Interneteinstellungen der Cloud-Umgebung. Eine genehmigte Ausführung mit Vollzugriff außerhalb der Sandbox kann den Befehlsproxy umgehen, sofern die Richtlinie dies erlaubt. Work Cloud übernimmt diese Anforderungen nicht. |
network_proxy.allow_local_binding | boolean | Erlaubt aus der Sandbox weitergehenden Zugriff auf lokale oder private Netze. Auf dem unterstützten Proxy-Pfad in Codex Cloud kann ein explizites false den Zugriff auf den vorgeschalteten Proxy verhindern, selbst wenn eine Domain erlaubt ist. Der Standardwert ist dort nur dann true, wenn weder eine geltende Anforderung noch das ausgewählte Netzwerkprofil oder eine Proxy-Funktionseinstellung einen Wert vorgibt. Ein geerbtes false zählt weiterhin als expliziter Wert. Eine unterstützte Cloud-Einstellung mit höherer Priorität kann diesen Wert überschreiben, ohne die globalen Vorgaben für Lokal zu lockern oder Domainfreigaben hinzuzufügen. Prüfe die Unterstützung durch den Executor. Übertrage diesen Cloud-Standardwert nicht auf Lokal. |
network_proxy.allow_upstream_proxy | boolean | Erlaubt die Weiterleitung von Netzwerkzugriffen aus der Sandbox über einen in der Umgebung festgelegten vorgeschalteten Proxy. |
network_proxy.allowed_domains | array<string> | Administrative Freigaberegeln für den Netzwerkzugriff von Sandbox-Befehlen bei aktiviertem verwaltetem Netzwerkproxy. Diese Regeln gelten nicht für Websuche, Apps oder MCP-Server. Nicht mit network_proxy.domains kombinieren. |
network_proxy.dangerously_allow_all_unix_sockets | boolean | Erlaubt beliebige Unix-Socket-Ziele über die Liste zulässiger Sockets hinaus. Verwende diese Einstellung nur in streng kontrollierten Umgebungen. |
network_proxy.dangerously_allow_non_loopback_proxy | boolean | Erlaubt für Anforderungen in [network_proxy] Listener-Adressen außerhalb von Loopback. Bei Aktivierung können Listener auch außerhalb von localhost erreichbar sein. |
network_proxy.denied_domains | array<string> | Liste administrativer Sperrregeln für Netzwerkzugriffe aus der Sandbox. Nicht mit network_proxy.domains kombinieren. |
network_proxy.domains | map<string, allow | deny> | Administrativ verwaltete Domainrichtlinie als Schlüssel-Wert-Zuordnung für Netzwerkzugriffe aus der Sandbox. Unterstützt exakte Hostnamen, *.example.com nur für Subdomains, **.example.com für die Basisdomain und ihre Subdomains sowie globale *-Freigaben. Verwende möglichst eng gefasste Regeln, da * ausgehende Zugriffe auf das öffentliche Netz weitgehend freigibt. Innerhalb einer Richtlinie können Umgebungsregeln denselben Domainschlüssel aus Global ersetzen. Ein Wert mit höherer Priorität ersetzt den Wert desselben Schlüssels. Andere geerbte Schlüssel bleiben erhalten. Nach der Zusammenführung blockiert ein anderes passendes deny die Anfrage weiterhin, auch wenn es aus einer geerbten Platzhalterregel stammt. Leere Domainzuordnungen einer Umgebung heben keine globalen Regeln auf. Prüfe die Unterstützung durch den Executor. Nicht mit network_proxy.allowed_domains oder network_proxy.denied_domains kombinieren. |
network_proxy.domains.<pattern> | allow | deny | Erlaubt oder sperrt Netzwerkzugriffe aus der Sandbox für das passende Domainmuster. Treffen mehrere Muster zu, hat eine Sperrregel Vorrang. |
network_proxy.enabled | boolean | Aktiviert Netzwerkanforderungen für die Sandbox. Dadurch erhalten Befehle keinen Netzwerkzugriff, wenn die aktive Sandbox ihn deaktiviert hält. |
network_proxy.http_port | integer | Port des HTTP-Listeners auf der Loopback-Schnittstelle für Anforderungen in [network_proxy]. |
network_proxy.managed_allowed_domains_only | boolean | Sind die Netzwerkanforderungen aktiviert und steht dieser Wert auf true, können gewöhnliche Benutzerkonfigurationen und Genehmigungen für einzelne Domains die verwaltete Freigabeliste des Proxys nicht erweitern. Ohne wirksame konfigurierte oder geerbte Freigaben gibt es für gewöhnliche verwaltete Befehle keine zulässigen Ziele. Eine Richtlinie, die nur Sperrregeln enthält, gibt das übrige Internet nicht frei. Die Beschränkung erfasst nicht jedes Tool und gilt nicht für eine genehmigte Ausführung mit Vollzugriff außerhalb der Sandbox. |
network_proxy.review_domains | array<string> | Fordert für Zugriffe auf passende Hosts auch dann eine Netzwerkgenehmigung an, wenn eine Freigaberegel zutrifft. Ein explizites Verbot hat Vorrang. Auch bei genehmigten Anfragen werden DNS und private Adressen geprüft. Standard ist eine leere Liste. |
network_proxy.socks_port | integer | Port des SOCKS5-Listeners auf der Loopback-Schnittstelle für Anforderungen in [network_proxy]. |
network_proxy.unix_sockets | map<string, allow | deny> | Administrativ verwaltete Liste zulässiger Unix-Sockets für Netzwerkzugriffe aus der Sandbox unter macOS. Pfade müssen absolut sein. |
network_proxy.unix_sockets.<path> | allow | deny | Unter macOS nimmt allow einen absoluten Unix-Socket-Pfad in die Freigabeliste auf. Bei deny bleibt er außerhalb der Liste. Ein deny-Eintrag kann einen Socket nicht sperren, wenn der Zugriff auf alle Unix-Sockets aktiviert ist. |
otel | table | Setzt die angegebenen OpenTelemetry-Einstellungen verbindlich durch. Jeder Exporter ersetzt die gesamte Definition des entsprechenden Exporters. Span-Attribute und tracestate-Felder überschreiben jeweils nur die passenden Einträge. |
otel.environment | string | Gibt die Umgebungskennzeichnung für Telemetriedaten verbindlich vor. |
otel.exporter | none | otlp-http | otlp-grpc | Gibt den Protokollexporter einschließlich Endpunkt, Headern und TLS-Einstellungen verbindlich vor. |
otel.log_agent_responses | boolean | Legt fest, ob OTLP-Protokolle den Text der abschließenden Antworten des Hauptagenten und der gestarteten Subagenten enthalten. |
otel.log_guardian_assessments | boolean | Legt fest, ob OTLP-Protokolle abgeschlossene automatische Prüfungen von Genehmigungsanfragen und die zugehörigen Begründungen enthalten. |
otel.log_user_prompt | boolean | Legt fest, ob exportierte Protokolle den Text von Benutzerprompts enthalten. |
otel.metrics_exporter | none | statsig | otlp-http | otlp-grpc | Gibt den Metrikexporter verbindlich vor. Der Statsig-Exporter richtet sich nach analytics.enabled. Explizit konfigurierte OTLP-Metrikexporter arbeiten unabhängig davon. |
otel.span_attributes | map<string,string> | Gibt einzelne Zeichenfolgenattribute für exportierte Spans verbindlich vor. Für dasselbe Attribut hat die Anforderung mit höherer Priorität Vorrang. |
otel.tool_result | table | Gibt die Protokolleinstellungen für Tool-Ergebnisse als Einheit verbindlich vor. Eine leere Tabelle schreibt die standardmäßige Byte-Obergrenze vor. |
otel.tool_result.max_bytes | integer (nonnegative) | Höchstzahl der UTF-8-Bytes aus dem Text eines Tool-Ergebnisses vor dem Kürzungshinweis im Protokoll. Ist die verwaltete Tabelle vorhanden, gilt standardmäßig 2048. |
otel.trace_exporter | none | otlp-http | otlp-grpc | Gibt den Trace-Exporter einschließlich Endpunkt, Headern und TLS-Einstellungen verbindlich vor. |
otel.tracestate | map<string,map<string,string>> | Gibt einzelne Felder in W3C-tracestate-Einträgen verbindlich vor. Für dasselbe Feld desselben Eintrags hat die Anforderung mit höherer Priorität Vorrang. |
permissions | table | Administrativ definierte Berechtigungsprofile, zugeordnet über den Profilnamen. Verwendet dieselben Profilfelder wie config.toml. |
permissions.<name> | table | Administrativ definiertes Berechtigungsprofil. Der Name darf weder mit : beginnen noch filesystem lauten oder mit einem Profilnamen aus einer geladenen Konfiguration übereinstimmen. Es gelten dieselben Profilfelder wie in config.toml. Das vollständige Profilschema findest du im Leitfaden zu Berechtigungen. |
permissions.filesystem.deny_read | array<string> | Administrativ durchgesetzte Leseverbote für das Dateisystem. Einträge können Pfade oder Glob-Muster sein. Die lokale Konfiguration kann diese Verbote nicht lockern. |
plugins | table | Plugin-spezifische Listen zulässiger MCP-Server, zugeordnet über die Plugin-Kennung. Ist diese Tabelle vorhanden, werden mitgelieferte Server ohne passenden Plugin- und Servereintrag deaktiviert. |
plugins.<plugin>.mcp_servers | table | Liste zulässiger MCP-Server, die ein bestimmtes Plugin mitliefert. Für Plugin-Server gelten dieselben Formen für exakte Identitäten und Abgleichregeln wie für die übergeordneten Anforderungen in mcp_servers. |
plugins.<plugin>.mcp_servers.<server>.identity | table | Identitätsregel für einen einzelnen MCP-Server, den ein Plugin mitliefert. Setze entweder command (stdio) oder url (Streamable HTTP). |
plugins.<plugin>.mcp_servers.<server>.identity.command | string | table | Erlaubt den stdio-MCP-Server eines Plugins anhand der exakten Befehlszeichenfolge. Alternativ kannst du in einer Abgleichtabelle eine exakte ausführbare Datei und geordnete Abgleichregeln für Argumente verlangen. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args | array<table> | Geordnete Abgleichregeln für die Argumente eines vom Plugin mitgelieferten stdio-Servers. Die konfigurierte Argumentliste muss dieselbe Länge haben und an jeder Position zur Regel passen. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression | string | Regulärer Ausdruck für eine Argumentregel vom Typ regex. Der Ausdruck muss den gesamten Argumentwert erfassen. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match | exact | prefix | regex | Abgleichverfahren für das Argument an dieser Position. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value | string | Vergleichswert für eine Argumentregel vom Typ exact oder prefix. |
plugins.<plugin>.mcp_servers.<server>.identity.command.executable | string | Ausführbare Datei, mit der der konfigurierte Befehl des vom Plugin mitgelieferten stdio-Servers exakt übereinstimmen muss. |
plugins.<plugin>.mcp_servers.<server>.identity.url | string | table | Erlaubt den MCP-Server eines Plugins mit Streamable HTTP anhand der exakten URL oder einer Abgleichtabelle vom Typ exact, prefix oder regex. |
plugins.<plugin>.mcp_servers.<server>.identity.url.expression | string | Regulärer Ausdruck für eine URL-Regel vom Typ regex. Der Ausdruck muss die gesamte URL erfassen. |
plugins.<plugin>.mcp_servers.<server>.identity.url.match | exact | prefix | regex | Abgleichverfahren für die URL des vom Plugin mitgelieferten MCP-Servers. |
plugins.<plugin>.mcp_servers.<server>.identity.url.value | string | Vergleichswert für eine URL-Regel vom Typ exact oder prefix. |
remote_sandbox_config | array<table> | Hostspezifische Sandbox-Anforderungen. Der erste Eintrag, dessen hostname_patterns zum ermittelten Hostnamen passen, überschreibt die übergeordnete Einstellung allowed_sandbox_modes dieser Anforderungsquelle. Hostspezifische Einträge überschreiben derzeit nur Sandbox-Modi. |
remote_sandbox_config[].allowed_sandbox_modes | array<string> | Zulässige Sandbox-Modi, wenn dieser hostspezifische Eintrag zutrifft. |
remote_sandbox_config[].hostname_patterns | array<string> | Muster für Hostnamen ohne Unterscheidung zwischen Groß- und Kleinschreibung. * steht für eine beliebige Zeichenfolge, ? für ein einzelnes Zeichen. |
rules | table | Administrativ durchgesetzte Befehlsregeln, die mit .rules-Dateien zusammengeführt werden. Regeln aus Anforderungen müssen einschränkend sein. |
rules.prefix_rules | array<table> | Liste verbindlicher Präfixregeln. Jede Regel muss pattern und decision enthalten. |
rules.prefix_rules[].decision | prompt | forbidden | Erforderlich. Regeln aus Anforderungen können nur eine Rückfrage auslösen oder den Befehl verbieten. Eine Freigabe ist nicht zulässig. |
rules.prefix_rules[].justification | string | Optionale Begründung, die in Genehmigungsanfragen oder Ablehnungsmeldungen erscheint. Wenn du sie angibst, darf sie nicht leer sein. |
rules.prefix_rules[].pattern | array<table> | Befehlspräfix als Folge von Mustertoken. Jedes Token legt entweder token oder any_of fest. |
rules.prefix_rules[].pattern[].any_of | array<string> | Liste zulässiger alternativer Token an dieser Position. |
rules.prefix_rules[].pattern[].token | string | Ein einzelnes Token, das an dieser Position exakt übereinstimmen muss. |
sqlite_home | string (path) | Gibt verbindlich das Verzeichnis vor, in dem Codex Laufzeitzustände mit SQLite speichert. |
unsafe_enforce_sqlite_journal_mode | boolean | Setze den Wert unter Linux auf true, um bestehende SQLite-Datenbanken auf NFS vom Journalmodus WAL auf DELETE umzustellen, bevor Codex sie zum Schreiben öffnet. Standard ist false. Das eingehängte Dateisystem muss hostübergreifende POSIX-Sperren unterstützen. Stoppe auf allen Hosts alle anderen SQLite-Clients, die diese Datenbanken verwenden, und starte sie erst nach erfolgreicher Migration wieder. Die Ersatzdateien behalten die Dateimodusbits bei und gehören dem Konto, das die Migration ausführt. Ursprüngliche Eigentümer- und Gruppenzuordnungen sowie erweiterte ACLs werden nicht übernommen. |
windows | table | Anforderungen an die native Windows-Sandbox. |
windows.allow_mxc | boolean | Mit false untersagst du sowohl die explizite Auswahl von MXC als auch die automatische Auswahl über features.prefer_mxc. Ohne Angabe oder mit true ist MXC zulässig, wird aber weder aktiviert noch vorgeschrieben. Beim Rückgriff auf eine ältere Implementierung gelten deren Beschränkungen weiterhin. |
windows.allowed_sandbox_implementations | array<string> | Zulässige ältere native Windows-Sandbox-Implementierungen ( elevated und unelevated). Die Liste darf nicht leer sein. Sind beide erlaubt und ist kein Modus ausgewählt, bevorzugt Codex elevated. Die Liste schränkt die Sandbox mxc nicht ein, wenn diese verfügbar ist. |
windows.require_mxc | boolean | Bei true akzeptiert Codex unter Windows nur MXC als wirksame Sandbox-Implementierung. Wähle MXC separat aus. Kann Codex MXC nicht verwenden, schlägt die Konfiguration fehl. Codex greift dann nicht auf eine ältere Sandbox zurück. |
additional_developer_instructionsstringallow_appshotsbooleanfalse deaktivierst du Appshots für verwaltete Konten. Ohne Angabe beschränken die Anforderungen Appshots nicht. Es gilt die reguläre Produktverfügbarkeit.allow_browser_and_computer_usebooleanfalse sperrst du sowohl die Browsersteuerung durch Agenten als auch die Computernutzung in nativen Apps. Mit true oder ohne Angabe wird keine der beiden Funktionen aktiviert. Die übrigen Funktions-, Richtlinien- und Genehmigungsprüfungen gelten weiterhin.allow_login_shellbooleanallow_managed_hooks_onlybooleantrue überspringt Codex Benutzer-, Projekt-, Sitzungs- und Plugin-Hooks. Verwaltete Hooks aus requirements.toml und anderen verwalteten Konfigurationsebenen bleiben zulässig.allow_remote_controlbooleanfalse deaktivierst du die Fernsteuerung von Geräten für verwaltete Konten. Ohne Angabe beschränken die Anforderungen die Fernsteuerung nicht. Es gilt die reguläre Produktverfügbarkeit.allowed_approval_policiesarray<string>on-request, never und granular. Nimm untrusted auf, um die strengere Richtlinie zu erlauben, die Codex für ein nicht vertrauenswürdiges Projekt ableitet. Sie lässt sich nicht direkt mit approval_policy auswählen.allowed_approvals_reviewersarray<string>approvals_reviewer, zum Beispiel user und auto_review.allowed_chatgpt_workspacesarray<string>allowed_login_methodsarray<string>chatgpt, api oder beide Methoden. Ohne Angabe schränkt diese Einstellung die Anmeldemethoden nicht ein. Gibst du eine Liste an, muss sie mindestens eine Methode enthalten. api erlaubt die API-Authentifizierung, auch für Amazon Bedrock. Lege die Einstellung in der lokalen Systemanforderungsdatei oder per macOS-MDM fest. In der Cloud verwaltete Werte werden ignoriert.allowed_permission_profilestable<boolean>true sind erlaubt. Ausgelassene Profile und Profile mit false sind gesperrt, auch solche, die erst in späteren Versionen hinzukommen. Beim Zusammenführen mehrerer Anforderungsquellen werden Einträge anhand des Profilnamens zugeordnet.allowed_permission_profiles.<name>booleanfalse ein Profil deaktivieren, das eine frühere Quelle mit niedrigerer Priorität erlaubt hat.allowed_sandbox_modesarray<string>sandbox_mode.allowed_web_search_modesarray<string>web_search (disabled, cached, indexed, live). disabled ist immer erlaubt. Bei einer leeren Liste ist effektiv nur disabled zulässig.applicationtableapplication.networktableapplication.network.domainstable<allow | deny>application.network.domains.<domain>allow | denyapplication.network.enabledbooleanapplication.storagetableapplication.storage.default_project_parentstring (absolute path)application.storage.projectless_workspace_rootstring (absolute path)appstableapps.<id>.enabledbooleanfalse deaktivierst du eine App. Diese Sperre bleibt beim Zusammenführen mehrerer Anforderungsquellen wirksam.apps.<id>.tools.<tool>.approval_modeauto | prompt | writes | approveauto_reviewtableauto_review.ignore_rulesarray<string>allow-Präfixregeln in der Richtlinie zur Befehlsausführung ignoriert. Gib den Slug exakt an, einschließlich eines vorhandenen Anbieter-Namespace. Anders als required_on_models akzeptiert diese Einstellung keinen Alias ohne Namespace. Verbots- und Netzwerkregeln gelten weiterhin.auto_review.required_on_modelsarray<string>browser_usetablebrowser_use.allow_global_persistent_approvalbooleanfalse verhinderst du, dass der Browser Genehmigungen vom Typ Always allow erstellt oder berücksichtigt, die für alle Sites gelten, etwa für Downloads von beliebigen Sites. Bereits gespeicherte Genehmigungen werden ignoriert, bleiben aber gespeichert. Mit true oder ohne Angabe wird keine Genehmigung erteilt.browser_use.allow_history_accessbooleanfalse verhinderst du, dass Agenten über den Browser den Browserverlauf lesen. Mit true oder ohne Angabe gelten die üblichen Verlaufseinstellungen und Verfügbarkeitsprüfungen.browser_use.allow_webmcpbooleantrue als auch ein nicht gesetzter Wert erlauben den Zugriff über diese Richtlinie. Mit false deaktivierst du diesen Zugangsweg. Über den Rollout für ihr Konto können Personen weiterhin Zugriff haben. Browsereinstellungen und Site-Berechtigungen gelten.browser_use.default_origin_policytablebrowser_use.origins definiert. Eine passende Origin-Regel ersetzt den Standardwert dieser Quelle. Anschließend wendet Codex das strengere Ergebnis aus verwalteten Anforderungen und Benutzerkonfiguration an.browser_use.default_origin_policy.accessallow | denydeny sperrst du die Browsersteuerung für Origins, für die der Standardwert gilt. Damit sind dort auch Uploads, Downloads, voller Zugriff auf die Browser-Debugging-Funktionen und automatische Überprüfungen gesperrt. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu.browser_use.default_origin_policy.access_approval_lifetimeturn | threadturn gilt sie nur für den aktuellen Gesprächsschritt, bei thread für den Rest des aktuellen Threads. persistent_approval steuert separat, ob Always allow verfügbar ist. Der Produktstandard ist thread.browser_use.default_origin_policy.auto_reviewallow | denydeny überspringt Codex die automatische Überprüfung für Origins, für die der Standardwert gilt, und fordert stattdessen eine Genehmigung an. Bei allow bleibt die automatische Überprüfung verfügbar, sofern andere Einstellungen sie zulassen.browser_use.default_origin_policy.downloadsallow | denydeny sperrst du Downloads durch Agenten im Browser für Origins, für die der Standardwert gilt. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu.browser_use.default_origin_policy.full_cdp_accessallow | denydeny sperrst du den Vollzugriff über das Chrome DevTools Protocol (CDP) für Origins, für die der Standardwert gilt. allow lässt lediglich die üblichen Prüfungen zur ausdrücklichen Aktivierung und Genehmigung zu.browser_use.default_origin_policy.persistent_approvalbooleanfalse verhinderst du, dass der Browser für Origins, für die der Standardwert gilt, eine Genehmigung vom Typ Always allow speichert oder berücksichtigt. Genehmigungen für den aktuellen Gesprächsschritt oder Thread können weiterhin gelten. true macht Always allow verfügbar, sofern die übrigen Einstellungen es zulassen, erteilt aber keine Genehmigung.browser_use.default_origin_policy.uploadsallow | denydeny sperrst du Uploads durch Agenten im Browser für Origins, für die der Standardwert gilt. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu.browser_use.disable_auto_reviewbooleantrue überspringst du die automatische Überprüfung für Browseraktionen. Stattdessen wird die Person, die den Browser nutzt, um Genehmigung gebeten. Mit false oder ohne Angabe bleibt die automatische Überprüfung verfügbar, sofern andere Einstellungen sie zulassen.browser_use.extensiontablebrowser_use.extension.request_headersarray<table>browser_use.extension.request_headers[].namestringAuthorization und Cookie, sind unzulässig. In Namen und Werten ist {{session_id}} der einzige unterstützte Platzhalter.browser_use.extension.request_headers[].valuestringbrowser_use.originsmap<string, table><scheme>://<host-pattern>[:<port>] mit http oder https. Verwende einen exakten Hostnamen, *.example.com nur für Subdomains oder **.example.com für die Basisdomain und ihre Subdomains. Andere *-Platzhalter können auch Punkte einschließen. Deshalb passt region*.example.com auch auf region.api.example.com. Der Host * passt auf jeden Host mit dem angegebenen Schema. Das Schema und vom Standard abweichende Ports sind für den Abgleich relevant. Explizite Standardports werden bei der Normalisierung entfernt. Pfade, Abfragen, eingebettete Benutzernamen oder Passwörter sowie Platzhalter für Schema oder Port sind ungültig. Setze das Muster in TOML in Anführungszeichen, zum Beispiel [browser_use.origins."https://**.example.com"].browser_use.origins.<pattern>tabledeny vor allow, false vor true und turn vor thread.browser_use.origins.<pattern>.accessallow | denydeny sperrst du die Browsersteuerung für passende Origins. Damit sind dort auch Uploads, Downloads, voller Zugriff auf die Browser-Debugging-Funktionen und automatische Überprüfungen gesperrt. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu.browser_use.origins.<pattern>.access_approval_lifetimeturn | threadturn gilt sie nur für den aktuellen Gesprächsschritt, bei thread für den Rest des aktuellen Threads. persistent_approval steuert separat, ob Always allow verfügbar ist.browser_use.origins.<pattern>.auto_reviewallow | denydeny überspringt Codex die automatische Überprüfung für passende Origins und fordert stattdessen eine Genehmigung an. Bei allow bleibt die automatische Überprüfung verfügbar, sofern andere Einstellungen sie zulassen.browser_use.origins.<pattern>.downloadsallow | denydeny sperrst du Downloads durch Agenten im Browser für passende Origins. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu.browser_use.origins.<pattern>.full_cdp_accessallow | denydeny sperrst du den Vollzugriff über das Chrome DevTools Protocol (CDP) für passende Origins. allow lässt lediglich die üblichen Prüfungen zur ausdrücklichen Aktivierung und Genehmigung zu.browser_use.origins.<pattern>.persistent_approvalbooleanfalse verhinderst du, dass der Browser für passende Origins eine Genehmigung vom Typ Always allow speichert oder berücksichtigt. Genehmigungen für den aktuellen Gesprächsschritt oder Thread können weiterhin gelten. true macht Always allow verfügbar, sofern die übrigen Einstellungen es zulassen, erteilt aber keine Genehmigung.browser_use.origins.<pattern>.uploadsallow | denydeny sperrst du Uploads durch Agenten im Browser für passende Origins. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu.chatgpt_base_urlstringcheck_for_update_on_startupbooleancli_auth_credentials_storefile | keyring | auto | ephemeralfile verwendet CODEX_HOME/auth.json. keyring erfordert den Anmeldedatenspeicher des Betriebssystems. auto greift auf eine Datei zurück, wenn der Speicher nicht verfügbar ist. ephemeral hält die Anmeldedaten für den aktuellen Prozess im Arbeitsspeicher. Lege die Einstellung in der lokalen Systemanforderungsdatei oder per macOS-MDM fest. In der Cloud verwaltete Werte werden ignoriert.computer_usetableconfig.toml werden durchgesetzt. Jede Richtlinienquelle muss die App zulassen.computer_use.allow_locked_computer_usebooleanfalse verhinderst du, dass die Computernutzung bei gesperrtem Gerät auf einem verwalteten macOS-Gerät aktiviert wird. Die Anforderung entfernt die Bedienelemente zur Aktivierung. Eine bereits aktivierte Nutzung bei gesperrtem Gerät bleibt aktiv. Ohne Angabe gilt die reguläre Produktverfügbarkeit.computer_use.allow_persistent_approvalbooleanfalse entfernst du die Option, App-Genehmigungen sitzungsübergreifend zu speichern. Genehmigungen für die aktuelle Sitzung bleiben verfügbar. Mit true oder ohne Angabe wird keine App genehmigt.computer_use.default_app_accessallow | denydeny sperrt den Zugriff. allow lässt lediglich die üblichen Genehmigungs- und Richtlinienprüfungen zu. Der Produktstandard ist allow.computer_use.macostablecomputer_use.macos.bundle_idsmap<string, allow | deny>allow oder deny zu. Eine passende Regel ersetzt computer_use.default_app_access innerhalb derselben Richtlinienquelle. Ein Verbot in den verwalteten Anforderungen oder der Benutzerkonfiguration sperrt den Zugriff weiterhin.computer_use.macos.bundle_ids.<bundle-id>allow | denydeny sperrst du genau diese Bundle-ID. allow überschreibt nur den Standardwert dieser Richtlinienquelle. Auch alle anderen Richtlinienquellen und das übliche Genehmigungsverfahren müssen die App zulassen.computer_use.windowstablecomputer_use.windows.aumidsmap<string, allow | deny>allow oder deny zu. Eine passende Regel ersetzt computer_use.default_app_access innerhalb derselben Richtlinienquelle.computer_use.windows.aumids.<aumid>allow | denydeny sperrst du genau diese Identität einer paketierten App. allow überschreibt nur den Standardwert dieser Richtlinienquelle. Auch alle anderen Richtlinienquellen und das übliche Genehmigungsverfahren müssen die App zulassen.computer_use.windows.exesarray<table>computer_use.default_app_access. Lässt sich die signierte Identität einer Datei nicht eindeutig verifizieren, wird die Datei gesperrt.computer_use.windows.exes[].accessallow | denydeny sperrt den Zugriff. allow überschreibt nur den Standardwert dieser Richtlinienquelle. Auch alle anderen Richtlinienquellen und das übliche Genehmigungsverfahren müssen die App zulassen.computer_use.windows.exes[].binary_namestringOriginalFilename aus den signierten Versionsinformationen der ausführbaren Datei. Groß- und Kleinschreibung spielen beim Abgleich keine Rolle. Verlangt eine passende Regel für Herausgeber und Produkt diesen Wert und fehlt er in der Datei, wird die Datei für die Computernutzung gesperrt.computer_use.windows.exes[].product_namestringProductName aus den signierten Versionsinformationen der ausführbaren Datei.computer_use.windows.exes[].publisher_namestringconfig_servertableconfig_servertableconfig_server.base_urlstring (HTTPS URL)config_server.base_urlstring/codex/config/bundle an. Lass Anmeldedaten, Abfrageparameter und Fragmente in der Basis-URL weg.config_server.oauthtableconfig_server.oauthtableauthorization_url, token_url und eine nicht leere client_id. Optional sind device_authorization_url, resource, scopes (standardmäßig eine leere Liste) und redirect_port (ungleich null). Alle Endpunkt-URLs müssen HTTPS verwenden.config_server.oauth.authorization_urlstring (HTTPS URL)config_server.oauth.client_idstringconfig_server.oauth.redirect_portnumberconfig_server.oauth.resourcestringconfig_server.oauth.scopesarray<string>config_server.oauth.token_urlstring (HTTPS URL)default_permissionsstringallowed_permission_profiles erlaubt sein. Lege es für vorhersehbares Verhalten explizit fest. Ohne Angabe verwendet Codex :workspace nur dann als Standard, wenn sowohl :workspace als auch :read-only explizit erlaubt sind.enforce_residencystringus zulässig.featurestableconfig.toml. Dokumentierte Anforderungsschlüssel, die nur für die App gelten, werden hier ebenfalls unterstützt.features.<name>booleanfeatures.api_key_cyber_access_programsbooleanfeatures.appsbooleanfeatures.browser_annotation_apibooleanfalse sperrst du im integrierten Browser die von Websites bereitgestellten Anpassungen für Anmerkungen. Du kannst Seiten weiterhin selbst mit Anmerkungen versehen. Mit true lässt du Anpassungen zu, sofern die App und das Konto sie unterstützen.features.browser_usebooleanfalse in requirements.toml, um die Browsersteuerung durch Agenten zu deaktivieren.features.browser_use_externalbooleanfalse in requirements.toml, um zu verhindern, dass Codex unterstützte Browser über die ChatGPT-Browsererweiterung steuert. Das gilt auch für bereits geöffnete Tabs und angemeldete Sitzungen.features.browser_use_full_cdp_accessbooleanfalse in requirements.toml, um den Vollzugriff über das Chrome DevTools Protocol in der lokalen Laufzeit einschließlich des Browser-Entwicklermodus zu deaktivieren. Die ChatGPT-Desktop-App kann die entsprechende Einstellung dann nicht aktivieren. Ohne Angabe gilt die reguläre Produktverfügbarkeit.features.computer_usebooleanfalse in requirements.toml, um die Computernutzung, „Aufzeichnen und Wiedergeben“ sowie die zugehörigen Installations- und Aktivierungsvorgänge zu deaktivieren.features.fast_modebooleanfeatures.guardian_approvalbooleanfeatures.in_app_browserbooleanfalse in requirements.toml, um den integrierten Browserbereich zu deaktivieren, den Personen selbst öffnen und bedienen.features.in_app_chatbooleanfalse blendest du in der ChatGPT-Desktop-App die Gesprächsansichten von ChatGPT und ChatGPT Work sowie die zugehörige Oberfläche für Cloud-Automatisierungen aus. ChatGPT Voice bleibt davon unberührt und bestehende Cloud-Aufgaben laufen weiter. true umgeht keine Prüfungen zu Konto, Workspace-Berechtigungen oder Rollout.features.in_app_dictationbooleanfalse deaktivierst du die Diktierfunktion in der Desktop-App. true umgeht keine anderen Verfügbarkeitsprüfungen.features.in_app_local_automationbooleanfalse deaktivierst du lokale geplante Aufgaben in der Desktop-App. true umgeht keine anderen Verfügbarkeitsprüfungen.features.in_app_updatesbooleanfalse in requirements.toml, um Updates innerhalb der App zu deaktivieren. Ohne diese Anforderung bleiben Updates standardmäßig aktiviert.features.in_app_voicebooleanfalse deaktivierst du die Echtzeit-Sprachfunktion von Codex in der Desktop-App. Die Diktierfunktion verwaltest du separat mit features.in_app_dictation.features.memoriesbooleanfeatures.multi_agentbooleanfeatures.plugin_sharingbooleanrequirements.toml auf false, um das Teilen lokal erstellter Plugins im Workspace zu deaktivieren.features.pluginsbooleanfeatures.realtime_conversationbooleanfalse deaktivierst du den experimentellen Befehl /voice in der Codex CLI. Verlass dich nicht auf diese Einstellung, um ChatGPT Voice in der Desktop-App oder Sprachsitzungen des App Servers zu sperren. true umgeht keine Client- oder Rollout-Prüfungen.features.remote_pluginbooleanfeatures.standalone_web_searchbooleantrue behält die Desktop-App ihre native Konfiguration für die Websuche bei, wenn andernfalls die gehostete Suche über MCP verfügbar wäre.features.ultrafast_modebooleanfeatures.workspace_dependenciesbooleanfeedbacktablefeedback.enabledbooleanguardian_policy_configstring[auto_review].policy. Leere Werte werden ignoriert.hookstable[hooks] in config.toml.hooks.<Event>array<table>PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit oder Stop.hooks.<Event>[].hooksarray<table>hooks.<Event>[].hooks[].additionalContextLimitintegeradditionalContext größer, speichert Codex den Inhalt auf dem Datenträger und zeigt dem Modell eine kürzere Vorschau. Standard ist 2500. Bei 0 erhält das Modell direkt den vollständigen Kontext. Siehe Große Hook-Ausgaben.hooks.<Event>[].hooks[].asyncbooleanfalse. SessionEnd läuft immer synchron. Siehe Hooks im Hintergrund ausführen.hooks.<Event>[].hooks[].commandWindowsstringcommand_windows zulässig.hooks.managed_dirstring (absolute path)hooks.windows_managed_dirstring (absolute path)in_app_browsertablein_app_browser.allow_external_browser_settings_importbooleanfalse verhinderst du den Import von Einstellungen oder Browserdaten aus einem externen Browser in den integrierten Browser. Mit true oder ohne Angabe bleibt der Import verfügbar, sofern die übrigen Produktprüfungen ihn zulassen. Diese Einstellung lässt sich nur administrativ verwalten und nicht in config.toml überschreiben.log_dirstring (path)marketplacestablerestrict_to_allowed_sources auf true steht.marketplaces.allowed_sourcestablemarketplaces.allowed_sources.<name>tablesource nach dem Zusammenführen der Anforderungen bestimmt, welche weiteren Felder dieses Eintrags Codex auswertet.marketplaces.allowed_sources.<name>.host_patternstringsource = "host_pattern" erforderlicher regulärer Ausdruck. Codex gleicht ihn mit dem kleingeschriebenen Hostnamen aus einer Git-Quelle im HTTPS-, SSH- oder SCP-Format ab. Verwende ^ und $, damit der gesamte Hostname übereinstimmen muss.marketplaces.allowed_sources.<name>.pathstring (absolute path)source = "local" erforderliches lokales Marketplace-Verzeichnis. Codex verlangt einen absoluten Pfad und vergleicht die Pfade nach der Normalisierung.marketplaces.allowed_sources.<name>.refstringgit-Regel. Ohne Angabe erlaubt die Regel jede Referenz im passenden Repository.marketplaces.allowed_sources.<name>.sourcegit | host_pattern | localgit für ein einzelnes Repository, host_pattern für Git-Hosts, die einem regulären Ausdruck entsprechen, oder local für ein einzelnes Verzeichnis.marketplaces.allowed_sources.<name>.urlstringsource = "git" erforderliche URL des Git-Repositorys. Codex normalisiert die konfigurierte und die zulässige URL und verlangt anschließend eine exakte Übereinstimmung des Repositorys.marketplaces.restrict_to_allowed_sourcesbooleantrue müssen konfigurierte Marketplace-Quellen zu allowed_sources passen, wenn ein Marketplace hinzugefügt, ein Plugin installiert, eine Aktualisierung durchgeführt oder ein Plugin zur Laufzeit geladen wird. Auch von OpenAI kuratierte Git-Kataloge einschließlich des Katalogs für API-Schlüssel müssen auf der Freigabeliste stehen. Mitgelieferte und remote installierte Workspace-Plugins fallen nicht unter diese Richtlinie für kuratierte Git-Quellen.mcp_serverstable<id>) als auch die Identität müssen übereinstimmen. Konfigurierte MCP-Server ohne passenden Listeneintrag oder mit abweichender Identität werden deaktiviert.mcp_servers.<id>.identitytablecommand (stdio) oder url (Streamable HTTP).mcp_servers.<id>.identity.commandstring | tablecwd, env oder env_vars.mcp_servers.<id>.identity.command.argsarray<table>cwd noch env oder env_vars.mcp_servers.<id>.identity.command.args[].expressionstringregex. Der Ausdruck muss gültig sein und den gesamten Argumentwert erfassen.mcp_servers.<id>.identity.command.args[].matchexact | prefix | regexmcp_servers.<id>.identity.command.args[].valuestringexact oder prefix.mcp_servers.<id>.identity.command.executablestringcommand des stdio-Servers exakt übereinstimmen muss.mcp_servers.<id>.identity.urlstring | tableexact, prefix oder regex.mcp_servers.<id>.identity.url.expressionstringregex. Der Ausdruck muss gültig sein und die gesamte URL erfassen.mcp_servers.<id>.identity.url.matchexact | prefix | regexmcp_servers.<id>.identity.url.valuestringexact oder prefix.model_catalog_jsonstring (path)model_providerstringmodel_providersmap<string, table>model_providers.<id>tableconfig.toml, einschließlich name, base_url sowie Authentifizierungs- und Transporteinstellungen.modelstable[models.new_thread].models.new_threadtablemodels.new_thread.modelstringmodels.new_thread.model_reasoning_effortstringmodels.new_thread.service_tierstringnetwork_proxytable[network_proxy] und den Alias [experimental_network]. Verwende pro Anforderungsebene nur einen der beiden Namen. Behalte in veröffentlichten Richtlinien den Alias bei, bis alle Clients und Richtlinienvalidatoren den neuen Namen unterstützen. Sind die Anforderungen aktiviert, können sie den Netzwerkproxy für Befehle ohne features.network_proxy starten. Browser-Tools prüfen verwaltete Netzwerkverbote und ausschließliche Freigabelisten separat. Diese Anforderungen leiten den Browserverkehr nicht über den Proxy und steuern weder Websuche, Apps und MCP-Server noch den Datenverkehr nativer Apps oder anderer einzelner Funktionen. Auf unterstützten verwalteten Ausführungspfaden in Codex Cloud beschränken sie den Netzwerkzugriff von Befehlen zusammen mit den separaten Interneteinstellungen der Cloud-Umgebung. Eine genehmigte Ausführung mit Vollzugriff außerhalb der Sandbox kann den Befehlsproxy umgehen, sofern die Richtlinie dies erlaubt. Work Cloud übernimmt diese Anforderungen nicht.network_proxy.allow_local_bindingbooleannetwork_proxy.allow_upstream_proxybooleannetwork_proxy.allowed_domainsarray<string>network_proxy.domains kombinieren.network_proxy.dangerously_allow_all_unix_socketsbooleannetwork_proxy.dangerously_allow_non_loopback_proxyboolean[network_proxy] Listener-Adressen außerhalb von Loopback. Bei Aktivierung können Listener auch außerhalb von localhost erreichbar sein.network_proxy.denied_domainsarray<string>network_proxy.domains kombinieren.network_proxy.domainsmap<string, allow | deny>*.example.com nur für Subdomains, **.example.com für die Basisdomain und ihre Subdomains sowie globale *-Freigaben. Verwende möglichst eng gefasste Regeln, da * ausgehende Zugriffe auf das öffentliche Netz weitgehend freigibt. Innerhalb einer Richtlinie können Umgebungsregeln denselben Domainschlüssel aus Global ersetzen. Ein Wert mit höherer Priorität ersetzt den Wert desselben Schlüssels. Andere geerbte Schlüssel bleiben erhalten. Nach der Zusammenführung blockiert ein anderes passendes deny die Anfrage weiterhin, auch wenn es aus einer geerbten Platzhalterregel stammt. Leere Domainzuordnungen einer Umgebung heben keine globalen Regeln auf. Prüfe die Unterstützung durch den Executor. Nicht mit network_proxy.allowed_domains oder network_proxy.denied_domains kombinieren.network_proxy.domains.<pattern>allow | denynetwork_proxy.enabledbooleannetwork_proxy.http_portinteger[network_proxy].network_proxy.managed_allowed_domains_onlybooleannetwork_proxy.review_domainsarray<string>network_proxy.socks_portinteger[network_proxy].network_proxy.unix_socketsmap<string, allow | deny>network_proxy.unix_sockets.<path>allow | denyallow einen absoluten Unix-Socket-Pfad in die Freigabeliste auf. Bei deny bleibt er außerhalb der Liste. Ein deny-Eintrag kann einen Socket nicht sperren, wenn der Zugriff auf alle Unix-Sockets aktiviert ist.oteltableotel.environmentstringotel.exporternone | otlp-http | otlp-grpcotel.log_agent_responsesbooleanotel.log_guardian_assessmentsbooleanotel.log_user_promptbooleanotel.metrics_exporternone | statsig | otlp-http | otlp-grpcanalytics.enabled. Explizit konfigurierte OTLP-Metrikexporter arbeiten unabhängig davon.otel.span_attributesmap<string,string>otel.tool_resulttableotel.tool_result.max_bytesinteger (nonnegative)2048.otel.trace_exporternone | otlp-http | otlp-grpcotel.tracestatemap<string,map<string,string>>permissionstableconfig.toml.permissions.<name>table: beginnen noch filesystem lauten oder mit einem Profilnamen aus einer geladenen Konfiguration übereinstimmen. Es gelten dieselben Profilfelder wie in config.toml. Das vollständige Profilschema findest du im Leitfaden zu Berechtigungen.permissions.filesystem.deny_readarray<string>pluginstableplugins.<plugin>.mcp_serverstablemcp_servers.plugins.<plugin>.mcp_servers.<server>.identitytablecommand (stdio) oder url (Streamable HTTP).plugins.<plugin>.mcp_servers.<server>.identity.commandstring | tableplugins.<plugin>.mcp_servers.<server>.identity.command.argsarray<table>plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expressionstringregex. Der Ausdruck muss den gesamten Argumentwert erfassen.plugins.<plugin>.mcp_servers.<server>.identity.command.args[].matchexact | prefix | regexplugins.<plugin>.mcp_servers.<server>.identity.command.args[].valuestringexact oder prefix.plugins.<plugin>.mcp_servers.<server>.identity.command.executablestringplugins.<plugin>.mcp_servers.<server>.identity.urlstring | tableexact, prefix oder regex.plugins.<plugin>.mcp_servers.<server>.identity.url.expressionstringregex. Der Ausdruck muss die gesamte URL erfassen.plugins.<plugin>.mcp_servers.<server>.identity.url.matchexact | prefix | regexplugins.<plugin>.mcp_servers.<server>.identity.url.valuestringexact oder prefix.remote_sandbox_configarray<table>hostname_patterns zum ermittelten Hostnamen passen, überschreibt die übergeordnete Einstellung allowed_sandbox_modes dieser Anforderungsquelle. Hostspezifische Einträge überschreiben derzeit nur Sandbox-Modi.remote_sandbox_config[].allowed_sandbox_modesarray<string>remote_sandbox_config[].hostname_patternsarray<string>* steht für eine beliebige Zeichenfolge, ? für ein einzelnes Zeichen.rulestable.rules-Dateien zusammengeführt werden. Regeln aus Anforderungen müssen einschränkend sein.rules.prefix_rulesarray<table>pattern und decision enthalten.rules.prefix_rules[].decisionprompt | forbiddenrules.prefix_rules[].justificationstringrules.prefix_rules[].patternarray<table>token oder any_of fest.rules.prefix_rules[].pattern[].any_ofarray<string>rules.prefix_rules[].pattern[].tokenstringsqlite_homestring (path)unsafe_enforce_sqlite_journal_modebooleantrue, um bestehende SQLite-Datenbanken auf NFS vom Journalmodus WAL auf DELETE umzustellen, bevor Codex sie zum Schreiben öffnet. Standard ist false. Das eingehängte Dateisystem muss hostübergreifende POSIX-Sperren unterstützen. Stoppe auf allen Hosts alle anderen SQLite-Clients, die diese Datenbanken verwenden, und starte sie erst nach erfolgreicher Migration wieder. Die Ersatzdateien behalten die Dateimodusbits bei und gehören dem Konto, das die Migration ausführt. Ursprüngliche Eigentümer- und Gruppenzuordnungen sowie erweiterte ACLs werden nicht übernommen.windowstablewindows.allow_mxcbooleanfalse untersagst du sowohl die explizite Auswahl von MXC als auch die automatische Auswahl über features.prefer_mxc. Ohne Angabe oder mit true ist MXC zulässig, wird aber weder aktiviert noch vorgeschrieben. Beim Rückgriff auf eine ältere Implementierung gelten deren Beschränkungen weiterhin.windows.allowed_sandbox_implementationsarray<string>elevated und unelevated). Die Liste darf nicht leer sein. Sind beide erlaubt und ist kein Modus ausgewählt, bevorzugt Codex elevated. Die Liste schränkt die Sandbox mxc nicht ein, wenn diese verfügbar ist.windows.require_mxcbooleantrue akzeptiert Codex unter Windows nur MXC als wirksame Sandbox-Implementierung. Wähle MXC separat aus. Kann Codex MXC nicht verwenden, schlägt die Konfiguration fehl. Codex greift dann nicht auf eine ältere Sandbox zurück.