# Claude Code





Documentación oficial: [Claude Code](https://code.claude.com/docs)

## Inicio rápido

Lanza Claude Code en un sandbox apuntándolo a un directorio de proyecto:

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

El parámetro del espacio de trabajo toma como valor predeterminado el directorio actual, por lo que ejecutar `sbx run claude` desde tu proyecto también funciona. Para iniciar Claude con un prompt específico:

```console
$ sbx run claude --name mi-sandbox -- "Añade control de errores a la función de inicio de sesión"
```

Todo lo que va después de `--` se pasa directamente a Claude Code. También puedes canalizar un prompt desde un archivo con `-- "$(cat prompt.txt)"`.

## Autenticación

Claude Code requiere una clave de API de Anthropic o una suscripción a Claude.

**Clave de API**: Almacena tu clave utilizando [secretos guardados](/ai/sandboxes/security/credentials/#stored-secrets):

```console
$ sbx secret set -g anthropic
```

Alternativamente, exporta la variable de entorno `ANTHROPIC_API_KEY` en tu shell antes de ejecutar el sandbox. Consulta [Credenciales](/ai/sandboxes/security/credentials/) para obtener más detalles sobre ambos métodos.

**Suscripción a Claude**: Si no se configura ninguna clave de API, Claude Code te pedirá que te autentiques de forma interactiva utilizando OAuth. El proxy gestiona el flujo de OAuth, por lo que las credenciales no se almacenan dentro del sandbox.

## Configuración

Los sandboxes no heredan la configuración a nivel de usuario de tu host, como `~/.claude`. 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.

Cualquier opción de la CLI de Claude Code se puede pasar después del separador `--`:

```console
$ sbx run claude --name mi-sandbox -- --continue
```

Consulta la [referencia de la CLI de Claude Code](https://code.claude.com/docs/en/cli-reference) para ver las opciones disponibles.

## Imagen base

El sandbox utiliza `docker/sandbox-templates:claude-code` y lanza Claude Code con `--dangerously-skip-permissions` por defecto. Consulta [Plantillas](/ai/sandboxes/customize/templates/) para compilar tu propia imagen sobre esta base.

## Usar un modelo local

Para ejecutar Claude Code en un sandbox contra un modelo local en tu host a través de Docker Model Runner, consulta [Ejecutar Claude Code en un Docker Sandbox con Docker Model Runner](/guides/claude-code-sandbox-model-runner/). Para la versión de solo host sin sandbox, consulta [Usar Claude Code con Docker Model Runner](/guides/claude-code-model-runner/).