ChatGPT-Dokumentation
Deutsch
Kontakt goolvyouyou@gmail.com

Grundlagen der Konfiguration

Den vollständigen Dokumentationsindex finden Sie unter llms.txt. Markdown-Versionen der Dokumentationsseiten sind verfügbar, indem Sie .md an die Seiten-URL anhängen.

Codex liest Konfigurationsdetails aus mehreren Quellen. Ihre persönlichen Standardeinstellungen befinden sich in ~/.codex/config.toml, und mit .codex/config.toml-Dateien können Sie projektspezifische Überschreibungen hinzufügen. Aus Sicherheitsgründen lädt Codex projektbezogene .codex/-Ebenen nur, wenn Sie dem Projekt vertrauen.

Codex-Konfigurationsdatei

Codex speichert die Konfiguration auf Benutzerebene unter ~/.codex/config.toml. Um Einstellungen auf ein bestimmtes Projekt oder einen Unterordner zu beschränken, fügen Sie Ihrem Repository eine .codex/config.toml-Datei hinzu.

Um die Konfigurationsdatei über die Codex IDE-Erweiterung zu öffnen, wählen Sie oben rechts das Zahnradsymbol und anschließend Codex Settings > Open config.toml aus.

Die CLI und die IDE-Erweiterung verwenden dieselben Konfigurationsebenen. Damit können Sie:

Konfigurationsrangfolge

Codex löst Werte in dieser Reihenfolge auf, beginnend mit der höchsten Priorität:

  1. CLI-Flags und --config-Überschreibungen
  2. Projektkonfigurationsdateien: .codex/config.toml, geordnet vom Projektstamm bis zu Ihrem aktuellen Arbeitsverzeichnis (die nächstgelegene Datei hat Vorrang; nur vertrauenswürdige Projekte)
  3. Mit --profile profile-name ausgewählte Profildateien (~/.codex/profile-name.config.toml)
  4. Benutzerkonfiguration: ~/.codex/config.toml
  5. Systemkonfiguration (falls vorhanden): /etc/codex/config.toml unter Unix
  6. Integrierte Standardeinstellungen

Nutzen Sie diese Rangfolge, um gemeinsame Standardeinstellungen in config.toml festzulegen, und beschränken Sie Profildateien auf abweichende Werte.

Wenn Sie ein Projekt als nicht vertrauenswürdig markieren, überspringt Codex projektbezogene .codex/-Ebenen einschließlich lokaler Projektkonfigurationen, Hooks und Regeln. Benutzer- und Systemkonfigurationen werden weiterhin geladen, einschließlich benutzerbezogener und globaler Hooks und Regeln.

Informationen zu einmaligen Überschreibungen über -c/--config, einschließlich der TOML-Regeln für Anführungszeichen, finden Sie unter Erweiterte Konfiguration.

Häufig verwendete Konfigurationsoptionen

Dies sind einige der am häufigsten geänderten Optionen:

Standardmodell

Wählen Sie das Modell aus, das Codex standardmäßig in der CLI und der IDE verwendet.

model = "gpt-5.6"

Genehmigungsabfragen

Legen Sie fest, wann Codex vor dem Ausführen generierter Befehle pausiert und um Genehmigung bittet.

approval_policy = "on-request"

Informationen zu den Verhaltensunterschieden zwischen untrusted, on-request und never finden Sie unter Ohne Genehmigungsabfragen ausführen und Gängige Kombinationen aus Sandbox und Genehmigungen.

Sandbox-Stufe

Legen Sie fest, wie weit Codex beim Ausführen von Befehlen auf das Dateisystem und das Netzwerk zugreifen darf.

sandbox_mode = "workspace-write"

Das Verhalten der einzelnen Modi, einschließlich geschützter .git-/.codex-Pfade und der Netzwerkstandardeinstellungen, wird unter Sandbox und Genehmigungen, Geschützte Pfade in beschreibbaren Stammverzeichnissen und Netzwerkzugriff beschrieben.

Berechtigungsprofile

Codex unterstützt außerdem benannte Berechtigungsprofile für wiederverwendbare Dateisystem- und Netzwerkrichtlinien. Die integrierten Profile sind :read-only, :workspace und :danger-full-access. Benutzerdefinierte Profile verwenden [permissions.<name>]-Tabellen und einen entsprechenden default_permissions-Wert. Weitere Informationen finden Sie unter Berechtigungen.

Windows-Sandbox-Modus

Wenn Sie Codex nativ unter Windows ausführen, setzen Sie den nativen Sandbox-Modus in der Tabelle windows auf elevated. Verwenden Sie unelevated nur, wenn Sie keine Administratorberechtigungen besitzen oder die Einrichtung mit erhöhten Rechten fehlschlägt.

[windows]
sandbox = "elevated"   # Recommended
# sandbox = "unelevated" # Fallback if admin permissions/setup are unavailable

Websuchmodus

