Compartir comentarios
Las respuestas se generan en base a la documentación.

Claude Code

Tabla de contenidos
Disponibilidad: Acceso anticipado

Documentación oficial: Claude Code

Inicio rápido

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

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

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

$ sbx secret set -g anthropic

Alternativamente, exporta la variable de entorno ANTHROPIC_API_KEY en tu shell antes de ejecutar el sandbox. Consulta Credenciales 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? para conocer las soluciones alternativas.

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

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

Consulta la referencia de la CLI de Claude Code 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 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. Para la versión de solo host sin sandbox, consulta Usar Claude Code con Docker Model Runner.