Sandcastle

活跃
GitHub TypeScript MIT

简介

用于编排沙箱化编码 Agent 的 TypeScript 工具，基于 sandcastle.run 提供安全执行环境。

核心特性

  • 沙箱化 Agent 编排 — 通过 sandcastle.run() 在隔离沙箱中安全执行 AI 编码 Agent
  • 多沙箱提供商 — 内置 Docker、Podman、Vercel 支持，可自定义创建沙箱
  • Provider 无关设计 — 可替换任意 Agent 提供商，当前内置 Claude Code 支持
  • Git 分支策略管理 — 自动处理 Agent 的分支创建、提交和合并
  • 并行 Agent 执行 — 支持多个 AFK Agent 并行运行，创建审阅管道
  • TypeScript 原生 — 完整 TypeScript 支持，类型安全的 API 设计

适用场景

💡 并行 AI 编码 — 在隔离沙箱中并行运行多个 Claude Code Agent 处理不同任务
💡 代码审阅管道 — 创建自动化的 Agent 代码审阅和合并流程
💡 安全代码执行 — 在容器化环境中安全执行不可信的 AI 生成代码
💡 CI/CD Agent 集成 — 在持续集成流水线中使用沙箱化 Agent
💡 多仓库并行开发 — 同时在多个工作区中运行 Agent 进行跨仓库修改

标签

coding-agent sandbox typescript orchestration

分类

💻 编码 Agent 🏗️ 沙箱执行

快速开始

# 安装
npm install --save-dev @ai-hero/sandcastle

# 初始化项目
npx @ai-hero/sandcastle init

# 配置 .sandcastle/.env
# 填入 ANTHROPIC_API_KEY

# 运行 Agent
npx tsx .sandcastle/main.ts

# 或通过 API
import { run, claudeCode } from "@ai-hero/sandcastle";
import { docker } from "@ai-hero/sandcastle/sandboxes/docker";

await run({
  agent: claudeCode("claude-opus-4-7"),
  sandbox: docker(),
  promptFile: ".sandcastle/prompt.md",
});
访问 GitHub

相关项目