Claude Code CLI overlay for a shell workload, with Anthropic credentials and agent hooks.
10K+
Claude Code CLI overlay for a shell workload, with Anthropic credentials and agent hooks.
| Name | Required | Default | Description |
|---|---|---|---|
model | Optional | | Claude model to use (settings.json `model`); empty keeps the CLI default |
reasoningEffort | Optional | | Effort level (settings.json `effortLevel`); empty keeps the CLI default Options: , low, medium, high, xhigh, max, auto |
version | Required | — | Claude Code release the overlay carries |
[email protected]| Type | Required | Description | |
|---|---|---|---|
com.docker.sandbox/network-policy@1 | Required | — | |
com.docker.sandbox/credential@1 | Optional | Anthropic API access (API key or claude.ai OAuth) | |
com.docker.sandbox/lifecycle@1 | Required | — | |
com.docker.sandbox/agent-skills@1 | Optional | — | |
com.docker.sandbox/agent-context@1 | Optional | — | |
com.docker.sandbox/agent-context@2 | Optional | — | |
sbx run <agent> --kit sbx/claude-mixin:latestRun the following command to install sbx on your machine.
brew install docker/tap/sbxwinget install Docker.sbxThis v3 mixin Kit packages Claude Code for Docker Sandboxes. It adds the agent, authentication configuration, and runtime integration to a compatible workload. The workload keeps its entrypoint.
This Kit is built on Docker Hardened Images.
sbx run sbx/shell:latest --kit sbx/claude-mixin:latest /path/to/workspace
When the shell opens, run claude. This kit supplies an overlay, so it needs a workload such as
Shell.
Set these arguments when creating the sandbox with --kit-arg <name>=<value>. Repeat the flag for multiple arguments.
Use --kit-arg <kit>.<name>=<value> to target one kit in a composition, as in the example below.
| Argument | Default | Description | Accepted values |
|---|---|---|---|
model | "" | Claude model to use (settings.json model); empty keeps the CLI default | Letters, digits, ., _, and -. |
reasoningEffort | "" | Effort level (settings.json effortLevel); empty keeps the CLI default | Empty, low, medium, high, xhigh, max, or auto. |
An empty value keeps the agent default. The model must be available to your provider account, and the selected model
must support the requested effort or thinking level. These are kit configuration inputs, separate from agent
command-line arguments passed after --.
sbx run sbx/shell:latest --kit sbx/claude-mixin:latest \
--kit-arg claude-mixin.model=claude-sonnet-4-6 --kit-arg claude-mixin.reasoningEffort=high \
/path/to/workspace
Bind an Anthropic API key on the host with sbx secret set anthropic, or use a Claude subscription through the
runtime's OAuth support. With no host credential, Claude Code can prompt for /login inside the sandbox. Host-bound
credentials remain proxy-managed.
The sandbox supplies the isolation for agent tool execution. Launch the kit through Docker Sandboxes and configure extra tool or MCP destinations in the runtime network policy as needed.
sbx/claude provides the complete agent workload.sbx/claude-acp provides the ACP adapter for the composed agent.sbx/claude-sessions provides host-backed conversation state.For the Kit format and capability contracts, see the Sandbox Kit v3 specification.
For runtime setup, see the Docker Sandboxes documentation. For provenance, SBOM, VEX, and image verification, see the Docker Hardened Images documentation.
Claude, Claude Code, and Anthropic are trademarks of Anthropic PBC. Product names and logos do not imply sponsorship or endorsement.