# docker sandbox run

**Descripción:** Ejecuta un agente en un sandbox

**Uso:** `docker sandbox run SANDBOX [-- AGENT_ARGS...] | AGENT [WORKSPACE] [EXTRA_WORKSPACE...] [-- AGENT_ARGS...]`










## Descripción

> [!WARNING]
> Los comandos `docker sandbox` integrados en Docker Desktop están obsoletos y han sido
> reemplazados por la [CLI `sbx` independiente](/ai/sandboxes/).
> Esta obsolescencia se aplica únicamente a la integración con Docker Desktop, no a los
> sandboxes de Docker en sí.

Ejecuta un agente en un sandbox. Crea el sandbox si este no existe.

Pasa los argumentos del agente después del separador "--".
Se pueden proporcionar espacios de trabajo adicionales como argumentos extra. Añade ":ro" al final para montarlos en modo de solo lectura.

Ejemplos:
  # Crea y ejecuta un sandbox con claude en el directorio actual
  docker sandbox run claude

  # Crea y ejecuta un sandbox con claude en el directorio actual (explícito)
  docker sandbox run claude .

  # Crea y ejecuta con espacios de trabajo adicionales (solo lectura)
  docker sandbox run claude . /path/to/docs:ro

  # Ejecuta un sandbox existente
  docker sandbox run existing-sandbox

  # Ejecuta un sandbox con argumentos de agente
  docker sandbox run claude -- --continue


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--name` |  |  Nombre para el sandbox (por defecto: <agent>-<workdir>) |

 | `--pull-template` | `missing` |  Política de descarga de la imagen de la plantilla: always (descargar siempre del registro), missing (descargar solo si no está en caché), never (usar solo imágenes en caché)<br> |

 | `-t`, `--template` |  |  Imagen de contenedor a utilizar para el sandbox (por defecto: imagen específica del agente)<br> |




## Ejemplos

### Crea y ejecuta Claude en el directorio actual

```console
$ docker sandbox run claude .
```

### Ejecuta un sandbox existente

```console
$ docker sandbox run my-sandbox
```

### Crea y ejecuta con un espacio de trabajo específico

```console
$ docker sandbox run claude ~/projects/my-app
```

El directorio del espacio de trabajo se monta en la misma ruta absoluta dentro del sandbox.

### Nombra el sandbox (--name) {#name}

```text
--name NOMBRE
```

Asigna un nombre personalizado al crear un sandbox:

```console
$ docker sandbox run --name my-project claude .
```

### Usa una imagen base personalizada (-t, --template) {#template}

```text
--template IMAGEN
```

Especifica una imagen de contenedor personalizada al crear un sandbox:

```console
$ docker sandbox run --template python:3-alpine claude .
```

Por defecto, cada agente utiliza una imagen preconfigurada. La opción `--template` te permite sustituirla por una imagen diferente.

### Pasa argumentos al agente

Usa `--` para separar las opciones del sandbox de los argumentos del agente:

```console
$ docker sandbox run claude . -- -p "What version are you running?"
```