Codex CLI-Konfiguration

Codex CLI kann durch Konfigurationsdateien angepasst werden. Dieser Abschnitt beschreibt die Struktur der Konfigurationsdateien, die verschiedenen Konfigurationsoptionen und wie Sie sie an Ihre Bedürfnisse anpassen.

Speicherort der Konfigurationsdatei

Die Konfigurationsdatei von Codex befindet sich im Home-Verzeichnis des Benutzers unter~/.codex/config.toml：

~/.codex/config.toml

Wenn die Datei nicht vorhanden ist, müssen Sie sie manuell erstellen. Codex erstellt beim ersten Start eine Standardkonfigurationsdatei.

Nach dem Ändern der Konfiguration müssen Sie Codex neu starten, damit die Änderung wirksam wird.

Struktur der Konfigurationsdatei

Eine vollständige Konfigurationsdatei kann die folgenden Abschnitte enthalten:

Codex CLI 配置结构图 — Abbildung: Struktur der Codex CLI-Konfiguration

Vollständiges Konfigurationsbeispiel

# ~/.codex/config.toml

# Grundeinstellungen
[model]
default = "o4-mini" # Standardmäßig zu verwendendes Modell

# TUI-Einstellungen
[tui]
alternate_screen = "auto" # Alternativer Bildschirmmodus: auto/always/never

# Skill-Konfiguration
[skills]
enabled = true

# Funktionsschalter
[features]
js_repl = false # Ob JavaScript-REPL aktiviert werden soll

# MCP-Server-Konfiguration
[mcp_servers]

# Benachrichtigungseinstellungen
[notify]
enabled = false

Modellkonfiguration

Codex unterstützt mehrere Modelle; Sie können je nach Aufgabenanforderungen auswählen:

Konfigurationselement	Type	Beschreibung
`model.default`	string	Standardmäßig verwendetes Modell
`model.reasoning_effort`	string	Denkaufwand: niedrig/mittel/hoch

Verfügbare Modelle

Die in der Codex CLI verfügbaren Modelle umfassen:

o4-mini- Schnell und effizient, geeignet für einfache Aufgaben
o4-mini-high- Version von o4-mini mit hoher Denkleistung
o3- Starke Denkfähigkeiten
o3-pro- Professionelle Version von o3

Verschiedene Modelle haben unterschiedliche Geschwindigkeiten und Preise; die Wahl des richtigen Modells kann Benutzererfahrung und Kosten optimieren.

TUI-Konfiguration

Relevante Einstellungen für die Terminal-Benutzeroberfläche:

Konfigurationselement	Type	Beschreibung	Standardwert
`tui.alternate_screen`	string	Alternativer Bildschirmmodus: auto/always/never	auto
`tui.width`	number	Terminalbreite	0 (automatisch)
`tui.height`	number	Terminalhöhe	0 (automatisch)

Erklärung des alternativen Bildschirmmodus

auto- Automatisch erkennen, automatisch deaktiviert in Terminal-Multiplexern wie Zellij
always- Immer den alternativen Bildschirm verwenden (Standarderlebnis)
never- Niemals den alternativen Bildschirm verwenden (Scroll-Verlauf beibehalten)

Laufzeitüberschreibung

Sie können diese Einstellungen zur Laufzeit über Befehlszeilenargumente überschreiben:

Konfiguration der Befehlszeilenüberschreibung

# Alternativen Bildschirmmodus deaktivieren
codex --no-alt-screen

Skills-Konfiguration

Skills sind Codex' Erweiterungsmechanismus, mit dem du Workflows anpassen kannst:

Konfigurationselement	Type	Beschreibung
`skills.enabled`	boolesch	Ob das Skills-System aktiviert werden soll
`skills.directory`	string	Skills-Dateiverzeichnis

Benutzerdefiniertes Skills-Verzeichnis

Skills-Verzeichnis konfigurieren

[skills]
enabled = true
directory = "~/my-codex-skills"

MCP-Server-Konfiguration

