sbx run
| Descripción | Ejecuta un agente en un sandbox |
|---|---|
| Uso | sbx run [flags] SANDBOX | AGENT [PATH...] [-- AGENT_ARGS...] |
Descripción
Ejecuta un agente en un sandbox, creando el sandbox si aún no existe.
Pasa los argumentos del agente después del separador "--". Se pueden proporcionar espacios de trabajo adicionales como argumentos adicionales. Añade ":ro" al final para montarlos en modo de solo lectura.
Para crear un sandbox sin conectarte a él, usa "sbx create" en su lugar.
Agentes disponibles: claude, codex, copilot, cursor, docker-agent, droid, gemini, kiro, opencode, shell
Opciones
| Opción | Predeterminado | Descripción |
|---|---|---|
--branch | Crea un worktree de Git en la rama dada (usa --branch auto para generarla automáticamente) | |
--cpus | 0 | Número de CPUs a asignar al sandbox (0 = auto: N-1 CPUs del host, mín 1) |
--kit | Referencia del kit (directorio, ZIP u OCI). Se puede especificar varias veces | |
-m, --memory | Límite de memoria en unidades binarias (p. ej., 1024m, 8g). Por defecto: 50% de la memoria del host, máx 32 GiB | |
--name | Nombre para el sandbox (por defecto: <agent>-<workdir>) | |
-t, --template | Imagen del contenedor a utilizar para el sandbox (por defecto: imagen específica del agente) |
Opciones globales
| Opción | Predeterminado | Descripción |
|---|---|---|
-D, --debug | Habilita el modo de depuración (debug) |
Ejemplos
# Crear y ejecutar un sandbox con claude en el directorio actual
sbx run claude
# Crear y ejecutar con espacios de trabajo adicionales (solo lectura)
sbx run claude . /path/to/docs:ro
# Ejecutar un sandbox existente
sbx run existing-sandbox
# Ejecutar un sandbox con argumentos para el agente
sbx run claude -- --continue