Codex usa config.toml para guardar la configuración de forma persistente. Usa variables de entorno para sobrescribir valores solo en el shell actual, proporcionar secretos a las automatizaciones, ajustar el comportamiento del instalador o realizar diagnósticos.
Esta página enumera las variables de entorno públicas y estables que Codex lee directamente. Se excluyen las variables internas de desarrollo, las variables de prueba y los nombres de secretos específicos de cada proveedor que tú eliges mediante env_key.
Directorios principales
| Variable | Dónde se usa | Valor predeterminado | Descripción |
|---|---|---|---|
CODEX_HOME |
CLI, extensión del IDE, app-server e instaladores | ~/.codex |
Define el directorio raíz donde Codex guarda su estado, incluidos la configuración, los datos de autenticación, los registros, las sesiones, las habilidades y los metadatos de los paquetes independientes. Si defines esta variable, el directorio ya debe existir. |
CODEX_SQLITE_HOME |
Estado de la CLI y de app-server | CODEX_HOME |
Define dónde se guardan los datos de estado que Codex almacena en SQLite. La opción de configuración sqlite_home tiene prioridad. Las rutas relativas se resuelven a partir del directorio de trabajo actual. |
Para obtener más información sobre los archivos que se guardan en CODEX_HOME, consulta Ubicaciones de la configuración y del estado.
Si varios hosts Linux abren las mismas bases de datos, consulta Ejecutar Codex con un directorio personal en NFS.
Variables del instalador
Estas variables se aplican a los scripts de instalación independientes disponibles en https://chatgpt.com/codex/install.sh y https://chatgpt.com/codex/install.ps1.
| Variable | Valor predeterminado | Descripción |
|---|---|---|
CODEX_NON_INTERACTIVE |
false |
Usa 1, true o yes para omitir las preguntas del instalador. El instalador usa la respuesta predeterminada para cada pregunta, así que reserva esta opción para instalaciones y actualizaciones mediante scripts. Evítala durante la configuración inicial. |
CODEX_INSTALL_DIR |
~/.local/bin en macOS/Linux y %LOCALAPPDATA%\Programs\OpenAI\Codex\bin en Windows |
Cambia la ubicación donde se instala el comando codex que ve el usuario. La caché de paquetes independientes sigue en CODEX_HOME/packages/standalone. |
Para realizar una instalación desatendida, establece CODEX_NON_INTERACTIVE=1 en el shell que ejecuta el instalador descargado:
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 | iexAutenticación y red
| Variable | Dónde se usa | Descripción |
|---|---|---|
CODEX_API_KEY |
Ejecución, revisión, SDK de TypeScript y exec-server remoto | Proporciona una clave de API a un proceso no interactivo de Codex. Cuando ejecutes código controlado por el repositorio, define la variable en la misma línea del comando para limitar su alcance a ese comando y evitar que se aplique a todo el trabajo. |
CODEX_ACCESS_TOKEN |
CLI, app-server y automatizaciones de confianza | Proporciona un token de acceso de ChatGPT o Codex para automatizaciones de confianza. Para que la sesión quede guardada, pasa el token por una tubería a codex login --with-access-token. |
OPENAI_FEDERATION_RULE_ID |
Identidad de la carga de trabajo | Selecciona la regla de federación configurada para la carga de trabajo. |
OPENAI_IDENTITY_TOKEN_FILE |
Identidad de la carga de trabajo | Indica la ruta absoluta del archivo que contiene el token OIDC vigente o el JWT-SVID de SPIFFE vigente. |
OPENAI_WORKLOAD_IDENTITY_CONTEXT |
Identidad de la carga de trabajo | Permite proporcionar identificadores JSON con límites definidos que el cliente comunica para atribuir la actividad en los registros de auditoría. No afecta la autenticación ni la autorización. |
CODEX_CA_CERTIFICATE |
Clientes HTTPS, de inicio de sesión y WebSocket | Indica la ruta a un conjunto de certificados de autoridades certificadoras en formato PEM para entornos con interceptación corporativa de TLS o certificados raíz privados. Tiene prioridad sobre SSL_CERT_FILE. |
SSL_CERT_FILE |
Clientes HTTPS, de inicio de sesión y WebSocket | Indica la ruta al conjunto de certificados de autoridades certificadoras en formato PEM que se usa si no se define CODEX_CA_CERTIFICATE. |
Para usar las claves de API de un proveedor, define env_key en la configuración del proveedor de modelos. Codex lee la variable cuyo nombre indiques allí, por lo que esa variable de entorno no tiene un nombre fijo.
Para gestionar secretos en automatizaciones, consulta Usar la autenticación con clave de API. Para configurar los tokens de acceso, consulta Tokens de acceso.
Diagnóstico
| Variable | Dónde se usa | Descripción |
|---|---|---|
RUST_LOG |
CLI y app-server | Controla el filtrado y el nivel de detalle de los registros de Rust. De forma predeterminada, codex exec usa el nivel de salida error, salvo que elijas un nivel más detallado. |
RUST_LOG acepta valores como error, warn, info, debug y trace. También acepta filtros de registro de Rust más específicos, como codex_core=debug,codex_tui=debug.
De forma predeterminada, la CLI interactiva guarda los datos de diagnóstico en almacenes locales de tamaño limitado. Para generar el archivo de texto sin formato codex-tui.log, debes habilitarlo. Define log_dir explícitamente cuando necesites un registro de texto sin formato para diagnosticar problemas:
RUST_LOG=debug codex -c log_dir=./.codex-log
tail -F ./.codex-log/codex-tui.logEn modo no interactivo, codex exec muestra los mensajes directamente en la salida del comando en lugar de escribirlos en un archivo de registro separado de la TUI.