Sandcastle
Sandcastle 在您的代码仓库上运行 Claude Code、Codex 等编程智能体,每个智能体都在独立的 E2B 沙箱中。智能体的提交会回到您本机的一个分支上。
- Sandcastle
- 内置 E2B 沙箱提供方
- @ai-hero/sandcastle
- TypeScript
快速开始
将提示词粘贴到您的编程智能体中,或按以下步骤自行配置。
粘贴到您的编程智能体中
为这个 Sandcastle 项目添加 E2B 沙箱。
- 1.使用项目的包管理器安装 @ai-hero/sandcastle 和 e2b。
- 2.Sandcastle 需要我的 Shell 中有 E2B_API_KEY 环境变量。如果尚未设置,请向我索要 API 密钥(在 https://console.e2b.dev/?tab=keys 获取)。切勿将其硬编码,也不要放进 .sandcastle/.env。
- 3.按照 https://docs.e2b.dev/agents/sandcastle 上的 Sandcastle 指南操作,用 sandbox: e2b({ template: "claude" }) 运行 claudeCode,并在智能体的 env 中传入 ANTHROPIC_API_KEY。
- 4.在代码仓库根目录运行一次,并展示从沙箱取回的提交。
或自行配置
1. 安装 Sandcastle 和 E2B
2. 设置 API 密钥
3. 在沙箱中运行 Claude Code
沙箱中运行的内容
每个智能体都在自己的沙箱中处理代码仓库的副本,只有它的提交会被取回。
- 来自模板的智能体 CLI(claude 或 codex),在 $HOME/workspace 中处理您代码仓库的副本。
- 提交落在您当前的分支上,或通过 branchStrategy 落在单独的分支上。
- run() 创建沙箱,并在运行结束时终止它。到达 timeoutMs(默认 30 分钟)时,沙箱会被终止,而不是暂停。
- 只有 .sandcastle/.env 中的密钥和提供方的 env 会进入沙箱。不要把 E2B_API_KEY 放进 .sandcastle/.env。
