Codex Cloud (versión anterior)

Usa los entornos para controlar qué instala y ejecuta Codex durante los chats en la nube. Por ejemplo, puedes agregar dependencias, instalar herramientas como linters y formateadores, y definir variables de entorno.

Configura los entornos en la configuración de Codex.

Cómo funcionan los chats de Codex en la nube

Cuando envías una tarea:

1. Codex crea un contenedor y carga tu repositorio en la rama seleccionada o en el commit que hayas indicado mediante su SHA.
2. Codex ejecuta tu script de configuración. Si se reanuda un contenedor almacenado en caché, también ejecuta el script de mantenimiento opcional.
3. Codex aplica tu configuración de acceso a internet. Los scripts de configuración se ejecutan con acceso a internet. El acceso a internet del agente está desactivado de forma predeterminada, pero puedes habilitar el acceso limitado o sin restricciones si lo necesitas. Consulta Acceso a internet del agente.
4. El agente ejecuta comandos de terminal en un bucle. Edita código, ejecuta comprobaciones e intenta validar su trabajo. Si tu repositorio incluye AGENTS.md, el agente lo consulta para encontrar los comandos de análisis estático y de pruebas específicos del proyecto.
5. Cuando termina, el agente muestra su respuesta y las diferencias en los archivos que modificó. Puedes abrir un PR o hacer preguntas de seguimiento.

Imagen universal predeterminada

El agente de Codex se ejecuta en una imagen de contenedor predeterminada llamada universal, que incluye lenguajes, paquetes y herramientas de uso común preinstalados.

En la configuración del entorno, selecciona Establecer versiones de paquetes para fijar las versiones de Python, Node.js y otros entornos de ejecución.

codex-universal incluye lenguajes preinstalados para agilizar y facilitar su uso. También puedes instalar paquetes adicionales en el contenedor mediante scripts de configuración.

Variables de entorno y secretos

Las variables de entorno están disponibles durante todo el chat, tanto al ejecutar los scripts de configuración como durante la fase del agente.

Los secretos son similares a las variables de entorno, con estas diferencias:

• Se almacenan con una capa adicional de cifrado y solo se descifran para ejecutar la tarea.
• Solo los scripts de configuración tienen acceso a ellos. Por motivos de seguridad, los secretos se eliminan antes de que comience la fase del agente.

Configuración automática

En proyectos que usan gestores de paquetes comunes (npm, yarn, pnpm, pip, pipenv y poetry), Codex puede instalar dependencias y herramientas automáticamente.

Configuración manual

Si tu entorno de desarrollo requiere una configuración más compleja, también puedes proporcionar un script de configuración personalizado. Por ejemplo:

# Install type checker
pip install pyright

# Install dependencies
poetry install --with test
pnpm install

Caché de contenedores

Codex guarda el estado del contenedor en caché hasta por 12 horas para agilizar el inicio de nuevos chats y la continuación de los existentes.

Cuando se guarda un entorno en caché:

• Codex clona el repositorio y carga la rama predeterminada.
• Codex ejecuta el script de configuración y guarda en caché el estado resultante del contenedor.

Cuando se reanuda un contenedor almacenado en caché:

• Codex carga la rama especificada para el chat.
• Codex ejecuta el script de mantenimiento (opcional). Esto es útil cuando el script de configuración se ejecutó en un commit anterior y es necesario actualizar las dependencias.

Codex invalida automáticamente la caché si cambias el script de configuración, el script de mantenimiento, las variables de entorno o los secretos. Si algún cambio en tu repositorio lo vuelve incompatible con el estado almacenado en caché, selecciona Restablecer caché en la página del entorno.

Acceso a internet y proxy de red

Durante la ejecución del script de configuración hay acceso a internet para instalar dependencias. Durante la fase del agente, el acceso a internet está desactivado de forma predeterminada, pero puedes configurar el acceso limitado o sin restricciones. Consulta Acceso a internet del agente.

Los entornos se ejecutan detrás de un proxy de red HTTP/HTTPS por motivos de seguridad y para prevenir abusos. Todo el tráfico saliente hacia internet pasa por este proxy.

Requisitos de Agent Security para el acceso de los comandos a la red

Si tu Espacio de trabajo usa Agent Security para administrar el acceso de los comandos a la red, revisa tanto la configuración de acceso a internet del entorno como la política administrada. Consulta Aislamiento de red para saber cómo se aplican estos controles a los comandos.