Simon Willison 介绍外部沙箱模式:Agent 留在 Mac 上,命令进隔离环境
Simon Willison 介绍了让 Claude Code、Codex、Pi 在本机跑,但代码进 WebAssembly/QEMU 沙箱执行的做法,三套原型已开源。比把 Agent 整个关进沙箱更灵活,比逐条人工批准更省事,天天用 Coding Agent 的开发者值得照着搭一套。
Simon Willison 在「External sandboxes for coding agents」一文中介绍一种沙箱模式:Claude Code、Codex、Pi 等 Coding Agent 继续在本机运行,但要执行的代码送入由 WebAssembly、QEMU 或 Apple Container 搭建的隔离 Linux 环境。团队比较了两种方案,一种把 Agent 放进沙箱(如 Fly 的 Sprites),另一种只把命令送进沙箱,他们选择后者,避免 Agent 改动自身环境,也让边界更容易审查。
文中开源了三套 Apache-2.0 许可的原型:基于 v86 在 WebAssembly 里模拟 Alpine Linux 的实现走 8686 端口,需 Node.js 22.19+;封装 Apple Containers 的走 8687;搭配 QEMU 的 Microsoft Quicksand 走 8688。接入深度各不相同:Codex 会把进程和文件系统操作(含应用补丁)送入沙箱,团队用模拟模型测试通过了 Codex CLI 0.164.0;Pi 1.5 及以上可通过扩展替换命令行、读写和搜索工具,扩展加载失败时内置工具会被关闭;Claude Code 只有 Bash 进入沙箱,原生读取和编辑仍在本机执行。
与 Claude Code 自动模式、Codex 自动审查这类依赖模型判断的机制相比,外部沙箱是一套不依赖模型判断的保护,对更便宜、更易受提示注入攻击的小模型尤其重要。默认无外网,加代理后可按主机和 HTTP 方法放行,并做凭证替换:沙箱内只有占位符,真实密钥留在主机代理中对 Agent 不可见。
Simon Willison 介绍外部沙箱:Agent 留在 Mac 上,命令进入隔离环境 Simon Willison 在「External sandboxes for coding agents」中分享:让 Claude Code、Codex 或 Pi 继续在本机上运行,但它们要执行的代码进入由 WebAssembly、QEMU 或 Apple Container 搭建的隔离 Linux 环境。 blog.primeradiant.com/external-sandb… # 沙箱在 Agent 之外,不必把 Agent 一起关进去 他们比较过两种办法:一种是把 Agent 放进沙箱里跑,例如 Fly 的 Sprites;另一种是让 Agent 留在外面,只把命令送到独立沙箱。他们选择后者,以免 Agent 改动自身或所在环境,也让边界更容易审查。这里所说的「外部」,是相对于 Agent,不是相对于电脑,二者可以同在一台 Mac 上。 这样做的动机也很直接:Coding Agent 会出错,凡是它能读能改的内容都可能被破坏或泄露。逐条人工批准既慢,也容易让人习惯性同意。Claude Code 的自动模式和 Codex 的自动审查,会再用模型判断是否继续,这仍然取决于模型判断是否正确。沙箱则是一套不依赖模型判断的保护,对更便宜、可本地运行、也更容易出错和遭受提示注入的小模型尤其重要。 # 三种实现共用协议,但各家接入深度不同 团队开源了三套 Apache-2.0 许可的原型:用 Node.js 在 WebAssembly 里模拟 Alpine Linux 的 v86,默认端口 8686,需要 Node.js 22.19 或更新版本;封装 Apple Containers 的实现走 8687;搭配 QEMU 的 Microsoft Quicksand 走 8688。后两者需要 Apple 芯片的 Mac。 接入程度并不相同。Codex 会把进程和文件系统操作,包括应用补丁,送到沙箱;团队自报自动化测试通过了 Codex CLI 0.164.0,但用的是模拟模型,且该执行协议仍属实验性质。Pi 1.5 及以上可通过扩展替换命令行、读写和搜索等工具;若扩展未能加载,内置工具会被关闭,而不是退回本机执行。Claude Code 则只有 Bash 进入沙箱,原生的读取和编辑仍在本机直接进行,这是文中明确写出的限制。 默认没有外网。加上代理后,可按主机和 HTTP 方法放行,并做凭证替换:沙箱里只有占位符,真正的密钥留在主机代理中,对 Agent 不可见。作者提醒,若放行的服务在响应里回显密钥,仍可能泄露,因此只应用于受信任、范围收窄的接口。网页界面可改规则,并查看放行或拒绝记录。 Simon Willison @simonw I've been exploring new ways to sandbox code written by coding agents - here's a description of the external sandbox pattern, where agents run on your Mac but execute code in a WebAssembly or QEMU or Apple Container sandbox - with demos for Claude Code, Codex and Pi blog.primeradiant.com/external-sandb… 🔗 View Quoted Tweet📊 3 ⚡
This report is categorized under AITOP's "How-to" desk, focusing on US frontier AI labs and Silicon Valley technology leaders. Within our cross-regional analytical framework, it directly maps to AI developer toolchains, coding agents, and engineering workflows. Key entities and technical topics under continuous tracking include Claude Code, Codex, sandbox, Coding Agent.
Source attribution: curated from shao__meng (@shao__meng).