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.