Description

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

Pass agent arguments after the "--" separator.

Examples:

Create and run a sandbox with claude in current directory

docker sandbox run claude .

Run an existing sandbox

docker sandbox run existing-sandbox

Run a sandbox with agent arguments

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

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?"

Run with locally built template

Use --load-local-template to test local template changes:

$ docker sandbox run --load-local-template claude .