For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Hauptnavigation

Vorschläge

Anpassung

Konfigurationsdatei

Agentenkonfiguration

ChatGPT und Codex erweitern

Linux

Windows

API Dashboard
ChatGPT ausprobieren

Konfigurationsreferenz

Vollständige Referenz zu config.toml und requirements.toml von Codex

Nutze diese Seite als durchsuchbare Referenz für Codex-Konfigurationsdateien. Erläuterungen zu den Konzepten und Beispiele findest du unter Grundlagen der Konfiguration und Erweiterte Konfiguration.

config.toml

Die Konfiguration auf Benutzerebene befindet sich in ~/.codex/config.toml. Du kannst außerdem projektspezifische Überschreibungen in Dateien namens .codex/config.toml hinzufügen. Codex lädt projektspezifische Konfigurationsdateien nur, wenn du dem Projekt vertraust.

Projektspezifische Konfigurationen können folgende auf dem Rechner festgelegte Werte nicht überschreiben: Anbieter- und Authentifizierungseinstellungen, vom Host verwaltete Metadaten für App-Anfragen, Benachrichtigungseinstellungen und die Auswahl des Konfigurationsprofils sowie Schlüssel für das Telemetrie-Routing. 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 projektspezifischen Konfigurationsdatei namens .codex/config.toml vorkommen. Lege stattdessen die Schlüssel für Anbieter, Benachrichtigungen und Telemetrie in der Konfiguration auf Benutzerebene ab. Die Profildateien für die Konfiguration liegen im selben Verzeichnis wie config.toml und haben den Pfad $CODEX_HOME/profile-name.config.toml. Wähle eine davon mit --profile profile-name aus.

Nutze diese Referenz für Konfigurationsschlüssel zu Sandbox und Genehmigungen (approval_policy, sandbox_mode und sandbox_workspace_write.*) zusammen mit Sandbox und Genehmigungen, Geschützte Pfade in Stammverzeichnissen mit Schreibzugriff und Netzwerkzugriff. Informationen zu Berechtigungsprofilen in der Betaphase findest du unter Berechtigungen.

