Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Umgebungsvariablen

Von Codex unterstützte Umgebungsvariablen

Codex speichert dauerhafte Einstellungen in config.toml. Mit Umgebungsvariablen kannst du Einstellungen für die aktuelle Shell überschreiben, Secrets für die Automatisierung bereitstellen, die Installation steuern oder die Diagnose konfigurieren.

Diese Seite führt die stabilen, öffentlichen Umgebungsvariablen auf, die Codex direkt ausliest. Ausgenommen sind interne Entwicklungsvariablen, Testvariablen und anbieterspezifische Variablennamen für Secrets, die du mit env_key selbst festlegst.

Zentrale Speicherorte

Variable Verwendet von Standardwert Beschreibung
CODEX_HOME CLI, IDE-Erweiterung, App Server, Installationsprogramme ~/.codex Legt das Stammverzeichnis für die Zustandsdaten von Codex fest. Dazu gehören Konfiguration, Authentifizierungsdaten, Protokolle, Sitzungen, Skills und Metadaten zu eigenständigen Paketen. Wenn du die Variable setzt, muss das Verzeichnis bereits existieren.
CODEX_SQLITE_HOME CLI und App Server für ihre Zustandsdaten CODEX_HOME Legt fest, wo Codex seine SQLite-Datenbanken für Zustandsdaten speichert. Die Konfigurationsoption sqlite_home hat Vorrang. Relative Pfade beziehen sich auf das aktuelle Arbeitsverzeichnis.

Welche Dateien Codex unter CODEX_HOME speichert, erfährst du im Abschnitt Speicherorte für Konfiguration und Zustandsdaten. Wenn mehrere Linux-Hosts dieselben Datenbanken öffnen, lies die Anleitung Codex mit einem NFS-Home-Verzeichnis ausführen.

Variablen für die Installation

Diese Variablen gelten für die eigenständigen Installationsskripte unter https://chatgpt.com/codex/install.sh und https://chatgpt.com/codex/install.ps1.

Variable Standardwert Beschreibung
CODEX_NON_INTERACTIVE false Setze die Variable auf 1, true oder yes, um Rückfragen des Installationsprogramms zu überspringen. Es verwendet dann jeweils die Standardantwort. Nutze diese Option für skriptgesteuerte Installationen und Updates. Für das Setup beim ersten Start solltest du die Rückfragen selbst beantworten.
CODEX_INSTALL_DIR ~/.local/bin unter macOS und Linux, %LOCALAPPDATA%\Programs\OpenAI\Codex\bin unter Windows Ändert das Verzeichnis, in dem das Installationsprogramm den in der Shell aufrufbaren Befehl codex ablegt. Der Cache für eigenständige Pakete liegt weiterhin unter CODEX_HOME/packages/standalone.

Setze für eine unbeaufsichtigte Installation CODEX_NON_INTERACTIVE=1 in der Shell, die das heruntergeladene Installationsskript ausführt.

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh
$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iex

Authentifizierung und Netzwerk

Variable Verwendet von Beschreibung
CODEX_API_KEY Exec, Code Review, TypeScript-SDK, entfernter exec-server Stellt einem nicht interaktiven Codex-Prozess einen API-Schlüssel bereit. Wenn du Code ausführst, den das Repository vorgibt, setze die Variable nur für den jeweiligen Befehlsaufruf. Eine jobweite Einstellung würde den Schlüssel im gesamten Job verfügbar machen.
CODEX_ACCESS_TOKEN CLI, App Server, vertrauenswürdige Automatisierungen Stellt vertrauenswürdigen Automatisierungen ein Zugriffstoken für ChatGPT oder Codex bereit. Um die Anmeldung dauerhaft zu speichern, übergib das Token per Pipe an codex login --with-access-token.
OPENAI_FEDERATION_RULE_ID Workload-Identität Wählt die für den Workload konfigurierte Föderationsregel aus.
OPENAI_IDENTITY_TOKEN_FILE Workload-Identität Gibt den absoluten Pfad zur Datei an, die das aktuelle OIDC-Token oder das SPIFFE JWT-SVID enthält.
OPENAI_WORKLOAD_IDENTITY_CONTEXT Workload-Identität Kann JSON-Kennungen mit begrenztem Umfang bereitstellen, die der Client zur Zuordnung von Audit-Einträgen meldet. Die Variable hat keinen Einfluss auf die Authentifizierung oder Autorisierung.
CODEX_CA_CERTIFICATE HTTPS-, Anmelde- und WebSocket-Clients Verweist auf ein Bündel von CA-Zertifikaten im PEM-Format für Umgebungen, in denen Unternehmen TLS-Verbindungen zur Prüfung aufbrechen oder private Stammzertifikate einsetzen. Hat Vorrang vor SSL_CERT_FILE.
SSL_CERT_FILE HTTPS-, Anmelde- und WebSocket-Clients Gibt den Pfad zum Bündel von CA-Zertifikaten im PEM-Format an, das die Clients verwenden, wenn CODEX_CA_CERTIFICATE nicht gesetzt ist.

Setze für den API-Schlüssel eines Modellanbieters env_key in dessen Konfiguration. Codex liest die dort angegebene Umgebungsvariable aus. Ihr Name ist daher in Codex nicht fest vorgegeben.

Wie du Secrets bei der Automatisierung verwendest, erfährst du im Abschnitt Mit einem API-Schlüssel authentifizieren. Wie du Zugriffstoken einrichtest, erfährst du auf der Seite Zugriffstoken.

Diagnose

Variable Verwendet von Beschreibung
RUST_LOG CLI und App Server Steuert, wie Rust-Protokollmeldungen gefiltert werden und wie detailliert die Ausgabe ist. codex exec verwendet standardmäßig die Protokollstufe error, sofern du keine ausführlichere Stufe festlegst.

RUST_LOG akzeptiert Werte wie error, warn, info, debug und trace. Du kannst auch gezieltere Filter für die Rust-Protokollierung angeben, etwa codex_core=debug,codex_tui=debug.

Die interaktive CLI speichert Diagnosedaten standardmäßig lokal und begrenzt dabei den Speicherbedarf. Die Klartextdatei codex-tui.log schreibt sie nur auf Wunsch. Setze log_dir ausdrücklich, wenn du zur Fehlersuche ein Protokoll im Klartext brauchst.

RUST_LOG=debug codex -c log_dir=./.codex-log
tail -F ./.codex-log/codex-tui.log

Im nicht interaktiven Modus gibt codex exec Meldungen direkt aus, statt sie in eine separate TUI-Protokolldatei zu schreiben.