sandbox-agent/examples/cloudflare

Cloudflare Sandbox Agent Example

Deploy sandbox-agent inside a Cloudflare Sandbox.

Prerequisites

• Cloudflare account with Workers Paid plan
• Docker running locally for wrangler dev
• ANTHROPIC_API_KEY or OPENAI_API_KEY for the coding agents

Setup

1. Install dependencies:

pnpm install

2. Create .dev.vars with your API keys:

echo "ANTHROPIC_API_KEY=your-api-key" > .dev.vars

Development

Start the development server:

pnpm run dev

Test the endpoint:

curl http://localhost:8787

Test prompt routing through the SDK with a custom sandbox fetch handler:

curl -X POST "http://localhost:8787/sandbox/demo/prompt" \
  -H "Content-Type: application/json" \
  -d '{"agent":"codex","prompt":"Reply with one short sentence."}'

The response includes events, an array of all recorded session events for that prompt.

Deploy

pnpm run deploy

Note: Production preview URLs require a custom domain with wildcard DNS routing. See Cloudflare Production Deployment for details.