diff --git a/content/manuals/ai/sandboxes/_index.md b/content/manuals/ai/sandboxes/_index.md
index 0e737fc3b530..6f052e180946 100644
--- a/content/manuals/ai/sandboxes/_index.md
+++ b/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:
diff --git a/content/manuals/ai/sandboxes/agents.md b/content/manuals/ai/sandboxes/agents.md
index 18c94d2905ba..f4fde7cb3c6e 100644
--- a/content/manuals/ai/sandboxes/agents.md
+++ b/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
diff --git a/content/manuals/ai/sandboxes/architecture.md b/content/manuals/ai/sandboxes/architecture.md
index 86ab04cda8a5..a6453edc29f7 100644
--- a/content/manuals/ai/sandboxes/architecture.md
+++ b/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
diff --git a/content/manuals/ai/sandboxes/get-started.md b/content/manuals/ai/sandboxes/get-started.md
index e947464c1880..3f7e0f5c08a8 100644
--- a/content/manuals/ai/sandboxes/get-started.md
+++ b/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
diff --git a/content/manuals/ai/sandboxes/migration.md b/content/manuals/ai/sandboxes/migration.md
index 2959681cc627..d46937f04fe3 100644
--- a/content/manuals/ai/sandboxes/migration.md
+++ b/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`