Key
agents
Type / Values
table
Details
Einstellungen für mehrere Agenten und Deklarationen benutzerdefinierter Rollen. Namen skalarer Einstellungen sind reserviert und können nicht als benutzerdefinierte Rollennamen verwendet werden.
Key
agents.<name>.config_file
Type / Values
string (path)
Details
Pfad zu einer TOML-Konfigurationsebene für diese Rolle. Relative Pfade werden ausgehend von der Konfigurationsdatei aufgelöst, in der die Rolle deklariert ist.
Key
agents.<name>.description
Type / Values
string
Details
Hinweise zur Rolle, die Codex beim Auswählen und Starten dieses Agententyps angezeigt werden.
Key
agents.default_subagent_model
Type / Values
string
Details
Standardmodell für gestartete Agenten. Ein beim Starten explizit angegebenes Modell hat Vorrang.
Key
agents.default_subagent_reasoning_effort
Type / Values
string
Details
Standardmäßiger Reasoning-Aufwand für gestartete Agenten. Ein beim Starten explizit angegebener Reasoning-Aufwand hat Vorrang.
Key
agents.enabled
Type / Values
boolean
Details
Tools für mehrere Agenten aktivieren oder deaktivieren (Standard: true).
Key
agents.interrupt_message
Type / Values
boolean
Details
Eine für das Modell sichtbare Nachricht aufzeichnen, wenn ein Agenten-Turn unterbrochen wird (Standard: true).
Key
agents.max_concurrent_threads_per_session
Type / Values
number
Details
Maximale Anzahl an Threads gestarteter Agenten, die gleichzeitig geöffnet sein können. Der Haupt-Thread zählt nicht mit. Ist kein Wert festgelegt, wählt Codex den Standardwert.
Key
agents.max_threads
Type / Values
number
Details
Älterer Alias für agents.max_concurrent_threads_per_session.
Key
allow_login_shell
Type / Values
boolean
Details
Erlaubt Shell-basierten Tools, die Semantik einer Login-Shell zu verwenden. Standardmäßig true; bei false werden Anfragen mit login = true abgelehnt, und bei nicht angegebenem login werden standardmäßig Shells ohne Login verwendet.
Key
analytics.enabled
Type / Values
boolean
Details
Analysen für diesen Rechner oder dieses Profil aktivieren oder deaktivieren. Wenn nicht festgelegt, gilt der Standardwert des Clients.
Key
approval_policy
Type / Values
untrusted | on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }
Details
Steuert, wann Codex vor dem Ausführen von Befehlen auf eine Genehmigung wartet. Du kannst außerdem approval_policy = { granular = { ... } } verwenden, um bestimmte Prompt-Kategorien zuzulassen oder automatisch abzulehnen, während andere Prompts interaktiv bleiben. on-failure ist veraltet; verwende on-request für interaktive Ausführungen oder never für nicht interaktive Ausführungen.
Key
approval_policy.granular.mcp_elicitations
Type / Values
boolean
Details
Bei true dürfen Prompts zur MCP-Elizitation angezeigt werden, statt automatisch abgelehnt zu werden.
Key
approval_policy.granular.request_permissions
Type / Values
boolean
Details
Bei true dürfen Prompts des Tools request_permissions angezeigt werden.
Key
approval_policy.granular.rules
Type / Values
boolean
Details
Bei true dürfen Genehmigungsanfragen angezeigt werden, die durch prompt-Regeln von execpolicy ausgelöst werden.
Key
approval_policy.granular.sandbox_approval
Type / Values
boolean
Details
Bei true dürfen Genehmigungsanfragen für eine Sandbox-Eskalation angezeigt werden.
Key
approval_policy.granular.skill_approval
Type / Values
boolean
Details
Bei true dürfen Genehmigungsanfragen für Skill-Skripte angezeigt werden.
Key
approvals_reviewer
Type / Values
user | auto_review
Details
Legt fest, wer die bei on-request oder granularen Genehmigungsrichtlinien infrage kommenden Genehmigungsanfragen prüft. Standardmäßig ist dies user; bei auto_review übernimmt der für die Überprüfung zuständige Subagent die Prüfung. Diese Einstellung ändert nichts am Sandboxing und führt nicht dazu, dass innerhalb der Sandbox bereits erlaubte Aktionen überprüft werden.
Key
apps._default.approvals_reviewer
Type / Values
user | auto_review
Details
Legt fest, wer Genehmigungsanfragen für App-Tools standardmäßig prüft, sofern dies nicht für eine einzelne App überschrieben wird. Ohne Angabe übernehmen Apps den Wert approvals_reviewer der obersten Ebene.
Key
apps._default.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Standardverhalten bei Genehmigungen für App-Tools, sofern keine Überschreibung auf App- oder Tool-Ebene vorliegt.
Key
apps._default.destructive_enabled
Type / Values
boolean
Details
Legt fest, ob App-Tools mit destructive_hint = true standardmäßig zugelassen oder abgelehnt werden.
Key
apps._default.enabled
Type / Values
boolean
Details
Legt fest, ob Apps standardmäßig aktiviert sind, sofern dies nicht für eine einzelne App überschrieben wird.
Key
apps._default.open_world_enabled
Type / Values
boolean
Details
Legt fest, ob App-Tools mit open_world_hint = true standardmäßig zugelassen oder abgelehnt werden.
Key
apps.<id>.approvals_reviewer
Type / Values
user | auto_review
Details
Legt fest, wer Genehmigungsanfragen für die Tools dieser App prüft. Überschreibt apps._default.approvals_reviewer.
Key
apps.<id>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Standardverhalten bei Genehmigungen für Tools in dieser App, sofern keine Überschreibung für das jeweilige Tool vorliegt.
Key
apps.<id>.default_tools_enabled
Type / Values
boolean
Details
Legt fest, ob Tools in dieser App standardmäßig aktiviert sind, sofern keine Überschreibung für das jeweilige Tool vorliegt.
Key
apps.<id>.destructive_enabled
Type / Values
boolean
Details
Tools in dieser App, die destructive_hint = true angeben, zulassen oder blockieren.
Key
apps.<id>.enabled
Type / Values
boolean
Details
Eine bestimmte App oder einen bestimmten Konnektor anhand der ID aktivieren oder deaktivieren (Standard: true).
Key
apps.<id>.open_world_enabled
Type / Values
boolean
Details
Tools in dieser App, die open_world_hint = true angeben, zulassen oder blockieren.
Key
apps.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Überschreibt das Verhalten bei Genehmigungen für ein einzelnes App-Tool.
Key
apps.<id>.tools.<tool>.enabled
Type / Values
boolean
Details
Überschreibt den Aktivierungsstatus eines einzelnen App-Tools (zum Beispiel repos/list).
Key
auto_review.policy
Type / Values
string
Details
Lokale Richtlinienanweisungen in Markdown für die automatische Überprüfung. Die verwaltete Einstellung guardian_policy_config hat Vorrang. Leere Werte werden ignoriert.
Key
background_terminal_max_timeout
Type / Values
number
Details
Maximales Abfragezeitfenster in Millisekunden für leere write_stdin-Abfragen (Abfragen des Hintergrundterminals). Standard: 300000 (5 Minuten). Ersetzt den älteren Schlüssel background_terminal_timeout.
Key
chatgpt_base_url
Type / Values
string
Details
Die beim ChatGPT-Anmeldevorgang verwendete Basis-URL überschreiben.
Key
check_for_update_on_startup
Type / Values
boolean
Details
Beim Start nach Codex-Updates suchen (nur auf false setzen, wenn Updates zentral verwaltet werden).
Key
cli_auth_credentials_store
Type / Values
file | keyring | auto
Details
Festlegen, wo die CLI zwischengespeicherte Anmeldedaten speichert (in der Datei auth.json oder im Schlüsselbund des Betriebssystems).
Key
compact_prompt
Type / Values
string
Details
Inline-Überschreibung für den Prompt zur Compaction (Kontextverdichtung) des Verlaufs.
Key
computer_use.windows.always_allowed_app_ids
Type / Values
array<string>
Details
Kennungen von Windows-Apps, die über die Computernutzung ohne Rückfrage geöffnet werden können. Apps, die nicht in der Liste stehen, erfordern eine Genehmigung. Entferne gespeicherte Einträge aus den Einstellungen für die Computernutzung der ChatGPT-Desktop-App.
Key
default_permissions
Type / Values
string
Details
Name des standardmäßigen Berechtigungsprofils für Toolaufrufe in der Sandbox. Integrierte Profile sind :read-only, :workspace und :danger-full-access; benutzerdefinierte Profilnamen erfordern passende [permissions.<name>]-Tabellen. Nicht mit sandbox_mode oder [sandbox_workspace_write] kombinieren.
Key
desktop.custom_file_handlers.<id>
Type / Values
table
Details
Nur auf Benutzerebene. Definiert für die ChatGPT-Desktop-App ein zusätzliches Ziel im Menü Öffnen in. Beispiele und Einschränkungen für Handler-IDs findest du unter Benutzerdefinierte Dateihandler hinzufügen.
Key
desktop.custom_file_handlers.<id>.args
Type / Values
array<string>
Details
Argumente, die zwischen Befehl und Dateieingabe eingefügt werden (Standard: []).
Key
desktop.custom_file_handlers.<id>.command
Type / Values
string
Details
Pfad zur ausführbaren Datei oder Befehlsname, um das Programm zu erkennen und zu starten. Erforderlich.
Key
desktop.custom_file_handlers.<id>.icon
Type / Values
string
Details
Pfad zu einem mitgelieferten Asset, Base64-codierte URL im Format data:image/..., Datei-URI oder absoluter lokaler Pfad für das Handler-Symbol. Erforderlich; bei nicht unterstützten Quellen wird das Standardsymbol von VS Code verwendet.
Key
desktop.custom_file_handlers.<id>.input
Type / Values
path | json_argument | json_stdin
Details
Legt fest, wie die App Dateieingaben an den Handler sendet (Standard: path).
Key
desktop.custom_file_handlers.<id>.label
Type / Values
string
Details
Anzeigename in den Menüs Öffnen in. Erforderlich.
Key
desktop.custom_file_handlers.<id>.supports_ssh
Type / Values
boolean
Details
Handler für Dateien in SSH-Workspaces anbieten (Standard: false).
Key
developer_instructions
Type / Values
string
Details
Zusätzliche Entwickleranweisungen, die in die Sitzung eingebunden werden (optional).
Key
disable_paste_burst
Type / Values
boolean
Details
Erkennung schneller Eingabefolgen als eingefügten Text in der TUI deaktivieren.
Key
experimental_compact_prompt_file
Type / Values
string (path)
Details
Überschreibung für den Prompt zur Compaction (Kontextverdichtung) aus einer Datei laden (experimentell).
Key
experimental_use_unified_exec_tool
Type / Values
boolean
Details
Ältere Bezeichnung zum Aktivieren von unified exec; verwende vorzugsweise [features].unified_exec oder codex --enable unified_exec.
Key
features.apps
Type / Values
boolean
Details
App-Integrationen (Konnektoren) aktivieren (stabil; standardmäßig aktiviert). Der Datenverkehr von Apps und Konnektoren wird weder durch den Netzwerkproxy für Befehle in der Sandbox noch durch dessen Domain-Zulassungsliste gesteuert.
Key
features.code_mode.direct_only_tool_namespaces
Type / Values
array<string>
Details
Tool-Namespaces, die der Code-Modus nur über direkte Tool-Aufrufe verwenden kann.
Key
features.code_mode.enabled
Type / Values
boolean
Details
Konfiguration für die Code-Modus-Funktion aktivieren. Diese Funktion befindet sich in der Entwicklung und ist standardmäßig deaktiviert.
Key
features.code_mode.excluded_tool_namespaces
Type / Values
array<string>
Details
Tool-Namespaces, die der Code-Modus weder in Anleitungen für verschachtelte Code-Modus-Tools einbezieht noch dem Executor bereitstellt.
Key
features.enable_request_compression
Type / Values
boolean
Details
Anfragekörper von Streaming-Anfragen mit zstd komprimieren, sofern dies unterstützt wird (stabil; standardmäßig aktiviert).
Key
features.fast_mode
Type / Values
boolean
Details
Die Auswahl der Servicestufe aus dem Modellkatalog in der TUI aktivieren, einschließlich der Befehle für die Fast-Servicestufe, sofern das aktive Modell sie anbietet (stabil; standardmäßig aktiviert).
Key
features.goals
Type / Values
boolean
Details
Dauerhaft gespeicherte Ziele und automatische Fortsetzung aktivieren (stabil; standardmäßig aktiviert).
Key
features.hooks
Type / Values
boolean
Details
Lifecycle-Hooks aktivieren, die aus hooks.json oder aus der Inline-Konfiguration [hooks] geladen werden. features.codex_hooks ist ein veralteter Alias.
Key
features.memories
Type / Values
boolean
Details
Erinnerungen aktivieren (standardmäßig deaktiviert).
Key
features.multi_agent
Type / Values
boolean
Details
Tools für die Zusammenarbeit mehrerer Agenten (spawn_agent, send_input, resume_agent, wait_agent und close_agent) aktivieren (stabil; standardmäßig aktiviert).
Key
features.network_proxy
Type / Values
boolean | table
Details
Netzwerk-Proxy für Befehle in der Sandbox starten (experimentell; standardmäßig deaktiviert). Er ist erforderlich, um die Domainregeln der Berechtigungsprofile durchzusetzen, sofern der Proxy nicht durch aktivierte, administrativ verwaltete experimental_network-Anforderungen gestartet wird. Verwende die Tabellenform, wenn du Richtlinienoptionen auf Funktionsebene wie domains festlegst. Filtert weder die Websuche noch Apps, MCP oder andere gehostete Tools.
Key
features.network_proxy.allow_local_binding
Type / Values
boolean
Details
Umfassenderen Zugriff auf lokale oder private Netzwerke zulassen. Standard: false; Zulassungsregeln für eine exakt angegebene lokale IP-Adresse oder für localhost können bestimmte lokale Ziele weiterhin freigeben.
Key
features.network_proxy.allow_upstream_proxy
Type / Values
boolean
Details
Verkettung mit einem in der Umgebung konfigurierten Upstream-Proxy zulassen. Standard: true.
Key
features.network_proxy.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Beliebige Unix-Socket-Ziele zulassen, statt den Zugriff auf eine Allowlist zu beschränken. Standard: false; nur in streng kontrollierten Umgebungen verwenden.
Key
features.network_proxy.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Listener-Adressen zulassen, die keine Loopback-Adressen sind. Standard: false; bei Aktivierung können Proxy-Listener auch außerhalb von localhost erreichbar werden.
Key
features.network_proxy.domains
Type / Values
map<string, allow | deny>
Details
Domainrichtlinie für den Netzwerkzugriff in der Sandbox. Standardmäßig nicht festgelegt; externe Ziele sind erst zulässig, wenn du Regeln mit allow hinzufügst. Unterstützt exakt angegebene Hosts, *.example.com ausschließlich für Subdomains, **.example.com für die Apex-Domain einschließlich ihrer Subdomains sowie globale Zulassungsregeln mit *. Bevorzuge Regeln mit begrenztem Geltungsbereich, da * ausgehenden Zugriff auf öffentliche Ziele umfassend freigibt. Füge für gesperrte Ziele Regeln mit deny hinzu; bei Konflikten hat deny Vorrang.
Key
features.network_proxy.enable_socks5
Type / Values
boolean
Details
SOCKS5-Unterstützung bereitstellen. Standard: true.
Key
features.network_proxy.enable_socks5_udp
Type / Values
boolean
Details
UDP über SOCKS5 zulassen. Standard: true.
Key
features.network_proxy.enabled
Type / Values
boolean
Details
Netzwerk-Proxy für Befehle in der Sandbox starten, wenn der Netzwerkzugriff für Befehle aktiviert ist. Standard: false. Solange der Proxy deaktiviert ist, werden die Domainregeln der Berechtigungsprofile nicht durchgesetzt.
Key
features.network_proxy.proxy_url
Type / Values
string
Details
HTTP-Listener-URL für den Netzwerkzugriff in der Sandbox. Standard: "http://127.0.0.1:3128".
Key
features.network_proxy.socks_url
Type / Values
string
Details
SOCKS5-Listener-URL. Standard: "http://127.0.0.1:8081".
Key
features.network_proxy.unix_sockets
Type / Values
map<string, allow | deny>
Details
Unix-Socket-Richtlinie für den Netzwerkzugriff in der Sandbox. Standardmäßig nicht festgelegt; füge für zulässige Sockets Einträge mit allow hinzu.
Key
features.personality
Type / Values
boolean
Details
Bedienelemente zur Auswahl der Persönlichkeit aktivieren (stabil; standardmäßig aktiviert).
Key
features.prevent_idle_sleep
Type / Values
boolean
Details
Verhindern, dass der Computer während einer laufenden Interaktion in den Ruhezustand wechselt (experimentell; standardmäßig deaktiviert).
Key
features.remote_plugin
Type / Values
boolean
Details
Remote-Katalog für Plug-ins aktivieren (stabil; standardmäßig aktiviert).
Key
features.rollout_budget.enabled
Type / Values
boolean
Details
Nachverfolgung des Rollout-Budgets aktivieren. Diese Funktion befindet sich in der Entwicklung und ist standardmäßig deaktiviert. Bei Aktivierung ist features.rollout_budget.limit_tokens erforderlich.
Key
features.rollout_budget.limit_tokens
Type / Values
integer
Details
Positives Token-Limit für die Nachverfolgung des Rollout-Budgets. Erforderlich, wenn das Rollout-Budget aktiviert ist.
Key
features.rollout_budget.prefill_token_weight
Type / Values
number
Details
Endlicher, nicht negativer Multiplikator für Prefill-Token bei der Berechnung des Rollout-Budgets. Standardwert ist 1.0.
Key
features.rollout_budget.reminder_interval_tokens
Type / Values
integer
Details
Positives Token-Intervall zwischen Erinnerungen zum Rollout-Budget. Der Standardwert beträgt 10 % von limit_tokens, mindestens jedoch 1 Token.
Key
features.rollout_budget.sampling_token_weight
Type / Values
number
Details
Endlicher, nicht negativer Multiplikator für per Sampling erzeugte Token bei der Berechnung des Rollout-Budgets. Standardwert ist 1.0.
Key
features.shell_snapshot
Type / Values
boolean
Details
Einen Snapshot der Shell-Umgebung erstellen, um wiederholte Befehle zu beschleunigen (stabil; standardmäßig aktiviert).
Key
features.shell_tool
Type / Values
boolean
Details
Das standardmäßige Tool shell zum Ausführen von Befehlen aktivieren (stabil; standardmäßig aktiviert).
Key
features.skill_mcp_dependency_install
Type / Values
boolean
Details
Installationsaufforderungen und die Installation fehlender MCP-Abhängigkeiten für Skills zulassen (stabil; standardmäßig aktiviert).
Key
features.unified_exec
Type / Values
boolean
Details
Das einheitliche, PTY-gestützte exec-Tool verwenden (stabil; außer unter Windows standardmäßig aktiviert).
Key
features.web_search
Type / Values
boolean
Details
Veralteter Schalter aus älteren Versionen; verwende vorzugsweise die Einstellung web_search auf oberster Ebene.
Key
features.web_search_cached
Type / Values
boolean
Details
Veralteter Schalter aus älteren Versionen. Ist web_search nicht festgelegt, entspricht true der Einstellung web_search = "cached".
Key
features.web_search_request
Type / Values
boolean
Details
Veralteter Schalter aus älteren Versionen. Ist web_search nicht festgelegt, entspricht true der Einstellung web_search = "live".
Key
feedback.enabled
Type / Values
boolean
Details
Übermittlung von Feedback über /feedback in allen lokalen Clients aktivieren (Standard: true).
Key
file_opener
Type / Values
vscode | vscode-insiders | windsurf | cursor | none
Details
URI-Schema zum Öffnen von Quellenverweisen aus der Codex-Ausgabe (Standard: vscode).
Key
forced_chatgpt_workspace_id
Type / Values
string (uuid)
Details
Beschränkt ChatGPT-Anmeldungen auf eine bestimmte Workspace-Kennung.
Key
forced_login_method
Type / Values
chatgpt | api
Details
Beschränkt Codex auf eine bestimmte Authentifizierungsmethode.
Key
hide_agent_reasoning
Type / Values
boolean
Details
Reasoning-Ereignisse sowohl in der TUI als auch in der Ausgabe von codex exec unterdrücken.
Key
history.max_bytes
Type / Values
number
Details
Begrenzt, sofern festgelegt, die Größe der Verlaufsdatei in Byte, indem die ältesten Einträge entfernt werden.
Key
history.persistence
Type / Values
save-all | none
Details
Festlegen, ob Codex Sitzungstranskripte in history.jsonl speichert.
Key
hooks
Type / Values
table
Details
Direkt in config.toml konfigurierte Lifecycle-Hooks. Sie verwenden dasselbe Ereignisschema wie hooks.json. Beispiele und unterstützte Ereignisse findest du im Leitfaden zu Hooks.
Key
hooks.<Event>
Type / Values
array<table>
Details
Matcher-Gruppen für Hook-Ereignisse wie PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit oder Stop.
Key
hooks.<Event>[].hooks
Type / Values
array<table>
Details
Hook-Handler für eine Matcher-Gruppe. Befehls-Hooks und Hooks für MCP-Tools werden unterstützt; Handler für Prompt- und Agenten-Hooks werden geparst, aber übersprungen.
Key
hooks.<Event>[].hooks[].additionalContextLimit
Type / Values
integer
Details
Ungefährer Token-Schwellenwert pro Handler, ab dem zu umfangreiche Inhalte von additionalContext auf dem Datenträger gespeichert werden und dem Modell eine kürzere Vorschau angezeigt wird. Standardwert ist 2500; bei 0 wird der vollständige Kontext direkt an das Modell übergeben. Siehe Große Hook-Ausgaben.
Key
hooks.<Event>[].hooks[].async
Type / Values
boolean
Details
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.
Key
hooks.<Event>[].hooks[].commandWindows
Type / Values
string
Details
Abweichender Befehl für Befehls-Hooks, der nur unter Windows verwendet wird. Der TOML-Alias command_windows wird ebenfalls akzeptiert.
Key
instructions
Type / Values
string
Details
Für die zukünftige Verwendung reserviert; verwende vorzugsweise model_instructions_file oder AGENTS.md.
Key
log_dir
Type / Values
string (path)
Details
Verzeichnis, in das Codex Protokolldateien schreibt; Standard ist $CODEX_HOME/log. Wenn du es explizit festlegst, wird in diesem Verzeichnis auch das optionale TUI-Klartextprotokoll codex-tui.log aktiviert.
Key
mcp_oauth_callback_port
Type / Values
integer
Details
Optionaler globaler fester Port für den lokalen HTTP-Callback-Server, der bei der MCP-OAuth-Anmeldung verwendet wird. Ein serverspezifischer oauth.callback_port hat Vorrang. Ist keiner der beiden Werte festgelegt, bindet Codex den Server an einen vom Betriebssystem ausgewählten ephemeren Port.
Key
mcp_oauth_callback_url
Type / Values
string
Details
Optionale Basis-Callback-URL für die MCP-OAuth-Anmeldung, etwa eine Ingress-URL für eine Devbox. Neu hinzugefügte, vorab registrierte Clients verwenden diese URL unverändert, wenn der Autorisierungsserver die Identifizierung des Ausstellers unterstützt. Bestehende Clients ohne gespeicherten Callback hängen eine serverspezifische Callback-ID an. Ohne diese Unterstützung 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 legen den Listener-Port nicht fest.
Key
mcp_oauth_credentials_store
Type / Values
auto | file | keyring
Details
Bevorzugter Speicher für MCP-OAuth-Anmeldedaten.
Key
mcp_servers.<id>.args
Type / Values
array<string>
Details
Argumente, die an den Befehl des MCP-Servers mit stdio übergeben werden.
Key
mcp_servers.<id>.auth
Type / Values
oauth | chatgpt
Details
Fallback für die Authentifizierung eines MCP-HTTP-Servers, nachdem konfigurierte Bearer-Token und Autorisierungsheader geprüft wurden. oauth (Standard) verwendet gespeicherte MCP-OAuth-Anmeldedaten, sofern vorhanden. chatgpt verwendet für den vertrauenswürdigen, ChatGPT-eigenen Origin die aktuelle ChatGPT-Sitzung und greift bei Bedarf auf gespeicherte OAuth-Anmeldedaten zurück. In beiden Modi ist auch eine Verbindung ohne Authentifizierung möglich, wenn keine Quelle Anmeldedaten liefert.
Key
mcp_servers.<id>.bearer_token_env_var
Type / Values
string
Details
Umgebungsvariable, aus der das Bearer-Token für einen MCP-HTTP-Server bezogen wird.
Key
mcp_servers.<id>.command
Type / Values
string
Details
Startbefehl für einen MCP-Server mit stdio.
Key
mcp_servers.<id>.cwd
Type / Values
string
Details
Arbeitsverzeichnis für den Prozess des MCP-Servers mit stdio.
Key
mcp_servers.<id>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Standardmäßiges Genehmigungsverhalten für MCP-Tools auf diesem Server, sofern keine toolspezifische Überschreibung vorliegt.
Key
mcp_servers.<id>.disabled_tools
Type / Values
array<string>
Details
Sperrliste für den MCP-Server, die nach enabled_tools angewendet wird.
Key
mcp_servers.<id>.enabled
Type / Values
boolean
Details
Einen MCP-Server deaktivieren, ohne seine Konfiguration zu entfernen.
Key
mcp_servers.<id>.enabled_tools
Type / Values
array<string>
Details
Zulassungsliste der Tool-Namen, die der MCP-Server bereitstellt.
Key
mcp_servers.<id>.env
Type / Values
map<string,string>
Details
Umgebungsvariablen, die an den MCP-Server mit stdio weitergeleitet werden.
Key
mcp_servers.<id>.env_http_headers
Type / Values
map<string,string>
Details
HTTP-Header für einen MCP-HTTP-Server, deren Werte aus Umgebungsvariablen stammen.
Key
mcp_servers.<id>.env_vars
Type / Values
array<string | { name = string, source = "local" | "remote" }>
Details
Zusätzliche Umgebungsvariablen für die Zulassungsliste eines MCP-Servers mit stdio. Für Zeichenfolgeneinträge gilt standardmäßig source = "local"; verwende source = "remote" nur für stdio, das über einen Executor remote ausgeführt wird.
Key
mcp_servers.<id>.experimental_environment
Type / Values
local | remote
Details
Experimenteller Ausführungsort für einen MCP-Server. remote startet stdio-Server über eine Remote-Executor-Umgebung; die Remote-Ausführung von Servern mit Streamable HTTP ist nicht implementiert.
Key
mcp_servers.<id>.http_headers
Type / Values
map<string,string>
Details
Statische HTTP-Header, die jeder MCP-HTTP-Anfrage hinzugefügt werden.
Key
mcp_servers.<id>.oauth_resource
Type / Values
string
Details
Optionaler OAuth-Ressourcenparameter gemäß RFC 8707, der bei der MCP-Anmeldung mitgesendet wird.
Key
mcp_servers.<id>.oauth.callback_port
Type / Values
integer
Details
Fester Listener-Port für OAuth-Callbacks dieses MCP-Servers. Überschreibt mcp_oauth_callback_port. Konfiguriere für einen direkten Loopback-Callback mit expliziter Portangabe in der URL denselben Listener-Port.
Key
mcp_servers.<id>.oauth.callback_url
Type / Values
string
Details
Serverspezifischer OAuth-Callback. Vorab registrierte Clients verwenden ihn wieder, wenn die Identifizierung des Ausstellers unterstützt wird oder die URL bereits mit der serverspezifischen Callback-ID endet. Andernfalls verwendet Codex den globalen oder den Standard-Callback und hängt diese ID an. Clients ohne vorab registrierte ID verwenden diesen Callback bei der Client-Registrierung.
Key
mcp_servers.<id>.oauth.client_id
Type / Values
string
Details
Vorab registrierte OAuth-Client-ID, die für die Autorisierung und den Token-Austausch mit diesem MCP-Server verwendet wird.
Key
mcp_servers.<id>.required
Type / Values
boolean
Details
Wenn true festgelegt ist, schlägt der Start oder die Fortsetzung fehl, falls dieser aktivierte MCP-Server nicht initialisiert werden kann.
Key
mcp_servers.<id>.scopes
Type / Values
array<string>
Details
OAuth-Berechtigungsbereiche, die bei der Authentifizierung bei diesem MCP-Server angefordert werden.
Key
mcp_servers.<id>.startup_timeout_ms
Type / Values
number
Details
Alias für startup_timeout_sec in Millisekunden.
Key
mcp_servers.<id>.startup_timeout_sec
Type / Values
number
Details
Den standardmäßigen Start-Timeout von 10 s für einen MCP-Server überschreiben.
Key
mcp_servers.<id>.tool_timeout_sec
Type / Values
number
Details
Den standardmäßigen Timeout von 60 s pro Tool für einen MCP-Server überschreiben.
Key
mcp_servers.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Überschreibung des Genehmigungsverhaltens für ein einzelnes MCP-Tool auf diesem Server.
Key
mcp_servers.<id>.url
Type / Values
string
Details
Endpunkt für einen MCP-Server mit Streamable HTTP.
Key
memories.consolidation_model
Type / Values
string
Details
Optional abweichendes Modell für die globale Konsolidierung von Erinnerungen.
Key
memories.disable_on_external_context
Type / Values
boolean
Details
Wenn true festgelegt ist, werden Threads, die externen Kontext wie MCP-Tool-Aufrufe, die Websuche oder die Tool-Suche verwenden, von der Generierung von Erinnerungen ausgeschlossen. Standardwert ist false. Älterer Alias: memories.no_memories_if_mcp_or_web_search.
Key
memories.extract_model
Type / Values
string
Details
Optional abweichendes Modell für die Extraktion von Erinnerungen pro Thread.
Key
memories.generate_memories
Type / Values
boolean
Details
Wenn false festgelegt ist, werden neu erstellte Threads nicht als Eingaben für die Generierung von Erinnerungen gespeichert. Standardwert ist true.
Key
memories.max_raw_memories_for_consolidation
Type / Values
number
Details
Maximale Anzahl zuletzt erfasster unverarbeiteter Erinnerungen, die für die globale Konsolidierung aufbewahrt werden. Standardwert ist 256, die Obergrenze 4096.
Key
memories.max_rollout_age_days
Type / Values
number
Details
Maximales Alter von Threads, die für die Generierung von Erinnerungen berücksichtigt werden. Standardwert ist 30; der Wert wird auf den Bereich von 0 bis 90 begrenzt.
Key
memories.max_rollouts_per_startup
Type / Values
number
Details
Maximale Anzahl an Rollout-Kandidaten, die pro Startdurchlauf verarbeitet werden. Standardwert ist 16, die Obergrenze 128.
Key
memories.max_unused_days
Type / Values
number
Details
Maximale Anzahl an Tagen, die seit der letzten Verwendung einer Erinnerung vergehen darf, bevor sie nicht mehr für die Konsolidierung berücksichtigt wird. Standardwert ist 30; der Wert wird auf den Bereich von 0 bis 365 begrenzt.
Key
memories.min_rate_limit_remaining_percent
Type / Values
number
Details
Mindestprozentsatz, der in den Ratenlimit-Fenstern von Codex noch verfügbar sein muss, damit die Generierung von Erinnerungen beginnt. Standardwert ist 25; der Wert wird auf den Bereich von 0 bis 100 begrenzt.
Key
memories.min_rollout_idle_hours
Type / Values
number
Details
Minimale Leerlaufzeit, bevor ein Thread für die Generierung von Erinnerungen berücksichtigt wird. Standardwert ist 6; der Wert wird auf den Bereich von 1 bis 48 begrenzt.
Key
memories.use_memories
Type / Values
boolean
Details
Wenn false festgelegt ist, bindet Codex vorhandene Erinnerungen nicht in zukünftige Sitzungen ein. Standardwert ist true.
Key
model
Type / Values
string
Details
Zu verwendendes Modell (z. B. gpt-5.5).
Key
model_auto_compact_token_limit
Type / Values
number
Details
Token-Schwellenwert, der die automatische Compaction (Kontextverdichtung) des Verlaufs auslöst (wenn nicht festgelegt, gelten die Standardwerte des Modells).
Key
model_auto_compact_token_limit_scope
Type / Values
total | body_after_prefix
Details
Steuert, ob für den Schwellenwert der automatischen Compaction (Kontextverdichtung) der gesamte aktive Kontext (total, der Standardwert) oder nur der Zuwachs nach dem übernommenen Präfix des Compaction-Fensters (body_after_prefix) berücksichtigt wird.
Key
model_catalog_json
Type / Values
string (path)
Details
Optionaler Pfad zu einem JSON-Modellkatalog, der beim Start geladen wird. Eine ausgewählte Profildatei $CODEX_HOME/profile-name.config.toml kann diesen Wert für das jeweilige Profil überschreiben.
Key
model_context_window
Type / Values
number
Details
Anzahl der für das aktive Modell verfügbaren Token im Kontextfenster.
Key
model_instructions_file
Type / Values
string (path)
Details
Ersatz für die integrierten Anweisungen; wird anstelle von AGENTS.md verwendet.
Key
model_provider
Type / Values
string
Details
Anbieter-ID aus model_providers (Standard: openai).
Key
model_providers.<id>
Type / Values
table
Details
Definition eines benutzerdefinierten Anbieters. Die IDs der integrierten Anbieter (openai, ollama und lmstudio) sind reserviert und können nicht überschrieben werden.
Key
model_providers.<id>.auth
Type / Values
table
Details
Konfiguration für einen benutzerdefinierten Anbieter, bei der ein Befehl das Bearer-Token bereitstellt. Nicht zusammen mit env_key, experimental_bearer_token oder requires_openai_auth verwenden.
Key
model_providers.<id>.auth.args
Type / Values
array<string>
Details
Argumente, die an den Token-Befehl übergeben werden.
Key
model_providers.<id>.auth.command
Type / Values
string
Details
Befehl, der ausgeführt wird, wenn Codex ein Bearer-Token benötigt. Der Befehl muss das Token auf stdout ausgeben.
Key
model_providers.<id>.auth.cwd
Type / Values
string (path)
Details
Arbeitsverzeichnis für den Token-Befehl.
Key
model_providers.<id>.auth.refresh_interval_ms
Type / Values
number
Details
Intervall in Millisekunden, in dem Codex das Token proaktiv aktualisiert (Standard: 300000). Setze den Wert auf 0, um das Token nur nach einem erneuten Authentifizierungsversuch zu aktualisieren.
Key
model_providers.<id>.auth.timeout_ms
Type / Values
number
Details
Maximale Laufzeit des Token-Befehls in Millisekunden (Standard: 5000).
Key
model_providers.<id>.base_url
Type / Values
string
Details
API-Basis-URL des Modellanbieters.
Key
model_providers.<id>.env_http_headers
Type / Values
map<string,string>
Details
HTTP-Header, deren Werte aus vorhandenen Umgebungsvariablen übernommen werden.
Key
model_providers.<id>.env_key
Type / Values
string
Details
Umgebungsvariable, die den API-Schlüssel des Anbieters bereitstellt.
Key
model_providers.<id>.env_key_instructions
Type / Values
string
Details
Optionale Hinweise zum Einrichten des API-Schlüssels des Anbieters.
Key
model_providers.<id>.experimental_bearer_token
Type / Values
string
Details
Direktes Bearer-Token für den Anbieter (nicht empfohlen; verwende env_key).
Key
model_providers.<id>.http_headers
Type / Values
map<string,string>
Details
Statische HTTP-Header, die Anfragen an den Anbieter hinzugefügt werden.
Key
model_providers.<id>.name
Type / Values
string
Details
Anzeigename eines benutzerdefinierten Modellanbieters.
Key
model_providers.<id>.query_params
Type / Values
map<string,string>
Details
Zusätzliche Abfrageparameter, die an Anfragen an den Anbieter angehängt werden.
Key
model_providers.<id>.request_max_retries
Type / Values
number
Details
Anzahl der Wiederholungsversuche für HTTP-Anfragen an den Anbieter (Standard: 4).
Key
model_providers.<id>.requires_openai_auth
Type / Values
boolean
Details
Der Anbieter verwendet die OpenAI-Authentifizierung (Standard: false).
Key
model_providers.<id>.stream_idle_timeout_ms
Type / Values
number
Details
Leerlauf-Timeout für SSE-Streams in Millisekunden (Standard: 300000).
Key
model_providers.<id>.stream_max_retries
Type / Values
number
Details
Anzahl der Wiederholungsversuche nach Unterbrechungen von SSE-Streams (Standard: 5).
Key
model_providers.<id>.supports_standalone_web_search
Type / Values
boolean
Details
Unterstützung für einen kompatiblen, eigenständigen Endpunkt für die Websuche angeben (Standard: false). Die eigenständige Suche ist weiterhin in Entwicklung und standardmäßig deaktiviert. Die Kompatibilität des Anbieters allein aktiviert sie nicht.
Key
model_providers.<id>.supports_websockets
Type / Values
boolean
Details
Gibt an, ob dieser Anbieter den WebSocket-Transport der Responses API unterstützt.
Key
model_providers.<id>.wire_api
Type / Values
responses
Details
Vom Anbieter verwendetes Protokoll. responses ist der einzige unterstützte Wert und wird standardmäßig verwendet, wenn die Angabe fehlt.
Key
model_providers.amazon-bedrock.aws.profile
Type / Values
string
Details
AWS-Profilname, den der integrierte Anbieter amazon-bedrock verwendet.
Key
model_providers.amazon-bedrock.aws.region
Type / Values
string
Details
AWS-Region, die der integrierte Anbieter amazon-bedrock verwendet.
Key
model_reasoning_effort
Type / Values
minimal | low | medium | high | xhigh
Details
Reasoning-Aufwand für unterstützte Modelle anpassen (nur Responses API; xhigh ist modellabhängig).
Key
model_reasoning_summary
Type / Values
auto | concise | detailed | none
Details
Detailgrad der Reasoning-Zusammenfassungen auswählen oder Zusammenfassungen vollständig deaktivieren.
Key
model_supports_reasoning_summaries
Type / Values
boolean
Details
Erzwingen, dass Codex Reasoning-Metadaten entweder sendet oder nicht sendet.
Key
model_verbosity
Type / Values
low | medium | high
Details
Optionale abweichende Einstellung für die Ausführlichkeit von GPT-5 über die Responses API. Ist kein Wert festgelegt, wird die Standardeinstellung des ausgewählten Modells oder Presets verwendet.
Key
notice.hide_full_access_warning
Type / Values
boolean
Details
Erfasst, ob der Warnhinweis zum Vollzugriff bestätigt wurde.
Key
notice.hide_gpt-5.1-codex-max_migration_prompt
Type / Values
boolean
Details
Erfasst, ob die Aufforderung zur Migration auf gpt-5.1-codex-max bestätigt wurde.
Key
notice.hide_gpt5_1_migration_prompt
Type / Values
boolean
Details
Erfasst, ob die Aufforderung zur Migration auf GPT-5.1 bestätigt wurde.
Key
notice.hide_rate_limit_model_nudge
Type / Values
boolean
Details
Erfasst, ob die Erinnerung an einen Modellwechsel aufgrund des Ratenlimits deaktiviert wurde.
Key
notice.hide_world_writable_warning
Type / Values
boolean
Details
Erfasst, ob die Warnung zu Windows-Verzeichnissen mit Schreibzugriff für alle bestätigt wurde.
Key
notice.model_migrations
Type / Values
map<string,string>
Details
Erfasst bestätigte Modellmigrationen als Zuordnungen im Format old->new.
Key
notify
Type / Values
array<string>
Details
Befehl, der für Benachrichtigungen aufgerufen wird; erhält eine JSON-Nutzlast von Codex.
Key
openai_base_url
Type / Values
string
Details
Abweichende Basis-URL für den integrierten Modellanbieter openai.
Key
oss_provider
Type / Values
lmstudio | ollama
Details
Standardmäßig verwendeter lokaler Anbieter bei der Ausführung mit --oss (wenn nicht festgelegt, fragt Codex danach).
Key
otel.environment
Type / Values
string
Details
Umgebungs-Tag für ausgegebene OpenTelemetry-Ereignisse (Standard: dev).
Key
otel.exporter
Type / Values
none | otlp-http | otlp-grpc
Details
OpenTelemetry-Exporter auswählen und gegebenenfalls Endpunktmetadaten angeben.
Key
otel.exporter.<id>.endpoint
Type / Values
string
Details
Exporter-Endpunkt für OTEL-Logs.
Key
otel.exporter.<id>.headers
Type / Values
map<string,string>
Details
Statische Header, die in Anfragen des OTEL-Exporters enthalten sind.
Key
otel.exporter.<id>.protocol
Type / Values
binary | json
Details
Vom OTLP/HTTP-Exporter verwendetes Protokoll.
Key
otel.exporter.<id>.tls.ca-certificate
Type / Values
string
Details
Pfad zum CA-Zertifikat für die TLS-Verbindung des OTEL-Exporters.
Key
otel.exporter.<id>.tls.client-certificate
Type / Values
string
Details
Pfad zum Clientzertifikat für die TLS-Verbindung des OTEL-Exporters.
Key
otel.exporter.<id>.tls.client-private-key
Type / Values
string
Details
Pfad zum privaten Clientschlüssel für die TLS-Verbindung des OTEL-Exporters.
Key
otel.log_user_prompt
Type / Values
boolean
Details
Export unverarbeiteter Prompts von Nutzenden zusammen mit OpenTelemetry-Logs aktivieren.
Key
otel.metrics_exporter
Type / Values
none | statsig | otlp-http | otlp-grpc
Details
OpenTelemetry-Metrik-Exporter auswählen (Standard: statsig).
Key
otel.trace_exporter
Type / Values
none | otlp-http | otlp-grpc
Details
OpenTelemetry-Trace-Exporter auswählen und gegebenenfalls Endpunktmetadaten angeben.
Key
otel.trace_exporter.<id>.endpoint
Type / Values
string
Details
Endpunkt des Trace-Exporters für OTEL-Logs.
Key
otel.trace_exporter.<id>.headers
Type / Values
map<string,string>
Details
Statische Header, die in Anfragen des OTEL-Trace-Exporters enthalten sind.
Key
otel.trace_exporter.<id>.protocol
Type / Values
binary | json
Details
Vom OTLP/HTTP-Trace-Exporter verwendetes Protokoll.
Key
otel.trace_exporter.<id>.tls.ca-certificate
Type / Values
string
Details
Pfad zum CA-Zertifikat für die TLS-Verbindung des OTEL-Trace-Exporters.
Key
otel.trace_exporter.<id>.tls.client-certificate
Type / Values
string
Details
Pfad zum Clientzertifikat für die TLS-Verbindung des OTEL-Trace-Exporters.
Key
otel.trace_exporter.<id>.tls.client-private-key
Type / Values
string
Details
Pfad zum privaten Clientschlüssel für die TLS-Verbindung des OTEL-Trace-Exporters.
Key
permissions.<name>.description
Type / Values
string
Details
Verständliche Beschreibung dieses benannten Profils. Ein Profil erbt über extends nicht die Beschreibung seines übergeordneten Profils.
Key
permissions.<name>.extends
Type / Values
string
Details
Optionales übergeordnetes Profil, das vor diesem benannten Profil angewendet wird. Gib ein anderes benanntes Profil, :read-only oder :workspace an. :danger-full-access, nicht definierte übergeordnete Profile und Zyklen werden abgelehnt.
Key
permissions.<name>.filesystem
Type / Values
table
Details
Benanntes Berechtigungsprofil für das Dateisystem. Jeder Schlüssel ist ein absoluter Pfad oder ein spezielles Token wie :minimal oder :workspace_roots.
Key
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>
Type / Values
"read" | "write" | "deny"
Details
Dateisystemzugriff, dessen Geltungsbereich relativ zu jedem effektiven Workspace-Stammverzeichnis festgelegt wird. Verwende "." für das Stammverzeichnis selbst; bei Glob-Unterpfaden wie "**/*.env" lässt sich der Lesezugriff mit "deny" verweigern.
Key
permissions.<name>.filesystem.<path-or-glob>
Type / Values
"read" | "write" | "deny" | table
Details
Gewährt direkten Zugriff für einen Pfad, ein Glob-Muster oder ein spezielles Token oder begrenzt den Geltungsbereich verschachtelter Einträge auf dieses Stammverzeichnis. Verwende "deny", um den Lesezugriff auf übereinstimmende Pfade zu verweigern.
Key
permissions.<name>.filesystem.glob_scan_max_depth
Type / Values
number
Details
Maximale Tiefe beim Auflösen von Glob-Mustern für Leseverbote auf Plattformen, die übereinstimmende Pfade vor dem Start der Sandbox als Momentaufnahme erfassen. Muss bei Angabe mindestens 1 betragen.
Key
permissions.<name>.network.allow_local_binding
Type / Values
boolean
Details
Erlaubt über den Netzwerkzugriff in der Sandbox einen umfassenderen Zugriff auf lokale oder private Netzwerke. Zulassungsregeln für exakt angegebene lokale IP-Adressen oder localhost können auch dann bestimmte lokale Ziele freigeben, wenn diese Einstellung false bleibt.
Key
permissions.<name>.network.allow_upstream_proxy
Type / Values
boolean
Details
Erlaubt, den Netzwerkverkehr aus der Sandbox über einen weiteren Upstream-Proxy zu leiten.
Key
permissions.<name>.network.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Erlaubt beliebige Unix-Socket-Ziele anstelle der standardmäßig eingeschränkten Zielauswahl. Nur in streng kontrollierten Umgebungen verwenden.
Key
permissions.<name>.network.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Erlaubt Netzwerk-Listenern der Sandbox, sich an Nicht-Loopback-Adressen zu binden. Bei Aktivierung können die Listener auch außerhalb von localhost erreichbar sein.
Key
permissions.<name>.network.domains
Type / Values
table
Details
Domänenregeln für Befehle in der Sandbox. Sie werden nur durchgesetzt, wenn features.network_proxy oder aktivierte, von der Administration verwaltete Netzwerkanforderungen den Proxy aktivieren. Unterstützt exakt angegebene Hosts, *.example.com, **.example.com und globale Zulassungsregeln mit *; deny hat Vorrang. Schränkt weder die Websuche noch Apps oder MCP-Server ein.
Key
permissions.<name>.network.domains.<pattern>
Type / Values
allow | deny
Details
Legt für einen exakt angegebenen Host oder ein Wildcard-Muster mit begrenztem Geltungsbereich wie *.example.com oder **.example.com fest, ob der Zugriff zugelassen oder verweigert wird.
Key
permissions.<name>.network.enable_socks5
Type / Values
boolean
Details
Stellt SOCKS5-Unterstützung bereit, wenn dieses Berechtigungsprofil den Netzwerkzugriff in der Sandbox aktiviert.
Key
permissions.<name>.network.enable_socks5_udp
Type / Values
boolean
Details
Erlaubt bei Aktivierung UDP über den SOCKS5-Listener.
Key
permissions.<name>.network.enabled
Type / Values
boolean
Details
Aktiviert den Netzwerkzugriff für Befehle in diesem Berechtigungsprofil. Dadurch wird der Netzwerkproxy nicht gestartet. Ohne features.network_proxy oder aktivierte, von der Administration verwaltete Netzwerkanforderungen greifen Befehle direkt auf das Netzwerk zu, und die Domänenregeln des Profils werden nicht durchgesetzt.
Key
permissions.<name>.network.mode
Type / Values
limited | full
Details
Netzwerkproxy-Modus für den Datenverkehr von Unterprozessen.
Key
permissions.<name>.network.proxy_url
Type / Values
string
Details
URL des HTTP-Listeners, die verwendet wird, wenn dieses Berechtigungsprofil den Netzwerkzugriff in der Sandbox aktiviert.
Key
permissions.<name>.network.socks_url
Type / Values
string
Details
Von diesem Berechtigungsprofil verwendeter SOCKS5-Proxy-Endpunkt.
Key
permissions.<name>.network.unix_sockets
Type / Values
table
Details
Überschreibungen für die Unix-Socket-Zulassungsliste beim Netzwerkzugriff in der Sandbox. Verwende Socket-Pfade als Schlüssel; allow fügt einen Pfad hinzu, deny lehnt ihn ab.
Key
permissions.<name>.network.unix_sockets.<path>
Type / Values
allow | deny
Details
Fügt mit allow einen absoluten Unix-Socket-Pfad zur effektiven Zulassungsliste hinzu oder lehnt ihn mit deny ab. Abgelehnte Einträge werden nicht in die effektive Zulassungsliste aufgenommen.
Key
permissions.<name>.workspace_roots
Type / Values
table
Details
Im Profil definierte Workspace-Stammverzeichnisse, für die ebenso wie für die zur Laufzeit geltenden Workspace-Stammverzeichnisse der Sitzung die Dateisystemregeln für :workspace_roots gelten.
Key
permissions.<name>.workspace_roots.<path>
Type / Values
boolean
Details
Nimmt bei true einen Pfad in die Menge der Workspace-Stammverzeichnisse des Profils auf. Deaktivierte Einträge bleiben inaktiv.
Key
personality
Type / Values
none | friendly | pragmatic
Details
Standardmäßiger Kommunikationsstil für Modelle, die supportsPersonality signalisieren. Kann pro Thread oder Turn oder über /personality überschrieben werden.
Key
plan_mode_reasoning_effort
Type / Values
none | minimal | low | medium | high | xhigh
Details
Abweichende Einstellung des Reasoning-Aufwands speziell für den Planmodus. Ist kein Wert festgelegt, verwendet der Planmodus seine integrierte Standardeinstellung.
Key
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Standardmäßiges Genehmigungsverhalten für Tools eines MCP-Servers, den ein Plug-in bereitstellt.
Key
plugins.<plugin>.mcp_servers.<server>.disabled_tools
Type / Values
array<string>
Details
Sperrliste für einen MCP-Server aus einem Plug-in, die nach enabled_tools angewendet wird.
Key
plugins.<plugin>.mcp_servers.<server>.enabled
Type / Values
boolean
Details
Einen in einem installierten Plug-in enthaltenen MCP-Server aktivieren oder deaktivieren, ohne das Plug-in-Manifest zu ändern.
Key
plugins.<plugin>.mcp_servers.<server>.enabled_tools
Type / Values
array<string>
Details
Zulassungsliste für Tools, die ein MCP-Server aus einem Plug-in bereitstellt.
Key
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Überschreibung des Genehmigungsverhaltens für ein einzelnes MCP-Tool aus einem Plug-in.
Key
project_doc_fallback_filenames
Type / Values
array<string>
Details
Zusätzliche Dateinamen, nach denen gesucht wird, wenn AGENTS.md fehlt.
Key
project_doc_max_bytes
Type / Values
number
Details
Maximale Anzahl von Bytes, die beim Zusammenstellen von Projektanweisungen aus AGENTS.md gelesen werden.
Key
project_root_markers
Type / Values
array<string>
Details
Liste der Dateinamen, die das Projektstammverzeichnis kennzeichnen. Sie wird verwendet, um in übergeordneten Verzeichnissen nach dem Projektstammverzeichnis zu suchen.
Key
projects.<path>.trust_level
Type / Values
string
Details
Kennzeichnet ein Projekt oder einen Worktree als vertrauenswürdig oder nicht vertrauenswürdig ("trusted" | "untrusted"). Bei nicht vertrauenswürdigen Projekten werden projektspezifische Ebenen unter .codex/ übersprungen, darunter projektlokale Konfiguration, Hooks und Regeln.
Key
review_model
Type / Values
string
Details
Optionales abweichendes Modell für /review (standardmäßig wird das Modell der aktuellen Sitzung verwendet).
Key
sandbox_mode
Type / Values
read-only | workspace-write | danger-full-access
Details
Sandbox-Richtlinie für Dateisystem- und Netzwerkzugriff während der Befehlsausführung.
Key
sandbox_workspace_write.exclude_slash_tmp
Type / Values
boolean
Details
/tmp im workspace-write-Modus aus den Stammverzeichnissen mit Schreibzugriff ausschließen.
Key
sandbox_workspace_write.exclude_tmpdir_env_var
Type / Values
boolean
Details
$TMPDIR im workspace-write-Modus aus den Stammverzeichnissen mit Schreibzugriff ausschließen.
Key
sandbox_workspace_write.network_access
Type / Values
boolean
Details
Ausgehenden Netzwerkzugriff innerhalb der workspace-write-Sandbox zulassen.
Key
sandbox_workspace_write.writable_roots
Type / Values
array<string>
Details
Zusätzliche Stammverzeichnisse mit Schreibzugriff bei sandbox_mode = "workspace-write".
Key
service_tier
Type / Values
string
Details
Bevorzugte Servicestufe für neue Turns. Verwende fast oder eine andere vom aktiven Modell angebotene Stufe; fast wird dem Anfragewert priority zugeordnet.
Key
shell_environment_policy.exclude
Type / Values
array<string>
Details
Ältere Ausschlussmuster für Umgebungsvariablen. Verwende für neue Konfigurationen shell_environment_policy.filters. Kombiniere beide Formen nicht auf derselben Ebene.
Key
shell_environment_policy.experimental_use_profile
Type / Values
boolean
Details
Beim Starten von Unterprozessen das Shell-Profil des Benutzerkontos verwenden.
Key
shell_environment_policy.filters
Type / Values
map<string, include | exclude>
Details
Kanonische Musterfilter für Umgebungsvariablen ohne Beachtung der Groß- und Kleinschreibung. Einschlussregeln bilden eine Allowlist und können ausgeschlossene Werte nicht wiederherstellen. Explizit mit set festgelegte Werte werden nach den Ausschlüssen angewendet. Kombiniere diese Filter auf derselben Konfigurationsebene nicht mit den älteren Arrays exclude oder include_only.
Key
shell_environment_policy.ignore_default_excludes
Type / Values
boolean
Details
Variablen, deren Namen KEY, SECRET oder TOKEN enthalten, vor der Anwendung anderer Filter beibehalten (Standard: true). Setze den Wert auf false, damit Variablen mit Namen, die auf geheime Werte hindeuten, automatisch ausgeschlossen werden.
Key
shell_environment_policy.include_only
Type / Values
array<string>
Details
Ältere Allowlist mit Mustern für Umgebungsvariablen. Verwende für neue Konfigurationen shell_environment_policy.filters. Kombiniere beide Formen nicht auf derselben Ebene.
Key
shell_environment_policy.inherit
Type / Values
all | core | none
Details
Grundlegende Regeln für die Vererbung der Umgebung beim Starten von Unterprozessen.
Key
shell_environment_policy.set
Type / Values
map<string,string>
Details
Explizite Umgebungswerte, die nach Anwendung der Ausschlussregeln eingefügt werden. Einschlussfilter können sie dennoch entfernen.
Key
show_raw_agent_reasoning
Type / Values
boolean
Details
Unverarbeitete Reasoning-Inhalte anzeigen, wenn das aktive Modell sie ausgibt.
Key
skills.config
Type / Values
array<object>
Details
In config.toml gespeicherte Vorgaben, die den Aktivierungsstatus einzelner Skills überschreiben.
Key
skills.config.<index>.enabled
Type / Values
boolean
Details
Den angegebenen Skill aktivieren oder deaktivieren.
Key
skills.config.<index>.path
Type / Values
string (path)
Details
Pfad zu einem Skill-Ordner, der SKILL.md enthält.
Key
sqlite_home
Type / Values
string (path)
Details
Verzeichnis, in dem Codex die SQLite-basierte Zustandsdatenbank für Agentenaufträge und andere fortsetzbare Laufzeitzustände speichert.
Key
suppress_unstable_features_warning
Type / Values
boolean
Details
Die Warnung unterdrücken, die bei aktivierten Feature-Flags für noch in Entwicklung befindliche Funktionen angezeigt wird.
Key
tool_output_token_limit
Type / Values
number
Details
Token-Budget zum Speichern einzelner Tool- oder Funktionsausgaben im Verlauf.
Key
tool_suggest.disabled_tools
Type / Values
array<table>
Details
Vorschläge für bestimmte auffindbare Konnektoren oder Plug-ins deaktivieren. Jeder Eintrag verwendet type = "connector" oder "plugin" sowie eine id.
Key
tool_suggest.discoverables
Type / Values
array<table>
Details
Tool-Vorschläge für weitere auffindbare Konnektoren oder Plug-ins zulassen. Jeder Eintrag verwendet type = "connector" oder "plugin" sowie eine id.
Key
tools.view_image
Type / Values
boolean
Details
Tool view_image zum Anhängen lokaler Bilder aktivieren.
Key
tools.web_search
Type / Values
boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } }
Details
Optionale Konfiguration des Tools für die Websuche. In der Objektform kannst du die Größe des Suchkontexts, die zulässigen Suchdomains und den ungefähren Standort der nutzenden Person festlegen. Diese Filter für Suchdomains sind unabhängig von den Domainregeln für Netzwerkzugriffe von Befehlen in der Sandbox und schränken weder Konnektoren noch MCP-Server ein.
Key
tui
Type / Values
table
Details
TUI-spezifische Optionen, beispielsweise zum Aktivieren von Inline-Desktop-Benachrichtigungen.
Key
tui.alternate_screen
Type / Values
auto | always | never
Details
Nutzung des alternativen Bildschirmpuffers für die TUI steuern (Standard: auto; bei auto wird er in Zellij nicht verwendet, damit der Scrollback-Verlauf erhalten bleibt).
Key
tui.animations
Type / Values
boolean
Details
Terminalanimationen (Willkommensbildschirm, Schimmereffekt, rotierender Ladeindikator) aktivieren (Standard: true).
Key
tui.keymap.<context>.<action>
Type / Values
string | array<string>
Details
Tastenkombination für eine TUI-Aktion. Unterstützte Kontexte sind unter anderem global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list und approval. Bestimmte Aktionen im Editor greifen ersatzweise auf passende Belegungen in tui.keymap.global zurück; kontextspezifische Belegungen haben Vorrang, wenn sie unterstützt werden.
Key
tui.keymap.<context>.<action> = []
Type / Values
empty array
Details
Tastenbelegung für die Aktion in diesem Belegungskontext entfernen. Tastennamen werden als normalisierte Zeichenfolgen wie ctrl-a, shift-enter, page-down oder minus angegeben.
Key
tui.model_availability_nux.<model>
Type / Values
integer
Details
Interner Status des beim Start angezeigten Tooltips, mit dem Modell-Slug als Schlüssel.
Key
tui.notification_condition
Type / Values
unfocused | always
Details
Legt fest, ob TUI-Benachrichtigungen nur bei nicht fokussiertem Terminal oder unabhängig vom Fokus ausgelöst werden. Standard: unfocused.
Key
tui.notification_method
Type / Values
auto | osc9 | bel
Details
Methode für Terminalbenachrichtigungen (Standard: auto).
Key
tui.notifications
Type / Values
boolean | array<string>
Details
TUI-Benachrichtigungen aktivieren und optional auf bestimmte Ereignistypen beschränken.
Key
tui.raw_output_mode
Type / Values
boolean
Details
Die TUI im Raw-Scrollback-Modus starten, um Text bequem im Terminal auswählen und kopieren zu können (Standard: false). Du kannst den Modus mit /raw oder der Standard-Tastenkombination alt-r umschalten.
Key
tui.resume_cwd
Type / Values
current | session
Details
Arbeitsverzeichnis für das Fortsetzen oder Forken einer Sitzung. Ist kein Wert festgelegt und unterscheidet sich dein aktuelles Verzeichnis vom gespeicherten Verzeichnis der Sitzung, fordert Codex dich zur Auswahl auf.
Key
tui.show_tooltips
Type / Values
boolean
Details
Tooltips für den Einstieg auf dem Willkommensbildschirm der TUI anzeigen (Standard: true).
Key
tui.status_line
Type / Values
array<string> | null
Details
Geordnete Liste der Elementkennungen für die Statuszeile in der TUI-Fußzeile. null deaktiviert die Statuszeile.
Key
tui.terminal_title
Type / Values
array<string> | null
Details
Geordnete Liste der Elementkennungen für den Titel des Terminalfensters oder -Tabs. Standard: ["spinner", "project"]; null deaktiviert Titelaktualisierungen.
Key
tui.theme
Type / Values
string
Details
Theme für die Syntaxhervorhebung überschreiben (Theme-Name in Kebab-Case).
Key
tui.vim_mode_default
Type / Values
boolean
Details
Den Editor im Vim-Normalmodus statt im Einfügemodus starten (Standard: false). Du kannst den Modus weiterhin pro Sitzung mit /vim umschalten.
Key
web_search
Type / Values
disabled | cached | indexed | live
Details
Modus für die Websuche (Standard: "cached"; cached nutzt einen von OpenAI gepflegten Index ohne externen Webzugriff; indexed erlaubt externen Zugriff nur, wenn der Suchindex ihn zulässt; bei Verwendung von --yolo oder einer anderen Sandbox-Einstellung mit Vollzugriff ist der Standardwert "live"). Verwende "live" für uneingeschränkte Live-Abrufe oder "disabled", um das Tool zu entfernen.
Key
windows_wsl_setup_acknowledged
Type / Values
boolean
Details
Erfassen, ob das Windows-Onboarding bestätigt wurde (nur Windows).
Key
windows.sandbox
Type / Values
unelevated | elevated
Details
Nativer Sandbox-Modus nur für Windows, wenn Codex nativ unter Windows ausgeführt wird.
Key
windows.sandbox_private_desktop
Type / Values
boolean
Details
Wenn Codex nativ unter Windows läuft, wird der abschließende Unterprozess in der Sandbox standardmäßig auf einem privaten Desktop ausgeführt. Setze den Wert nur auf false, wenn du Kompatibilität mit dem älteren Verhalten von Winsta0\\Default benötigst.

