Supported agents

{{< summary-bar feature_name="Docker Sandboxes" >}}

Docker Sandboxes supports multiple AI coding agents. All agents run isolated inside microVMs with private Docker daemons.

Supported agents

Experimental status

All agents are experimental features. This means:

• Breaking changes may occur between Docker Desktop versions
• Features may be incomplete or change significantly
• Stability and performance are not production-ready
• Limited support and documentation

Use sandboxes for development and testing, not production workloads.

Using different agents

The agent type is specified when creating a sandbox:

$ docker sandbox create AGENT [PATH] [PATH...]

Each agent runs in its own isolated sandbox. The agent type is bound to the sandbox when created and cannot be changed later.

Template environment

All agent templates share a common base environment:

• Ubuntu 25.10 base
• Development tools: Docker CLI (with Buildx and Compose), Git, GitHub CLI, Node.js, Go, Python 3, uv, make, jq, ripgrep
• Non-root agent user with sudo access
• Private Docker daemon for running additional containers
• Package managers: apt, pip, npm

Individual agents add their specific CLI tools on top of this base. See Custom templates to build your own agent images.

Agent-specific configuration

Each agent has its own credential requirements and authentication flow. Credentials are scoped per agent and must be provided specifically for that agent (no fallback authentication methods are used).

See the agent-specific documentation:

• Claude Code
• Docker Agent
• Codex
• Copilot
• Gemini
• Kiro
• OpenCode
• Custom shell

Requirements

• Docker Desktop 4.58 or later
• Platform support:
  • macOS with virtualization.framework
  • Windows with Hyper-V {{< badge color=violet text=Experimental >}}
• API keys or credentials for your chosen agent