跳到主要内容

编程智能体

Sandcastle

Sandcastle 在您的代码仓库上运行 Claude Code、Codex 等编程智能体,每个智能体都在独立的 E2B 沙箱中。智能体的提交会回到您本机的一个分支上。

维护方
Sandcastle
集成方式
内置 E2B 沙箱提供方
软件包
@ai-hero/sandcastle
语言
TypeScript

配置

快速开始

将提示词粘贴到您的编程智能体中,或按以下步骤自行配置。

粘贴到您的编程智能体中

为这个 Sandcastle 项目添加 E2B 沙箱。

  1. 1.使用项目的包管理器安装 @ai-hero/sandcastle 和 e2b。
  2. 2.Sandcastle 需要我的 Shell 中有 E2B_API_KEY 环境变量。如果尚未设置,请向我索要 API 密钥(在 https://console.e2b.dev/?tab=keys 获取)。切勿将其硬编码,也不要放进 .sandcastle/.env。
  3. 3.按照 https://docs.e2b.dev/agents/sandcastle 上的 Sandcastle 指南操作,用 sandbox: e2b({ template: "claude" }) 运行 claudeCode,并在智能体的 env 中传入 ANTHROPIC_API_KEY。
  4. 4.在代码仓库根目录运行一次,并展示从沙箱取回的提交。

或自行配置

  1. 1. 安装 Sandcastle 和 E2B

    npm install @ai-hero/sandcastle e2b
  2. 2. 设置 API 密钥

    export E2B_API_KEY="e2b_..."
    export ANTHROPIC_API_KEY="..."
  3. 3. 在沙箱中运行 Claude Code

    import { run, claudeCode } from "@ai-hero/sandcastle";
    import { e2b } from "@ai-hero/sandcastle/sandboxes/e2b";
    
    const result = await run({
      agent: claudeCode("claude-opus-4-8", {
        env: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY! },
      }),
      sandbox: e2b({ template: "claude" }),
      prompt: "Fix the failing test in src/slugify.js and commit the fix.",
    });
    
    console.log(result.commits);

安全

沙箱中运行的内容

每个智能体都在自己的沙箱中处理代码仓库的副本,只有它的提交会被取回。

  • 代码来自模板的智能体 CLI(claude 或 codex),在 $HOME/workspace 中处理您代码仓库的副本。
  • 提交提交落在您当前的分支上,或通过 branchStrategy 落在单独的分支上。
  • 生命周期run() 创建沙箱,并在运行结束时终止它。到达 timeoutMs(默认 30 分钟)时,沙箱会被终止,而不是暂停。
  • 密钥只有 .sandcastle/.env 中的密钥和提供方的 env 会进入沙箱。不要把 E2B_API_KEY 放进 .sandcastle/.env。

已启动 30亿+ 个沙箱

为每个智能体 配一台机器