Konfigurationsreferenz
Vollständige Referenz für Codex config.toml und requirements.toml
Verwenden Sie diese Seite als durchsuchbare Referenz für Codex-Konfigurationsdateien. Konzeptionelle Anleitungen und Beispiele finden Sie zunächst unter Grundlagen der Konfiguration und Erweiterte Konfiguration.
Einstellungen für den lokalen Computerzugriff mit Work Cloud
Wenn der lokale Computerzugriff mit Work Cloud aktiviert ist, koordiniert die Cloud von OpenAI die Aufgabe, während unterstützte Tools in der Cloud oder auf einem verbundenen Computer ausgeführt werden. Anforderungen legen Grenzen fest; Konfigurationswerte geben Standardwerte vor.
Verwenden Sie die Richtlinien-API, um Einstellungen für Global zu verwalten. Einstellungen für Local oder Codex Cloud verwalten Sie über die Agent Security-Oberfläche. Bestehende API-Workflows für Global bleiben nach der Migration verfügbar. Testen Sie Ihre Skripte und Terraform-Integrationen und vergewissern Sie sich, dass Richtlinienzuweisungen und Reihenfolge unverändert sind. Die Unterstützung eines Feldes in requirements.toml allein gewährleistet keine API-Kompatibilität.
| Einstellung oder Einstellungsgruppe | Geltungsbereich beim lokalen Computerzugriff mit Work Cloud | Hinweise |
|---|---|---|
| Genehmigungsrichtlinien und Prüfanforderungen | Global-Richtlinie für den Orchestrator, wenn verwaltete Richtlinien aktiviert sind | Belassen Sie Genehmigungs- und Prüfkontrollen in Global. Umgebungsspezifische Überschreibungen können die Kontrollen des Orchestrators nicht ändern. Für die lokale Ausführung und die Ausführung in Cloud-Containern gelten separate Richtlinienbereiche. |
| Verwaltete Apps, MCP server, Plugins, Marktplätze und Befehlsregeln | Global-Richtlinie | Belassen Sie diese Kontrollen auf globaler Ebene. Werten Sie das Vorhandensein eines Feldes in einem Schema nicht als Beleg dafür, dass es pro Umgebung bearbeitet werden kann. |
| Datei-, Sandbox- und übertragbare Netzwerkanforderungen | Lokale Ausführung | Bei der lokalen Ausführung haben MDM-Anforderungen und bisherige Anforderungen für verwaltete Geräte Vorrang vor Agent Security. Die Systemanforderungsdatei des Geräts ist Agent Security nachgeordnet. Die neue Enterprise-Konfiguration über requirements.toml gilt nicht für Work-Cloud-Container, für die weiterhin die bestehenden Work Cloud-Richtlinien gelten. |
| Plattformspezifische Kontrollen für die Ausführungsinstanz | Computer, auf dem der Schritt ausgeführt wird | Die Unterstützung hängt von der Ausführungsinstanz und der Plattform ab. |
| Verwaltete Hooks | Sofern aktiviert: von Administratoren definierte MCP-Hooks, die bei unterstützten Lebenszyklus- und Tool-Ereignissen auf dem Cloud-Koordinator (Orchestrator) ausgeführt werden. | Bevor Sie sich auf diese Hooks verlassen, testen Sie die Callback-Verbindung, prüfen Sie, welche Ereignisse sie empfängt, und kontrollieren Sie, wie sich Fehler auf die Aufgabe auswirken. MCP-Hooks liefern keinen vollständigen Audit-Trail für die Compliance API. Befehls-Hooks sowie Hooks aus der lokalen Konfiguration oder aus Plugins werden bei der Cloud-Orchestrierung nicht unterstützt, auch wenn Tools lokal ausgeführt werden. Bestehende unterstützte Hooks gelten weiterhin für rein lokale Work- und Codex-Threads, bei denen sowohl Orchestrierung als auch Ausführung lokal erfolgen. |
| Proxy-Listener-Adressen, Ports und Prozesseinstellungen | Keine übertragbare Umgebungsrichtlinie | Verwaltete HTTP/SOCKS-Listener-Ports und Proxy-Listener außerhalb von Loopback werden von der Cloud-Laufzeitumgebung nicht unterstützt; die Unterstützung von Socket-Regeln hängt vom Ausführungspfad ab. Die benutzerdefinierte Proxy-Konfiguration ist von den unterstützten Zielbeschränkungen getrennt. |
| App-spezifische Einstellungen und gewöhnliche lokale Standardwerte | Werden nicht zwangsläufig von der Cloud-Koordination berücksichtigt | Von der App durchgesetzte Kontrollen können wirksam bleiben, auch wenn der lokale Computerzugriff mit Work Cloud sie nicht berücksichtigt. Die Bereitstellung über die Cloud und das Verhalten des Cloud-Browsers müssen separat validiert werden. |
Agent Security-Anforderungen für den lokalen Computerzugriff mit Work Cloud
Für Work mit lokalem Zugriff und dots gilt die unterstützte Global-Richtlinie für den gemeinsam genutzten Cloud-Orchestrator, wenn verwaltete Richtlinien aktiviert sind. Für den verbundenen Computer gelten die Anforderungen an die lokale Ausführung. Work-Cloud-Container und dots-Cloud-Computer verwenden ihre eigene Ausführungskonfiguration und eigene Anforderungen. Testen Sie lokale Kontrollen und Cloud-Kontrollen separat.
In der Agent Security-Oberfläche verfügbar
- Zulässige Genehmigungsrichtlinien
- Zulässige Websuchmodi
Über TOML konfiguriert
allowed_approvals_reviewersauto_reviewguardian_policy_configappsmcp_serverspluginsrules
Diese Orchestrator-Anforderungen verbleiben in Global. Sie konfigurieren weder Berechtigungen für gemeinsam genutzte Cloud-Funktionen noch machen sie lokale Ausführungseinstellungen auf Work-Cloud-Container oder dots-Cloud-Computer übertragbar.
Kompatibilitätsgrenzen des lokalen Computerzugriffs mit Work Cloud
Die Unterstützung hängt vom Feld, der Art der Richtlinienbereitstellung und dem Ausführungsort der Aufgabe ab. Prüfen Sie die für das Mitglied wirksame Richtlinie, bevor Sie die Synchronisierung aktivieren. Einige Kontrollen müssen in Ihrer Bereitstellung getestet werden, wie in der Tabelle angegeben.
Innerhalb einer Richtlinie gilt folgende Rangfolge von der höchsten zur niedrigsten Priorität: betriebssystemspezifische Umgebungsüberschreibung → betriebssystemübergreifende Umgebungsüberschreibung → Global. Eine Richtlinie mit höherer Priorität hat auch dann Vorrang, wenn eine Richtlinie mit niedrigerer Priorität spezifischer ist.
Bei der lokalen Ausführung haben MDM-Anforderungen und ältere Anforderungen für verwaltete Geräte Vorrang vor Agent Security, das wiederum Vorrang vor der Systemanforderungsdatei des Geräts hat. Für einige Anforderungen, darunter Netzwerkanforderungen, gelten feldspezifische Zusammenführungsregeln und Laufzeitbeschränkungen. Beispiele finden Sie unter Verwaltete Konfiguration.
| Einstellung oder Gruppe | Kompatibilität mit lokalem Computerzugriff über Work Cloud | Hinweise für Administratoren |
|---|---|---|
sqlite_home, log_dir, model_catalog_json |
Als verwaltete Cloud-Überschreibungen nicht unterstützt. | Lokale Pfade können Cloud-Speicher oder Protokolle nicht verlagern. Ein lokaler Modellkatalog wird nicht übernommen. |
model_provider, model_providers |
In verwalteten Anforderungen oder Konfigurationen für lokalen Computerzugriff über Work Cloud nicht unterstützt. | Benutzerdefinierte Inferenz-Gateways und Anbieterverbindungen werden über diese Felder nicht übernommen. Dies ist von der Modellauswahl unabhängig. |
enforce_residency |
Blockiert lokalen Computerzugriff über Work Cloud, wenn die Einstellung in einer beliebigen Cloud-Richtlinie aktiviert ist. | Wenn enforce_residency in einer beliebigen Cloud-Richtlinie aktiviert ist, wird Allow local computer access sowohl für Work als auch für dots deaktiviert. Diese Schutzmaßnahme konfiguriert weder die Datenresidenz des Arbeitsbereichs noch deaktiviert sie für sich genommen Work Cloud oder dots. |
application.network.enabled und application.network.domains |
Vom lokalen Computerzugriff über Work Cloud nicht unterstützt. | Verwenden Sie diese Beschränkungen für Anwendungsziele nicht zur Steuerung des Netzwerkzugriffs von Befehlen beim lokalen Computerzugriff über Work Cloud. |
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions |
Die Übermittlung von Cloud-Richtlinien muss validiert werden. Lokaler Computerzugriff über Work Cloud weist diese Schlüssel für verwaltete Anforderungen zurück. | Browserbeschränkungen werden auf App-Seite geprüft. Das belegt weder die Übermittlung über die Cloud noch die Durchsetzung im Cloud-Browser. additional_developer_instructions erfordert Unterstützung durch den Orchestrator. |
experimental_network und permissions.<profile>.network |
Teilweise. Unterstützte Ziel- und Executor-Beschränkungen unterscheiden sich von einer benutzerdefinierten Proxy-Konfiguration. | Verwaltete HTTP/SOCKS-Listener-Ports und Proxy-Listener an Nicht-Loopback-Adressen werden von der Cloud-Laufzeit nicht unterstützt; die Unterstützung von Socket-Regeln hängt vom Ausführungspfad ab. Das Zusammenführungsverhalten bei lokaler Ausführung ist davon unabhängig. Beschränkungen des Netzwerkzugriffs von Befehlen deaktivieren weder gehostete Suche noch MCP- oder App-Tools. |
Funktionen / feature_requirements, Modelle, computer_use |
Teilweise. | Eingestellte Schalter wie tool_search = false, tool_search_always_defer_mcp_tools = false, js_repl = true und remote_control = true werden zurückgewiesen. Einige Einstellungen zur Computernutzung müssen noch durchgängig validiert werden. |
browser_use, allow_appshots, Feedback, allow_remote_control, Beschränkungen für Marketplace-Quellen |
Die App oder der App-Server setzt diese Kontrollen auf einigen Übermittlungswegen für Richtlinien durch. | App-Kontrollen können weiterhin gelten, wenn der lokale Computerzugriff über Work Cloud ein Feld ignoriert. Website-Regeln für Desktop-Browser gelten nicht für Work-Cloud-Container. Validieren Sie die tatsächliche Oberfläche und den Übermittlungsweg der Richtlinie. |
Das Konfigurationsschema enthält Schlüssel, die möglicherweise beim lokalen Computerzugriff über Work Cloud nicht funktionieren oder keine umgebungsspezifischen Überschreibungen unterstützen. Informationen zur globalen Basiskonfiguration und zur Rangfolge finden Sie unter Verwaltete Konfiguration.
config.toml
Die Konfiguration auf Benutzerebene befindet sich in ~/.codex/config.toml. Sie können außerdem projektspezifische Überschreibungen in .codex/config.toml-Dateien hinzufügen. Codex lädt projektspezifische Konfigurationsdateien nur, wenn Sie dem Projekt vertrauen.
Die projektspezifische Konfiguration kann keine maschinenlokalen Anbieter-, Authentifizierungs-,
vom Host verwalteten App-Anforderungsmetadaten-, Benachrichtigungs-, Konfigurationsprofilauswahl-
oder Telemetrie-Routing-Schlüssel überschreiben. Codex ignoriert openai_base_url,
chatgpt_base_url, apps_mcp_product_sku, model_provider,
model_providers, notify, profile, profiles,
experimental_realtime_ws_base_url und otel, wenn sie in einer
projektlokalen .codex/config.toml vorkommen; legen Sie Anbieter-, Benachrichtigungs- und Telemetrie-Schlüssel stattdessen in der Konfiguration auf Benutzerebene ab. Konfigurations-Profildateien befinden sich neben
config.toml als $CODEX_HOME/profile-name.config.toml; wählen Sie eine davon mit
--profile profile-name aus.
Ziehen Sie für Sandbox- und Genehmigungsschlüssel (approval_policy, sandbox_mode und sandbox_workspace_write.*) zusätzlich zu dieser Referenz die Seiten Sandbox und Genehmigungen, Geschützte Pfade in beschreibbaren Stammverzeichnissen und Netzwerkzugriff heran. Informationen zu Beta-Berechtigungsprofilen finden Sie unter Berechtigungen.
Codex und ChatGPT Work unterstützen approval_policy = "untrusted" nicht mehr.
Entfernen Sie die Einstellung oder wählen Sie eine unterstützte Richtlinie. Projekteinträge mit
trust_level = "untrusted" in der benutzerspezifischen ~/.codex/config.toml werden weiterhin unterstützt. Unter
Von der eingestellten Genehmigungsrichtlinie untrusted migrieren
finden Sie Beispiele und Hinweise zu den Vor- und Nachteilen der Genehmigungsoptionen.
Setzen Sie model auf ein Modell, das für Ihr angemeldetes Konto oder Ihren Arbeitsbereich verfügbar ist. Lesen Sie die Hinweise zur
Verfügbarkeit von GPT-6.1 Sol, bevor Sie den Beispielwert verwenden.
| Schlüssel | Typ / Werte | Details |
|---|---|---|
agents |
table |
Multi-Agent-Einstellungen und benutzerdefinierte Rollendeklarationen. Namen skalarer Einstellungen sind reserviert und können nicht als benutzerdefinierte Rollennamen verwendet werden. |
agents.<name>.config_file |
string (path) |
Pfad zu einer TOML-Konfigurationsebene für diese Rolle; relative Pfade werden ausgehend von der Konfigurationsdatei aufgelöst, die die Rolle deklariert. |
agents.<name>.description |
string |
Rollenanweisungen, die Codex bei der Auswahl und beim Start dieses Agententyps angezeigt werden. |
agents.default_subagent_model |
string |
Standardmodell für gestartete Agenten. Ein beim Start explizit angegebenes Modell hat Vorrang. |
agents.default_subagent_reasoning_effort |
string |
Standardmäßiger Reasoning-Aufwand für gestartete Agenten. Ein beim Start explizit angegebener Aufwand hat Vorrang. |
agents.enabled |
boolean |
Aktiviert oder deaktiviert Multi-Agent-Tools (Standard: true). |
agents.interrupt_message |
boolean |
Zeichnet eine für das Modell sichtbare Nachricht auf, wenn ein Agenten-Turn unterbrochen wird (Standard: true). |
agents.max_concurrent_threads_per_session |
number |
Maximale Anzahl gleichzeitig geöffneter Threads gestarteter Agenten, ohne den primären Thread. Ohne Angabe wählt Codex den Standardwert. |
agents.max_threads |
number |
Veralteter Alias für agents.max_concurrent_threads_per_session. |
allow_login_shell |
boolean |
Erlaubt shellbasierten Tools die Verwendung der Login-Shell-Semantik. Standardmäßig true; bei false werden login = true-Anfragen abgelehnt, und bei ausgelassenem login werden standardmäßig Nicht-Login-Shells verwendet. |
analytics.enabled |
boolean |
Aktiviert oder deaktiviert Analysen für diesen Computer bzw. dieses Profil. Ohne Angabe gilt der Standardwert des Clients. |
approval_policy |
on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } } |
Steuert, wann Codex vor der Ausführung von Befehlen zur Genehmigung pausiert. Sie können auch approval_policy = { granular = { ... } } verwenden, um bestimmte Anfragekategorien zuzulassen oder automatisch abzulehnen, während andere Anfragen interaktiv bleiben. untrusted wird nicht unterstützt und on-failure ist veraltet; verwenden Sie on-request für interaktive Ausführungen oder never für nicht interaktive Ausführungen. |
approval_policy.granular.mcp_elicitations |
boolean |
Bei true dürfen MCP-Elicitation-Anfragen angezeigt werden, statt automatisch abgelehnt zu werden. |
approval_policy.granular.request_permissions |
boolean |
Bei true dürfen Anfragen des Tools request_permissions angezeigt werden. |
approval_policy.granular.rules |
boolean |
Bei true dürfen Genehmigungsanfragen angezeigt werden, die durch execpolicy-Regeln vom Typ prompt ausgelöst werden. |
approval_policy.granular.sandbox_approval |
boolean |
Bei true dürfen Genehmigungsanfragen zur Erweiterung der Sandbox-Berechtigungen angezeigt werden. |
approval_policy.granular.skill_approval |
boolean |
Bei true dürfen Genehmigungsanfragen für Skill-Skripte angezeigt werden. |
approvals_reviewer |
user | auto_review |
Legt fest, wer entsprechende Genehmigungsanfragen unter on-request oder granularen Genehmigungsrichtlinien prüft. Standardmäßig user; auto_review verwendet den Prüfer-Subagenten. Diese Einstellung ändert weder das Sandboxing noch die Prüfung von Aktionen, die innerhalb der Sandbox bereits erlaubt sind. |
apps._default.approvals_reviewer |
user | auto_review |
Standardprüfer für Genehmigungsanfragen von App-Tools, sofern nicht pro App überschrieben. Ohne Angabe übernehmen Apps den Wert von approvals_reviewer auf oberster Ebene. |
apps._default.default_tools_approval_mode |
auto | prompt | writes | approve |
Standardmäßiges Genehmigungsverhalten für App-Tools ohne Überschreibung auf App- oder Tool-Ebene. |
apps._default.destructive_enabled |
boolean |
Standardmäßiges Zulassen oder Ablehnen von App-Tools mit destructive_hint = true. |
apps._default.enabled |
boolean |
Standardmäßiger Aktivierungsstatus für alle Apps, sofern er nicht pro App überschrieben wird. |
apps._default.open_world_enabled |
boolean |
Standardmäßiges Zulassen oder Ablehnen von App-Tools mit open_world_hint = true. |
apps.<id>.approvals_reviewer |
user | auto_review |
Prüfer für Genehmigungsanfragen der Tools dieser App. Überschreibt apps._default.approvals_reviewer. |
apps.<id>.default_tools_approval_mode |
auto | prompt | writes | approve |
Standardmäßiges Genehmigungsverhalten für Tools dieser App, sofern keine Überschreibung auf Tool-Ebene vorhanden ist. |
apps.<id>.default_tools_enabled |
boolean |
Standardmäßiger Aktivierungsstatus für Tools dieser App, sofern keine Überschreibung auf Tool-Ebene vorhanden ist. |
apps.<id>.destructive_enabled |
boolean |
Erlaubt oder blockiert Tools dieser App, die destructive_hint = true ausweisen. |
apps.<id>.enabled |
boolean |
Aktiviert oder deaktiviert eine bestimmte App bzw. einen bestimmten Connector anhand der ID (Standard: true). |
apps.<id>.open_world_enabled |
boolean |
Erlaubt oder blockiert Tools dieser App, die open_world_hint = true ausweisen. |
apps.<id>.tools.<tool>.approval_mode |
auto | prompt | writes | approve |
Überschreibung des Genehmigungsverhaltens für ein einzelnes App-Tool. |
apps.<id>.tools.<tool>.enabled |
boolean |
Überschreibung des Aktivierungsstatus für ein einzelnes App-Tool (z. B. repos/list). |
auto_review.extra_policy |
string |
Zusätzliche lokale Markdown-Richtlinie für die automatische Prüfung, die zusammen mit der Hauptrichtlinie einbezogen wird. Die verwaltete Einstellung guardian_extra_policy hat Vorrang. Leere Werte werden ignoriert. |
auto_review.policy |
string |
Lokale Richtlinienanweisungen in Markdown für die automatische Prüfung. Die verwaltete Einstellung guardian_policy_config hat Vorrang. Leere Werte werden ignoriert. |
background_terminal_max_timeout |
number |
Maximales Abfragefenster in Millisekunden für leere write_stdin-Abfragen (Terminalabfragen im Hintergrund). Standard: 300000 (5 Minuten). Ersetzt den älteren Schlüssel background_terminal_timeout. |
browser_use.allow_history_access |
boolean |
Setzen Sie den Wert auf false, um den Zugriff auf den Browserverlauf einzuschränken. Verwaltete Vorgaben können diese Einschränkung erzwingen. |
browser_use.default_origin_policy |
table |
Standardeinschränkungen für Browser-Origins. Unterstützt access, uploads, downloads und full_cdp_access, jeweils mit dem Wert allow oder deny. |
browser_use.origins.<origin> |
table |
Browsereinschränkungen pro Origin mit denselben Feldern wie browser_use.default_origin_policy. Geben Sie ein HTTP- oder HTTPS-Schema und optional einen Port an; lassen Sie Pfade, Abfragen und Fragmente weg. Lokale Werte können verwaltete Verbote nicht lockern. |
chatgpt_base_url |
string |
Überschreibt die Basis-URL, die beim ChatGPT-Anmeldevorgang verwendet wird. |
check_for_update_on_startup |
boolean |
Prüft beim Start auf Codex-Updates (setzen Sie den Wert nur dann auf false, wenn Updates zentral verwaltet werden). |
cli_auth_credentials_store |
file | keyring | auto | ephemeral |
Steuert, wo die CLI zwischengespeicherte Anmeldedaten ablegt. |
compact_prompt |
string |
Direkte Überschreibung des Prompts für die Verlaufskomprimierung. |
computer_use.default_app_access |
allow | deny |
Standardrichtlinie für den Zugriff auf native Apps durch Computer Use. App-spezifische Einträge können eine Richtlinie festlegen; lokale Konfigurationen können verwaltete Einschränkungen nicht lockern. |
computer_use.macos.bundle_ids |
map<string, allow | deny> |
Zugriff auf native macOS-Apps, zugeordnet über die Bundle-Kennung. |
computer_use.windows.always_allowed_app_ids |
array<string> |
Kennungen von Windows-Apps, die Computer Use ohne Rückfrage öffnen darf. Apps, die nicht in der Liste stehen, erfordern eine Genehmigung; entfernen Sie gespeicherte Einträge in den Computer Use-Einstellungen der ChatGPT-Desktop-App. |
computer_use.windows.aumids |
map<string, allow | deny> |
Zugriff auf paketierte Windows-Apps, zugeordnet über die Application User Model ID (AUMID). |
computer_use.windows.exes |
array<table> |
Zugriffsregeln für ausführbare Windows-Dateien. Jede Regel erfordert publisher_name, product_name und access (allow oder deny); binary_name ist optional. |
default_permissions |
string |
Name des standardmäßigen Berechtigungsprofils für Tool-Aufrufe in der Sandbox. Integriert sind :read-only, :workspace und :danger-full-access; benutzerdefinierte Profilnamen erfordern entsprechende [permissions.<name>]-Tabellen. Kombinieren Sie dies nicht mit sandbox_mode oder [sandbox_workspace_write]. |
desktop.custom_file_handlers.<id> |
table |
Nur auf Benutzerebene. Definiert ein zusätzliches Ziel für Öffnen in in der ChatGPT-Desktop-App. Beispiele und Einschränkungen für Handler-IDs finden Sie unter Benutzerdefinierte Datei-Handler hinzufügen. |
desktop.custom_file_handlers.<id>.args |
array<string> |
Argumente, die zwischen dem Befehl und der Dateieingabe eingefügt werden (Standard: []). |
desktop.custom_file_handlers.<id>.command |
string |
Pfad zur ausführbaren Datei oder Befehlsname für Erkennung und Start. Erforderlich. |
desktop.custom_file_handlers.<id>.icon |
string |
Pfad zu einer mitgelieferten Ressource, Base64-kodierte data:image/...-URL, Datei-URI oder absoluter lokaler Pfad für das Handler-Symbol. Erforderlich; bei nicht unterstützten Quellen wird das Standardsymbol von VS Code verwendet. |
desktop.custom_file_handlers.<id>.input |
path | json_argument | json_stdin |
Legt fest, wie die App Dateieingaben an den Handler sendet (Standard: path). |
desktop.custom_file_handlers.<id>.label |
string |
Anzeigename in den Menüs Öffnen in. Erforderlich. |
desktop.custom_file_handlers.<id>.supports_ssh |
boolean |
Bietet den Handler für Dateien in SSH-Arbeitsbereichen an (Standard: false). |
developer_instructions |
string |
Zusätzliche Entwickleranweisungen, die in die Sitzung eingefügt werden (optional). |
disable_paste_burst |
boolean |
Deaktiviert die Erkennung schubweise eingefügter Texte in der TUI. |
experimental_compact_prompt_file |
string (path) |
Lädt die Überschreibung des Komprimierungs-Prompts aus einer Datei (experimentell). |
experimental_use_unified_exec_tool |
boolean |
Veralteter Name zum Aktivieren von unified exec; verwenden Sie vorzugsweise [features].unified_exec oder codex --enable unified_exec. |
features.apps |
boolean |
Aktiviert App-Integrationen (Connectors) (stabil; standardmäßig aktiviert). Der Datenverkehr von Apps und Connectors wird weder durch den Netzwerkproxy für Sandbox-Befehle noch durch dessen Domain-Zulassungsliste gesteuert. |
features.code_mode.direct_only_tool_namespaces |
array<string> |
Tool-Namensräume, die der Codemodus nur über direkte Tool-Aufrufe verwenden kann. |
features.code_mode.enabled |
boolean |
Aktiviert die Funktionskonfiguration für den Codemodus. Diese Funktion befindet sich in Entwicklung und ist standardmäßig deaktiviert. |
features.code_mode.excluded_tool_namespaces |
array<string> |
Tool-Namensräume, die der Codemodus von den Anweisungen für verschachtelte Codemodus-Tools und von der Bereitstellung im Executor ausschließt. |
features.context_management.experimental_mode |
boolean |
Experimentelle Einstellung zur Kontextverwaltung. Die Funktion ist derzeit nicht verfügbar. |
features.enable_request_compression |
boolean |
Komprimiert Streaming-Anfragetexte mit zstd, sofern unterstützt (stabil; standardmäßig aktiviert). |
features.fast_mode |
boolean |
Aktiviert die Auswahl von Servicestufen aus dem Modellkatalog in der TUI, einschließlich Befehlen für die Fast-Stufe, wenn das aktive Modell diese unterstützt (stabil; standardmäßig aktiviert). |
features.goals |
boolean |
Aktiviert dauerhaft gespeicherte Ziele und automatische Fortsetzung (stabil; standardmäßig aktiviert). |
features.hooks |
boolean |
Aktiviert Lebenszyklus-Hooks, die aus hooks.json oder einer direkt eingebetteten [hooks]-Konfiguration geladen werden. features.codex_hooks ist ein veralteter Alias. |
features.memories |
boolean |
Aktiviert Erinnerungen (standardmäßig deaktiviert). |
features.multi_agent |
boolean |
Aktiviert Tools für die Zusammenarbeit mehrerer Agenten (spawn_agent, send_input, resume_agent, wait_agent und close_agent) (stabil; standardmäßig aktiviert). |
features.network_proxy |
boolean | table |
Startet den Netzwerkproxy für Sandbox-Befehle (experimentell; standardmäßig deaktiviert). Erforderlich, um Domainregeln von Berechtigungsprofilen durchzusetzen, sofern nicht aktivierte, administrativ verwaltete experimental_network-Vorgaben den Proxy starten. Verwenden Sie eine Tabelle, wenn Sie Richtlinienoptionen auf Funktionsebene wie domains festlegen. Filtert weder Websuche noch Apps, MCP oder andere gehostete Tools. |
features.network_proxy.allow_local_binding |
boolean |
Erlaubt umfassenderen Zugriff auf lokale und private Netzwerke. Standardmäßig false; Zulassungsregeln für exakte lokale IP-Literale oder localhost können weiterhin bestimmte lokale Ziele erlauben. |
features.network_proxy.allow_upstream_proxy |
boolean |
Erlaubt die Verkettung über einen in der Umgebung festgelegten vorgeschalteten Proxy. Standardmäßig true. |
features.network_proxy.dangerously_allow_all_unix_sockets |
boolean |
Erlaubt beliebige Unix-Socket-Ziele statt eines auf die Zulassungsliste beschränkten Zugriffs. Standardmäßig false; verwenden Sie dies nur in streng kontrollierten Umgebungen. |
features.network_proxy.dangerously_allow_non_loopback_proxy |
boolean |
Erlaubt Listener-Adressen außerhalb von Loopback. Standardmäßig false; die Aktivierung kann Proxy-Listener über localhost hinaus zugänglich machen. |
features.network_proxy.domains |
map<string, allow | deny> |
Domainrichtlinie für Netzwerkzugriff in der Sandbox. Standardmäßig nicht gesetzt; dadurch sind keine externen Ziele erlaubt, bis Sie allow-Regeln hinzufügen. Unterstützt exakte Hosts, *.example.com nur für Subdomains, **.example.com für die Stammdomain samt Subdomains sowie globale *-Zulassungsregeln. Bevorzugen Sie eng gefasste Regeln, da * ausgehenden Zugriff auf öffentliche Ziele umfassend öffnet. Fügen Sie deny-Regeln für blockierte Ziele hinzu; bei Konflikten hat deny Vorrang. |
features.network_proxy.enable_socks5 |
boolean |
Stellt SOCKS5-Unterstützung bereit. Standardmäßig true. |
features.network_proxy.enable_socks5_udp |
boolean |
Erlaubt UDP über SOCKS5. Standardmäßig true. |
features.network_proxy.enabled |
boolean |
Startet den Netzwerkproxy für Sandbox-Befehle, wenn der Netzwerkzugriff für Befehle aktiviert ist. Standardmäßig false; bei deaktiviertem Proxy werden Domainregeln von Berechtigungsprofilen nicht durchgesetzt. |
features.network_proxy.proxy_url |
string |
HTTP-Listener-URL für Netzwerkzugriff in der Sandbox. Standardmäßig "http://127.0.0.1:3128". |
features.network_proxy.socks_url |
string |
SOCKS5-Listener-URL. Standardmäßig "http://127.0.0.1:8081". |
features.network_proxy.unix_sockets |
map<string, allow | deny> |
Unix-Socket-Richtlinie für Netzwerkzugriff in der Sandbox. Standardmäßig nicht gesetzt; fügen Sie allow-Einträge für erlaubte Sockets hinzu. |
features.personality |
boolean |
Aktiviert Steuerelemente zur Persönlichkeitsauswahl (stabil; standardmäßig aktiviert). |
features.prevent_idle_sleep |
boolean |
Verhindert, dass der Computer während eines laufenden Turns in den Ruhezustand wechselt (experimentell; standardmäßig deaktiviert). |
features.remote_plugin |
boolean |
Aktiviert den Remote-Plugin-Katalog (stabil; standardmäßig aktiviert). |
features.rollout_budget.enabled |
boolean |
Aktiviert die Erfassung des Rollout-Budgets. Diese Funktion befindet sich in Entwicklung und ist standardmäßig deaktiviert. Wenn sie aktiviert ist, ist features.rollout_budget.limit_tokens erforderlich. |
features.rollout_budget.limit_tokens |
integer |
Positives Token-Limit für die Erfassung des Rollout-Budgets. Erforderlich, wenn das Rollout-Budget aktiviert ist. |
features.rollout_budget.prefill_token_weight |
number |
Endlicher, nicht negativer Multiplikator für Prefill-Tokens bei der Berechnung des Rollout-Budgets. Standardmäßig 1.0. |
features.rollout_budget.reminder_interval_tokens |
integer |
Positives Token-Intervall zwischen Erinnerungen an das Rollout-Budget. Standardmäßig 10 % von limit_tokens, mindestens jedoch 1 Token. |
features.rollout_budget.sampling_token_weight |
number |
Endlicher, nicht negativer Multiplikator für generierte Tokens bei der Berechnung des Rollout-Budgets. Standardmäßig 1.0. |
features.shell_snapshot |
boolean |
Erstellt einen Snapshot der Shell-Umgebung, um wiederholte Befehle zu beschleunigen (stabil; standardmäßig aktiviert). |
features.shell_tool |
boolean |
Aktiviert das Standardtool shell zur Befehlsausführung (stabil; standardmäßig aktiviert). |
features.skill_mcp_dependency_install |
boolean |
Erlaubt Rückfragen und die Installation fehlender MCP-Abhängigkeiten für Skills (stabil; standardmäßig aktiviert). |
features.unified_exec |
boolean |
Verwendet das einheitliche PTY-gestützte exec-Tool (stabil; außer unter Windows standardmäßig aktiviert). |
features.web_search |
boolean |
Veralteter Schalter; verwenden Sie vorzugsweise die Einstellung web_search auf oberster Ebene. |
features.web_search_cached |
boolean |
Veralteter Schalter. Wenn web_search nicht gesetzt ist, wird true auf web_search = "cached" abgebildet. |
features.web_search_request |
boolean |
Veralteter Schalter. Wenn web_search nicht gesetzt ist, wird true auf web_search = "live" abgebildet. |
feedback.enabled |
boolean |
Aktiviert das Senden von Feedback über /feedback in allen lokalen Clients (Standard: true). |
file_opener |
vscode | vscode-insiders | windsurf | cursor | none |
URI-Schema zum Öffnen von Quellenverweisen aus der Codex-Ausgabe (Standard: vscode). |
forced_chatgpt_workspace_id |
string (uuid) |
Beschränkt ChatGPT-Anmeldungen auf eine bestimmte Arbeitsbereichskennung. |
forced_login_method |
chatgpt | api |
Beschränkt Codex auf eine bestimmte Authentifizierungsmethode. |
hide_agent_reasoning |
boolean |
Unterdrückt Reasoning-Ereignisse sowohl in der TUI als auch in der Ausgabe von codex exec. |
history.max_bytes |
number |
Begrenzt, falls gesetzt, die Größe der Verlaufsdatei in Bytes durch Entfernen der ältesten Einträge. |
history.persistence |
save-all | none |
Steuert, ob Codex Sitzungsprotokolle in history.jsonl speichert. |
hooks |
table |
Direkt in config.toml konfigurierte Lebenszyklus-Hooks. Verwendet dasselbe Ereignisschema wie hooks.json; Beispiele und unterstützte Ereignisse finden Sie in der Anleitung zu Hooks. |
hooks.<Event> |
array<table> |
Matcher-Gruppen für Hook-Ereignisse wie PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop oder Interrupt. |
hooks.<Event>[].hooks |
array<table> |
Hook-Handler für eine Matcher-Gruppe. Befehls- und MCP-Tool-Hooks werden unterstützt, während Prompt- und Agenten-Hook-Handler geparst, aber übersprungen werden. |
hooks.<Event>[].hooks[].additionalContextLimit |
integer |
Ungefährer Token-Schwellenwert pro Handler, ab dem übergroße additionalContext auf dem Datenträger gespeichert werden und dem Modell eine kürzere Vorschau angezeigt wird. Standardmäßig 2500; 0 übergibt den vollständigen Kontext direkt an das Modell. Siehe Große Hook-Ausgaben. |
hooks.<Event>[].hooks[].async |
boolean |
Führt einen Befehls-Hook im Hintergrund aus, ohne den auslösenden Vorgang zu verzögern. Standardmäßig false; SessionEnd wird immer synchron ausgeführt. Siehe Hooks im Hintergrund ausführen. |
hooks.<Event>[].hooks[].commandWindows |
string |
Befehlsüberschreibung für Befehls-Hooks ausschließlich unter Windows. Der TOML-Alias command_windows wird ebenfalls akzeptiert. |
instructions |
string |
Für zukünftige Verwendung reserviert; verwenden Sie vorzugsweise model_instructions_file oder AGENTS.md. |
log_dir |
string (path) |
Verzeichnis, in das Codex Protokolldateien schreibt; standardmäßig $CODEX_HOME/log. Wenn Sie diese Einstellung explizit setzen, wird auch das optionale TUI-Klartextprotokoll codex-tui.log in diesem Verzeichnis aktiviert. |
marketplaces.<name>.ref |
string |
Optionaler Git-Branch, -Tag oder -Commit für den Marktplatz. |
marketplaces.<name>.source |
string |
Speicherort des Git-Repositorys oder lokales Stammverzeichnis des Marktplatzes. Verwenden Sie für eine lokale Quelle einen absoluten Pfad; das Verzeichnis enthält .agents/plugins/marketplace.json. |
marketplaces.<name>.source_type |
git | local |
Quelltyp für einen konfigurierten Plugin-Marktplatz. Marktplätze können in der systemweiten, cloudverwalteten, benutzerspezifischen oder zu einem vertrauenswürdigen Projekt gehörenden config.toml definiert werden. |
marketplaces.<name>.sparse_paths |
array<string> |
Optionale Sparse-Checkout-Pfade für einen Git-Marktplatz. Nehmen Sie den Marktplatzkatalog und alle darin referenzierten lokalen Plugin-Verzeichnisse auf. |
mcp_oauth_callback_port |
integer |
Optionaler globaler fester Port für den lokalen HTTP-Callback-Server bei der MCP-OAuth-Anmeldung. Ein serverspezifischer Wert für oauth.callback_port hat Vorrang. Ist keiner der beiden Werte gesetzt, bindet Codex an einen vom Betriebssystem gewählten kurzlebigen Port. |
mcp_oauth_callback_url |
string |
Optionale Callback-Basis-URL für die MCP-OAuth-Anmeldung, etwa eine Devbox-Ingress-URL. Neu hinzugefügte vorab registrierte Clients verwenden diese URL unverändert, wenn der Autorisierungsserver die Identifizierung des Ausstellers unterstützt; bestehende Clients ohne gespeicherten Callback hängen eine serverspezifische Callback-ID an. Ohne Unterstützung für die Ausstelleridentifizierung greift jeder vorab registrierte MCP server, dessen konfigurierter Callback die erforderliche ID nicht enthält, auf diese URL mit angehängter ID zurück. Ports in Callback-URLs bestimmen nicht den Listener-Port. |
mcp_oauth_credentials_store |
auto | file | keyring |
Bevorzugter Speicher für MCP-OAuth-Anmeldedaten. |
mcp_optional_startup_grace_ms |
integer (milliseconds) |
Gemeinsame Wartezeit für optionale MCP server beim Aufbau des anfänglichen Tool-Katalogs. Standardmäßig 1000. Setzen Sie den Wert auf 0, um stattdessen für jeden Server dessen startup_timeout_sec abzuwarten. |
mcp_servers.<id>.args |
array<string> |
Argumente, die an den Befehl des STDIO MCP server übergeben werden. |
mcp_servers.<id>.auth |
oauth | chatgpt |
Authentifizierungsfallback für einen HTTP MCP server nach konfigurierten Bearer-Tokens und Authorization-Headern. oauth (Standard) verwendet gespeicherte MCP-OAuth-Anmeldedaten, sofern verfügbar. chatgpt verwendet die aktuelle ChatGPT-Sitzung für die vertrauenswürdige ChatGPT-Origin des Erstanbieters und greift anschließend auf gespeicherte OAuth-Anmeldedaten zurück. Beide Modi können eine Verbindung ohne Authentifizierung herstellen, wenn keine Anmeldedatenquelle verfügbar ist. |
mcp_servers.<id>.bearer_token_env_var |
string |
Umgebungsvariable, aus der das Bearer-Token für einen HTTP MCP server bezogen wird. |
mcp_servers.<id>.command |
string |
Startbefehl für einen STDIO MCP server. |
mcp_servers.<id>.cwd |
string |
Arbeitsverzeichnis für den Prozess des STDIO MCP server. |
mcp_servers.<id>.default_tools_approval_mode |
auto | prompt | writes | approve |
Standardmäßiges Genehmigungsverhalten für MCP-Tools auf diesem Server, sofern keine Überschreibung auf Tool-Ebene vorhanden ist. |
mcp_servers.<id>.disabled_tools |
array<string> |
Sperrliste, die für den MCP server nach enabled_tools angewendet wird. |
mcp_servers.<id>.enabled |
boolean |
Deaktiviert einen MCP server, ohne seine Konfiguration zu entfernen. |
mcp_servers.<id>.enabled_tools |
array<string> |
Zulassungsliste der vom MCP server bereitgestellten Tool-Namen. |
mcp_servers.<id>.env |
map<string,string> |
Umgebungsvariablen, die an den STDIO MCP server weitergegeben werden. |
mcp_servers.<id>.env_http_headers |
map<string,string> |
HTTP-Header für einen HTTP MCP server, deren Werte aus Umgebungsvariablen stammen. |
mcp_servers.<id>.env_vars |
array<string | { name = string, source = "local" | "remote" }> |
Zusätzliche Umgebungsvariablen, die für einen STDIO MCP server zugelassen werden sollen. Zeichenfolgeneinträge verwenden standardmäßig source = "local"; verwenden Sie source = "remote" nur mit Executor-gestütztem Remote-STDIO. |
mcp_servers.<id>.experimental_environment |
local | remote |
Experimenteller Ausführungsort für einen MCP server. remote startet STDIO-Server über eine Remote-Executor-Umgebung; die Remote-Ausführung mit Streamable HTTP ist nicht implementiert. |
mcp_servers.<id>.http_headers |
map<string,string> |
Statische HTTP-Header, die jeder MCP-HTTP-Anfrage beigefügt werden. |
mcp_servers.<id>.http_headers_helper |
string (command) |
Lokaler Befehl, der ein JSON-Objekt mit HTTP-Headernamen und -werten ausgibt. Wird nur für lokal verbundene HTTP MCP server unterstützt. Explizite Bearer-Tokens und OAuth-Anmeldedaten haben Vorrang vor Authorization-Headern, die der Hilfsbefehl bereitstellt. |
mcp_servers.<id>.oauth_resource |
string |
Optionaler OAuth-Ressourcenparameter gemäß RFC 8707, der bei der MCP-Anmeldung übermittelt wird. |
mcp_servers.<id>.oauth.callback_port |
integer |
Fester Listener-Port für den OAuth-Callback dieses MCP server. Überschreibt mcp_oauth_callback_port. Konfigurieren Sie bei einem direkten Loopback-Callback mit explizitem URL-Port denselben Listener-Port. |
mcp_servers.<id>.oauth.callback_url |
string |
Serverspezifischer OAuth-Callback. Vorab registrierte Clients verwenden ihn erneut, wenn die Identifizierung des Ausstellers unterstützt wird oder die URL bereits mit der serverspezifischen Callback-ID endet. Andernfalls verwendet Codex den globalen oder standardmäßigen Callback mit angehängter ID. Clients ohne vorab registrierte ID verwenden diesen Callback bei der Clientregistrierung. |
mcp_servers.<id>.oauth.client_id |
string |
Vorab registrierte OAuth-Client-ID für die Autorisierung und den Token-Austausch mit diesem MCP server. |
mcp_servers.<id>.required |
boolean |
Bei true schlägt der Start bzw. die Wiederaufnahme fehl, wenn dieser aktivierte MCP server nicht initialisiert werden kann. |
mcp_servers.<id>.scopes |
array<string> |
OAuth-Berechtigungsbereiche, die bei der Authentifizierung bei diesem MCP server angefordert werden. |
mcp_servers.<id>.startup_timeout_ms |
number |
Alias für startup_timeout_sec in Millisekunden. |
mcp_servers.<id>.startup_timeout_sec |
number |
Überschreibt das standardmäßige Startzeitlimit von 10 Sekunden für einen MCP server. |
mcp_servers.<id>.tool_timeout_sec |
number |
Überschreibt das standardmäßige Zeitlimit von 60 Sekunden pro Tool für einen MCP server. |
mcp_servers.<id>.tools.<tool>.approval_mode |
auto | prompt | writes | approve |
Überschreibung des Genehmigungsverhaltens für ein einzelnes MCP-Tool auf diesem Server. |
mcp_servers.<id>.tools.<tool>.output_token_limit |
integer (positive) |
Token-Budget für die Ausgabe eines einzelnen MCP-Tools vor dem standardmäßigen Serialisierungszuschlag von 20 %. Überschreibt das standardmäßige Budget des Modells für die Ausgabekürzung dieses Tools. |
mcp_servers.<id>.url |
string |
Endpunkt für einen MCP server mit Streamable HTTP. |
memories.consolidation_model |
string |
Optionale Modellüberschreibung für die globale Erinnerungskonsolidierung. |
memories.disable_on_external_context |
boolean |
Bei true werden Threads, die externen Kontext wie MCP-Tool-Aufrufe, Websuche oder Tool-Suche verwenden, von der Erinnerungsgenerierung ausgeschlossen. Standardmäßig false. Veralteter Alias: memories.no_memories_if_mcp_or_web_search. |
memories.extract_model |
string |
Optionale Modellüberschreibung für die Erinnerungsextraktion pro Thread. |
memories.generate_memories |
boolean |
Bei false werden neu erstellte Threads nicht als Eingaben für die Erinnerungsgenerierung gespeichert. Standardmäßig true. |
memories.max_raw_memories_for_consolidation |
number |
Maximale Anzahl neuerer Roherinnerungen, die für die globale Konsolidierung aufbewahrt werden. Standardmäßig 256, begrenzt auf 4096. |
memories.max_rollout_age_days |
number |
Maximales Alter von Threads, die für die Erinnerungsgenerierung berücksichtigt werden. Standardmäßig 30, begrenzt auf den Bereich 0-90. |
memories.max_rollouts_per_startup |
number |
Maximale Anzahl von Rollout-Kandidaten, die pro Startdurchlauf verarbeitet werden. Standardmäßig 16, begrenzt auf 128. |
memories.max_unused_days |
number |
Maximale Anzahl von Tagen seit der letzten Verwendung einer Erinnerung, bevor sie nicht mehr für die Konsolidierung infrage kommt. Standardmäßig 30, begrenzt auf den Bereich 0-365. |
memories.min_rate_limit_remaining_percent |
number |
Erforderlicher verbleibender Mindestprozentsatz in den Codex-Ratenlimitfenstern, bevor die Erinnerungsgenerierung beginnt. Standardmäßig 25, begrenzt auf den Bereich 0-100. |
memories.min_rollout_idle_hours |
number |
Minimale Inaktivitätsdauer, bevor ein Thread für die Erinnerungsgenerierung berücksichtigt wird. Standardmäßig 6, begrenzt auf den Bereich 1-48. |
memories.use_memories |
boolean |
Bei false fügt Codex keine vorhandenen Erinnerungen in zukünftige Sitzungen ein. Standardmäßig true. |
model |
string |
Zu verwendendes Modell (z. B. gpt-6.1-sol). |
model_auto_compact_token_limit |
number |
Token-Schwellenwert, der die automatische Verlaufskomprimierung auslöst (ohne Angabe gelten die Modellstandardwerte). |
model_auto_compact_token_limit_scope |
total | body_after_prefix |
Steuert, ob der Schwellenwert für die automatische Komprimierung den gesamten aktiven Kontext (total, Standard) oder nur den Zuwachs nach dem übernommenen Präfix des Komprimierungsfensters (body_after_prefix) berücksichtigt. |
model_catalog_json |
string (path) |
Optionaler Pfad zu einem JSON-Modellkatalog, der beim Start geladen wird. Eine ausgewählte $CODEX_HOME/profile-name.config.toml-Profildatei kann dies für das jeweilige Profil überschreiben. |
model_context_window |
number |
Anzahl der Tokens im Kontextfenster, die dem aktiven Modell zur Verfügung stehen. |
model_instructions_file |
string (path) |
Ersatz für integrierte Anweisungen anstelle von AGENTS.md. |
model_provider |
string |
Anbieter-ID aus model_providers (Standard: openai). |
model_providers.<id> |
table |
Benutzerdefinierte Anbieterdefinition. Integrierte Anbieter-IDs (openai, ollama und lmstudio) sind reserviert und können nicht überschrieben werden. |
model_providers.<id>.auth |
table |
Befehlsgestützte Bearer-Token-Konfiguration für einen benutzerdefinierten Anbieter. Kombinieren Sie sie nicht mit env_key, experimental_bearer_token oder requires_openai_auth. |
model_providers.<id>.auth.args |
array<string> |
Argumente, die an den Token-Befehl übergeben werden. |
model_providers.<id>.auth.command |
string |
Befehl, der ausgeführt wird, wenn Codex ein Bearer-Token benötigt. Der Befehl muss das Token auf stdout ausgeben. |
model_providers.<id>.auth.cwd |
string (path) |
Arbeitsverzeichnis für den Token-Befehl. |
model_providers.<id>.auth.refresh_interval_ms |
number |
Intervall in Millisekunden, in dem Codex das Token proaktiv aktualisiert (Standard: 300000). Setzen Sie den Wert auf 0, um es nur nach einem erneuten Authentifizierungsversuch zu aktualisieren. |
model_providers.<id>.auth.timeout_ms |
number |
Maximale Laufzeit des Token-Befehls in Millisekunden (Standard: 5000). |
model_providers.<id>.base_url |
string |
API-Basis-URL für den Modellanbieter. |
model_providers.<id>.env_http_headers |
map<string,string> |
HTTP-Header, deren Werte aus Umgebungsvariablen stammen, sofern diese vorhanden sind. |
model_providers.<id>.env_key |
string |
Umgebungsvariable, die den API key des Anbieters bereitstellt. |
model_providers.<id>.env_key_instructions |
string |
Optionale Einrichtungshinweise für den API key des Anbieters. |
model_providers.<id>.experimental_bearer_token |
string |
Direktes Bearer-Token für den Anbieter (nicht empfohlen; verwenden Sie env_key). |
model_providers.<id>.http_headers |
map<string,string> |
Statische HTTP-Header, die Anbieteranfragen hinzugefügt werden. |
model_providers.<id>.name |
string |
Anzeigename für einen benutzerdefinierten Modellanbieter. |
model_providers.<id>.query_params |
map<string,string> |
Zusätzliche Abfrageparameter, die an Anbieteranfragen angehängt werden. |
model_providers.<id>.request_max_retries |
number |
Anzahl der Wiederholungsversuche für HTTP-Anfragen an den Anbieter (Standard: 4). |
model_providers.<id>.requires_openai_auth |
boolean |
Der Anbieter verwendet die OpenAI-Authentifizierung (standardmäßig false). |
model_providers.<id>.stream_idle_timeout_ms |
number |
Inaktivitätszeitlimit für SSE-Streams in Millisekunden (Standard: 300000). |
model_providers.<id>.stream_max_retries |
number |
Anzahl der Wiederholungsversuche bei SSE-Streaming-Unterbrechungen (Standard: 5). |
model_providers.<id>.supports_standalone_web_search |
boolean |
Weist Unterstützung für einen kompatiblen eigenständigen Websuchendpunkt aus (Standard: false). Die eigenständige Suche befindet sich weiterhin in Entwicklung und ist standardmäßig deaktiviert; Anbieterkompatibilität allein aktiviert sie nicht. |
model_providers.<id>.supports_websockets |
boolean |
Gibt an, ob dieser Anbieter den WebSocket-Transport der Responses API unterstützt. |
model_providers.<id>.wire_api |
responses |
Vom Anbieter verwendetes Protokoll. responses ist der einzige unterstützte Wert und wird ohne Angabe als Standard verwendet. |
model_providers.amazon-bedrock.aws.profile |
string |
AWS-Profilname, den der integrierte Anbieter amazon-bedrock verwendet. |
model_providers.amazon-bedrock.aws.region |
string |
AWS-Region, die der integrierte Anbieter amazon-bedrock verwendet. |
model_reasoning_effort |
string |
Vom ausgewählten Modell unterstützter Reasoning-Aufwand, etwa low, medium, high, xhigh, max oder ultra. Verfügbare Stufen hängen vom Modell und vom Client ab. |
model_reasoning_summary |
auto | concise | detailed | none |
Wählt den Detailgrad von Reasoning-Zusammenfassungen oder deaktiviert Zusammenfassungen vollständig. |
model_supports_reasoning_summaries |
boolean |
Erzwingt, dass Codex Reasoning-Metadaten sendet oder nicht sendet. |
model_verbosity |
low | medium | high |
Optionale Überschreibung der Ausführlichkeit für die GPT-5 Responses API; ohne Angabe wird der Standardwert des ausgewählten Modells bzw. der ausgewählten Voreinstellung verwendet. |
notice.hide_full_access_warning |
boolean |
Erfasst die Bestätigung der Warnung vor Vollzugriff. |
notice.hide_gpt-5.1-codex-max_migration_prompt |
boolean |
Erfasst die Bestätigung des Hinweises zur gpt-5.1-codex-max-Migration. |
notice.hide_gpt5_1_migration_prompt |
boolean |
Erfasst die Bestätigung des Hinweises zur GPT-5.1-Migration. |
notice.hide_rate_limit_model_nudge |
boolean |
Erfasst die Deaktivierung der Erinnerung an einen Modellwechsel bei Erreichen des Ratenlimits. |
notice.hide_world_writable_warning |
boolean |
Erfasst die Bestätigung der Windows-Warnung zu allgemein beschreibbaren Verzeichnissen. |
notice.model_migrations |
map<string,string> |
Erfasst bestätigte Modellmigrationen als Zuordnungen von alt->neu. |
notify |
array<string> |
Befehl für Benachrichtigungen; erhält eine JSON-Nutzlast von Codex. |
openai_base_url |
string |
Überschreibung der Basis-URL für den integrierten Modellanbieter openai. |
oss_provider |
lmstudio | ollama |
Standardmäßiger lokaler Anbieter bei Ausführung mit --oss (ohne Angabe erfolgt standardmäßig eine Rückfrage). |
otel.environment |
string |
Umgebungstag für ausgegebene OpenTelemetry-Ereignisse (Standard: dev). |
otel.exporter |
none | otlp-http | otlp-grpc |
Wählt den OpenTelemetry-Exporter aus und legt gegebenenfalls Endpunktmetadaten fest. |
otel.exporter.<id>.endpoint |
string |
Exporter-Endpunkt für OTEL-Protokolle. |
otel.exporter.<id>.headers |
map<string,string> |
Statische Header für OTEL-Exporter-Anfragen. |
otel.exporter.<id>.protocol |
binary | json |
Vom OTLP/HTTP-Exporter verwendetes Protokoll. |
otel.exporter.<id>.tls.ca-certificate |
string |
Pfad zum CA-Zertifikat für TLS des OTEL-Exporters. |
otel.exporter.<id>.tls.client-certificate |
string |
Pfad zum Clientzertifikat für TLS des OTEL-Exporters. |
otel.exporter.<id>.tls.client-private-key |
string |
Pfad zum privaten Clientschlüssel für TLS des OTEL-Exporters. |
otel.log_user_prompt |
boolean |
Aktiviert den Export unverarbeiteter Benutzer-Prompts mit OpenTelemetry-Protokollen. |
otel.metrics_exporter |
none | statsig | otlp-http | otlp-grpc |
Wählt den OpenTelemetry-Metrikexporter aus (standardmäßig statsig). |
otel.trace_exporter |
none | otlp-http | otlp-grpc |
Wählt den OpenTelemetry-Trace-Exporter aus und legt gegebenenfalls Endpunktmetadaten fest. |
otel.trace_exporter.<id>.endpoint |
string |
Trace-Exporter-Endpunkt für OTEL-Protokolle. |
otel.trace_exporter.<id>.headers |
map<string,string> |
Statische Header für OTEL-Trace-Exporter-Anfragen. |
otel.trace_exporter.<id>.protocol |
binary | json |
Vom OTLP/HTTP-Trace-Exporter verwendetes Protokoll. |
otel.trace_exporter.<id>.tls.ca-certificate |
string |
Pfad zum CA-Zertifikat für TLS des OTEL-Trace-Exporters. |
otel.trace_exporter.<id>.tls.client-certificate |
string |
Pfad zum Clientzertifikat für TLS des OTEL-Trace-Exporters. |
otel.trace_exporter.<id>.tls.client-private-key |
string |
Pfad zum privaten Clientschlüssel für TLS des OTEL-Trace-Exporters. |
permissions.<name>.description |
string |
Menschenlesbare Beschreibung dieses benannten Profils. Ein Profil übernimmt die Beschreibung seines übergeordneten Profils nicht über extends. |
permissions.<name>.extends |
string |
Optionales übergeordnetes Profil, das vor diesem benannten Profil angewendet wird. Setzen Sie den Wert auf ein anderes benanntes Profil, :read-only oder :workspace; :danger-full-access, nicht definierte übergeordnete Profile und Zyklen werden abgelehnt. |
permissions.<name>.filesystem |
table |
Benanntes Dateisystem-Berechtigungsprofil. Jeder Schlüssel ist ein absoluter Pfad oder ein spezielles Token wie :minimal oder :workspace_roots. |
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob> |
"read" | "write" | "deny" |
Begrenzter Dateisystemzugriff relativ zu jedem wirksamen Arbeitsbereichsstammverzeichnis. Verwenden Sie "." für das Stammverzeichnis selbst; Glob-Unterpfade wie "**/*.env" können mit "deny" Lesezugriffe verweigern. |
permissions.<name>.filesystem.<path-or-glob> |
"read" | "write" | "deny" | table |
Gewährt direkten Zugriff für einen Pfad, ein Glob-Muster oder ein spezielles Token oder beschränkt verschachtelte Einträge auf dieses Stammverzeichnis. Verwenden Sie "deny", um Lesezugriffe auf übereinstimmende Pfade zu verweigern. |
permissions.<name>.filesystem.glob_scan_max_depth |
number |
Maximale Tiefe für die Auflösung von Glob-Mustern, die Lesezugriff verweigern, auf Plattformen, die vor dem Sandbox-Start einen Snapshot der Treffer erstellen. Muss, falls gesetzt, mindestens 1 betragen. |
permissions.<name>.network.allow_local_binding |
boolean |
Erlaubt umfassenderen Zugriff auf lokale und private Netzwerke über den Netzwerkzugriff der Sandbox. Zulassungsregeln für exakte lokale IP-Literale oder localhost können weiterhin bestimmte lokale Ziele erlauben, wenn dieser Wert auf false bleibt. |
permissions.<name>.network.allow_upstream_proxy |
boolean |
Erlaubt die Verkettung des Netzwerkzugriffs in der Sandbox über einen weiteren vorgeschalteten Proxy. |
permissions.<name>.network.dangerously_allow_all_unix_sockets |
boolean |
Erlaubt beliebige Unix-Socket-Ziele statt der standardmäßig eingeschränkten Menge. Verwenden Sie dies nur in streng kontrollierten Umgebungen. |
permissions.<name>.network.dangerously_allow_non_loopback_proxy |
boolean |
Erlaubt Bind-Adressen außerhalb von Loopback für Netzwerk-Listener der Sandbox. Die Aktivierung kann Listener über localhost hinaus zugänglich machen. |
permissions.<name>.network.domains |
table |
Domainregeln für Sandbox-Befehle. Sie werden nur durchgesetzt, wenn features.network_proxy oder aktivierte, administrativ verwaltete Netzwerkvorgaben den Proxy aktivieren. Unterstützt exakte Hosts, *.example.com, **.example.com und globale *-Zulassungsregeln; deny hat Vorrang. Schränkt weder Websuche noch Apps oder MCP server ein. |
permissions.<name>.network.domains.<pattern> |
allow | deny |
Erlaubt oder verweigert einen exakten Host oder ein begrenztes Platzhaltermuster wie *.example.com oder **.example.com. |
permissions.<name>.network.enable_socks5 |
boolean |
Stellt SOCKS5-Unterstützung bereit, wenn dieses Berechtigungsprofil Netzwerkzugriff in der Sandbox aktiviert. |
permissions.<name>.network.enable_socks5_udp |
boolean |
Erlaubt UDP über den SOCKS5-Listener, wenn dieser aktiviert ist. |
permissions.<name>.network.enabled |
boolean |
Aktiviert den Netzwerkzugriff für Befehle in diesem Berechtigungsprofil. Dadurch wird der Netzwerkproxy nicht gestartet. Ohne features.network_proxy oder aktivierte, administrativ verwaltete Netzwerkvorgaben erfolgt der Netzwerkzugriff von Befehlen direkt, und die Domainregeln des Profils werden nicht durchgesetzt. |
permissions.<name>.network.mode |
limited | full |
Netzwerkproxy-Modus für den Datenverkehr von Unterprozessen. |
permissions.<name>.network.proxy_url |
string |
HTTP-Listener-URL, die verwendet wird, wenn dieses Berechtigungsprofil Netzwerkzugriff in der Sandbox aktiviert. |
permissions.<name>.network.socks_url |
string |
SOCKS5-Proxy-Endpunkt dieses Berechtigungsprofils. |
permissions.<name>.network.unix_sockets |
table |
Überschreibungen der Unix-Socket-Zulassungsliste für Netzwerkzugriff in der Sandbox. Verwenden Sie Socket-Pfade als Schlüssel; allow fügt einen Pfad hinzu, deny lehnt ihn ab. |
permissions.<name>.network.unix_sockets.<path> |
allow | deny |
Fügt mit allow einen absoluten Unix-Socket-Pfad zur wirksamen Zulassungsliste hinzu oder lehnt ihn mit deny ab. Abgelehnte Einträge werden aus der wirksamen Zulassungsliste ausgeschlossen. |
permissions.<name>.workspace_roots |
table |
Im Profil definierte Arbeitsbereichsstammverzeichnisse, auf die neben den zur Laufzeit festgelegten Arbeitsbereichsstammverzeichnissen der Sitzung die Dateisystemregeln von :workspace_roots angewendet werden. |
permissions.<name>.workspace_roots.<path> |
boolean |
Nimmt einen Pfad bei true in die Menge der Arbeitsbereichsstammverzeichnisse des Profils auf. Deaktivierte Einträge bleiben inaktiv. |
personality |
none | friendly | pragmatic |
Standardkommunikationsstil für Modelle, die supportsPersonality unterstützen; kann pro Thread oder Turn oder über /personality überschrieben werden. |
plan_mode_reasoning_effort |
string |
Überschreibung des Reasoning-Aufwands speziell für den Planungsmodus mit einer vom ausgewählten Modell unterstützten Stufe. Ohne Angabe verwendet der Planungsmodus seinen integrierten Standardwert. |
plugins.<plugin>.enabled |
boolean |
Aktiviert oder deaktiviert ein Plugin aus einem lokalen Marktplatz über einen plugin-name@marketplace-name-Schlüssel. Wird aus der wirksamen zusammengeführten Konfiguration gelesen; Einstellungen vertrauenswürdiger Projekte können Benutzer-, cloudverwaltete und Systemstandardwerte überschreiben. Eine Marktplatzaktualisierung kann konfigurierte Plugins installieren oder aktualisieren, auch wenn sie deaktiviert sind. Dies überschreibt keine vom Arbeitsbereich verwalteten Aktivierungszustände. |
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode |
auto | prompt | writes | approve |
Standardmäßiges Genehmigungsverhalten für Tools auf einem von einem Plugin bereitgestellten MCP server. |
plugins.<plugin>.mcp_servers.<server>.disabled_tools |
array<string> |
Sperrliste, die nach enabled_tools auf einen von einem Plugin bereitgestellten MCP server angewendet wird. |
plugins.<plugin>.mcp_servers.<server>.enabled |
boolean |
Aktiviert oder deaktiviert einen mit einem installierten Plugin gebündelten MCP server, ohne das Plugin-Manifest zu ändern. |
plugins.<plugin>.mcp_servers.<server>.enabled_tools |
array<string> |
Zulassungsliste der Tools, die von einem durch ein Plugin bereitgestellten MCP server verfügbar gemacht werden. |
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode |
auto | prompt | writes | approve |
Überschreibung des Genehmigungsverhaltens für ein einzelnes von einem Plugin bereitgestelltes MCP-Tool. |
project_doc_fallback_filenames |
array<string> |
Zusätzliche Dateinamen, die geprüft werden, wenn AGENTS.md fehlt. |
project_doc_max_bytes |
number |
Maximale Anzahl von Bytes, die beim Erstellen der Projektanweisungen aus AGENTS.md gelesen werden. |
project_root_markers |
array<string> |
Liste von Dateinamen, die das Projektstammverzeichnis kennzeichnen; wird bei der Suche nach dem Projektstammverzeichnis in übergeordneten Verzeichnissen verwendet. |
projects.<path>.trust_level |
string |
Kennzeichnet ein Projekt oder einen Worktree als vertrauenswürdig oder nicht vertrauenswürdig ("trusted" | "untrusted"). Nicht vertrauenswürdige Projekte überspringen projektbezogene .codex/-Ebenen, einschließlich projektlokaler Konfiguration, Hooks und Regeln. |
review_model |
string |
Optionale Modellüberschreibung für /review (standardmäßig das Modell der aktuellen Sitzung). |
sandbox_mode |
read-only | workspace-write | danger-full-access |
Sandbox-Richtlinie für Dateisystem- und Netzwerkzugriff während der Befehlsausführung. |
sandbox_workspace_write.exclude_slash_tmp |
boolean |
Schließt /tmp im workspace-write-Modus von den beschreibbaren Stammverzeichnissen aus. |
sandbox_workspace_write.exclude_tmpdir_env_var |
boolean |
Schließt $TMPDIR im workspace-write-Modus von den beschreibbaren Stammverzeichnissen aus. |
sandbox_workspace_write.network_access |
boolean |
Erlaubt ausgehenden Netzwerkzugriff innerhalb der workspace-write-Sandbox. |
sandbox_workspace_write.writable_roots |
array<string> |
Zusätzliche beschreibbare Stammverzeichnisse bei sandbox_mode = "workspace-write". |
service_tier |
string |
Bevorzugte Servicestufe für neue Turns. Verwenden Sie fast oder eine andere vom aktiven Modell unterstützte Stufe; fast wird dem Anfragewert priority zugeordnet. |
shell_environment_policy.exclude |
array<string> |
Veraltete Ausschlussmuster für Umgebungsvariablen. Verwenden Sie shell_environment_policy.filters für neue Konfigurationen; kombinieren Sie nicht beide Formen in derselben Ebene. |
shell_environment_policy.experimental_use_profile |
boolean |
Verwendet beim Start von Unterprozessen das Shell-Profil des Benutzers. |
shell_environment_policy.filters |
map<string, include | exclude> |
Kanonische Musterfilter für Umgebungsvariablen ohne Unterscheidung zwischen Groß- und Kleinschreibung. Einschließende Einträge erstellen eine Zulassungsliste und können ausgeschlossene Werte nicht wiederherstellen. Explizite set-Werte werden nach den Ausschlüssen angewendet. Kombinieren Sie Filter nicht mit veralteten exclude- oder include_only-Arrays in derselben Ebene. |
shell_environment_policy.ignore_default_excludes |
boolean |
Behält Variablen mit KEY, SECRET oder TOKEN im Namen bei, bevor andere Filter ausgeführt werden (Standard: true). Setzen Sie den Wert auf false, um automatische Ausschlüsse anhand von Geheimnisnamen anzuwenden. |
shell_environment_policy.include_only |
array<string> |
Veraltete Zulassungsliste mit Mustern für Umgebungsvariablen. Verwenden Sie shell_environment_policy.filters für neue Konfigurationen; kombinieren Sie nicht beide Formen in derselben Ebene. |
shell_environment_policy.inherit |
all | core | none |
Grundlegende Vererbung der Umgebung beim Start von Unterprozessen. |
shell_environment_policy.set |
map<string,string> |
Explizite Umgebungswerte, die nach den Ausschlüssen eingefügt werden; einschließende Filter können sie weiterhin entfernen. |
show_raw_agent_reasoning |
boolean |
Zeigt unverarbeitete Reasoning-Inhalte an, wenn das aktive Modell sie ausgibt. |
skills.config |
array<object> |
In config.toml gespeicherte Überschreibungen des Aktivierungsstatus einzelner Skills. |
skills.config.<index>.enabled |
boolean |
Aktiviert oder deaktiviert den referenzierten Skill. |
skills.config.<index>.path |
string (path) |
Pfad zu einem Skill-Ordner mit SKILL.md. |
skills.max_context_tokens |
integer (positive) |
Token-Budget für den Katalog verfügbarer Skills. Standardmäßig 2 % des Kontextfensters des Modells. Explizite Werte sind auf 10000 Tokens begrenzt. |
sqlite_home |
string (path) |
Verzeichnis, in dem Codex die SQLite-basierte Zustandsdatenbank für Agentenaufträge und andere fortsetzbare Laufzeitzustände speichert. |
suppress_unstable_features_warning |
boolean |
Unterdrückt die Warnung, die bei aktivierten Funktionsschaltern für Funktionen in Entwicklung erscheint. |
tool_output_token_limit |
number |
Token-Budget für das Speichern einzelner Tool- und Funktionsausgaben im Verlauf. |
tool_suggest.disabled_tools |
array<table> |
Deaktiviert Vorschläge für bestimmte auffindbare Connectors oder Plugins. Jeder Eintrag verwendet type = "connector" oder "plugin" sowie eine id. |
tool_suggest.discoverables |
array<table> |
Erlaubt Tool-Vorschläge für weitere auffindbare Connectors oder Plugins. Jeder Eintrag verwendet type = "connector" oder "plugin" sowie eine id. |
tools.view_image |
boolean |
Aktiviert das Tool view_image zum Anhängen lokaler Bilder. |
tools.web_search |
boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } } |
Optionale Konfiguration des Websuchtools. In Objektform lassen sich die Größe des Suchkontexts, zulässige Suchdomains und der ungefähre Benutzerstandort festlegen. Diese Suchdomainfilter sind von den Netzwerk-Domainregeln für Sandbox-Befehle getrennt und schränken weder Connectors noch MCP server ein. |
tui |
table |
TUI-spezifische Optionen, etwa zum Aktivieren integrierter Desktop-Benachrichtigungen. |
tui.alternate_screen |
auto | always | never |
Steuert die Verwendung des alternativen Bildschirmpuffers für die TUI (Standard: auto; auto verzichtet in Zellij darauf, um den Scrollverlauf zu erhalten). |
tui.animations |
boolean |
Aktiviert Terminalanimationen (Willkommensbildschirm, Schimmereffekt, Ladeanimation) (Standard: true). |
tui.keymap.<context>.<action> |
string | array<string> |
Tastenkombination für eine TUI-Aktion. Unterstützte Kontexte sind global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list und approval. Bestimmte Aktionen des Eingabeeditors greifen auf passende tui.keymap.global-Belegungen zurück; kontextspezifische Belegungen haben Vorrang, sofern sie unterstützt werden. |
tui.keymap.<context>.<action> = [] |
empty array |
Hebt die Tastenbelegung der Aktion in diesem Tastaturbelegungskontext auf. Tastennamen verwenden normalisierte Zeichenfolgen wie ctrl-a, shift-enter, page-down oder minus. |
tui.model_availability_nux.<model> |
integer |
Interner Zustand der Starttooltips, zugeordnet über den Modell-Slug. |
tui.notification_condition |
unfocused | always |
Steuert, ob TUI-Benachrichtigungen nur bei nicht fokussiertem Terminal oder unabhängig vom Fokus ausgelöst werden. Standardmäßig unfocused. |
tui.notification_method |
auto | osc9 | bel |
Benachrichtigungsmethode für Terminalbenachrichtigungen (Standard: auto). |
tui.notifications |
boolean | array<string> |
Aktiviert TUI-Benachrichtigungen; optional auf bestimmte Ereignistypen beschränkt. |
tui.raw_output_mode |
boolean |
Startet die TUI im unverarbeiteten Scrollverlaufsmodus, um das Auswählen und Kopieren im Terminal zu erleichtern (Standard: false). Sie können ihn mit /raw oder der standardmäßigen Tastenkombination alt-r umschalten. |
tui.resume_cwd |
current | session |
Arbeitsverzeichnis beim Wiederaufnehmen oder Abzweigen einer Sitzung. Ohne Angabe fordert Codex Sie zur Auswahl auf, wenn Ihr aktuelles Verzeichnis vom gespeicherten Verzeichnis der Sitzung abweicht. |
tui.show_tooltips |
boolean |
Zeigt Einführungstooltips auf dem TUI-Willkommensbildschirm an (Standard: true). |
tui.status_line |
array<string> | null |
Geordnete Liste der Elementkennungen für die Statuszeile im TUI-Fußbereich. null deaktiviert die Statuszeile. |
tui.terminal_title |
array<string> | null |
Geordnete Liste der Elementkennungen für den Titel des Terminalfensters bzw. Tabs. Standardmäßig ["spinner", "project"]; null deaktiviert Titelaktualisierungen. |
tui.theme |
string |
Überschreibung des Designs für die Syntaxhervorhebung (Designname in kebab-case). |
tui.vim_mode_default |
boolean |
Startet den Eingabeeditor im Vim-Normalmodus statt im Einfügemodus (Standard: false). Sie können den Modus weiterhin pro Sitzung mit /vim umschalten. |
web_search |
disabled | cached | indexed | live |
Websuchmodus (Standard: "cached"; cached verwendet einen von OpenAI gepflegten Index ohne externen Webzugriff; indexed erlaubt externen Zugriff nur, wenn der Suchindex ihn freigibt; bei Verwendung von --yolo oder einer anderen Sandbox-Einstellung mit Vollzugriff gilt standardmäßig "live"). Verwenden Sie "live" für uneingeschränkten Live-Abruf oder "disabled", um das Tool zu entfernen. |
windows_wsl_setup_acknowledged |
boolean |
Erfasst die Bestätigung der Windows-Einführung (nur Windows). |
windows.sandbox |
unelevated | elevated | mxc |
Nativer Sandbox-Modus ausschließlich für die native Ausführung von Codex unter Windows. |
Keine passenden Konfigurationsoptionen.
Das aktuelle JSON-Schema für config.toml finden Sie hier.
Um beim Bearbeiten von config.toml in VS Code oder Cursor Autovervollständigung und Diagnosen zu erhalten, können Sie die Erweiterung Even Better TOML installieren und diese Zeile am Anfang Ihrer config.toml einfügen:
#:schema https://developers.openai.com/codex/config-schema.jsonHinweis: Benennen Sie experimental_instructions_file in model_instructions_file um. Codex stuft den alten Schlüssel als veraltet ein; aktualisieren Sie bestehende Konfigurationen auf den neuen Namen.
requirements.toml
requirements.toml ist eine administrativ erzwungene Konfigurationsdatei, die sicherheitsrelevante Einstellungen einschränkt, welche Benutzer nicht überschreiben können. Details, Speicherorte und Beispiele finden Sie unter Administrativ erzwungene Anforderungen.
Für Benutzer von ChatGPT Business und Enterprise kann Codex außerdem aus der Cloud abgerufene Anforderungen anwenden. Details zur Rangfolge finden Sie auf der Sicherheitsseite.
Verwenden Sie [features] in requirements.toml, um Laufzeit-Feature-Flags anhand derselben
kanonischen Schlüssel festzuschreiben, die config.toml verwendet. Anforderungen können auch dokumentierte,
nur für die App bestimmte Schlüssel enthalten, die nicht in config.toml gehören. Ausgelassene Schlüssel bleiben
uneingeschränkt.
Einige verwaltete Anforderungen erzwingen einen exakten Konfigurationswert anstelle einer Zulassungsliste. Benutzer können einen erzwungenen Pfad, eine Aktualisierungspräferenz, eine Login-Shell-Richtlinie, eine Feedback-Einstellung oder eine Einstellung für den privaten Windows-Desktop nicht überschreiben.
Verwaltete Zulassungslisten für Berechtigungsprofile erfordern Codex 0.138.0 oder höher. Codex
0.137.0 und frühere Versionen ignorieren allowed_permission_profiles und verwaltete
default_permissions.
Verwenden Sie allowed_sandbox_modes mit sandbox_mode. Für Berechtigungsprofil-Bereitstellungen verwenden Sie allowed_permission_profiles mit verwaltetem
default_permissions.
Ein untrusted-Eintrag in allowed_approval_policies ist weiterhin gültig für das
strengere Genehmigungsverhalten, das Codex ableitet, wenn ein Projekt
trust_level = "untrusted" verwendet. Er erlaubt es nicht, explizit
approval_policy = "untrusted" festzulegen.
Die Tabelle [models.new_thread] stellt verwaltete Standardwerte bereit, erzwingt sie jedoch nicht.
Wenn Sie das Modell oder den Reasoning-Aufwand explizit mit --model,
--config oder --profile überschreiben, ignoriert Codex sowohl model als auch
model_reasoning_effort in [models.new_thread]. service_tier ist davon unabhängig.
Die Browseranforderungen decken drei separate Oberflächen ab. in_app_browser
steuert den Browserbereich, den eine Person öffnet und direkt verwendet. browser_use
steuert agentengesteuerte Arbeit in einem Browser. computer_use steuert agentengesteuerte
Arbeit in nativen Desktop-Apps.
Die verschachtelten Richtlinienwerte für Browser Use und Computer Use gewähren nicht von
sich aus Zugriff. Ein ursprungs- oder app-spezifisches allow kann den Fallback für
dieselbe Richtlinienquelle außer Kraft setzen, aber die üblichen Funktions-, Genehmigungs- und sonstigen Richtlinienprüfungen
gelten weiterhin. Wenn sowohl verwaltete Anforderungen als auch config.toml gelten, setzt sich ein deny
aus einer der beiden Quellen durch.
| Schlüssel | Typ / Werte | Details |
|---|---|---|
additional_developer_instructions |
string |
Verwaltete Entwickleranweisungen, die als separate Entwicklernachricht hinzugefügt werden. Codex lehnt Anweisungen ab, die einschließlich Kontextmarkierungen ein Limit von schätzungsweise 10.000 Tokens überschreiten. |
allow_appshots |
boolean |
Setzen Sie den Wert auf false, um Appshots für verwaltete Benutzer zu deaktivieren. Fehlt die Einstellung, werden Appshots durch Vorgaben nicht eingeschränkt und unterliegen der normalen Produktverfügbarkeit. |
allow_browser_and_computer_use |
boolean |
Setzen Sie den Wert auf false, um sowohl agentengesteuertes Browser Use als auch Computer Use in nativen Apps zu blockieren. Der Wert true oder das Weglassen der Einstellung aktiviert keine der beiden Funktionen; die übrigen Funktions-, Richtlinien- und Genehmigungsprüfungen gelten weiterhin. |
allow_login_shell |
boolean |
Verbindlich festlegen, ob Shell-Tools eine Login-Shell starten dürfen. |
allow_managed_hooks_only |
boolean |
Bei true überspringt Codex Benutzer-, Projekt-, Sitzungs- und Plugin-Hooks, lässt jedoch verwaltete Hooks aus requirements.toml und anderen verwalteten Konfigurationsebenen weiterhin zu. |
allow_remote_control |
boolean |
Setzen Sie den Wert auf false, um die Gerätefernsteuerung für verwaltete Benutzer zu deaktivieren. Fehlt die Einstellung, wird die Gerätefernsteuerung durch Vorgaben nicht eingeschränkt und unterliegt der normalen Produktverfügbarkeit. |
allowed_approval_policies |
array<string> |
Zulässige Genehmigungsrichtlinien, etwa on-request, never und granular. Nehmen Sie untrusted auf, um die strengere Richtlinie zuzulassen, die aus einem nicht vertrauenswürdigen Projekt abgeleitet wird; sie kann nicht direkt mit approval_policy ausgewählt werden. |
allowed_approvals_reviewers |
array<string> |
Zulässige Werte für approvals_reviewer, etwa user und auto_review. |
allowed_chatgpt_workspaces |
array<string> |
Die ChatGPT-Anmeldung einschließlich Codex-Zugriffstokens auf die aufgeführten Workspace-IDs beschränken. Eine leere Liste deaktiviert die ChatGPT-Anmeldung; die API-Authentifizierung bleibt verfügbar, sofern sie zulässig ist. Wird über die lokale Datei mit Systemvorgaben oder macOS MDM festgelegt; in der Cloud verwaltete Werte werden ignoriert. |
allowed_login_methods |
array<string> |
chatgpt, api oder beides zulassen. Wenn diese Einstellung fehlt, schränkt sie die Anmeldemethoden nicht ein. Wenn sie gesetzt ist, muss die Liste mindestens eine Methode enthalten. api erlaubt die API-Authentifizierung, einschließlich Amazon Bedrock. Wird über die lokale Datei mit Systemvorgaben oder macOS MDM festgelegt. In der Cloud verwaltete Werte werden ignoriert. |
allowed_permission_profiles |
table<boolean> |
Vollständige Liste der zulässigen Berechtigungsprofile. Profile mit dem Wert true sind zulässig. Profile, die fehlen oder auf false gesetzt sind, werden abgelehnt, einschließlich Profilen, die in zukünftigen Versionen hinzukommen. Beim Zusammenführen von Vorgabenquellen werden Einträge anhand des Profilnamens zugeordnet. |
allowed_permission_profiles.<name> |
boolean |
Ein integriertes oder benutzerdefiniertes Berechtigungsprofil zulassen oder ablehnen, das in einer geladenen Konfiguration oder Vorgabenquelle definiert ist. Eine spätere Vorgabenquelle mit höherer Priorität kann mit false ein Profil deaktivieren, das eine frühere Quelle mit niedrigerer Priorität zugelassen hat. |
allowed_sandbox_modes |
array<string> |
Zulässige Werte für sandbox_mode. |
allowed_web_search_modes |
array<string> |
Zulässige Werte für web_search (disabled, cached, indexed, live). disabled ist immer zulässig; eine leere Liste lässt effektiv nur disabled zu. |
apps |
table |
Verwaltete App-Vorgaben mit der App-ID als Schlüssel. Vorgaben können eine App deaktivieren oder das Genehmigungsverhalten für einzelne Tools einschränken. |
apps.<id>.enabled |
boolean |
Setzen Sie den Wert auf false, um eine App zu deaktivieren. Eine deaktivierende Vorgabe bleibt beim Zusammenführen mehrerer Vorgabenquellen einschränkend wirksam. |
apps.<id>.tools.<tool>.approval_mode |
auto | prompt | writes | approve |
Den verwalteten Genehmigungsmodus für ein einzelnes App-Tool festlegen. |
auto_review |
table |
Verwaltete Vorgaben für die automatische Prüfung. |
auto_review.ignore_rules |
array<string> |
Vollständige Modell-Slugs, für die Codex allow-Präfixregeln in der Richtlinie zur Befehlsausführung ignoriert. Der Slug muss exakt übereinstimmen, einschließlich seines Anbieter-Namespace, sofern vorhanden; anders als required_on_models akzeptiert diese Einstellung keinen Alias ohne Namespace. Verbots- und Netzwerkregeln gelten weiterhin. |
auto_review.required_on_models |
array<string> |
Modell-Slugs, für die die automatische Prüfung verwendet werden muss. Slugs dürfen nicht leer sein, keine Anbieter-Namespaces enthalten und keine führenden oder nachgestellten Leerzeichen aufweisen. Listen aus mehreren Vorgabenquellen werden zusammengeführt. |
browser_use |
table |
Verwaltete Vorgaben für agentengesteuertes Browser Use. |
browser_use.allow_global_persistent_approval |
boolean |
Setzen Sie den Wert auf false, um zu verhindern, dass Browser Use Always allow-Genehmigungen erstellt oder berücksichtigt, die alle Websites abdecken, beispielsweise eine Erlaubnis für Downloads von beliebigen Websites. Vorhandene gespeicherte Genehmigungen werden ignoriert, nicht gelöscht. Der Wert true oder das Weglassen der Einstellung erstellt keine Genehmigung. |
browser_use.allow_history_access |
boolean |
Setzen Sie den Wert auf false, um zu verhindern, dass Browser Use den Browserverlauf liest. Der Wert true oder das Weglassen der Einstellung belässt die normalen Verlaufseinstellungen und Verfügbarkeitsprüfungen unverändert. |
browser_use.default_origin_policy |
table |
Fallback für jede Browser Use-Einstellung, wenn kein passender Eintrag unter browser_use.origins sie definiert. Eine passende Origin-Regel ersetzt den Fallback für diese Quelle. Codex wendet anschließend das strengere Ergebnis aus verwalteten Vorgaben und Benutzerkonfiguration an. |
browser_use.default_origin_policy.access |
allow | deny |
Verwenden Sie deny, um Browser Use für Origins zu blockieren, für die der Fallback gilt. Eine abgelehnte Origin blockiert dort auch Uploads, Downloads, vollständigen Browser-Debugging-Zugriff und die automatische Prüfung. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren. |
browser_use.default_origin_policy.access_approval_lifetime |
turn | thread |
Legen Sie fest, wie lange eine nicht dauerhafte Genehmigung für den Websitezugriff gilt: turn beschränkt sie auf den aktuellen Dialogschritt, und thread behält sie für den Rest des aktuellen Threads bei. persistent_approval steuert separat, ob Always allow verfügbar ist. Der Produktstandard ist thread. |
browser_use.default_origin_policy.auto_review |
allow | deny |
Verwenden Sie deny, um die automatische Prüfung für Origins zu überspringen, für die der Fallback gilt, und stattdessen den Benutzer um Genehmigung zu bitten. allow lässt die automatische Prüfung verfügbar, sofern andere Einstellungen sie zulassen. |
browser_use.default_origin_policy.downloads |
allow | deny |
Verwenden Sie deny, um Downloads über Browser Use für Origins zu blockieren, für die der Fallback gilt. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren. |
browser_use.default_origin_policy.full_cdp_access |
allow | deny |
Verwenden Sie deny, um den vollständigen Zugriff über das Chrome DevTools Protocol (CDP) für Origins zu blockieren, für die der Fallback gilt. allow lässt lediglich die normalen Opt-in- und Genehmigungsprüfungen fortfahren. |
browser_use.default_origin_policy.persistent_approval |
boolean |
Setzen Sie den Wert auf false, um zu verhindern, dass Browser Use eine Always allow-Genehmigung für Origins speichert oder berücksichtigt, für die der Fallback gilt. Genehmigungen für den aktuellen Dialogschritt oder Thread können weiterhin gelten. true macht Always allow verfügbar, sofern dies ansonsten zulässig ist, erstellt jedoch keine Genehmigung. |
browser_use.default_origin_policy.uploads |
allow | deny |
Verwenden Sie deny, um Uploads über Browser Use für Origins zu blockieren, für die der Fallback gilt. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren. |
browser_use.disable_auto_review |
boolean |
Setzen Sie den Wert auf true, um die automatische Prüfung für Browser Use zu überspringen und stattdessen den Benutzer um Genehmigung zu bitten. Der Wert false oder das Weglassen der Einstellung lässt die automatische Prüfung verfügbar, sofern andere Einstellungen sie zulassen. |
browser_use.origins |
map<string, table> |
Origin-spezifische Browser Use-Richtlinien. Schlüssel verwenden <scheme>://<host-pattern>[:<port>] mit http oder https. Verwenden Sie einen exakten Host, *.example.com nur für Subdomains oder **.example.com für die Basisdomain und ihre Subdomains. Andere *-Platzhalter können Punkte einschließen, sodass region*.example.com auch auf region.api.example.com zutrifft; ein Host mit dem Wert * trifft auf jeden Host für dieses Schema zu. Schemata und vom Standard abweichende Ports sind relevant; explizite Standardports werden bei der Normalisierung entfernt. Pfade, Abfragen, eingebettete Benutzernamen oder Passwörter sowie Platzhalter in Schemata oder Ports sind ungültig. Setzen Sie das Muster in TOML in Anführungszeichen, beispielsweise [browser_use.origins."https://**.example.com"]. |
browser_use.origins.<pattern> |
table |
Richtlinie für Origins, die diesem Muster entsprechen. Wenn mehrere Muster zutreffen, verwendet Codex für jede Funktion den restriktivsten Wert: deny vor allow, false vor true und turn vor thread. |
browser_use.origins.<pattern>.access |
allow | deny |
Verwenden Sie deny, um Browser Use für passende Origins zu blockieren. Die Ablehnung blockiert dort auch Uploads, Downloads, vollständigen Browser-Debugging-Zugriff und die automatische Prüfung. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren. |
browser_use.origins.<pattern>.access_approval_lifetime |
turn | thread |
Legen Sie fest, wie lange eine nicht dauerhafte Genehmigung für den Websitezugriff auf passende Origins gilt: turn beschränkt sie auf den aktuellen Dialogschritt, und thread behält sie für den Rest des aktuellen Threads bei. persistent_approval steuert separat, ob Always allow verfügbar ist. |
browser_use.origins.<pattern>.auto_review |
allow | deny |
Verwenden Sie deny, um die automatische Prüfung für passende Origins zu überspringen und stattdessen den Benutzer um Genehmigung zu bitten. allow lässt die automatische Prüfung verfügbar, sofern andere Einstellungen sie zulassen. |
browser_use.origins.<pattern>.downloads |
allow | deny |
Verwenden Sie deny, um Downloads über Browser Use für passende Origins zu blockieren. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren. |
browser_use.origins.<pattern>.full_cdp_access |
allow | deny |
Verwenden Sie deny, um den vollständigen Zugriff über das Chrome DevTools Protocol (CDP) für passende Origins zu blockieren. allow lässt lediglich die normalen Opt-in- und Genehmigungsprüfungen fortfahren. |
browser_use.origins.<pattern>.persistent_approval |
boolean |
Setzen Sie den Wert auf false, um zu verhindern, dass Browser Use eine Always allow-Genehmigung für passende Origins speichert oder berücksichtigt. Genehmigungen für den aktuellen Dialogschritt oder Thread können weiterhin gelten. true macht Always allow verfügbar, sofern dies ansonsten zulässig ist, erstellt jedoch keine Genehmigung. |
browser_use.origins.<pattern>.uploads |
allow | deny |
Verwenden Sie deny, um Uploads über Browser Use für passende Origins zu blockieren. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren. |
chatgpt_base_url |
string |
Die Basis-URL des ChatGPT-Dienstes vor der Authentifizierung und dem Abruf der Cloud-Richtlinien verbindlich festlegen. Dies konfiguriert nicht alle Netzwerkziele von Codex. Wird über die lokale Datei mit Systemvorgaben oder macOS MDM festgelegt; in der Cloud verwaltete Werte werden ignoriert. |
check_for_update_on_startup |
boolean |
Verbindlich festlegen, ob Codex beim Start nach Updates sucht. |
cli_auth_credentials_store |
file | keyring | auto | ephemeral |
Den CLI-Anmeldedatenspeicher verbindlich festlegen, bevor die Authentifizierung geladen wird. file verwendet CODEX_HOME/auth.json; keyring erfordert den Anmeldedatenspeicher des Betriebssystems; auto greift auf eine Datei zurück, wenn der Anmeldedatenspeicher nicht verfügbar ist; ephemeral hält Anmeldedaten für den aktuellen Prozess im Arbeitsspeicher. Wird über die lokale Datei mit Systemvorgaben oder macOS MDM festgelegt; in der Cloud verwaltete Werte werden ignoriert. |
computer_use |
table |
Verwaltete Vorgaben für agentengesteuerte Arbeit in nativen Desktop-Apps. Sowohl verwaltete App-Regeln als auch App-Regeln aus config.toml werden durchgesetzt; eine App muss von jeder Richtlinienquelle zugelassen werden. |
computer_use.allow_locked_computer_use |
boolean |
Setzen Sie den Wert auf false, um zu verhindern, dass Benutzer Locked Use auf einem verwalteten macOS-Gerät aktivieren. Diese Vorgabe entfernt die Steuerelemente zur Aktivierung; sie deaktiviert Locked Use nicht, wenn es bereits aktiviert ist. Fehlt die Einstellung, gilt die normale Produktverfügbarkeit. |
computer_use.allow_persistent_approval |
boolean |
Setzen Sie den Wert auf false, um die Option zum sitzungsübergreifenden Speichern von App-Genehmigungen zu entfernen. Genehmigungen für die aktuelle Sitzung bleiben verfügbar. Der Wert true oder das Weglassen der Einstellung genehmigt keine App. |
computer_use.default_app_access |
allow | deny |
Fallback-Zugriff für native Apps, auf die keine plattformspezifische Regel zutrifft. deny blockiert den Zugriff. allow lässt lediglich die normalen Genehmigungs- und Richtlinienprüfungen fortfahren. Der Produktstandard ist allow. |
computer_use.macos |
table |
Computer Use-App-Regeln für macOS. |
computer_use.macos.bundle_ids |
map<string, allow | deny> |
Exakte macOS-Bundle-IDs allow oder deny zuordnen. Eine passende Regel ersetzt computer_use.default_app_access innerhalb derselben Richtlinienquelle. Eine Ablehnung durch verwaltete Vorgaben oder die Benutzerkonfiguration blockiert den Zugriff weiterhin. |
computer_use.macos.bundle_ids.<bundle-id> |
allow | deny |
Verwenden Sie deny, um die exakte Bundle-ID zu blockieren. allow überschreibt nur den Standardwert dieser Richtlinienquelle und erfordert weiterhin, dass jede andere Richtlinienquelle und der normale Genehmigungsablauf die App zulassen. |
computer_use.windows |
table |
Computer Use-App-Regeln für paketierte und nicht paketierte Windows-Apps. |
computer_use.windows.aumids |
map<string, allow | deny> |
Exakte, registrierte Application User Model IDs (AUMIDs) für signierte paketierte Apps allow oder deny zuordnen. Eine passende Regel ersetzt computer_use.default_app_access innerhalb derselben Richtlinienquelle. |
computer_use.windows.aumids.<aumid> |
allow | deny |
Verwenden Sie deny, um die exakte Identität der paketierten App zu blockieren. allow überschreibt nur den Standardwert dieser Richtlinienquelle und erfordert weiterhin, dass jede andere Richtlinienquelle und der normale Genehmigungsablauf die App zulassen. |
computer_use.windows.exes |
array<table> |
Regeln für signierte, nicht paketierte ausführbare Windows-Dateien. Regeln gleichen den verifizierten Herausgeber und die signierten Versionsinformationen der ausführbaren Datei ab, nicht ihren Pfad oder aktuellen Dateinamen. Eine passende Ablehnung hat Vorrang vor passenden Erlaubnissen. Nicht signierte ausführbare Dateien verwenden computer_use.default_app_access; ausführbare Dateien, deren signierte Identität nicht eindeutig verifiziert werden kann, werden blockiert. |
computer_use.windows.exes[].access |
allow | deny |
Erforderliche Zugriffsentscheidung für passende ausführbare Dateien. deny blockiert den Zugriff. allow überschreibt nur den Standardwert dieser Richtlinienquelle und erfordert weiterhin, dass jede andere Richtlinienquelle und der normale Genehmigungsablauf die App zulassen. |
computer_use.windows.exes[].binary_name |
string |
Optionaler Wert für OriginalFilename aus den signierten Versionsinformationen der ausführbaren Datei. Der Abgleich unterscheidet nicht zwischen Groß- und Kleinschreibung. Wenn eine passende Herausgeber- und Produktregel diesen Wert erfordert, die ausführbare Datei ihn aber nicht bereitstellt, blockiert Computer Use die ausführbare Datei. |
computer_use.windows.exes[].product_name |
string |
Erforderlicher exakter Wert für ProductName aus den signierten Versionsinformationen der ausführbaren Datei. |
computer_use.windows.exes[].publisher_name |
string |
Erforderlicher exakter Herausgebername aus dem vertrauenswürdigen Signaturzertifikat der ausführbaren Datei, formatiert als Windows-X.500-Distinguished-Name. |
default_permissions |
string |
Verwaltetes Standardberechtigungsprofil. Das Profil muss durch allowed_permission_profiles zugelassen sein. Legen Sie dies explizit fest, um ein vorhersehbares Verhalten zu gewährleisten; fehlt die Einstellung, verwendet Codex nur dann standardmäßig :workspace, wenn sowohl :workspace als auch :read-only explizit zugelassen sind. |
enforce_residency |
string |
Für den Codex-Dienstverkehr eine unterstützte Datenresidenz vorschreiben. Akzeptiert derzeit us. |
experimental_network |
table |
Vom Administrator verwaltete Netzwerkvorgaben für lokale Befehle in der Sandbox, die aus requirements.toml durchgesetzt werden. Wenn diese Vorgaben aktiviert sind, können sie den Netzwerkproxy für Befehle ohne features.network_proxy starten. Browser-Tools prüfen verwaltete Netzwerkverbote und exklusive Positivlisten separat. Diese Vorgaben leiten weder Browserdatenverkehr durch den Proxy noch steuern sie Websuche, Apps, MCP server, Datenverkehr nativer Apps oder anderen funktionsspezifischen Datenverkehr. Auf unterstützten verwalteten Codex Cloud-Ausführungspfaden beschränken diese Vorgaben den Netzwerkzugriff von Befehlen zusammen mit separaten Interneteinstellungen der Cloud-Umgebung. Eine genehmigte vollständige Sandbox-Eskalation kann den Befehlsproxy umgehen, sofern die Richtlinie dies zulässt. Work Cloud übernimmt diese Vorgaben nicht. |
experimental_network.allow_local_binding |
boolean |
Umfassenderen Zugriff auf lokale/private Netzwerke aus der Sandbox zulassen. Auf dem unterstützten Codex Cloud-Proxy-Pfad kann ein expliziter falscher Wert den Zugriff über einen vorgeschalteten Proxy verhindern, selbst wenn eine Domain zugelassen ist. Der Standardwert ist nur dann wahr, wenn keine anwendbare Vorgabe, kein ausgewähltes Netzwerkprofil und keine Proxy-Funktionseinstellung einen Wert vorgibt. Ein geerbter falscher Wert bleibt explizit. Eine unterstützte Cloud-Überschreibung mit höherer Priorität kann ihn ändern, ohne Global für Local zu erweitern oder Domain-Erlaubniseinträge hinzuzufügen. Prüfen Sie die Unterstützung durch die Ausführungskomponente. Wenden Sie diesen Cloud-Standardwert nicht auf Local an. |
experimental_network.allow_upstream_proxy |
boolean |
Zulassen, dass Sandbox-Netzwerkverbindungen über einen vorgeschalteten Proxy aus der Umgebung weitergeleitet werden. |
experimental_network.allowed_domains |
array<string> |
Administrator-Erlaubnisregeln für den Netzwerkzugriff von Sandbox-Befehlen, während der verwaltete Netzwerkproxy aktiviert ist. Diese Regeln gelten nicht für Websuche, Apps oder MCP server. Kombinieren Sie dies nicht mit experimental_network.domains. |
experimental_network.dangerously_allow_all_unix_sockets |
boolean |
Beliebige Unix-Socket-Ziele statt ausschließlich Zugriff gemäß Positivliste zulassen. Nur in streng kontrollierten Umgebungen verwenden. |
experimental_network.dangerously_allow_non_loopback_proxy |
boolean |
Listener-Adressen außerhalb von Loopback für [experimental_network]-Vorgaben zulassen. Die Aktivierung kann Listener über localhost hinaus erreichbar machen. |
experimental_network.denied_domains |
array<string> |
Als Liste strukturierte Administrator-Verbotsregeln für den Netzwerkzugriff in der Sandbox. Kombinieren Sie dies nicht mit experimental_network.domains. |
experimental_network.domains |
map<string, allow | deny> |
Als Zuordnung strukturierte Administrator-Domainrichtlinie für den Netzwerkzugriff in der Sandbox. Unterstützt exakte Hosts, *.example.com nur für Subdomains, **.example.com für die Basisdomain samt Subdomains sowie globale *-Erlaubnisregeln. Bevorzugen Sie eingegrenzte Regeln, da * ausgehenden Zugriff auf öffentliche Ziele weitgehend öffnet. Umgebungsregeln können denselben Domain-Schlüssel aus Global innerhalb einer Richtlinie ersetzen. Werte mit höherer Priorität ersetzen denselben Schlüssel, während andere geerbte Schlüssel erhalten bleiben. Nach dem Zusammenführen blockiert ein anderes zutreffendes deny, einschließlich eines geerbten Platzhalters, eine Anfrage weiterhin. Leere Umgebungszuordnungen löschen keine Global-Regeln. Prüfen Sie die Unterstützung durch die Ausführungskomponente. Kombinieren Sie dies nicht mit experimental_network.allowed_domains oder experimental_network.denied_domains. |
experimental_network.domains.<pattern> |
allow | deny |
Netzwerkzugriff aus der Sandbox für das passende Domainmuster zulassen oder ablehnen. Eine Verbotsregel hat Vorrang, wenn mehrere Muster zutreffen. |
experimental_network.enabled |
boolean |
Netzwerkvorgaben für die Sandbox aktivieren. Dies gewährt keinen Netzwerkzugriff, wenn die aktive Sandbox den Netzwerkzugriff für Befehle deaktiviert hält. |
experimental_network.http_port |
integer |
Port des Loopback-HTTP-Listeners für [experimental_network]-Vorgaben. |
experimental_network.managed_allowed_domains_only |
boolean |
Wenn Netzwerkvorgaben aktiviert sind und dieser Wert wahr ist, können die normale Benutzerkonfiguration und domainspezifische Genehmigungen die verwaltete Proxy-Positivliste nicht erweitern. Ohne wirksame konfigurierte oder geerbte Erlaubniseinträge haben normale verwaltete Befehle keine zulässigen Ziele. Eine reine Verbotsrichtlinie erlaubt nicht den Zugriff auf das übrige Internet. Dies deckt nicht jedes Tool oder eine genehmigte vollständige Sandbox-Eskalation ab. |
experimental_network.socks_port |
integer |
Port des Loopback-SOCKS5-Listeners für [experimental_network]-Vorgaben. |
experimental_network.unix_sockets |
map<string, allow | deny> |
Vom Administrator verwaltete Unix-Socket-Positivliste für den Netzwerkzugriff in der Sandbox unter macOS. Pfade müssen absolut sein. |
experimental_network.unix_sockets.<path> |
allow | deny |
Unter macOS fügt allow einen absoluten Unix-Socket-Pfad zur Positivliste hinzu; deny lässt ihn aus. Ein deny-Eintrag kann einen Socket nicht blockieren, wenn die Option zum Zulassen aller Unix-Sockets aktiviert ist. |
features |
table |
Verbindlich festgelegte Funktionswerte. Verwenden Sie für Laufzeitfunktionen die kanonischen Namen aus config.toml; dokumentierte Vorgabenschlüssel, die nur für die App gelten, werden hier ebenfalls unterstützt. |
features.<name> |
boolean |
Vorschreiben, dass eine dokumentierte Laufzeit- oder App-Funktion aktiviert oder deaktiviert bleibt. |
features.apps |
boolean |
Die Verfügbarkeit der Apps-Integration für verwaltete Benutzer verbindlich aktivieren oder deaktivieren. |
features.browser_use |
boolean |
Setzen Sie den Wert in requirements.toml auf false, um agentengesteuertes Browser Use zu deaktivieren. |
features.browser_use_external |
boolean |
Setzen Sie den Wert in requirements.toml auf false, um zu verhindern, dass Codex unterstützte Browser über die ChatGPT-Browsererweiterung bedient, einschließlich vorhandener Tabs und angemeldeter Sitzungen. |
features.browser_use_full_cdp_access |
boolean |
Setzen Sie den Wert in requirements.toml auf false, um den vollständigen Zugriff über das Chrome DevTools Protocol in der lokalen Laufzeit einschließlich des Browser Developer mode zu deaktivieren und zu verhindern, dass die ChatGPT-Desktop-App die entsprechende Einstellung aktiviert. Fehlt die Einstellung, gilt die normale Produktverfügbarkeit. |
features.computer_use |
boolean |
Setzen Sie den Wert in requirements.toml auf false, um Computer Use, Record & Replay sowie zugehörige Installations- oder Aktivierungsabläufe zu deaktivieren. |
features.fast_mode |
boolean |
Die kanonische Funktion fast_mode für verwaltete Benutzer verbindlich aktivieren oder deaktivieren. |
features.guardian_approval |
boolean |
Die Verfügbarkeit von Guardian-Genehmigungen für verwaltete Benutzer verbindlich aktivieren oder deaktivieren. |
features.in_app_browser |
boolean |
Setzen Sie den Wert in requirements.toml auf false, um den integrierten Browserbereich zu deaktivieren, den Benutzer direkt öffnen und steuern. |
features.in_app_chat |
boolean |
Setzen Sie den Wert auf false, um die Ansichten für ChatGPT- und ChatGPT Work-Unterhaltungen sowie die zugehörige Oberfläche für Cloud-Automatisierungen in der ChatGPT-Desktop-App auszublenden. Diese Einstellung blockiert weder ChatGPT Voice noch beendet sie bestehende Cloud-Aufgaben. Der Wert true umgeht keine Konto-, Workspace-Berechtigungs- oder Rollout-Prüfungen. |
features.in_app_dictation |
boolean |
Setzen Sie den Wert auf false, um die integrierte Diktierfunktion der Desktop-App zu deaktivieren. Der Wert true umgeht keine anderen Verfügbarkeitsprüfungen. |
features.in_app_local_automation |
boolean |
Setzen Sie den Wert auf false, um lokale geplante Aufgaben in der Desktop-App zu deaktivieren. Der Wert true umgeht keine anderen Verfügbarkeitsprüfungen. |
features.in_app_updates |
boolean |
Setzen Sie den Wert in requirements.toml auf false, um In-App-Updates zu deaktivieren. Updates bleiben standardmäßig aktiviert, wenn diese Vorgabe fehlt. |
features.memories |
boolean |
Die Verfügbarkeit von Memories für verwaltete Benutzer verbindlich aktivieren oder deaktivieren. |
features.multi_agent |
boolean |
Die Verfügbarkeit der Multi-Agent-Funktion für verwaltete Benutzer verbindlich aktivieren oder deaktivieren. |
features.plugin_sharing |
boolean |
Setzen Sie den Wert in cloudverwaltetem requirements.toml auf false, um die Workspace-Freigabe für lokal erstellte Plugins zu deaktivieren. |
features.plugins |
boolean |
Die Verfügbarkeit von Plugins für verwaltete Benutzer verbindlich aktivieren oder deaktivieren. |
features.realtime_conversation |
boolean |
Setzen Sie den Wert auf false, um den experimentellen Befehl /voice in der Codex CLI zu deaktivieren. Verlassen Sie sich nicht auf diese Einstellung, um ChatGPT Voice in der Desktop-App oder Sprachsitzungen über app-server zu blockieren. Der Wert true umgeht keine Client- oder Rollout-Prüfungen. |
features.remote_plugin |
boolean |
Die Verfügbarkeit des Remote-Plugin-Katalogs für verwaltete Benutzer verbindlich aktivieren oder deaktivieren. |
features.workspace_dependencies |
boolean |
Die Verfügbarkeit der mitgelieferten Laufzeit für Workspace-Abhängigkeiten für verwaltete Benutzer verbindlich aktivieren oder deaktivieren. |
feedback |
table |
Verwaltete Feedback-Einstellungen. |
feedback.enabled |
boolean |
Verbindlich festlegen, ob Benutzer in den Codex-Clients Feedback senden können. |
guardian_extra_policy |
string |
Zusätzliche verwaltete Markdown-Richtlinie für die automatische Prüfung, die zusammen mit der Hauptrichtlinie einbezogen wird. Diese hat Vorrang vor lokalem [auto_review].extra_policy. Leere Werte werden ignoriert. |
guardian_policy_config |
string |
Verwaltete Richtlinienanweisungen in Markdown für die automatische Prüfung. Diese haben Vorrang vor lokalem [auto_review].policy. Leere Werte werden ignoriert. |
hooks |
table |
Vom Administrator erzwungene verwaltete Lebenszyklus-Hooks. Erfordert ein Verzeichnis für verwaltete Hooks und verwendet dasselbe Ereignisschema wie inline definiertes [hooks] in config.toml. |
hooks.<Event> |
array<table> |
Matcher-Gruppen für ein Hook-Ereignis wie PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit oder Stop. |
hooks.<Event>[].hooks |
array<table> |
Hook-Handler für eine Matcher-Gruppe. Befehls- und MCP-Tool-Hooks werden unterstützt, während Prompt- und Agent-Hook-Handler geparst, aber übersprungen werden. |
hooks.<Event>[].hooks[].additionalContextLimit |
integer |
Ungefährer Token-Schwellenwert pro Handler, ab dem übergroßes additionalContext auf der Festplatte gespeichert und dem Modell eine kürzere Vorschau angezeigt wird. Standardwert ist 2500; 0 übergibt den vollständigen Kontext direkt an das Modell. Siehe Umfangreiche Hook-Ausgaben. |
hooks.<Event>[].hooks[].async |
boolean |
Einen Befehls-Hook im Hintergrund ausführen, ohne den auslösenden Vorgang zu verzögern. Standardwert ist false; SessionEnd wird immer synchron ausgeführt. Siehe Hooks im Hintergrund ausführen. |
hooks.<Event>[].hooks[].commandWindows |
string |
Befehlsüberschreibung für Befehls-Hooks, die nur unter Windows gilt. Der TOML-Alias command_windows wird ebenfalls akzeptiert. |
hooks.managed_dir |
string (absolute path) |
Verzeichnis mit verwalteten Hook-Skripten unter macOS und Linux. Codex prüft vor dem Laden verwalteter Hooks, ob der Pfad absolut ist und das Verzeichnis existiert. |
hooks.windows_managed_dir |
string (absolute path) |
Verzeichnis mit verwalteten Hook-Skripten unter Windows. Codex prüft vor dem Laden verwalteter Hooks, ob der Pfad absolut ist und das Verzeichnis existiert. |
in_app_browser |
table |
Vorgaben für den integrierten Browserbereich. Diese Einstellungen steuern nicht das agentengesteuerte Browser Use. |
in_app_browser.allow_external_browser_settings_import |
boolean |
Setzen Sie den Wert auf false, um zu verhindern, dass Benutzer Einstellungen oder Browserdaten aus einem externen Browser in den integrierten Browser importieren. Der Wert true oder das Weglassen der Einstellung lässt den Import verfügbar, sofern andere Produktprüfungen ihn zulassen. Dies ist eine ausschließlich verwaltete Einstellung ohne Überschreibung durch config.toml. |
log_dir |
string (path) |
Verzeichnis verbindlich festlegen, in das Codex lokale Protokolldateien schreibt. |
marketplaces |
table |
Administratorvorgaben für Plugin-Marktplatzquellen. Regeln werden wirksam, wenn restrict_to_allowed_sources den Wert true hat. |
marketplaces.allowed_sources |
table |
Zulässige Marktplatzquellen mit vom Administrator gewählten Regelnamen als Schlüssel. Unterschiedliche Namen werden über Vorgabenebenen hinweg zusammengeführt; für Felder unter demselben Namen gilt die normale Ebenenpriorität. |
marketplaces.allowed_sources.<name> |
table |
Eine Regel für eine zulässige Quelle. Der endgültige Wert von source nach dem Zusammenführen der Vorgaben bestimmt, welche Felder derselben Ebene Codex interpretiert. |
marketplaces.allowed_sources.<name>.host_pattern |
string |
Regulärer Ausdruck, der bei source = "host_pattern" erforderlich ist. Codex gleicht ihn mit dem in Kleinbuchstaben umgewandelten Hostnamen ab, der aus einer Git-Quelle im HTTPS-, SSH- oder SCP-Stil ausgelesen wurde. Verwenden Sie ^ und $, um eine Übereinstimmung mit dem gesamten Hostnamen zu verlangen. |
marketplaces.allowed_sources.<name>.path |
string (absolute path) |
Lokales Marktplatzverzeichnis, das bei source = "local" erforderlich ist. Codex verlangt einen absoluten Pfad und vergleicht Pfade nach der Normalisierung. |
marketplaces.allowed_sources.<name>.ref |
string |
Optionale exakte Git-Referenz für eine git-Regel. Fehlt sie, erlaubt die Regel jede Referenz für das passende Repository. |
marketplaces.allowed_sources.<name>.source |
git | host_pattern | local |
Matcher-Typ für die Marktplatzquelle. Verwenden Sie git für ein einzelnes Repository, host_pattern für Git-Hosts, die anhand eines regulären Ausdrucks abgeglichen werden, oder local für ein einzelnes Verzeichnis. |
marketplaces.allowed_sources.<name>.url |
string |
Git-Repository-URL, die bei source = "git" erforderlich ist. Codex normalisiert die konfigurierten und zulässigen URLs, bevor es eine exakte Repository-Übereinstimmung verlangt. |
marketplaces.restrict_to_allowed_sources |
boolean |
Bei true müssen konfigurierte Marktplatzquellen beim Hinzufügen von Marktplätzen, Installieren von Plugins, Aktualisieren und Laden zur Laufzeit mit allowed_sources übereinstimmen. Von OpenAI kuratierte Git-Kataloge, einschließlich des API key-Katalogs, müssen ebenfalls mit der Positivliste übereinstimmen. Gebündelte und remote installierte Workspace-Plugins sind von dieser Richtlinie für kuratierte Git-Quellen getrennt. |
mcp_servers |
table |
Positivliste der MCP server, die aktiviert werden dürfen. Sowohl der Servername (<id>) als auch seine Identität müssen übereinstimmen, damit der MCP server aktiviert werden kann. Jeder konfigurierte MCP server, der nicht in der Positivliste enthalten ist oder dessen Identität abweicht, wird deaktiviert. |
mcp_servers.<id>.identity |
table |
Identitätsregel für einen einzelnen MCP server. Setzen Sie entweder command (stdio) oder url (streamable HTTP). |
mcp_servers.<id>.identity.command |
string | table |
Einen stdio MCP server anhand einer exakten Befehlszeichenfolge zulassen oder mit einer Matcher-Tabelle eine exakte ausführbare Datei und geordnete Argument-Matcher vorschreiben. Die Zeichenfolgenform prüft weder Argumente noch cwd, env oder env_vars. |
mcp_servers.<id>.identity.command.args |
array<table> |
Geordnete Argument-Matcher für einen stdio-Server. Die konfigurierte Argumentliste muss dieselbe Länge haben, und jede Position muss übereinstimmen. Befehls-Matcher prüfen weder cwd noch env oder env_vars. |
mcp_servers.<id>.identity.command.args[].expression |
string |
Regulärer Ausdruck, den ein Argument-Matcher vom Typ regex verwendet. Der Ausdruck muss gültig sein und auf den vollständigen Argumentwert zutreffen. |
mcp_servers.<id>.identity.command.args[].match |
exact | prefix | regex |
Abgleichsoperation für diese Argumentposition. |
mcp_servers.<id>.identity.command.args[].value |
string |
Wert, den ein Argument-Matcher vom Typ exact oder prefix verwendet. |
mcp_servers.<id>.identity.command.executable |
string |
Ausführbare Datei, mit der das konfigurierte command des stdio-Servers exakt übereinstimmen muss. |
mcp_servers.<id>.identity.url |
string | table |
Einen MCP server mit streamable HTTP anhand einer exakten URL-Zeichenfolge zulassen oder eine Wert-Matcher-Tabelle vom Typ exact, prefix oder regex verwenden. |
mcp_servers.<id>.identity.url.expression |
string |
Regulärer Ausdruck, den ein URL-Matcher vom Typ regex verwendet. Der Ausdruck muss gültig sein und auf den vollständigen URL-Wert zutreffen. |
mcp_servers.<id>.identity.url.match |
exact | prefix | regex |
Abgleichsoperation für die konfigurierte URL des MCP server. |
mcp_servers.<id>.identity.url.value |
string |
Wert, den ein URL-Matcher vom Typ exact oder prefix verwendet. |
model_catalog_json |
string (path) |
JSON-Modellkatalog verbindlich festlegen, den Codex beim Start verwendet. |
model_provider |
string |
Die Modellanbieter-ID verbindlich festlegen und dabei die lokale und die Sitzungskonfiguration überschreiben. |
model_providers |
map<string, table> |
Verwaltete Modellanbieterdefinitionen. Jeder Eintrag ersetzt den gesamten konfigurierten Anbieter mit derselben ID; Felder werden nicht mit der Definition des Benutzers zusammengeführt. Anbieter mit anderen IDs bleiben verfügbar. |
model_providers.<id> |
table |
Vollständige verwaltete Anbieterdefinition. Verwendet dieselben Anbieterfelder wie config.toml, einschließlich name, base_url sowie Authentifizierungs- und Transporteinstellungen. |
models |
table |
Enthält die Tabelle [models.new_thread]. |
models.new_thread |
table |
Optionale Standardwerte, die beim Start eines neuen lokalen Threads gelten. Sie haben Vorrang vor Benutzer- und Projektstandardwerten, können aber durch explizite Überschreibungen ersetzt werden. |
models.new_thread.model |
string |
Standardmodell für neue Threads. Eine explizite Überschreibung des Modells oder des Reasoning-Aufwands führt dazu, dass beide Felder ignoriert werden. |
models.new_thread.model_reasoning_effort |
string |
Standardmäßiger Reasoning-Aufwand für neue Threads. Eine explizite Überschreibung des Modells oder des Reasoning-Aufwands führt dazu, dass beide Felder ignoriert werden. |
models.new_thread.service_tier |
string |
Standard-Service-Tier für neue Threads. Eine explizite Überschreibung des Service-Tiers führt dazu, dass dieses Feld ignoriert wird. |
permissions |
table |
Vom Administrator definierte Berechtigungsprofile mit dem Profilnamen als Schlüssel. Verwendet dieselben Profilfelder wie config.toml. |
permissions.<name> |
table |
Vom Administrator definiertes Berechtigungsprofil. Der Name darf weder mit : beginnen noch den reservierten Namen filesystem verwenden oder ein Profil aus einer geladenen Konfiguration duplizieren. Verwendet dieselben Profilfelder wie config.toml; das vollständige Profilschema finden Sie im Leitfaden zu Berechtigungen. |
permissions.filesystem.deny_read |
array<string> |
Vom Administrator erzwungene Leseverbote für das Dateisystem. Einträge können Pfade oder Glob-Muster sein; Benutzer können sie nicht durch lokale Konfiguration abschwächen. |
plugins |
table |
Plugin-spezifische Positivlisten für MCP server mit der Plugin-ID als Schlüssel. Wenn diese Tabelle vorhanden ist, werden mit Plugins gebündelte Server ohne passenden Plugin- und Servereintrag deaktiviert. |
plugins.<plugin>.mcp_servers |
table |
Positivliste für MCP server, die mit einem Plugin gebündelt sind. Vorgaben für Plugin-Server verwenden dieselben exakten Identitäts- und Matcher-Formen wie mcp_servers-Vorgaben auf oberster Ebene. |
plugins.<plugin>.mcp_servers.<server>.identity |
table |
Identitätsregel für einen mit einem Plugin gebündelten MCP server. Setzen Sie entweder command (stdio) oder url (streamable HTTP). |
plugins.<plugin>.mcp_servers.<server>.identity.command |
string | table |
Den stdio MCP server eines Plugins anhand einer exakten Befehlszeichenfolge zulassen oder mit einer Matcher-Tabelle eine exakte ausführbare Datei und geordnete Argument-Matcher vorschreiben. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args |
array<table> |
Geordnete Argument-Matcher für einen mit einem Plugin gebündelten stdio-Server. Die konfigurierte Argumentliste muss dieselbe Länge haben, und jede Position muss übereinstimmen. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression |
string |
Regulärer Ausdruck, den ein Argument-Matcher vom Typ regex verwendet. Der Ausdruck muss auf den vollständigen Argumentwert zutreffen. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match |
exact | prefix | regex |
Abgleichsoperation für diese Argumentposition. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value |
string |
Wert, den ein Argument-Matcher vom Typ exact oder prefix verwendet. |
plugins.<plugin>.mcp_servers.<server>.identity.command.executable |
string |
Ausführbare Datei, mit der der konfigurierte Befehl des mit dem Plugin gebündelten stdio-Servers exakt übereinstimmen muss. |
plugins.<plugin>.mcp_servers.<server>.identity.url |
string | table |
Den MCP server eines Plugins mit streamable HTTP anhand einer exakten URL-Zeichenfolge zulassen oder eine Wert-Matcher-Tabelle vom Typ exact, prefix oder regex verwenden. |
plugins.<plugin>.mcp_servers.<server>.identity.url.expression |
string |
Regulärer Ausdruck, den ein URL-Matcher vom Typ regex verwendet. Der Ausdruck muss auf den vollständigen URL-Wert zutreffen. |
plugins.<plugin>.mcp_servers.<server>.identity.url.match |
exact | prefix | regex |
Abgleichsoperation für die URL des mit dem Plugin gebündelten MCP server. |
plugins.<plugin>.mcp_servers.<server>.identity.url.value |
string |
Wert, den ein URL-Matcher vom Typ exact oder prefix verwendet. |
remote_sandbox_config |
array<table> |
Hostspezifische Sandbox-Vorgaben. Der erste Eintrag, dessen hostname_patterns mit dem ermittelten Hostnamen übereinstimmen, überschreibt allowed_sandbox_modes auf oberster Ebene für diese Vorgabenquelle. Hostspezifische Einträge überschreiben derzeit nur Sandbox-Modi. |
remote_sandbox_config[].allowed_sandbox_modes |
array<string> |
Zulässige Sandbox-Modi, die gelten, wenn dieser hostspezifische Eintrag zutrifft. |
remote_sandbox_config[].hostname_patterns |
array<string> |
Hostnamenmuster ohne Unterscheidung zwischen Groß- und Kleinschreibung. Unterstützt * für eine beliebige Zeichenfolge und ? für ein einzelnes Zeichen. |
rules |
table |
Vom Administrator erzwungene Befehlsregeln, die mit .rules-Dateien zusammengeführt werden. Vorgabenregeln müssen einschränkend sein. |
rules.prefix_rules |
array<table> |
Liste der erzwungenen Präfixregeln. Jede Regel muss pattern und decision enthalten. |
rules.prefix_rules[].decision |
prompt | forbidden |
Erforderlich. Vorgabenregeln können nur eine Rückfrage verlangen oder etwas verbieten, aber nichts erlauben. |
rules.prefix_rules[].justification |
string |
Optionale, nicht leere Begründung, die in Genehmigungsanfragen oder Ablehnungsmeldungen angezeigt wird. |
rules.prefix_rules[].pattern |
array<table> |
Befehlspräfix, ausgedrückt als Muster-Tokens. Jedes Token setzt entweder token oder any_of. |
rules.prefix_rules[].pattern[].any_of |
array<string> |
Eine Liste zulässiger alternativer Tokens an dieser Position. |
rules.prefix_rules[].pattern[].token |
string |
Ein einzelnes wörtliches Token an dieser Position. |
sqlite_home |
string (path) |
Verzeichnis verbindlich festlegen, in dem Codex den SQLite-basierten Laufzeitzustand speichert. |
windows |
table |
Vorgaben für die native Windows-Sandbox. |
windows.allowed_sandbox_implementations |
array<string> |
Zulässige ältere Implementierungen der nativen Windows-Sandbox (elevated und unelevated). Die Liste darf nicht leer sein. Wenn beide zulässig sind und kein Modus ausgewählt ist, bevorzugt Codex elevated. Diese Liste schränkt die Sandbox mxc nicht ein, wenn sie verfügbar ist. |
Keine passenden Konfigurationsoptionen.