Brood Box
在硬件隔离的微型虚拟机中运行编程 Agent,并在改动进入工作区前逐项审阅。
- Star 数
- ★ 81
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Go
- FA 评分
- 53/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望让 Claude Code 在真实虚拟机中处理项目副本,并在改动写回前检查差异的开发者。
- 不适合
- 需要稳定、不会频繁变化的生产工具的团队
- 需要在 Linux 且无法访问 KVM 的机器上运行的用户
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v0.0.25(2026-09-14)
- 源码审查
- 53/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Brood Box 是一个 Go 命令行工具,通过 libkrun 在 Linux 的 KVM 或 Apple Silicon macOS 的 Hypervisor.framework 上启动微型虚拟机。它把当前工作区的写时复制快照挂载到虚拟机中,并可运行 Claude Code、Codex、OpenCode、Hermes、Gemini CLI 或配置的自定义 Agent。Agent 通过交互式终端在来宾系统中运行,退出后 Brood Box 计算文件差异,并可提供逐文件审阅,再将接受的更改写回工作区。工具还提供 DNS 感知的出站防火墙、凭据转发和 ToolHive MCP 服务器代理。项目标记为实验性,命令行参数、配置和行为可能变化。
运行 bbox claude-code、bbox codex 等命令时,工具为工作区创建写时复制快照,拉取 OCI 镜像、提取根文件系统并注入初始化程序和 SSH 密钥,然后启动微型虚拟机。来宾系统由 bbox-init 作为 PID 1 启动,配置网络和工作区挂载,并提供嵌入式 SSH 服务;用户通过交互式 SSH 终端运行 Agent。结束后虚拟机停止,Brood Box 使用 SHA-256 差异检测展示改动,可逐文件审阅并把接受的改动写回工作区。用户可配置 egress profile、允许的主机、环境变量转发、MCP 代理和 Git 凭据转发。
- 希望让 Claude Code 在真实虚拟机中处理项目副本,并在改动写回前检查差异的开发者。
- 使用 Codex、OpenCode、Hermes 或 Gemini CLI,并希望通过同一
bbox命令行流程运行的工程团队。 - 需要按 permissive、standard 或 locked 配置 Agent 出站访问范围的安全工程师。
- 需要在虚拟机中访问 Git 仓库,并选择转发令牌或 SSH agent 的开发者。
- 使用 ToolHive MCP 服务器,并希望 Brood Box 自动发现和代理这些服务器的团队。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 环境变量
ANTHROPIC_API_KEY- 运行环境
- Go 1.26+
- 安装说明涉及
- macOS · Linux
如何安装或部署这个 Agent?
运行环境要求 Linux(可访问 /dev/kvm)或 Apple Silicon macOS(Hypervisor.framework)、Go 1.26+、Task 和 curl。可从 GitHub Releases 下载预构建二进制;README 也说明可从源码构建。运行 Agent 还需要对应服务的 API 密钥,例如 Claude Code 所需的 ANTHROPIC_API_KEY。示例:
# Linux amd64 示例:下载并解压相应的 GitHub Release 归档后
sudo mv bbox /usr/local/bin/源码构建命令:
task build如何使用这个 Agent?
设置所选 Agent 的 API 密钥,然后在项目目录运行对应命令。默认情况下,Brood Box 对工作区创建快照;退出后可查看每个文件的差异并接受或拒绝更改。
export ANTHROPIC_API_KEY="sk-ant-..."
bbox claude-code可用 --review 启用交互式逐文件审阅,或通过 --egress-profile locked 限制出站访问。快照模式下,已接受的更改才会写回工作区。
这个 Agent 有哪些优点和局限?
- 通过 libkrun 使用 KVM 或 Hypervisor.framework 启动硬件隔离虚拟机,而非共享宿主机内核的容器。
- 默认在写时复制工作区快照中运行,并提供逐文件差异审阅和接受后写回。
- 支持 Claude Code、Codex、OpenCode、Hermes、Gemini CLI 和配置的自定义 Agent。
- 提供三种 DNS 感知出站策略,并支持额外主机白名单及 ToolHive MCP 代理。
- 项目标为实验性,CLI 参数、配置格式和行为可能在版本间变化。
- 依赖 Linux KVM 或 Apple Silicon macOS Hypervisor.framework,不能据此推断支持其他运行环境。
- 运行 Agent 需要相应 API 密钥;构建或安装还需准备 README 列出的运行环境和工具。
- 选择 direct 工作区模式会让虚拟机直接读写工作区,并跳过快照审阅与 Git 凭据清理。
这个 Agent 与同类方案有什么区别?
README 将 Brood Box 与共享宿主机内核的容器作了对比:Brood Box 使用硬件隔离微型虚拟机。它还说明 direct 模式会让 Agent 直接写入工作区,而默认快照模式提供差异审阅。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Brood Box 当前 | 53 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 81 | 今天 | Go | Codex · Claude Code |
| Alas 智能编程工作区 | 79 · 表现良好 | 桌面应用免费 + 模型费 | ★ 25 | 今天 | Swift | Codex · Claude Code |
| Agent Teams AI | 63 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 2.5k | 今天 | TypeScript | Codex · Claude Code |
| Argot 仓库风格审查器 | 78 · 表现良好 | 命令行工具免费 | ★ 48 | 2 个月前 | Rust | Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 与源码显示多层隔离:KVM microVM、COW 快照、默认快照模式、--review 逐文件审阅、direct 模式需 --yes 首次确认、敏感文件模式不可被 .broodboxignore 否定、flush 时哈希复验与 setuid 剥离、SSH 仅绑定 127.0.0.1、每会话临时密钥。这些是实打实的最小权限与确认设计,故 least_privilege/user_confirmation/rollback 给 2。但依赖面极广(go.mod 引入 toolhive、docker、aws-sdk、ory 等大量间接依赖),未见依赖审计或 SBOM,dependency_security 仅 1。数据流方面 README 描述了密钥转发与 MCP 代理,但未逐项说明转发数据去向,data_flow_transparency 与 sensitive_data_handling 给 2 而非 3。
CLAUDE.md 与 README 在支持代理列表上不一致(CLAUDE.md 只列 claude-code/codex/opencode,README 与 cmd 帮助列 hermes/gemini),且 README 称 Go 1.26+ 而 go.mod 要求 1.27.0,属自洽性缺陷,self_consistency 给 1。运行时依赖 libkrunfw 固件需运行时下载并缓存,构建依赖预编译 go-microvm 运行时工件,依赖可用性存在外部单点,dependency_availability 给 1。源码中错误处理有 slog 记录与 halt 路径,失败信息较具体,failure_messages 给 2。
README 明确面向在本地运行编码代理的开发者,场景与受众清晰(audience_and_scenarios 2);能力边界有专门章节说明快照/直写、egress 三档、MCP 开关(capability_boundaries 2)。但触发精度不足:CLI 参数众多、配置三层合并规则复杂,且 per-workspace 配置部分字段被静默忽略,用户难以精确预测行为(trigger_precision 1)。环境适配仅限 Linux KVM 与 Apple Silicon macOS,无 Windows/Intel Mac 说明,environment_fit 给 1。
README 有目录、安装、配置、安全模型、文档索引,信息架构良好(2);安装说明含发行版二进制与源码构建两条路径(2);示例丰富(2);明确标注 EXPERIMENTAL 与 API 可能变更(known_limitations 2);LICENSE 为完整 Apache-2.0 且源码带 SPDX 头(license 3)。但命名稳定性差:项目自称 EXPERIMENTAL 且行为可能无预警变更(naming_stability 1);无 CHANGELOG 或版本策略说明(versioning_changelog 1);维护责任仅 README 末尾版权声明,发布者身份未经验证,维护承诺不明确(maintenance_responsibility 1)。
输出可用性方面,快照 diff 审阅、逐文件接受/拒绝、统一 diff 展示,产物直接可用(output_usability 2)。相对裸跑代理的边际价值明确:硬件隔离与变更审阅(marginal_value 2)。但成本较高:需 KVM/虚拟化、下载固件与运行时工件、构建需 Task 与网络,对普通用户门槛偏高(cost_benefit 1)。
README 的安全声明(哈希复验、路径穿越防护、权限剥离)在提供的源码片段中仅部分可见(如 bbox-init 的 seccomp、flock),多数声明无法在样本内追溯,claim_traceability 给 1。CI 工作流与 README 徽章可交叉印证测试/构建存在,但样本未含测试文件本身,cross_source_corroboration 给 1。文档中事实与推断(如“硬件隔离更安全”)混排,未明确区分,fact_inference_separation 给 1。
- 项目自标 EXPERIMENTAL,CLI 标志、配置格式与行为可能无预警变更,生产使用需谨慎。
- 依赖面极广(toolhive、docker、aws-sdk、ory 等大量间接依赖),样本中未见依赖审计、SBOM 或漏洞缓解说明。
- 运行时需下载 libkrunfw 固件与预编译 go-microvm 运行时工件,存在外部依赖与供应链风险。
- 文档间存在不一致:支持代理列表与 Go 版本要求(README 1.26+ vs go.mod 1.27.0)不符。
- 发布者身份未经验证,维护承诺与更新路径不明确。
- direct 模式跳过快照与审阅,写入直接落盘且无撤销,仅首次需 --yes,误用风险高。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
What's Changed * Update dependency NousResearch/hermes-agent to v2026.8.16 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/232 * Update dependency go-task/task to v3.53.1 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/242 * Fix SSH agent forwarding lint by @JAORMX in https://github.com/stacklok/brood-box/pull/246 * Update module github.com/gofrs/flock to v0.13.1 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/243 * Update module charm.land/lipgloss/v2 to v2.0.6 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/245 …在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * Update actions/setup-go action to v7 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/226 * Update module github.com/stacklok/toolhive-core to v0.0.30 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/225 * Update module github.com/stacklok/toolhive-core to v0.0.37 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/227 * Update module github.com/google/go-containerregistry to v0.21.8 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/229 …在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * Let Renovate manage pinned Dockerfile tool versions by @JAORMX in https://github.com/stacklok/brood-box/pull/171 * Update module github.com/stacklok/toolhive-core to v0.0.23 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/170 * Update module github.com/cedar-policy/cedar-go to v1.7.0 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/169 * Update opentelemetry-go monorepo to v1.44.0 by @renovate[bot] in https://github.com/stacklok/brood-box/pull/168 …在 GitHub 查看 ↗
常见问题
支持哪些宿主机环境?
默认运行会直接修改我的文件吗?
我能限制虚拟机访问的网络主机吗?
--allow-host 添加 DNS 主机名。使用它需要支付什么费用?
这个工具适合生产环境吗?
Brood Box 开源吗?
Brood Box 安全吗?
Brood Box 还在维护吗?
Brood Box 是谁开发的?
谢谢反馈,我们会据此改进页面。