Ejecutar Claude Code en un sandbox

Para ejecutar Claude Code en un sandbox de Lizard (lizard.build), conecta una credencial una sola vez con lizard agents add claude (un token de claude setup-token) o lizard agents add anthropic (una clave de API). Después crea un sandbox desde la plantilla claude y envíale trabajo con lizard sandbox prompt <id> --agent claude "…". Claude Code se ejecuta en su propia máquina Linux con --dangerously-skip-permissions: edita archivos y ejecuta comandos sin preguntar, y no tiene acceso a tu equipo.

Estado de las pruebas: los comandos y el comportamiento de esta página se basan en Lizard CLI 4.0.42 y del ejecutor de agentes de la plataforma a fecha de 2026-10-12. No hemos probado todos estos pasos de principio a fin en un sandbox real para esta página. Comprobamos en local los pasos de git bundle y del parche.

Antes de empezar

• Lizard CLI, con la sesión iniciada mediante lizard login, y un proyecto: ejecuta lizard init en una carpeta o pasa -p <project> a los comandos de sandbox.
• Lizard Pro o la prueba de Pro de 7 días (requiere tarjeta). Los sandboxes se facturan por segundo según su tamaño mientras están en marcha; consulta límites y precios.
• Para una suscripción de Claude: Claude Code en tu equipo, para ejecutar claude setup-token.

Conectar una credencial

Las credenciales pertenecen a tu cuenta de Lizard, no a un proyecto, y cualquier sandbox que inicies puede usarlas. Claude Code usa una credencial a la vez. Si tienes varias conectadas, elige una y, si quieres, un modelo predeterminado:

lizard agents use claude --credential anthropic
lizard agents use claude -m sonnet
lizard agents status

Consulta lizard agents para ver todas las opciones.

Crear un sandbox

lizard sandbox create -t claude --timeout 3600000

El comando muestra el ID del sandbox, por ejemplo sb_abc123. Guárdalo en una variable para los pasos siguientes: SB=sb_abc123.

• --timeout 3600000 le da al sandbox una hora. El valor predeterminado de la CLI es de cinco minutos; pasado ese tiempo, Lizard elimina el sandbox y sus archivos, aunque esté a mitad de una tarea. Amplía la duración de uno en marcha con lizard sandbox timeout $SB 3600000.
• La plantilla claude incluye Node.js 22, una versión fijada de Claude Code, git, Python 3, ripgrep, curl, jq, unzip y Lizard CLI. Comprueba la versión de Claude Code con lizard sandbox exec $SB -- claude --version.
• El tamaño predeterminado es Medium (4 vCPU, 8 GB). Pasa --size small o --size large para cambiarlo.

Poner tu código en el sandbox

Desde un repositorio público:

lizard sandbox exec $SB -- git clone https://github.com/your-org/your-app /workspace/app

Desde un repositorio git local, también uno privado:

git bundle create /tmp/app.bundle HEAD
lizard sandbox files put $SB /tmp/app.bundle /workspace/app.bundle
lizard sandbox exec $SB -- git clone -q /workspace/app.bundle /workspace/app

Un bundle solo contiene archivos que ya están en un commit, así que .env y los demás archivos sin seguimiento se quedan en tu equipo.

Enviar un prompt

lizard sandbox prompt $SB --agent claude --cwd /workspace/app "run the tests and fix any that fail"

La CLI transmite cada llamada a una herramienta y, después, la respuesta de Claude, el número de tokens y el ID de la conversación. Banderas útiles: -m <model>, --effort <level>, -v para mostrar la salida de los comandos y --no-wait para volver de inmediato. Ctrl-C deja de mostrar la actividad; Claude sigue trabajando. Detenlo con lizard sandbox interrupt $SB.

Para continuar la misma sesión de Claude Code, pasa el ID de la conversación:

lizard sandbox prompt $SB --agent claude -c conv_0123456789abcdef --cwd /workspace/app "now add a test for an empty list"
lizard sandbox conversations $SB

Pasa --agent claude y --cwd en cada prompt, también en los siguientes. Sin --agent, la CLI usa Codex, y sin --cwd, el agente trabaja en /workspace.

A qué tiene acceso Claude Code

• Permisos. Cada turno ejecuta claude -p con --dangerously-skip-permissions como root dentro del sandbox. Claude edita archivos, instala paquetes y ejecuta comandos sin preguntar. Estos permisos se limitan al sandbox.
• Archivos. Todo lo que hay en el sandbox y nada de tu equipo.
• Red. Acceso a internet de salida, para descargar paquetes y llamar a APIs. El precio del sandbox incluye el tráfico de salida hasta 2 TB por cuenta en una ventana móvil de 30 días.
• Tu credencial. Durante una ejecución, el token está en el entorno de Claude Code como CLAUDE_CODE_OAUTH_TOKEN o ANTHROPIC_API_KEY, y los comandos que ejecuta lo heredan. Con una suscripción, es el token de larga duración de claude setup-token; solo los inicios de sesión de ChatGPT reciben una copia de corta duración en cada ejecución. Da por hecho que el código que se ejecuta en el sandbox puede leerlo, y elimínalo con lizard agents remove claude cuando ya no lo necesites.
• Tu cuenta de Lizard. Sin acceso por defecto. Crea el sandbox con --with-token <key> para instalar una clave liz_ y que lizard funcione dentro, por ejemplo para desplegar lo que construyó Claude. Cualquier proceso del sandbox puede leer esa clave, así que usa una limitada a un solo workspace o proyecto; consulta lizard keys.

Recuperar los cambios

lizard sandbox exec $SB -- sh -c 'cd /workspace/app && git add -A && git diff --cached > /tmp/claude.patch'
lizard sandbox files get $SB /tmp/claude.patch claude.patch
git apply claude.patch

Revisa el parche antes de hacer commit. Para probar una app web que inició Claude, abre una URL de vista previa para su puerto, por ejemplo con lizard sandbox expose $SB 3000.

Usar Claude Code a mano

lizard sandbox ssh $SB abre una shell en el sandbox. Las credenciales de lizard agents solo llegan a las ejecuciones de lizard sandbox prompt, así que exporta tu propio CLAUDE_CODE_OAUTH_TOKEN o ANTHROPIC_API_KEY en esa shell y luego ejecuta claude.

Pausar o eliminar el sandbox

lizard sandbox pause $SB
lizard sandbox resume $SB
lizard sandbox rm $SB

Una pausa completada detiene los cargos de cómputo; el almacenamiento en Persistent Volumes se sigue cobrando. Reanudar restaura los archivos y procesos y vuelve a iniciar los cargos de cómputo. El estado de las conversaciones está en /workspace/.lizard-agent, dentro del sandbox. Para conservar archivos después de eliminar el sandbox, adjunta un volumen de Persistent Volumes al crearlo con --volume.

Problemas comunes

Ver también

• Ejecutar OpenCode en un sandbox
• Sandboxes
• lizard sandbox
• Desplegar desde un agente de programación

Actualizado 17 de octubre de 2026