Das aktuelle JSON-Schema für config.toml findest du hier.

Um beim Bearbeiten von config.toml in VS Code oder Cursor Autovervollständigung und Diagnosemeldungen zu erhalten, kannst du die Erweiterung Even Better TOML installieren und diese Zeile am Anfang deiner config.toml einfügen:

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

Hinweis: Benenne experimental_instructions_file in model_instructions_file um. Codex stuft den alten Schlüssel als veraltet ein. Aktualisiere bestehende Konfigurationen und verwende den neuen Namen.

requirements.toml

requirements.toml ist eine von der Administration vorgegebene Konfigurationsdatei, die sicherheitsrelevante Einstellungen verbindlich einschränkt. Nutzende können diese Vorgaben nicht überschreiben. Details, Speicherorte und Beispiele findest du unter Von der Administration vorgegebene Anforderungen.

Für Nutzende von ChatGPT Business und ChatGPT Enterprise kann Codex auch aus der Cloud abgerufene Anforderungen anwenden. Auf der Sicherheitsseite findest du Details dazu, welche Einstellungen Vorrang haben.

Verwende [features] in requirements.toml, um Feature-Flags für die Laufzeit anhand derselben kanonischen Schlüssel verbindlich festzulegen, die auch config.toml verwendet. Anforderungen können außerdem dokumentierte Schlüssel enthalten, die nur für die App gelten und nicht in config.toml gehören. Nicht angegebene Schlüssel bleiben uneingeschränkt.

