Sandbox Agent

正常
GitHub TypeScript Apache-2.0

简介

在沙箱中运行编程 Agent 的工具,通过 HTTP 控制,支持 Claude Code、Codex、OpenCode 和 Amp,为 AI 编程 Agent 提供隔离的执行环境。

核心特性

  • 通用 Agent API — 单一接口控制 Claude Code、Codex、OpenCode、Cursor、Amp 和 Pi
  • 通用会话模式,标准化所有 Agent 事件格式以便存储和回放
  • 轻量级静态 Rust 二进制文件 — 在 E2B、Daytona、Modal、Cloudflare Containers 或 Docker 中运行
  • 服务器或 SDK 模式 — HTTP 服务器或可嵌入的 TypeScript SDK,完整类型安全
  • OpenAPI 规范,便于任何编程语言集成
  • 内置 Inspector UI,在 /ui/ 端点调试会话和事件

适用场景

💡 在隔离沙箱中运行编码 Agent,实现生产基础设施上的安全代码执行
💡 构建通过统一 HTTP 接口编排多个编码 Agent 的平台
💡 将会话记录持久化到 Postgres 或 ClickHouse 以便审计和回放
💡 仅通过配置更改即可在编码 Agent(Claude Code、Codex 等)之间切换

快速开始

1. 安装:`npm install sandbox-agent@0.4.x`(SDK)或使用安装脚本(服务器)。
2. 本地嵌入:`const client = await SandboxAgent.start()`。
3. 远程服务器:`sandbox-agent server --token $SANDBOX_TOKEN --host 127.0.0.1 --port 2468`。
4. 创建会话:`client.createSession('demo', { agent: 'codex' })`。
5. 发送消息并流式传输:`for await (const event of client.streamEvents('demo')) ...`。

相关项目