跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

在 sandbox 中运行编程 Agent

最后更新 查看 MarkdownAgent 设置

Claude Code、Codex、OpenCode 等编程 Agent 可以独立完成任务:它们读取仓库、编辑文件,并运行命令直到任务完成。请在 Linux sandbox 中运行 Agent,使其命令留在属于单个任务的 Container 内。

Agent 在你的 sandbox 中运行

你的 Worker 启动 sandbox、保管凭据,并决定 sandbox 可以访问哪些 hostname。Agent 通过 HTTP 调用其模型,例如通过 AI Gateway。你的 Worker 会为每个请求添加 API token,因此 sandbox 永远不会收到它。

本节中的每篇指南只修改同一个 runner 中与 Agent 相关的部分。请先构建 runner:

构建编程 Agent runner

构建一个 Worker,在 sandbox 中对 GitHub 仓库运行 Claude Code,并将其更改作为 diff 返回。

然后将 runner 切换到另一个 Agent:

Claude Code

使用 Claude Code 编辑 GitHub 仓库,它通过 AI Gateway 调用 Anthropic 模型。

Codex

使用 Codex CLI 编辑 GitHub 仓库,它通过 AI Gateway 调用 OpenAI 模型。

OpenCode

使用 OpenCode 编辑 GitHub 仓库,它通过 AI Gateway 调用模型。

Pi

使用 Pi 编辑 GitHub 仓库,它通过内置的 AI Gateway provider 调用模型。

由供应商运行 Agent 循环

Devin、Cursor、Claude Managed Agents 以及 OpenAI Agents API 在它们自己的服务中运行 Agent 循环。该循环会向你 Cloudflare 账户中的 sandbox 发送命令和文件编辑。每个供应商模板都会为每个 session 提供独立 sandbox。在 Devin、Cursor 和 OpenAI Agents API 模板中,供应商的 worker 进程运行在 sandbox 内,因此 sandbox 也会持有供应商凭据。

Devin

部署 Devin Outpost,让每个 Devin session 在 Containers 上的独立 sandbox 中运行。

Cursor Cloud Agents

部署自托管机器,让每个 Cursor session 在 Containers 上的独立 sandbox 中运行。

Claude Managed Agents

在 Containers 和 Dynamic Workers 上的 sandbox 中运行 Claude Managed Agents session。

OpenAI Agents API

部署自托管环境,让每个 Codex session 在 Containers 上的独立 sandbox 中运行。

构建你自己的 Agent

要为运行在 Durable Object 中的 Agent 提供用于运行命令的 container,请参阅 Agents SDK 文档中的 Sandbox。

这篇文档对您有帮助吗?