Einige verwaltete Anforderungen erzwingen einen exakten Konfigurationswert statt einer Zulassungsliste. Nutzende können verbindlich vorgegebene Pfade, Update-Einstellungen, Login-Shell-Richtlinien, Feedback-Einstellungen oder Einstellungen 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 ältere Versionen ignorieren allowed_permission_profiles sowie die verwaltete Einstellung default_permissions.

Verwende allowed_sandbox_modes zusammen mit sandbox_mode. Verwende für Bereitstellungen mit Berechtigungsprofilen allowed_permission_profiles zusammen mit der verwalteten Einstellung default_permissions.

Die Tabelle [models.new_thread] enthält verwaltete Standardwerte, erzwingt sie aber nicht. Explizite Startoptionen über spezielle CLI-Flags oder Überschreibungen mit --config haben Vorrang. Wird das Modell oder der Reasoning-Aufwand explizit überschrieben, werden beide verwalteten Modellfelder übersprungen; service_tier ist davon unabhängig.

Key
allow_appshots
Type / Values
boolean
Details
Setze den Wert auf false, um Appshots für verwaltete Nutzerkonten zu deaktivieren. Wird der Wert weggelassen, schränken die Anforderungen Appshots nicht ein. Es gilt dann die reguläre Produktverfügbarkeit.
Key
allow_login_shell
Type / Values
boolean
Details
Legt verbindlich fest, ob Shell-Tools eine Login-Shell starten dürfen.
Key
allow_managed_hooks_only
Type / Values
boolean
Details
Bei true überspringt Codex Nutzer-, Projekt-, Sitzungs- und Plug-in-Hooks. Verwaltete Hooks aus requirements.toml und anderen verwalteten Konfigurationsebenen bleiben zulässig.
Key
allow_remote_control
Type / Values
boolean
Details
Setze den Wert auf false, um die Fernsteuerung von Geräten für verwaltete Nutzerkonten zu deaktivieren. Wird der Wert weggelassen, schränken die Anforderungen die Fernsteuerung von Geräten nicht ein. Es gilt dann die reguläre Produktverfügbarkeit.
Key
allowed_approval_policies
Type / Values
array<string>
Details
Zulässige Werte für approval_policy (zum Beispiel untrusted, on-request, never und granular).
Key
allowed_approvals_reviewers
Type / Values
array<string>
Details
Zulässige Werte für approvals_reviewer, etwa user und auto_review.
Key
allowed_permission_profiles
Type / Values
table<boolean>
Details
Vollständige Liste der zulässigen Berechtigungsprofile. Profile mit dem Wert true sind zulässig. Nicht aufgeführte oder auf false gesetzte Profile werden abgelehnt; das gilt auch für Profile, die in zukünftigen Versionen hinzukommen. Wenn Anforderungsquellen kombiniert werden, werden Einträge anhand des Profilnamens abgeglichen.
Key
allowed_permission_profiles.<name>
Type / Values
boolean
Details
Lässt ein integriertes oder benutzerdefiniertes Berechtigungsprofil zu oder lehnt es ab, das in einer geladenen Konfigurations- oder Anforderungsquelle definiert ist. Eine spätere Anforderungsquelle mit höherer Priorität kann mit false ein Profil deaktivieren, das eine frühere Quelle mit niedrigerer Priorität zugelassen hat.
Key
allowed_sandbox_modes
Type / Values
array<string>
Details
Zulässige Werte für sandbox_mode.
Key
allowed_web_search_modes
Type / Values
array<string>
Details
Zulässige Werte für web_search (disabled, cached, indexed, live). disabled ist immer zulässig; eine leere Liste lässt praktisch nur disabled zu.
Key
apps
Type / Values
table
Details
Verwaltete Anforderungen für Apps, bei denen die App-ID als Schlüssel dient. Diese Anforderungen können eine App deaktivieren oder das Genehmigungsverhalten für einzelne Tools einschränken.
Key
apps.<id>.enabled
Type / Values
boolean
Details
Setze den Wert auf false, um eine App zu deaktivieren. Die Deaktivierung bleibt auch dann verbindlich, wenn mehrere Anforderungsquellen zusammengeführt werden.
Key
apps.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Lege den verwalteten Genehmigungsmodus für ein einzelnes App-Tool fest.
Key
check_for_update_on_startup
Type / Values
boolean
Details
Legt verbindlich fest, ob Codex beim Start nach Updates sucht.
Key
computer_use
Type / Values
table
Details
Über requirements.toml durchgesetzte Anforderungen an die Computernutzung.
Key
computer_use.allow_locked_computer_use
Type / Values
boolean
Details
Setze den Wert auf false, um zu verhindern, dass die Computernutzung nach dem Sperren eines verwalteten macOS-Geräts fortgesetzt wird. Wird der Wert weggelassen, unterliegt die Nutzung bei gesperrtem Gerät keinen Einschränkungen durch die Anforderungen.
Key
default_permissions
Type / Values
string
Details
Verwaltetes Standardprofil für Berechtigungen. Das Profil muss durch allowed_permission_profiles zugelassen sein. Lege diesen Wert explizit fest, damit das Verhalten vorhersehbar ist. Wird er nicht angegeben, verwendet Codex nur dann standardmäßig :workspace, wenn sowohl :workspace als auch :read-only ausdrücklich zugelassen sind.
Key
enforce_residency
Type / Values
string
Details
Schreibt für den Datenverkehr der Codex-Dienste eine unterstützte Datenresidenz vor. Derzeit wird us akzeptiert.
Key
experimental_network
Type / Values
table
Details
Administrativ verwaltete Netzwerkanforderungen für lokale Befehle in der Sandbox, die über requirements.toml durchgesetzt werden. Wenn sie aktiviert sind, können sie den Netzwerkproxy für Befehle auch ohne features.network_proxy starten. Sie regeln weder die Websuche noch Apps, MCP-Server, Browser oder den Netzwerkverkehr von Codex Cloud.
Key
experimental_network.allow_local_binding
Type / Values
boolean
Details
Erlaubt aus der Sandbox heraus umfassenderen Zugriff auf lokale oder private Netzwerke. Zulassungsregeln für exakt angegebene lokale IP-Adressen oder für localhost können weiterhin bestimmte lokale Ziele freigeben, wenn der Wert false bleibt.
Key
experimental_network.allow_upstream_proxy
Type / Values
boolean
Details
Erlaubt, den Netzwerkverkehr aus der Sandbox über einen in der Umgebung angegebenen Upstream-Proxy weiterzuleiten.
Key
experimental_network.allowed_domains
Type / Values
array<string>
Details
Administrativ verwaltete Zulassungsregeln für den Netzwerkzugriff von Befehlen in der Sandbox, solange der verwaltete Netzwerkproxy aktiviert ist. Diese Regeln gelten nicht für die Websuche, Apps oder MCP-Server. Nicht mit experimental_network.domains kombinieren.
Key
experimental_network.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Erlaubt beliebige Unix-Socket-Ziele statt nur der Ziele aus der Zulassungsliste. Nur in streng kontrollierten Umgebungen verwenden.
Key
experimental_network.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Lässt für Anforderungen unter [experimental_network] Listener-Adressen zu, die nicht auf die Loopback-Schnittstelle beschränkt sind. Dadurch können Listener auch außerhalb von localhost erreichbar sein.
Key
experimental_network.denied_domains
Type / Values
array<string>
Details
Administrativ verwaltete Sperrregeln in Listenform für den Netzwerkzugriff in der Sandbox. Nicht mit experimental_network.domains kombinieren.
Key
experimental_network.domains
Type / Values
map<string, allow | deny>
Details
Administrativ verwaltete Domain-Richtlinie in Map-Form für den Netzwerkzugriff in der Sandbox. Unterstützt exakt angegebene Hosts, *.example.com nur für Subdomains, **.example.com für die Apex-Domain einschließlich Subdomains sowie globale Zulassungsregeln mit *. Bevorzuge eingegrenzte Regeln, da * ausgehenden Zugriff auf öffentliche Ziele weitgehend freigibt. Bei Konflikten hat deny Vorrang. Nicht mit experimental_network.allowed_domains oder experimental_network.denied_domains kombinieren.
Key
experimental_network.enabled
Type / Values
boolean
Details
Aktiviert Anforderungen an den Netzwerkzugriff in der Sandbox. Dadurch wird kein Netzwerkzugriff gewährt, wenn der Netzwerkzugriff für Befehle in der aktiven Sandbox deaktiviert ist.
Key
experimental_network.http_port
Type / Values
integer
Details
Port des HTTP-Listeners auf der Loopback-Schnittstelle für die Anforderungen unter [experimental_network].
Key
experimental_network.managed_allowed_domains_only
Type / Values
boolean
Details
Bei true gelten ausschließlich administrativ verwaltete Zulassungsregeln, solange Anforderungen an den Netzwerkzugriff in der Sandbox aktiv sind. Ergänzungen der Zulassungsliste auf Nutzerseite werden ignoriert. Auch wenn keine verwalteten Zulassungsregeln vorhanden sind, bleiben auf Nutzerseite hinzugefügte Domain-Zulassungsregeln unwirksam.
Key
experimental_network.socks_port
Type / Values
integer
Details
Port des SOCKS5-Listeners auf der Loopback-Schnittstelle für die Anforderungen unter [experimental_network].
Key
experimental_network.unix_sockets
Type / Values
map<string, allow | deny>
Details
Administrativ verwaltete Unix-Socket-Richtlinie für den Netzwerkzugriff in der Sandbox.
Key
features
Type / Values
table
Details
Festgeschriebene Werte für Funktionen. Verwende für Laufzeitfunktionen die kanonischen Namen aus config.toml; dokumentierte Anforderungsschlüssel, die nur für die App gelten, werden hier ebenfalls unterstützt.
Key
features.<name>
Type / Values
boolean
Details
Schreibt vor, dass eine dokumentierte Laufzeit- oder App-Funktion aktiviert oder deaktiviert bleibt.
Key
features.apps
Type / Values
boolean
Details
Legt für verwaltete Nutzerkonten verbindlich fest, ob die Apps-Integration verfügbar ist.
Key
features.browser_use
Type / Values
boolean
Details
Setze den Wert in requirements.toml auf false, um die Computernutzung in Browsern und den Browser-Agenten zu deaktivieren.
Key
features.browser_use_external
Type / Values
boolean
Details
Setze den Wert in requirements.toml auf false, um die Computernutzung in externen Browsern zu deaktivieren.
Key
features.browser_use_full_cdp_access
Type / Values
boolean
Details
Setze den Wert in requirements.toml auf false, um den vollständigen Zugriff auf das Chrome DevTools Protocol in der lokalen Laufzeitumgebung einschließlich des Browser-Entwicklermodus zu deaktivieren. Damit verhinderst du auch, dass die ChatGPT-Desktop-App die entsprechende Einstellung aktiviert. Wird der Wert weggelassen, gilt die reguläre Produktverfügbarkeit.
Key
features.computer_use
Type / Values
boolean
Details
Setze den Wert in requirements.toml auf false, um die Computernutzung, „Aufzeichnen und Wiedergeben“ sowie zugehörige Installations- oder Aktivierungsabläufe zu deaktivieren.
Key
features.fast_mode
Type / Values
boolean
Details
Legt für verwaltete Nutzerkonten verbindlich fest, ob die kanonische Funktion fast_mode aktiviert ist.
Key
features.guardian_approval
Type / Values
boolean
Details
Legt für verwaltete Nutzerkonten verbindlich fest, ob Genehmigungen durch Guardian verfügbar sind.
Key
features.in_app_browser
Type / Values
boolean
Details
Setze den Wert in requirements.toml auf false, um den integrierten Browserbereich zu deaktivieren.
Key
features.in_app_updates
Type / Values
boolean
Details
Setze den Wert in requirements.toml auf false, um In-App-Updates zu deaktivieren. Wird diese Anforderung weggelassen, bleiben Updates standardmäßig aktiviert.
Key
features.memories
Type / Values
boolean
Details
Legt für verwaltete Nutzerkonten verbindlich fest, ob Erinnerungen verfügbar sind.
Key
features.multi_agent
Type / Values
boolean
Details
Legt für verwaltete Nutzerkonten verbindlich fest, ob Multi-Agent-Funktionen verfügbar sind.
Key
features.plugin_sharing
Type / Values
boolean
Details
Setze den Wert in der über die Cloud verwalteten requirements.toml auf false, um das Teilen lokal erstellter Plug-ins im Workspace zu deaktivieren.
Key
features.plugins
Type / Values
boolean
Details
Legt für verwaltete Nutzerkonten verbindlich fest, ob Plug-ins verfügbar sind.
Key
features.remote_plugin
Type / Values
boolean
Details
Legt für verwaltete Nutzerkonten verbindlich fest, ob der Remote-Plug-in-Katalog verfügbar ist.
Key
features.workspace_dependencies
Type / Values
boolean
Details
Legt für verwaltete Nutzerkonten verbindlich fest, ob die mitgelieferte Laufzeitumgebung für Workspace-Abhängigkeiten verfügbar ist.
Key
feedback
Type / Values
table
Details
Verwaltete Feedback-Einstellungen.
Key
feedback.enabled
Type / Values
boolean
Details
Legt verbindlich fest, ob Nutzende über Codex-Clients Feedback senden können.
Key
guardian_policy_config
Type / Values
string
Details
Verwaltete Richtlinienvorgaben in Markdown für die automatische Überprüfung. Sie haben Vorrang vor der lokalen Einstellung [auto_review].policy. Leere Werte werden ignoriert.
Key
hooks
Type / Values
table
Details
Administrativ durchgesetzte, verwaltete Lebenszyklus-Hooks. Sie erfordern ein Verzeichnis für verwaltete Hooks und verwenden dasselbe Ereignisschema wie die Inline-Konfiguration [hooks] in config.toml.
Key
hooks.<Event>
Type / Values
array<table>
Details
Matcher-Gruppen für ein Hook-Ereignis wie PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit oder Stop.
Key
hooks.<Event>[].hooks
Type / Values
array<table>
Details
Hook-Handler für eine Matcher-Gruppe. Befehls-Hooks und MCP-Tool-Hooks werden unterstützt; Handler für Prompt- und Agenten-Hooks werden geparst, aber übersprungen.
Key
hooks.<Event>[].hooks[].additionalContextLimit
Type / Values
integer
Details
Ungefährer Token-Schwellenwert pro Handler, ab dem zu umfangreiche Inhalte aus additionalContext auf dem Datenträger gespeichert werden und das Modell eine kürzere Vorschau erhält. Der Standardwert ist 2500; bei 0 erhält das Modell direkt den vollständigen Kontext. Siehe Umfangreiche Hook-Ausgaben.
Key
hooks.<Event>[].hooks[].async
Type / Values
boolean
Details
Führt einen Befehls-Hook im Hintergrund aus, ohne den auslösenden Vorgang zu verzögern. Der Standardwert ist false; SessionEnd wird immer synchron ausgeführt. Siehe Hooks im Hintergrund ausführen.
Key
hooks.<Event>[].hooks[].commandWindows
Type / Values
string
Details
Überschreibt den Befehl für Befehls-Hooks nur unter Windows. Der TOML-Alias command_windows wird ebenfalls akzeptiert.
Key
hooks.managed_dir
Type / Values
string (absolute path)
Details
Verzeichnis mit verwalteten Hook-Skripten unter macOS und Linux. Codex prüft vor dem Laden der verwalteten Hooks, ob der Pfad absolut und das Verzeichnis vorhanden ist.
Key
hooks.windows_managed_dir
Type / Values
string (absolute path)
Details
Verzeichnis mit verwalteten Hook-Skripten unter Windows. Codex prüft vor dem Laden der verwalteten Hooks, ob der Pfad absolut und das Verzeichnis vorhanden ist.
Key
log_dir
Type / Values
string (path)
Details
Legt verbindlich das Verzeichnis fest, in das Codex lokale Protokolldateien schreibt.
Key
marketplaces
Type / Values
table
Details
Administrative Anforderungen für Quellen von Plug-in-Marketplaces. Die Regeln gelten, wenn restrict_to_allowed_sources auf true gesetzt ist.
Key
marketplaces.allowed_sources
Type / Values
table
Details
Zulässige Marketplace-Quellen, deren Schlüssel administrativ festgelegte Regelnamen sind. Über mehrere Anforderungsebenen hinweg bleiben Regeln mit unterschiedlichen Namen jeweils erhalten; für Felder unter demselben Namen gilt die übliche Prioritätsreihenfolge der Ebenen.
Key
marketplaces.allowed_sources.<name>
Type / Values
table
Details
Eine Regel für eine zulässige Quelle. Nach dem Zusammenführen der Anforderungen bestimmt der endgültige Wert von source, welche weiteren Felder auf derselben Ebene Codex auswertet.
Key
marketplaces.allowed_sources.<name>.host_pattern
Type / Values
string
Details
Regulärer Ausdruck, der bei source = "host_pattern" erforderlich ist. Codex gleicht ihn mit dem in Kleinbuchstaben umgewandelten Hostnamen ab, den es aus einer Git-Quelle im HTTPS-, SSH- oder SCP-Format extrahiert. Verwende ^ und $, damit der gesamte Hostname übereinstimmen muss.
Key
marketplaces.allowed_sources.<name>.path
Type / Values
string (absolute path)
Details
Lokales Marketplace-Verzeichnis, das bei source = "local" erforderlich ist. Codex verlangt einen absoluten Pfad und vergleicht Pfade nach der Normalisierung.
Key
marketplaces.allowed_sources.<name>.ref
Type / Values
string
Details
Optionale exakte Git-Referenz für eine git-Regel. Ohne diese Angabe lässt die Regel jede Referenz für das passende Repository zu.
Key
marketplaces.allowed_sources.<name>.source
Type / Values
git | host_pattern | local
Details
Abgleichstyp für Marketplace-Quellen. Verwende git für ein Repository, host_pattern für Git-Hosts, die mit einem regulären Ausdruck abgeglichen werden, oder local für ein Verzeichnis.
Key
marketplaces.allowed_sources.<name>.url
Type / Values
string
Details
URL des Git-Repositorys, die bei source = "git" erforderlich ist. Codex normalisiert die konfigurierten und zulässigen URLs. Danach müssen die Repositorys exakt übereinstimmen.
Key
marketplaces.restrict_to_allowed_sources
Type / Values
boolean
Details
Wenn der Wert true ist, müssen von Nutzenden konfigurierte Marketplace-Quellen beim Hinzufügen von Marketplaces, bei der Installation von Plug-ins und bei der Aktualisierung konfigurierter Git-Marketplaces mit allowed_sources übereinstimmen. Von Codex verwaltete OpenAI-Marketplaces bleiben zulässig, wenn ihre Quelle und ihr Name den reservierten Werten entsprechen. Bereits von Nutzenden konfigurierte Marketplaces werden dadurch zur Laufzeit nicht gefiltert.
Key
mcp_servers
Type / Values
table
Details
Zulassungsliste für MCP-Server, die aktiviert werden dürfen. Damit ein MCP-Server aktiviert werden kann, müssen sowohl der Servername (<id>) als auch seine Identität übereinstimmen. Alle konfigurierten MCP-Server, die nicht in der Zulassungsliste stehen oder deren Identität nicht übereinstimmt, werden deaktiviert.
Key
mcp_servers.<id>.identity
Type / Values
table
Details
Identitätsregel für einen einzelnen MCP-Server. Lege entweder command (stdio) oder url (streamable HTTP) fest.
Key
mcp_servers.<id>.identity.command
Type / Values
string | table
Details
Lässt einen MCP-Server mit stdio-Transport anhand einer exakt übereinstimmenden Befehlszeichenfolge zu. Alternativ kannst du über eine Matcher-Tabelle eine exakt übereinstimmende ausführbare Datei und Argument-Matcher in festgelegter Reihenfolge vorgeben. Die Zeichenfolgenform prüft weder Argumente noch cwd, env oder env_vars.
Key
mcp_servers.<id>.identity.command.args
Type / Values
array<table>
Details
Argument-Matcher in festgelegter Reihenfolge für einen stdio-Server. Die konfigurierte Argumentliste muss dieselbe Länge haben und an jeder Position den zugehörigen Matcher erfüllen. Befehls-Matcher prüfen weder cwd noch env noch env_vars.
Key
mcp_servers.<id>.identity.command.args[].expression
Type / Values
string
Details
Regulärer Ausdruck für einen Argument-Matcher vom Typ regex. Der Ausdruck muss gültig sein und auf den vollständigen Argumentwert passen.
Key
mcp_servers.<id>.identity.command.args[].match
Type / Values
exact | prefix | regex
Details
Abgleichsoperation für diese Argumentposition.
Key
mcp_servers.<id>.identity.command.args[].value
Type / Values
string
Details
Wert, den ein Argument-Matcher vom Typ exact oder prefix verwendet.
Key
mcp_servers.<id>.identity.command.executable
Type / Values
string
Details
Ausführbare Datei, mit der der für den stdio-Server konfigurierte Wert von command exakt übereinstimmen muss.
Key
mcp_servers.<id>.identity.url
Type / Values
string | table
Details
Lässt einen MCP-Server mit streamable HTTP anhand einer exakt übereinstimmenden URL-Zeichenfolge zu. Alternativ kannst du eine Tabelle für einen Wert-Matcher vom Typ exact, prefix oder regex verwenden.
Key
mcp_servers.<id>.identity.url.expression
Type / Values
string
Details
Regulärer Ausdruck für einen URL-Matcher vom Typ regex. Der Ausdruck muss gültig sein und auf den vollständigen URL-Wert passen.
Key
mcp_servers.<id>.identity.url.match
Type / Values
exact | prefix | regex
Details
Abgleichsoperation für die konfigurierte URL des MCP-Servers.
Key
mcp_servers.<id>.identity.url.value
Type / Values
string
Details
Wert, den ein URL-Matcher vom Typ exact oder prefix verwendet.
Key
model_catalog_json
Type / Values
string (path)
Details
Legt verbindlich den JSON-Modellkatalog fest, den Codex beim Start verwendet.
Key
models
Type / Values
table
Details
Verwaltete Standardwerte für Modelle in neuen Threads. Diese Werte haben Vorrang vor Standardwerten auf Benutzer- und Projektebene. Eine explizite Auswahl für den neuen Thread kann sie jedoch überschreiben.
Key
models.new_thread
Type / Values
table
Details
Standardwerte, die beim Start eines neuen lokalen Threads angewendet werden. Jede Modelleinstellung ist optional.
Key
models.new_thread.model
Type / Values
string
Details
Standardmodell für neue Threads. Eine explizite Überschreibung mit --model oder eine Überschreibung des Modells beziehungsweise des Reasoning-Aufwands mit --config hat Vorrang.
Key
models.new_thread.model_reasoning_effort
Type / Values
string
Details
Standardmäßiger Reasoning-Aufwand für neue Threads. Wird das Modell oder der Reasoning-Aufwand explizit überschrieben, werden beide verwalteten Modellfelder übersprungen.
Key
models.new_thread.service_tier
Type / Values
string
Details
Standardmäßige Servicestufe für neue Threads. Eine explizite Überschreibung der Servicestufe hat unabhängig von den Modellfeldern Vorrang.
Key
permissions
Type / Values
table
Details
Von der Administration definierte Berechtigungsprofile mit dem Profilnamen als Schlüssel. Es werden dieselben Profilfelder wie in config.toml verwendet.
Key
permissions.<name>
Type / Values
table
Details
Von der Administration definiertes Berechtigungsprofil. Der Name darf nicht mit : beginnen, nicht dem reservierten Namen filesystem entsprechen und nicht mit dem Namen eines Profils aus einer geladenen Konfiguration übereinstimmen. Das Profil verwendet dieselben Felder wie in config.toml; das vollständige Profilschema findest du im Leitfaden zu Berechtigungen.
Key
permissions.filesystem.deny_read
Type / Values
array<string>
Details
Administrativ durchgesetzte Lesesperren im Dateisystem. Einträge können Pfade oder Glob-Muster sein; diese Sperren lassen sich über die lokale Konfiguration nicht abschwächen.
Key
plugins
Type / Values
table
Details
Plug-in-spezifische Zulassungslisten für MCP-Server mit Plug-in-Kennungen als Schlüsseln. Wenn diese Tabelle vorhanden ist, werden mit Plug-ins ausgelieferte Server deaktiviert, für die kein passender Plug-in- und Servereintrag vorhanden ist.
Key
plugins.<plugin>.mcp_servers
Type / Values
table
Details
Zulassungsliste für MCP-Server, die mit einem Plug-in ausgeliefert werden. Anforderungen für Plug-in-Server verwenden dieselben Formen für den exakten Identitätsabgleich und für Matcher wie die Anforderungen für mcp_servers auf oberster Ebene.
Key
plugins.<plugin>.mcp_servers.<server>.identity
Type / Values
table
Details
Identitätsregel für einen mit einem Plug-in ausgelieferten MCP-Server. Lege entweder command (stdio) oder url (streamable HTTP) fest.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command
Type / Values
string | table
Details
Lasse den stdio-MCP-Server eines Plug-ins anhand einer exakt übereinstimmenden Befehlszeichenfolge zu oder verwende eine Abgleichstabelle, die eine exakt übereinstimmende ausführbare Datei und Abgleichsregeln für Argumente in festgelegter Reihenfolge vorschreibt.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args
Type / Values
array<table>
Details
Geordnete Abgleichsregeln für die Argumente eines im Plug-in enthaltenen stdio-Servers. Die konfigurierte Argumentliste muss dieselbe Länge haben, und an jeder Position muss der Abgleich erfolgreich sein.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression
Type / Values
string
Details
Regulärer Ausdruck für einen Argumentabgleich mit regex. Der Ausdruck muss den gesamten Argumentwert erfassen.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match
Type / Values
exact | prefix | regex
Details
Abgleichsoperation für diese Argumentposition.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value
Type / Values
string
Details
Wert für einen Argumentabgleich mit exact oder prefix.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.executable
Type / Values
string
Details
Ausführbare Datei, mit der der konfigurierte Befehl des im Plug-in enthaltenen stdio-Servers exakt übereinstimmen muss.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url
Type / Values
string | table
Details
Lasse den MCP-Server eines Plug-ins mit Streamable HTTP anhand einer exakt übereinstimmenden URL-Zeichenfolge zu oder verwende eine Tabelle für den Wertabgleich mit exact, prefix oder regex.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.expression
Type / Values
string
Details
Regulärer Ausdruck für einen URL-Abgleich mit regex. Der Ausdruck muss den gesamten URL-Wert erfassen.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.match
Type / Values
exact | prefix | regex
Details
Abgleichsoperation für die URL des im Plug-in enthaltenen MCP-Servers.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.value
Type / Values
string
Details
Wert für einen URL-Abgleich mit exact oder prefix.
Key
remote_sandbox_config
Type / Values
array<table>
Details
Hostspezifische Sandbox-Anforderungen. Der erste Eintrag, dessen hostname_patterns auf den ermittelten Hostnamen passen, überschreibt allowed_sandbox_modes auf oberster Ebene für diese Anforderungsquelle. Hostspezifische Einträge überschreiben derzeit nur Sandbox-Modi.
Key
remote_sandbox_config[].allowed_sandbox_modes
Type / Values
array<string>
Details
Zulässige Sandbox-Modi, die gelten, wenn dieser hostspezifische Eintrag zutrifft.
Key
remote_sandbox_config[].hostname_patterns
Type / Values
array<string>
Details
Muster für Hostnamen ohne Unterscheidung zwischen Groß- und Kleinschreibung. Unterstützt * für eine beliebige Zeichenfolge und ? für ein einzelnes Zeichen.
Key
rules
Type / Values
table
Details
Von der Administration verbindlich vorgegebene Befehlsregeln, die mit .rules-Dateien zusammengeführt werden. Regeln in den Anforderungen müssen einschränkend sein.
Key
rules.prefix_rules
Type / Values
array<table>
Details
Liste verbindlicher Präfixregeln. Jede Regel muss pattern und decision enthalten.
Key
rules.prefix_rules[].decision
Type / Values
prompt | forbidden
Details
Erforderlich. Regeln in den Anforderungen dürfen nur eine Genehmigung anfordern oder Befehle verbieten, aber keine Befehle erlauben.
Key
rules.prefix_rules[].justification
Type / Values
string
Details
Optionale Begründung, die nicht leer sein darf und in Genehmigungsanfragen oder Ablehnungsmeldungen angezeigt wird.
Key
rules.prefix_rules[].pattern
Type / Values
array<table>
Details
Befehlspräfix in Form von Muster-Tokens. Jedes Token legt entweder token oder any_of fest.
Key
rules.prefix_rules[].pattern[].any_of
Type / Values
array<string>
Details
Eine Liste zulässiger alternativer Tokens an dieser Position.
Key
rules.prefix_rules[].pattern[].token
Type / Values
string
Details
Ein einzelnes Literal-Token an dieser Position.
Key
sqlite_home
Type / Values
string (path)
Details
Legt verbindlich das Verzeichnis fest, in dem Codex den SQLite-basierten Laufzeitzustand speichert.
Key
windows
Type / Values
table
Details
Anforderungen an die native Windows-Sandbox.
Key
windows.allowed_sandbox_implementations
Type / Values
array<string>
Details
Zulässige Implementierungen der nativen Windows-Sandbox für 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.
Key
windows.sandbox_private_desktop
Type / Values
boolean
Details
Legt verbindlich fest, ob die native Windows-Sandbox ihren untergeordneten Prozess auf einem privaten Desktop startet.