Documentación de ChatGPT
Español
Contacto goolvyouyou@gmail.com

Variables de entorno

Variables de entorno

Variables de entorno compatibles con Codex

Codex utiliza config.toml para la configuración persistente. Utilice variables de entorno para anulaciones limitadas al shell, secretos de automatización, el comportamiento del instalador o diagnósticos.

Esta página enumera las variables de entorno públicas y estables que Codex lee directamente. No incluye variables internas de desarrollo, variables de prueba ni nombres de secretos específicos del proveedor que usted mismo elija mediante env_key.

Ubicaciones principales

Variable Utilizada por Valor predeterminado Descripción
CODEX_HOME CLI, extensión de IDE, app-server, instaladores ~/.codex Establece la raíz del estado de Codex, incluidos la configuración, la autenticación, los registros, las sesiones, las habilidades y los metadatos de paquetes independientes. Si la establece, el directorio ya debe existir.
CODEX_SQLITE_HOME Estado de la CLI y app-server CODEX_HOME Establece dónde se almacena el estado respaldado por SQLite. La opción de configuración sqlite_home tiene prioridad. Las rutas relativas se resuelven desde el directorio de trabajo actual.

Para obtener más información sobre los archivos almacenados en CODEX_HOME, consulte Ubicaciones de configuración y estado.

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 Establézcala en 1, true o yes para omitir las solicitudes del instalador. Las solicitudes utilizan su respuesta predeterminada, por lo que debe usar esta opción para instalaciones y actualizaciones mediante scripts, no para la configuración inicial.
CODEX_INSTALL_DIR ~/.local/bin en macOS/Linux; %LOCALAPPDATA%\Programs\OpenAI\Codex\bin en Windows Cambia dónde se instala el comando visible codex. La caché del paquete independiente permanece en CODEX_HOME/packages/standalone.

Para instalaciones desatendidas, establezca 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 | iex

Autenticación y red

Variable Utilizada por Descripción
CODEX_API_KEY Exec, revisión, SDK de TypeScript, exec-server remoto Proporciona una API key a un proceso no interactivo de Codex. Establécela en línea, en lugar de para todo el trabajo, al ejecutar código controlado por el repositorio.
CODEX_ACCESS_TOKEN CLI, app-server, automatización de confianza Proporciona un token de acceso de ChatGPT o Codex para automatizaciones de confianza. Para un inicio de sesión persistente, canalízalo a codex login --with-access-token.
OPENAI_FEDERATION_RULE_ID Identidad de carga de trabajo Selecciona la regla de federación configurada para la carga de trabajo.
OPENAI_IDENTITY_TOKEN_FILE Identidad de carga de trabajo Apunta a la ruta absoluta del archivo que contiene el token OIDC actual o el JWT-SVID de SPIFFE.
OPENAI_WORKLOAD_IDENTITY_CONTEXT Identidad de carga de trabajo Proporciona opcionalmente identificadores JSON acotados para la atribución de auditoría informada por el cliente. No afecta a la autenticación ni a la autorización.
CODEX_CA_CERTIFICATE Clientes HTTPS, de inicio de sesión y WebSocket Apunta a un paquete de CA PEM para entornos con interceptación TLS corporativa o certificados raíz privados. Tiene prioridad sobre SSL_CERT_FILE.
SSL_CERT_FILE Clientes HTTPS, de inicio de sesión y WebSocket Ruta alternativa del paquete de CA PEM cuando CODEX_CA_CERTIFICATE no está establecido.

Para las API key de proveedores, establezca env_key en la configuración del proveedor del modelo. Codex lee la variable indicada por esa configuración, por lo que el propio nombre de la variable no es una variable de entorno fija de Codex.

Para gestionar secretos en automatizaciones, consulta Usar la autenticación con API key. Para configurar tokens de acceso, consulta Tokens de acceso.

Diagnósticos

Variable Utilizada por Descripción
RUST_LOG CLI y app-server Controla el filtrado y el nivel de detalle de los registros de Rust. La salida de codex exec utiliza error de forma predeterminada, salvo que establezca un valor 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.

La CLI interactiva registra los diagnósticos en almacenes locales con límites de forma predeterminada, pero el archivo de texto sin formato codex-tui.log es opcional. Establezca log_dir explícitamente cuando necesite un registro de texto sin formato para solucionar problemas:

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

En el modo no interactivo, codex exec muestra los mensajes en línea en lugar de escribirlos en un archivo de registro independiente de la TUI.