Umgebungsvariablen
Umgebungsvariablen
Von Codex unterstützte Umgebungsvariablen
Codex verwendet config.toml für dauerhafte Einstellungen. Verwenden Sie Umgebungsvariablen für
auf die Shell beschränkte Überschreibungen, Geheimnisse für die Automatisierung, das Installationsverhalten oder die Diagnose.
Diese Seite listet stabile öffentliche Umgebungsvariablen auf, die Codex direkt liest.
Interne Entwicklungsvariablen, Testvariablen oder
anbieterspezifische Namen für Geheimnisse, die Sie selbst über
env_key festlegen, sind nicht aufgeführt.
Zentrale Speicherorte
| Variable | Verwendet von | Standardwert | Beschreibung |
|---|---|---|---|
CODEX_HOME |
CLI, IDE-Erweiterung, app-server, Installationsprogramme | ~/.codex |
Legt das Stammverzeichnis für den Codex-Zustand fest, einschließlich Konfiguration, Authentifizierung, Protokollen, Sitzungen, Skills und Metadaten eigenständiger Pakete. Wenn Sie es festlegen, muss das Verzeichnis bereits vorhanden sein. |
CODEX_SQLITE_HOME |
Zustand von CLI und app-server | CODEX_HOME |
Legt fest, wo der SQLite-gestützte Zustand gespeichert wird. Die Konfigurationsoption sqlite_home hat Vorrang. Relative Pfade werden ausgehend vom aktuellen Arbeitsverzeichnis aufgelöst. |
Weitere Informationen zu den unter CODEX_HOME gespeicherten Dateien finden Sie unter
Speicherorte für Konfiguration und Zustand.
Installationsvariablen
Diese Variablen gelten für die eigenständigen Installationsskripte, die über
https://chatgpt.com/codex/install.sh und
https://chatgpt.com/codex/install.ps1 bereitgestellt werden.
| Variable | Standardwert | Beschreibung |
|---|---|---|
CODEX_NON_INTERACTIVE |
false |
Legen Sie 1, true oder yes fest, um Eingabeaufforderungen des Installationsprogramms zu überspringen. Für Eingabeaufforderungen wird die jeweilige Standardantwort verwendet. Nutzen Sie dies daher für skriptgesteuerte Installationen und Aktualisierungen, nicht für die Ersteinrichtung. |
CODEX_INSTALL_DIR |
~/.local/bin unter macOS/Linux; %LOCALAPPDATA%\Programs\OpenAI\Codex\bin unter Windows |
Ändert den Installationsort des sichtbaren Befehls codex. Der Cache für eigenständige Pakete verbleibt weiterhin unter CODEX_HOME/packages/standalone. |
Legen Sie für unbeaufsichtigte Installationen CODEX_NON_INTERACTIVE=1 in der Shell fest, die
das heruntergeladene Installationsprogramm 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 | iexAuthentifizierung und Netzwerk
| Variable | Verwendet von | Beschreibung |
|---|---|---|
CODEX_API_KEY |
Exec, Prüfung, TypeScript SDK, Remote-Exec-Server | Stellt einem nicht interaktiven Codex-Prozess einen API key bereit. Legen Sie ihn beim Ausführen von Repository-gesteuertem Code inline statt für den gesamten Auftrag fest. |
CODEX_ACCESS_TOKEN |
CLI, App-Server, vertrauenswürdige Automatisierung | Stellt ein ChatGPT- oder Codex-Zugriffstoken für vertrauenswürdige Automatisierung bereit. Leiten Sie es für eine persistente Anmeldung an codex login --with-access-token weiter. |
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 | Verweist auf den absoluten Pfad der Datei, die das aktuelle OIDC-Token oder SPIFFE JWT-SVID enthält. |
OPENAI_WORKLOAD_IDENTITY_CONTEXT |
Workload-Identität | Stellt optional größenbegrenzte JSON-IDs für die vom Client gemeldete Audit-Zuordnung bereit. Dies wirkt sich weder auf die Authentifizierung noch auf die Autorisierung aus. |
CODEX_CA_CERTIFICATE |
HTTPS-, Anmelde- und WebSocket-Clients | Verweist auf ein PEM-CA-Bundle für Umgebungen mit unternehmensweiter TLS-Interzeption oder privaten Stammzertifikaten. Hat Vorrang vor SSL_CERT_FILE. |
SSL_CERT_FILE |
HTTPS-, Anmelde- und WebSocket-Clients | Ausweichpfad zum PEM-CA-Bundle, wenn CODEX_CA_CERTIFICATE nicht festgelegt ist. |
Legen Sie API-Schlüssel für Anbieter in der Modellanbieterkonfiguration unter
env_key fest. Codex liest die durch diese Konfiguration benannte Variable, daher ist der
Variablenname selbst keine fest vorgegebene Codex-Umgebungsvariable.
Informationen zum Umgang mit Geheimnissen bei der Automatisierung finden Sie unter Authentifizierung mit API key verwenden. Informationen zur Einrichtung von Zugriffstokens finden Sie unter Zugriffstokens.
Diagnose
| Variable | Verwendet von | Beschreibung |
|---|---|---|
RUST_LOG |
CLI und app-server | Steuert die Filterung und Ausführlichkeit von Rust-Protokollen. Die Ausgabe von codex exec verwendet standardmäßig error, sofern Sie keinen ausführlicheren Wert festlegen. |
RUST_LOG akzeptiert Werte wie error, warn, info, debug und
trace. Darüber hinaus werden gezieltere Rust-Protokollfilter akzeptiert, beispielsweise
codex_core=debug,codex_tui=debug.
Die interaktive CLI zeichnet Diagnosedaten standardmäßig in größenbegrenzten lokalen Speichern auf, aber
die Klartextdatei codex-tui.log muss explizit aktiviert werden. Legen Sie log_dir ausdrücklich fest, wenn Sie
für die Fehlerbehebung ein Klartextprotokoll benötigen:
RUST_LOG=debug codex -c log_dir=./.codex-log
tail -F ./.codex-log/codex-tui.logIm nicht interaktiven Modus gibt codex exec Meldungen direkt aus, statt sie
in eine separate TUI-Protokolldatei zu schreiben.