Sandboxes para agentes de IA
Los Sandboxes en Lizard (lizard.build) son máquinas Linux aisladas donde un agente de IA ejecuta código y tareas. Sandboxes admite microVMs de Firecracker con su propio kernel; también usa contenedores en los casos que se describen a continuación. Tu código crea uno con Lizard SDK (@lizard-build/sdk para TypeScript, lizard-sdk para Python), o ejecutas lizard sandbox create en una terminal; después ejecutas comandos, lees y escribes archivos y abres puertos. En una prueba del 2026-10-12, la mediana del tiempo desde crear un sandbox hasta su primera salida de Python fue de 228 ms.
Cuándo usar Sandboxes
- Ejecuta código que escribió un modelo. Dale a un LLM un intérprete de código que conserva el estado de Python entre llamadas.
- Dale a un agente de programación su propia máquina. Ejecuta Claude Code, OpenCode o Codex en un sandbox en lugar de en tu portátil. Conecta sus credenciales con
lizard agentsy envía prompts conlizard sandbox prompt. - Previsualiza lo que construyó el agente. Inicia un servidor de desarrollo y ábrelo mediante una URL de vista previa privada.
- Prueba varios caminos a la vez. Haz fork de un sandbox en marcha, con su memoria y sus procesos, o restaura muchas copias desde un snapshot.
- Controla un navegador. La plantilla
desktopejecuta un escritorio gráfico que un agente controla con capturas de pantalla, clics y teclas.
Para un servicio web o un worker que deba seguir en marcha, despliega una app; consulta el inicio rápido de apps.
¿Cuánto tarda en arrancar un sandbox?
En una prueba del 2026-10-12, la mediana del tiempo desde crear un sandbox hasta su primera salida de Python fue de 228 ms, y el percentil 95 fue de 310 ms. La prueba se ejecutó 300 veces desde la región US East de Railway contra us-east-1, con la plantilla base y el tamaño Small. Los resultados de la misma prueba para E2B, Daytona y Modal están en la página de Sandboxes.
Sandboxes de un vistazo
| Pregunta | Respuesta |
|---|---|
| ¿Qué ejecuta el código? | Una microVM de Firecracker o un contenedor; consulta runtime y plantillas |
| ¿Cómo creo uno? | Lizard SDK, lizard sandbox, el panel o la API HTTP |
| ¿Qué plantillas hay? | base, interpreter, codex, claude, opencode, pi, prime y desktop |
| ¿Qué tamaños hay? | Small (2 vCPU / 4 GB), Medium (4 vCPU / 8 GB, el predeterminado) y Large (8 vCPU / 16 GB); consulta tamaños y precios |
| ¿Cuánto dura uno? | Cinco minutos por defecto desde el SDK y la CLI; sin vencimiento por defecto desde la API directa y el panel |
| ¿Qué sobrevive a una detención? | Solo los archivos de un volumen de Persistent Volumes montado en /workspace |
| ¿Cuántos pueden ejecutarse a la vez? | 100 en Pro, 5 durante la prueba; consulta límites de la cuenta |
Runtime y plantillas
Elige una plantilla del catálogo actual: base, interpreter, codex, claude, opencode, pi, prime o desktop. Su disponibilidad depende de la región y de la capacidad del pool. interpreter incluye Python y bibliotecas de datos habituales. desktop ejecuta un escritorio gráfico que controlas con sandbox.desktop o lizard sandbox desktop. Comprueba las versiones dentro del sandbox. La CLI pública no permite subir plantillas propias.
Lizard Sandboxes admite microVMs de Firecracker con su propio kernel. Un sandbox también puede ejecutarse en un contenedor de Kubernetes que comparte el kernel del host: con un volumen o snapshot antiguo de pod, cuando la configuración de la cuenta o región elige contenedores, o tras algunos fallos al iniciar Firecracker. Comprueba getInfo().runtime antes de ejecutar código que necesite un kernel propio. Da al agente solo las credenciales y los permisos que necesita para su tarea. Un snapshot o volumen de Firecracker requiere Firecracker: si no puede iniciarse, la creación falla sin cambiar a un contenedor.
Ciclo de vida
Crea un sandbox, ejecuta comandos y llama a kill. connect se conecta a un sandbox existente sin cambiar su estado, así que no reanuda uno pausado ni uno detenido. Pausar, reanudar, snapshot y restore están disponibles; consulta Pausa, reanudación y snapshots. fork copia un sandbox en marcha, incluidos la memoria y los procesos; devuelve 409 cuando hay un volumen adjunto y 501 en un sandbox que se ejecuta como pod. La vigilancia de archivos aún no está disponible. lizard sandbox ssh abre una shell interactiva con tus credenciales de la CLI. No hay acceso por el protocolo SSH, así que los clientes SSH, scp y el reenvío de puertos no funcionan.
create -> running -> stopped (kill / expiration)
running -> paused -> running (pause / resume)
running -> new sandboxes (fork)
snapshot -> new sandbox (restore)Recursos y duración
Elige un tamaño al crear un sandbox: Small (2 vCPU / 4 GB), Medium (4 vCPU / 8 GB, el predeterminado) o Large (8 vCPU / 16 GB). Consulta tamaños y precios. Indica la región de forma explícita si hace falta; que aparezca en el catálogo no garantiza capacidad libre.
El SDK y la CLI fijan cinco minutos de duración por defecto. La API directa y el panel no fijan caducidad por defecto. Indica la duración: timeoutMs: 0 al crear desactiva la caducidad; un valor positivo fija un plazo. setTimeout acepta 1000 a 2147483647 ms, no cero. Los comandos no reinician el plazo. No es un temporizador de inactividad.
Almacenamiento y facturación
Los archivos y procesos siguen disponibles mientras el sandbox está en ejecución. Tras detenerlo, otro sandbox solo puede recuperar los archivos escritos en un volumen de Persistent Volumes adjunto en /workspace. Sin volumen, /workspace es temporal. Cada volumen se adjunta a un solo sandbox y usa almacenamiento local de un nodo; exporta los archivos que deban sobrevivir a la pérdida del nodo.
Cada tamaño tiene un precio fijo por hora, facturado por segundo mientras el sandbox está en marcha, incluido el tiempo inactivo. El tráfico saliente está incluido hasta 2 TB por cuenta en una ventana móvil de 30 días. Un sandbox restaurado desde un snapshot se ejecuta con el tamaño y el precio de su origen; uno restaurado desde un snapshot de pod se factura por consumo medido. Una pausa completada detiene los cargos de cómputo; Persistent Volumes se facturan aparte mientras guardes los datos. Pausa o detén el sandbox cuando termine la tarea. Las tarifas de cada recurso están en la página de facturación y en precios.
Guías
- Ejecutar Claude Code en un sandbox
- Ejecutar OpenCode en un sandbox
- URLs de vista previa para un servidor de desarrollo
- Intérprete de código para código generado por LLM
- Conservar archivos con Persistent Volumes
Referencia
- Inicio rápido de Sandboxes: tu primer sandbox, paso a paso.
- Referencia de la API y el SDK de Sandboxes: cada llamada en TypeScript y Python.
lizard sandbox: crear, exec, shell, snapshots y agentes de programación desde la terminal.- Panel de Sandboxes: crea, inspecciona y detén sandboxes en el navegador.
- Límites: tamaños, precios, concurrencia y tráfico de salida.
Actualizado