Codex aktiviert die Websuche standardmäßig für lokale Chats und stellt Ergebnisse aus einem Websuchcache bereit. Der Cache ist ein von OpenAI gepflegter Index von Webergebnissen. Im Cache-Modus werden daher vorab indexierte Ergebnisse zurückgegeben, anstatt Live-Seiten abzurufen. Dadurch sinkt das Risiko von Prompt-Injection-Angriffen durch beliebige Live-Inhalte. Sie sollten Webergebnisse dennoch als nicht vertrauenswürdig behandeln. Wenn Sie --yolo oder eine andere Sandbox-Einstellung mit Vollzugriff verwenden, liefert die Websuche standardmäßig Live-Ergebnisse. Wählen Sie mit web_search einen Modus aus:

  • "cached" (Standard) stellt Ergebnisse aus dem Websuchcache bereit.
  • "indexed" erlaubt externen Webzugriff nur, wenn der Suchindex die Anfrage freigibt.
  • "live" ruft die neuesten Daten aus dem Web ab (entspricht --search).
  • "disabled" deaktiviert das Websuchtool.
web_search = "cached"  # default; serves results from the web search cache
# web_search = "indexed" # gate external web access through the search index
# web_search = "live"  # fetch the most recent data from the web (same as --search)
# web_search = "disabled"

Reasoning-Aufwand

Legen Sie bei unterstützten Modellen fest, wie viel Reasoning-Aufwand das Modell aufwendet.

model_reasoning_effort = "high"

Kommunikationsstil

Legen Sie einen Standardkommunikationsstil für unterstützte Modelle fest.

personality = "friendly" # or "pragmatic" or "none"

Sie können diese Einstellung später in einer aktiven Sitzung mit /personality oder bei Verwendung der App-Server-APIs für einzelne Threads oder Turns überschreiben.

TUI-Tastenbelegung

Passen Sie die Terminal-Tastenkürzel unter tui.keymap an. Ausgewählte Aktionen des Eingabebereichs greifen ersatzweise auf entsprechende tui.keymap.global-Belegungen zurück. Kontextbezogene Belegungen haben Vorrang, sofern sie unterstützt werden. Eine leere Liste hebt die Belegung der Aktion auf.

[tui.keymap.global]
open_transcript = "ctrl-t"

[tui.keymap.composer]
submit = ["enter", "ctrl-m"]

[tui.keymap.chat]
interrupt_turn = "f12"

Befehlsumgebung

Legen Sie fest, welche Umgebungsvariablen Codex an erzeugte Befehle weitergibt. Verwenden Sie schlüsselbasierte Filter, um nur die benötigten Variablen beizubehalten:

[shell_environment_policy]
ignore_default_excludes = false

[shell_environment_policy.filters]
"PATH" = "include"
"HOME" = "include"

ignore_default_excludes verwendet standardmäßig true. Dadurch wird die automatische Filterung von Variablennamen übersprungen, die KEY, SECRET oder TOKEN enthalten. Setzen Sie den Wert auf false, wenn Sie diese automatische Filterung wünschen. Informationen zu Ausschlussregeln, Rangfolge und Legacy-Konfiguration finden Sie unter Richtlinie für die Shell- Umgebung.

Protokollverzeichnis

Überschreiben Sie den Speicherort, an den Codex lokale Protokolldateien schreibt. Wenn Sie log_dir ausdrücklich festlegen, wird außerdem das optionale TUI-Klartextprotokoll codex-tui.log in diesem Verzeichnis aktiviert.

log_dir = "/absolute/path/to/codex-logs"

Für einmalige Ausführungen können Sie den Speicherort auch über die CLI festlegen:

codex -c log_dir=./.codex-log

Feature-Flags

Verwenden Sie die Tabelle [features] in config.toml, um optionale und experimentelle Funktionen ein- oder auszuschalten.

Häufig verwendete Feature-Flags

Schlüssel Standard Reifegrad Beschreibung
apps true Stabil App-Integrationen (Connectors) aktivieren
goals true Stabil Persistierte Ziele und automatische Fortsetzung aktivieren
hooks true Stabil Lifecycle-Hooks aus hooks.json oder eingebetteten [hooks] aktivieren. Siehe Hooks.
fast_mode true Stabil Auswahl des Fast-Modus und den service_tier = "fast"-Pfad aktivieren
memories false Experimentell Erinnerungen aktivieren
multi_agent true Stabil Tools für die Zusammenarbeit mit Subagenten aktivieren
personality true Stabil Steuerelemente zur Persönlichkeitsauswahl aktivieren
remote_plugin true Stabil Remote-Plugin-Katalog aktivieren
shell_snapshot true Stabil Momentaufnahme Ihrer Shell-Umgebung erstellen, um wiederholte Befehle zu beschleunigen
shell_tool true Stabil Das standardmäßige shell-Tool aktivieren
unified_exec true außer unter Windows Stabil Das einheitliche PTY-gestützte Ausführungstool verwenden
web_search true Veraltet Legacy-Umschalter; verwenden Sie vorzugsweise die Einstellung web_search auf oberster Ebene
web_search_cached false Veraltet Legacy-Umschalter, der bei nicht gesetztem Wert web_search = "cached" zugeordnet wird
web_search_request false Veraltet Legacy-Umschalter, der bei nicht gesetztem Wert web_search = "live" zugeordnet wird

Informationen zur Konfiguration von Lifecycle-Hooks finden Sie unter Hooks.

Funktionen aktivieren

  • Fügen Sie in config.toml den Eintrag feature_name = true unter [features] hinzu.
  • Führen Sie in der CLI codex --enable feature_name aus.
  • Um mehrere Funktionen zu aktivieren, führen Sie codex --enable feature_a --enable feature_b aus.
  • Um eine Funktion zu deaktivieren, setzen Sie den Schlüssel in config.toml auf false.