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

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 codex exec Proporciona una API key para una única ejecución no interactiva. Solo es compatible con codex exec; establézcala en línea, en lugar de para todo el trabajo, cuando ejecute 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 la automatización de confianza. Para conservar el inicio de sesión, canalícelo a codex login --with-access-token.
CODEX_CA_CERTIFICATE Clientes HTTPS, de inicio de sesión y WebSocket Apunta a un paquete de CA en formato PEM para entornos con interceptación TLS corporativa o CA raíz privadas. Tiene prioridad sobre SSL_CERT_FILE.
SSL_CERT_FILE Clientes HTTPS, de inicio de sesión y WebSocket Ruta alternativa al paquete de CA en formato PEM cuando CODEX_CA_CERTIFICATE no está establecida.

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 de automatización, consulte Usar autenticación mediante API key. Para configurar tokens de acceso, consulte 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.