Documentation ChatGPT
Français
Contact goolvyouyou@gmail.com

Variables d’environnement

Variables d’environnement prises en charge par Codex

Codex utilise config.toml pour les paramètres persistants. Utilisez les variables d’environnement pour les substitutions limitées au shell, les secrets d’automatisation, le comportement du programme d’installation ou les diagnostics.

Cette page répertorie les variables d’environnement publiques et stables que Codex lit directement. Elle ne répertorie pas les variables de développement internes, les variables de test ni les noms de secrets propres aux fournisseurs que vous choisissez vous-même avec env_key.

Emplacements principaux

Variable Utilisée par Valeur par défaut Description
CODEX_HOME CLI, extension IDE, app-server, programmes d’installation ~/.codex Définit la racine de l’état de Codex, notamment la configuration, l’authentification, les journaux, les sessions, les skills et les métadonnées des paquets autonomes. Si vous la définissez, le répertoire doit déjà exister.
CODEX_SQLITE_HOME État de la CLI et d’app-server CODEX_HOME Définit l’emplacement de stockage de l’état reposant sur SQLite. L’option de configuration sqlite_home est prioritaire. Les chemins relatifs sont résolus à partir du répertoire de travail actuel.

Pour en savoir plus sur les fichiers stockés sous CODEX_HOME, consultez Emplacements de la configuration et de l’état.

Variables du programme d’installation

Ces variables s’appliquent aux scripts d’installation autonomes distribués depuis https://chatgpt.com/codex/install.sh et https://chatgpt.com/codex/install.ps1.

Variable Valeur par défaut Description
CODEX_NON_INTERACTIVE false Définissez cette variable sur 1, true ou yes pour ignorer les invites du programme d’installation. Les invites utilisent leur réponse par défaut ; réservez donc cette option aux installations et mises à jour scriptées, et non à la configuration initiale.
CODEX_INSTALL_DIR ~/.local/bin sur macOS/Linux ; %LOCALAPPDATA%\Programs\OpenAI\Codex\bin sur Windows Modifie l’emplacement d’installation de la commande visible codex. Le cache du paquet autonome reste stocké sous CODEX_HOME/packages/standalone.

Pour les installations sans intervention, définissez CODEX_NON_INTERACTIVE=1 dans le shell qui exécute le programme d’installation téléchargé :

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

Authentification et réseau

Variable Utilisée par Description
CODEX_API_KEY codex exec Fournit une API key pour une seule exécution non interactive. Cette fonctionnalité est uniquement prise en charge dans codex exec ; définissez-la en ligne plutôt qu’à l’échelle de la tâche lorsque vous exécutez du code contrôlé par le dépôt.
CODEX_ACCESS_TOKEN CLI, app-server, automatisation de confiance Fournit un jeton d’accès ChatGPT ou Codex pour une automatisation de confiance. Pour une connexion persistante, transmettez-le à codex login --with-access-token via un tube.
CODEX_CA_CERTIFICATE Clients HTTPS, de connexion et WebSocket Pointe vers un bundle d’autorités de certification PEM pour les environnements soumis à une interception TLS d’entreprise ou utilisant des autorités de certification racines privées. Est prioritaire sur SSL_CERT_FILE.
SSL_CERT_FILE Clients HTTPS, de connexion et WebSocket Chemin de secours vers un bundle d’autorités de certification PEM lorsque CODEX_CA_CERTIFICATE n’est pas défini.

Pour les API keys des fournisseurs, définissez env_key dans la configuration du fournisseur de modèles. Codex lit la variable désignée par cette configuration ; le nom de la variable n’est donc pas lui-même une variable d’environnement Codex fixe.

Pour la gestion des secrets d’automatisation, consultez Utiliser l’authentification par API key. Pour configurer les jetons d’accès, consultez Jetons d’accès.

Diagnostics

Variable Utilisée par Description
RUST_LOG CLI et app-server Contrôle le filtrage et le niveau de détail des journaux Rust. codex exec utilise par défaut une sortie error, sauf si vous définissez une valeur plus détaillée.

RUST_LOG accepte des valeurs telles que error, warn, info, debug et trace. Cette variable accepte également des filtres de journalisation Rust plus ciblés, tels que codex_core=debug,codex_tui=debug.

Par défaut, la CLI interactive enregistre les diagnostics dans des espaces de stockage locaux de taille limitée, mais le fichier en texte brut codex-tui.log doit être activé explicitement. Définissez explicitement log_dir lorsque vous avez besoin d’un journal en texte brut pour résoudre un problème :

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

En mode non interactif, codex exec affiche les messages directement au lieu de les écrire dans un fichier journal TUI distinct.