# Codex





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

Documentación oficial: [Codex CLI](https://developers.openai.com/codex/cli)

## Inicio rápido

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

```console
$ sbx run codex ~/mi-proyecto
```

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

```console
$ 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](/ai/sandboxes/security/credentials/#stored-secrets):

```console
$ 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:

```console
$ 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](/ai/sandboxes/security/credentials/) 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?](/ai/sandboxes/faq/#why-doesnt-the-sandbox-use-my-user-level-agent-configuration) 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 `--`:

```console
$ 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](/ai/sandboxes/customize) para preinstalar herramientas o personalizar este entorno.

