Codex

Esta guía cubre la autenticación, configuración y uso de Codex en un entorno de sandbox.

Documentación oficial: Codex CLI

Inicio rápido

Crea un sandbox y ejecuta Codex para un directorio de proyecto:

$ sbx run codex ~/mi-proyecto

El parámetro del espacio de trabajo es opcional y toma como valor predeterminado el directorio actual:

$ cd ~/mi-proyecto
$ sbx run codex

Autenticación

Codex admite dos métodos de autenticación: una clave de API o OAuth.

Clave de API: Almacena tu clave de API de OpenAI utilizando secretos guardados:

$ sbx secret set -g openai

Alternativamente, exporta la variable de entorno OPENAI_API_KEY en tu shell antes de ejecutar el sandbox.

OAuth: Si prefieres no usar una clave de API, inicia el flujo de OAuth en tu host con:

$ sbx secret set -g openai --oauth

Esto abre una ventana del navegador para la autenticación y almacena los tokens resultantes en el llavero de tu sistema operativo. El flujo de OAuth se ejecuta en el host, no dentro del sandbox, por lo que la autenticación basada en navegador funciona sin ninguna configuración adicional.

Consulta Credenciales para obtener más detalles.

Configuración

Los sandboxes no heredan la configuración a nivel de usuario de tu host, como ~/.codex. Solo la configuración a nivel de proyecto en el directorio de trabajo está disponible dentro del sandbox. Consulta ¿Por qué el sandbox no utiliza la configuración de mi agente a nivel de usuario? para conocer las soluciones alternativas.

El sandbox ejecuta Codex sin avisos de aprobación por defecto. Pasa opciones adicionales de la CLI de Codex después de --:

$ sbx run codex --name <nombre-sandbox> -- <opciones-de-codex>

Imagen base

Plantilla: docker/sandbox-templates:codex

Preconfigurado para ejecutarse sin avisos de aprobación.

Consulta Personalización para preinstalar herramientas o personalizar este entorno.