AgentBox SDK：一个API在任何沙箱里运行Claude Code/Codex/OpenCode

用AI编码Agent的时候，你可能遇到过这样的问题：Claude Code跑在Docker里，Codex跑在另一个沙箱里，OpenCode又要不同的配置。AgentBox SDK解决的就是这个问题——一个统一的API，在任何沙箱里运行任何编码Agent。

AgentBox是什么

AgentBox是一个TypeScript SDK，让你用一套代码就能在不同的沙箱环境里运行不同的AI编码Agent。

它支持的Agent：

• Claude Code
• Codex（OpenAI）
• OpenCode

它支持的沙箱：

• 本地Docker
• E2B
• Modal
• Daytona
• Vercel

为什么需要统一API

如果你只是自己用Claude Code写代码，可能不需要这个。但如果你在构建一个平台，需要让用户选择不同的Agent和不同的沙箱环境，AgentBox就很方便了。

比如你做一个”AI编码平台”，用户可以选择用Claude Code还是Codex，可以跑在本地Docker还是云端E2B。AgentBox让你不用为每个组合写单独的集成代码。

核心设计理念

AgentBox和其他wrapper不同的一点是：它不是简单地用CLI的非交互模式（比如claude --print），而是把Agent作为一个服务器进程运行在沙箱里，通过WebSocket或HTTP通信。

这样做的好处是保留了Agent的完整交互能力——审批流程、工具使用控制、流式事件等。

代码示例

import { Agent, Sandbox } from "agentbox-sdk";

const sandbox = new Sandbox("local-docker", {
  workingDir: "/workspace",
  image: process.env.IMAGE_ID!,
  env: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY! },
});

await sandbox.findOrProvision();

const run = new Agent("claude-code", {
  sandbox,
  cwd: "/workspace",
  approvalMode: "auto",
}).stream({
  model: "sonnet",
  input: "Create a hello world Express server",
});

for await (const event of run) {
  if (event.type === "text.delta") process.stdout.write(event.delta);
}

await sandbox.delete();

安装

npm install agentbox-sdk

需要Node.js 20+。Agent的CLI（claude、opencode、codex）需要安装在沙箱镜像里。

适用场景

• 构建AI编码平台的开发者
• 需要多Agent切换的团队
• 想统一沙箱管理的DevOps
• 在CI/CD中集成AI编码的工程团队

GitHub：TwillAI/agentbox-sdk