ChatGPT-Dokumentation
Deutsch
Kontakt goolvyouyou@gmail.com

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 | iex

Authentifizierung und Netzwerk

Variable Verwendet von Beschreibung
CODEX_API_KEY codex exec Stellt einen API key für einen einzelnen nicht interaktiven Durchlauf bereit. Dies wird nur in codex exec unterstützt. Legen Sie ihn bei der Ausführung von Repository-gesteuertem Code direkt im Befehl 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 dauerhafte Anmeldung an codex login --with-access-token weiter.
CODEX_CA_CERTIFICATE HTTPS-, Anmelde- und WebSocket-Clients Verweist auf ein PEM-CA-Bundle für Umgebungen mit unternehmensweiter TLS-Überwachung oder privaten Stammzertifizierungsstellen. Hat Vorrang vor SSL_CERT_FILE.
SSL_CERT_FILE HTTPS-, Anmelde- und WebSocket-Clients Pfad zum ersatzweise verwendeten 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 zur Handhabung von Geheimnissen bei der Automatisierung finden Sie unter Authentifizierung mit API key verwenden. Informationen zum Einrichten von Zugriffstoken finden Sie unter Zugriffstoken.

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.log

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