AgentBox 是一个开源命令行工具,目标是用一条命令在沙箱虚拟机中并行运行多个编码 AI 代理,代理包括 Claude Code、Codex、OpenCode。它可运行在本地 PC(Docker)、自托管服务器或云平台(Hetzner、Daytona、Vercel、E2B、DigitalOcean)上。每个盒子是一个独立的 VM/容器,配备专用浏览器、屏幕共享(noVNC)、持久 Shell,以及预热的 VS Code / Cursor IDE。
主要能力:
- Teleport:将项目通过一条命令迁移到专用 VM,本地或云端均可。
- 自动化:自动带入代理的 skills、插件和设置。
- 完整计算机环境:每个盒子都有浏览器、屏幕共享、持久 Shell、预热的 VS Code / Cursor IDE。
- 检查点:亚秒级从先前检查点启动新盒子;未使用时自动暂停以节省成本和资源。
- 安全:git 凭据保留在本地机器,推送到远程仓库需要权限请求。
- 终端集成:可与 iterm2、cmux、tmux、Herdr 配合使用。
- 云提供商支持:可选配置 Hetzner、Daytona、Vercel、E2B、DigitalOcean,也可通过 SSH 在自有机器上运行远程 Docker。
- 自定义提供商插件:通过 @madarco/agentbox-provider-sdk 发布自己的提供商。
使用方式: 安装要求为 macOS(arm64 或 Intel)或 Linux、Docker(Docker Desktop 或 OrbStack)、Node >=20.10。首次 agentbox create / agentbox claude 会构建约 1 GB 的 agentbox/box:dev 镜像(一次性)。云设置可选,用 agentbox install 交互式向导配置提供商。常用命令包括:agentbox create 创建盒子,agentbox claude 创建沙箱并启动 Claude Code,agentbox url 打开 Web 应用 URL,agentbox screen 打开 VNC 查看器,agentbox code 通过 Dev Containers 在 VS Code 或 Cursor 中打开,agentbox shell 打开交互式 bash,agentbox checkpoint 管理检查点,agentbox pause/unpause 冻结/恢复盒子,agentbox download 将盒子工作区下载回本地,agentbox self-update 更新自身等。更多细节见官方文档 agent-box.sh/docs。
适用场景:需要并行运行多个编码 AI 代理的开发者;希望将项目隔离在沙箱 VM 中,同时保留本地 git 凭据;需要在本地 Docker、自托管服务器或云平台上灵活选择运行环境。
限制:首次使用需构建约 1 GB 镜像;云提供商需自行获取并配置 API token;夜版通道需通过 npm -g install @madarco/agentbox@nightly 加入;安全漏洞需通过 SECURITY.md 报告;首次贡献者需签署一行 CLA。其他费用、价格、具体性能效果资料未提供。