MCP-Server (Model Context Protocol) ermöglichen es Codex, sich mit externen Tools und Diensten zu integrieren:

MCP-Server konfigurieren

[mcp_servers.docs]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]

# Konfiguration der Tool-Berechtigungen
[mcp_servers.docs.tools.search]
approval_mode = "approve"

MCP-Tool-Berechtigungen

Sie können die Berechtigungen für die Tools jedes MCP-Servers individuell festlegen:

approve- Automatische Genehmigung, keine Nachfrage
deny- Automatische Ablehnung
ask- Vor jeder Ausführung nachfragen (Standard)

Seien Sie vorsichtig beim Konfigurieren von MCP-Servern; aktivieren Sie nur Tools, denen Sie vertrauen.

Funktionsschalter

Aktivieren oder deaktivieren Sie bestimmte Codex-Funktionen:

Konfigurationselement	Type	Beschreibung
`features.js_repl`	boolesch	JavaScript REPL aktivieren
`features.js_repl_tools_only`	boolesch	Nur auf das js_repl-Tool beschränken

JavaScript-REPL-Konfiguration

JavaScript REPL aktivieren

[features]
js_repl = true

Sie können auch den Node.js-Pfad angeben:

Node.js-Pfad angeben

js_repl_node_path = "/usr/local/bin/node"

Benachrichtigungskonfiguration

Codex kann Benachrichtigungen senden, wenn Aufgaben abgeschlossen sind:

Konfigurationselement	Type	Beschreibung
`notify.enabled`	boolesch	Benachrichtigungen aktivieren

Benachrichtigungs-Hooks konfigurieren

Sie können benutzerdefinierte Benachrichtigungsskripte über Umgebungsvariablen konfigurieren:

CODEX_NOTIFY_HOOK=/path/to/your/notify-script.sh

SQLite-Zustandsdatenbank

Codex verwendet SQLite, um internen Zustand zu speichern:

Umgebungsvariable	Beschreibung	Standardwert
`CODEX_SQLITE_HOME`	SQLite-Datenbankverzeichnis	Identisch mit CODEX_HOME

SQLite-Verzeichnis konfigurieren

export CODEX_SQLITE_HOME=/path/to/sqlite
codex

Logging-Konfiguration

Codex verwendet Rusts env_logger; Sie können den Log-Level konfigurieren:

Log-Ausgabe konfigurieren

# Protokolle anzeigen
tail -f ~/.codex/log/codex-tui.log

# Log-Level festlegen
RUST_LOG=codex_core=info,codex_tui=info,codex_rmcp_client=info codex

Protokollstufe	Beschreibung
`error`	Nur Fehler anzeigen
`warn`	Warnungen und Fehler anzeigen
`info`	Allgemeine Infos, Warnungen und Fehler anzeigen
`debug`	Debug-Informationen anzeigen
`trace`	Detaillierte Trace-Informationen anzeigen

Standardmäßig ist die Protokollstufe im TUI-Modus info und die Standardstufe im nicht-interaktiven (exec) Modus error.

Plan-Modus-Konfiguration

Konfigurieren Sie das Verhalten von Codex im Plan-Modus:

Plan-Modus konfigurieren

# Standard-Reasoning-Aufwand für den Plan-Modus festlegen
# Optionale Werte: low/medium/high/none
plan_mode_reasoning_effort = "medium"

Gängige Konfigurationsbeispiele

Basiskonfiguration

Minimale Konfiguration

# Standardeinstellungen verwenden
# Codex bietet bereits sinnvolle Standardeinstellungen

Hochleistungskonfiguration

Konfiguration zur Leistungsoptimierung

[model]
default = "o4-mini"

[tui]
alternate_screen = "always"

[features]
js_repl = true

Entwicklerkonfiguration

[model]
default = "o4-mini"
reasoning_effort = "high"

[tui]
alternate_screen = "never"

[skills]
enabled = true
directory = "~/codex-skills"

Weitere Erweiterungen