![](https://developer.qcloudimg.com/http-save/yehe-7353521/a63ece73e40406869dca2db6405fecfd.jpg)

## TL;DR

在 Mac 上装好 Docker Sandboxes，把 Coding Agent 跑进一台可以随手删掉的微虚拟机。它自己的内核、文件系统、网络、Docker Engine，宿主机都碰不到——但你主动挂进去的项目目录是例外，Agent 在里面读写和你本人权限一样，不受额外限制。

安装到跑通 OpenCode，最短路径不到十分钟；真正费事的是模型登录：sandbox 不继承宿主机账号，SuperGrok 这类订阅还要单独 `/connect` 并放行网络策略。装完能人机协作改同一棵树，还不到无人值守的程度。

## 引言

给 Coding Agent 选运行环境时，「容器 vs 微虚拟机」不是选择题，是真问题。

Agent 要自己装依赖、跑测试、起 Compose，才算真的在干活。这些事权限不低。常见做法是把宿主机的 Docker socket 挂进容器，等于把整台机器的 Docker 交给它——风险出在共享宿主机内核和宿主机 Docker 上。

[Docker Sandboxes](https://www.docker.com/products/docker-sandboxes) 换了个方案：不共享内核和 Docker，而是给每个任务一个可以删掉的微虚拟机。项目还在你的 Mac 上，宿主机的 Docker 它碰不到。

下面只做一件事：在 Apple Silicon 的 Mac 上，从安装走到第一次跑起来。环境是 M1 Pro、`sbx v0.38.0`、OpenCode。宿主机上的 Docker 是 OrbStack。不是全 Agent 评测，也不讲隔离机制的全景。

## 能删的虚拟机，删不掉的工作区

一个 sandbox 对应一台微虚拟机，不是一次对话。Agent 退出后环境还在，再连上去，装过的包和拉过的镜像都在。只有 `sbx rm` 才拆掉。

里面有四样东西：

- 自己的 Linux kernel，不是和 Mac 共用一个
- 自己的文件系统，宿主机上的目录默认进不去
- 自己的网络，出站走策略，宿主机 localhost 不是它的 localhost
- 自己的 Docker Engine。在里面 `docker ps`，看到的不是 OrbStack

项目目录是挂进去的，路径和 Mac 上一样。Agent 改的文件，你这边立刻看得到。这是协作需要的，也是边界：工作区里的 `.env`、`.git` 都能被 Agent 直接读到，没有额外的权限限制去挡它。

和「容器里再跑 Agent、再把 `docker.sock` 挂进去」的差别就在这里。后者共享的是宿主机内核和宿主机 Docker；前者把这两样留在微虚拟机里。

具体到 Agent 这边，Docker 给这条链路预置了 Claude Code、Codex、OpenCode 等几个 Agent，加上一个没有预装 Agent 的 shell。本文只测 OpenCode——Kimaki（我自己接的 Discord + OpenCode 方案）和 omp（Pi 的一个功能拉满的独立 fork，不是 Pi 的新版本）都是独立于 Docker Sandboxes 官方支持列表之外的工具，能不能接进来是另一个问题，不在这篇的范围内。

## 装得快，连得慢

官方名单里的 Mac 只有 Apple Silicon，系统至少 Sonoma 14。Homebrew cask 也写死 `arm64`，Intel Mac 现在装不上。这是产品支持范围，不是 Intel 机器不能做虚拟化。Docker Desktop 不是前置条件——`sbx` 自己拉微虚拟机，也不依赖我已经在用的 OrbStack。

```bash
brew trust docker/tap
brew install docker/tap/sbx
sbx login
```

`sbx login` 走浏览器里的 Docker 账号。装完 CLI 不会自动拉起后台进程。我这边要先常驻 daemon，再初始化网络策略，否则后面执行 `sbx run` 之类的命令会因为策略未初始化而报错：

```bash
sbx daemon start
sbx policy init balanced
```

`daemon start` 前台阻塞，适合丢给 launchd 一类的进程管理，不要挂在你正用的那个终端里不管。

daemon 起来之后，再看网络策略。[官方把出站预设分成三档](https://docs.docker.com/ai/sandboxes/governance/access-controls/local/#default-preset)：Open 全开，Locked Down 全拦，**Balanced** 是居中那档——默认拒绝，只放行模型 API、包管理器、代码托管和 Registry 这类常见开发站点。文档里也可以在第一次 `sbx run` 时交互选；两条路选一条即可。

然后进项目目录：

```bash
cd ~/your-project
sbx run opencode
```

第一次会拉 OpenCode 的模板镜像，要等一会儿。起来的是 TUI，不是 Claude Code 那种自动跳过确认的会话。

模型不会跟过来。宿主机上已经登录的 OpenCode，sandbox 里看不到。

我用的是 xAI 的 SuperGrok 订阅，不是 console.x.ai 的 API Key。`sbx secret set xai` 只支持写入 API Key，不支持这种订阅制 OAuth 凭证，所以要在 TUI 里 `/connect`，选 xAI 的 Headless OAuth。`balanced` 默认不放行 xAI 的登录域名，device code 出不来，要先加规则：

```bash
sbx policy allow network "*.x.ai:443,api.x.ai:443,auth.x.ai:443,accounts.x.ai:443"
```

如果你走 Anthropic、OpenAI 这类 API Key，用 `sbx secret set <provider>` 即可，一般不必改策略。

连上之后就可以丢一个真任务进去，比如跑测试、补缺的函数。文件改动会出现在你的工作区里，用平时的 `git diff` 看就行。

停掉但留下环境用 `sbx stop`，下次 `sbx run --name <sandbox>` 再连。不要了再 `sbx rm`。需要进编辑器时，先 `sbx setup ssh`，然后 `ssh <name>.sbx`；VS Code 的 Remote-SSH 也能连这个主机名。

## 省的是确认，不是配置

工作区还在 Mac 上，OrbStack/Docker Desktop 还是你的 Docker，Agent 用它自己那一套。装依赖、跑测试、起容器，都可以在里面做，不必把宿主机的 Docker socket 交出去。

这条最短路径里，真正费事的不是拉镜像，是模型怎么进去。sandbox 不继承本机 OpenCode 登录；我用 SuperGrok，还要自己 `/connect`，并给 `balanced` 补上 xAI 的域名。YOLO 省掉的是一条条点确认，不是这些配置。

眼下这条路适合人在旁边、和 Agent 改同一棵树。装完不能当无人值守，Kimaki 和 omp 也开箱接不上。工作区挂进去之后，`.env` 对 Agent 是可见的：隔离挡的是工作区外面，不是工作区里面。工作区是不是必须直接读写、能不能换成给 Agent 一份隔离副本，这道边界具体打在哪，后面再写。




在 Mac 上装好 Docker Sandboxes，把 Coding Agent 跑进一台可以随手删掉的微虚拟机。它自己的内核、文件系统、网络、Docker Engine，宿主机都碰不到——但你主动挂进去的项目目录是例外，Agent 在里面读写和你本人权限一样，不受额外限制。

Docker Sandboxes 上手：从安装到第一次跑 Agent

云计算

开发工具

后端

在Mac上通过DockerSandboxes运行CodingAgent，使用可删除的微虚拟机隔离内核、文件系统和DockerEngine，宿主机不受影响。安装到跑通OpenCode最快不到10分钟，但模型登录需单独配置，SuperGrok订阅要手动/connect并放行网络策略。支持人机协作编辑同一项目目录，适合交互式开发场景。

2026上云采购 | AI焕新·智启新局

热销域名限时优惠，新客首年免费！


domain

coding

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

在Mac上通过DockerSandboxes运行CodingAgent，使用可删除的微虚拟机隔离内核、文件系统和DockerEngine，宿主机不受影响。安装到跑通OpenCode最快不到10分钟，但模型登录需单独配置，SuperGrok订阅要手动/connect并放行网络策略。支持人机协作编辑同一项目目录，适合交互式...

Docker Sandboxes 上手：从安装到第一次跑 Agent-腾讯云开发者社区-腾讯云

Docker Sandboxes 上手：从安装到第一次跑 Agent

Docker Sandboxes 上手：从安装到第一次跑 Agent

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