Merge pull request #24018 from dvdksn/sandboxes-snafu

sandboxes: experimental windows support, link to legacy version

Author: dvdksn

content/manuals/ai/sandboxes/_index.md

@@ -34,6 +34,11 @@ You get:
 For a comparison between Docker Sandboxes and other approaches to isolating
 coding agents, see [Comparison to alternatives](./architecture.md#comparison-to-alternatives).
 
+> [!NOTE]
+> MicroVM-based sandboxes require macOS or Windows (experimental). Linux users
+> can use legacy container-based sandboxes with
+> [Docker Desktop 4.57](/desktop/release-notes/#4570).
+
 ## How to use sandboxes
 
 To create and run a sandbox:

content/manuals/ai/sandboxes/agents.md

@@ -57,6 +57,7 @@ See the agent-specific documentation:
 - 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
 
 ## Next steps

content/manuals/ai/sandboxes/architecture.md

@@ -61,6 +61,7 @@ Docker capabilities but cannot safely share your Docker daemon.
 Sandboxes use your system's native virtualization:
 
 - macOS: virtualization.framework
+- Windows: Hyper-V {{< badge color=violet text=Experimental >}}
 
 This provides hypervisor-level isolation between the sandbox and your host.
 Unlike containers (which share the host kernel), VMs have separate kernels and

content/manuals/ai/sandboxes/get-started.md

@@ -19,7 +19,7 @@ This guide runs Claude Code in an isolated sandbox for the first time.
 Before you begin, ensure you have:
 
 - Docker Desktop 4.58 or later
-- macOS
+- macOS, or Windows {{< badge color=violet text=Experimental >}}
 - A Claude API key
 
 ## Run your first sandbox

content/manuals/ai/sandboxes/migration.md

@@ -16,6 +16,10 @@ Docker Sandboxes now run in lightweight microVMs instead of containers. Each
 sandbox has a private Docker daemon, better isolation, and network filtering
 policies.
 
+> [!NOTE]
+> If you need to use legacy container-based sandboxes, install
+> [Docker Desktop 4.57](/desktop/release-notes/#4570).
+
 After upgrading to Docker Desktop 4.58:
 
 - Old sandboxes don't appear in `docker sandbox ls`