Description

Run an agent in a sandbox. Create the sandbox if it does not exist.

Pass agent arguments after the "--" separator. Additional workspaces can be provided as extra arguments. Append ":ro" to mount them read-only.

Examples:

Create and run a sandbox with claude in current directory

docker sandbox run claude

Create and run a sandbox with claude in current directory (explicit)

docker sandbox run claude .

Create and run with additional workspaces (read-only)

docker sandbox run claude . /path/to/docs:ro

Run an existing sandbox

docker sandbox run existing-sandbox

Run a sandbox with agent arguments

docker sandbox run claude -- --continue

Options

Examples

Create and run Claude in the current directory

$ docker sandbox run claude .

Run an existing sandbox

$ docker sandbox run my-sandbox

Create and run with a specific workspace

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

The workspace directory is mounted at the same absolute path inside the sandbox.

Name the sandbox (--name)

--name NAME

Assign a custom name when creating a sandbox:

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

Use a custom base image (-t, --template)

--template IMAGE

Specify a custom container image when creating a sandbox:

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

By default, each agent uses a pre-configured image. The --template option lets you substitute a different image.

Pass arguments to the agent

Use -- to separate sandbox options from agent arguments:

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