Docker 沙箱

Table of contents

Availability: Experimental

Requires: Docker Desktop 4.58 or later

Docker 沙箱让您可以在机器上的隔离环境中运行 AI 编程代理。如果您正在使用像 Claude Code 这样的代理进行开发，沙箱提供了一种安全的方式，既能赋予代理自主权，又不会危及您的系统安全。

为何使用 Docker 沙箱

AI 代理需要执行命令、安装软件包和测试代码。如果直接在主机上运行它们，意味着它们可以完全访问您的文件、进程和网络。Docker 沙箱将代理隔离在微虚拟机（microVM）中，每个微虚拟机都有自己的 Docker 守护进程。代理可以在其中启动测试容器并修改其环境，而不会影响您的主机。

您将获得：

有关 Docker 沙箱与其他隔离编程代理方法的比较，请参阅与其他方案的比较。

Note

基于微虚拟机的沙箱需要 macOS 或 Windows（实验性支持）。Linux 用户可以使用基于传统容器的沙箱，需配合 Docker Desktop 4.57 使用。

要创建并运行一个沙箱：

$ docker sandbox run claude ~/my-project

此命令会为您的项目空间（~/my-project）创建一个沙箱，并在其中启动 Claude Code 代理。现在，代理可以在隔离的沙箱环境中处理您的代码、安装工具并运行容器。

沙箱运行在带有专用 Docker 守护进程的轻量级微虚拟机中。每个沙箱都是完全隔离的——代理在虚拟机内运行，无法访问您的主机 Docker 守护进程、容器或项目空间之外的文件。

您的项目目录会在主机和沙箱之间以相同的绝对路径同步，因此错误消息中的文件路径在两个环境中保持一致。

沙箱不会出现在您主机上的 docker ps 命令输出中，因为它们是虚拟机，而不是容器。请使用 docker sandbox ls 命令查看它们。

有关架构、隔离模型和网络的技术细节，请参阅架构。

为不同的项目创建独立的沙箱：

$ docker sandbox run claude ~/project-a
$ docker sandbox run claude ~/project-b

每个沙箱都与其他沙箱完全隔离。沙箱会持续存在，直到您手动删除它们，因此已安装的软件包和配置会为该工作空间保留。

Docker 沙箱支持多种 AI 编程代理：

请前往入门指南运行您的第一个沙箱代理。

有关常见配置错误，请参阅故障排除，或在 Docker Desktop 问题追踪器上报告问题。