docker sandbox create

Description

Create a sandbox with access to a host workspace for an agent.

Available agents are provided as subcommands. Use "create AGENT --help" for agent-specific options.

Options

Examples

Create a Claude sandbox

$ docker sandbox create claude ~/my-project

Create with a custom name

$ docker sandbox create --name my-sandbox claude ~/my-project

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

--template IMAGE

Specify a custom container image to use as the sandbox base:

$ docker sandbox create --template python:3-alpine claude ~/my-project

By default, each agent uses a pre-configured image.

Use locally built template (--load-local-template)

Load a locally built template image for testing:

$ docker sandbox create --load-local-template claude ~/my-project

This is useful when developing or testing changes to sandbox templates.

Create and run immediately

After creating a sandbox, use run to start the agent:

$ docker sandbox create --name my-sandbox claude ~/my-project
$ docker sandbox run my-sandbox

Or use docker sandbox run directly to create and run in one step:

$ docker sandbox run claude ~/my-project

Subcommands