wehub-resource-sync
1 line
6.0 KiB
JSON
1 line
6.0 KiB
JSON
{"content": "# Cloudflare Sandbox Quick Start Guide\n\nGet your Cloudflare Claude Code Sandbox running in under 5 minutes.\n\n## Prerequisites Checklist\n\n- [ ] Cloudflare account (sign up at https://dash.cloudflare.com/sign-up)\n- [ ] Anthropic API key (get from https://console.anthropic.com/)\n- [ ] Node.js 16.17.0+ installed\n- [ ] Docker installed and running (for local development)\n\n## Option 1: Deploy to Production (Fastest)\n\nPerfect if you want to skip local testing and deploy directly.\n\n### Step 1: Install Dependencies\n```bash\ncd .claude/sandbox/cloudflare\nnpm install\n```\n\n### Step 2: Set API Key\n```bash\nnpx wrangler secret put ANTHROPIC_API_KEY\n# Paste your Anthropic API key when prompted\n```\n\n### Step 3: Deploy\n```bash\nnpx wrangler deploy\n```\n\n### Step 4: Wait for Container Provisioning\n```bash\n# Wait 2-3 minutes, then check:\nnpx wrangler containers list\n# You should see: ✓ Container ready\n```\n\n### Step 5: Test Your Deployment\n```bash\n# Get your worker URL from the deploy output, then:\ncurl -X POST https://YOUR-WORKER.YOUR-SUBDOMAIN.workers.dev/execute \\\n -H \"Content-Type: application/json\" \\\n -d '{\"question\": \"What is the 10th Fibonacci number?\"}'\n```\n\nExpected response:\n```json\n{\n \"success\": true,\n \"question\": \"What is the 10th Fibonacci number?\",\n \"code\": \"def fibonacci(n):\\n ...\",\n \"output\": \"55\\n\",\n \"error\": \"\",\n \"executionTime\": 1234\n}\n```\n\n**Done!** Your sandbox is live at the edge.\n\n---\n\n## Option 2: Local Development First\n\nPerfect if you want to test locally before deploying.\n\n### Step 1: Install Dependencies\n```bash\ncd .claude/sandbox/cloudflare\nnpm install\n```\n\n### Step 2: Create Local Environment File\n```bash\ncp .dev.vars.example .dev.vars\n# Edit .dev.vars and add your Anthropic API key\n```\n\n### Step 3: Start Docker\n```bash\n# macOS: Open Docker Desktop\n# Linux: sudo systemctl start docker\n# Windows: Start Docker Desktop\n\n# Verify Docker is running:\ndocker ps\n```\n\n### Step 4: Start Development Server\n```bash\nnpm run dev\n```\n\nWait for:\n```\n⛅️ wrangler 3.78.12\n-------------------\n⎔ Starting local server...\n[wrangler:inf] Ready on http://localhost:8787\n```\n\n### Step 5: Test Locally\n```bash\n# In a new terminal:\ncurl -X POST http://localhost:8787/execute \\\n -H \"Content-Type: application/json\" \\\n -d '{\"question\": \"Calculate factorial of 5\"}'\n```\n\n### Step 6: Deploy When Ready\n```bash\n# Stop the dev server (Ctrl+C)\nnpx wrangler secret put ANTHROPIC_API_KEY\nnpx wrangler deploy\n```\n\n**Done!** You've tested locally and deployed.\n\n---\n\n## Option 3: Using the CLI Tools\n\nPerfect if you prefer command-line interaction.\n\n### Step 1: Setup (same as above)\n```bash\ncd .claude/sandbox/cloudflare\nnpm install\nnpx wrangler secret put ANTHROPIC_API_KEY\nnpx wrangler deploy\n```\n\n### Step 2: Use the Launcher\n```bash\n# Execute a prompt\nnode launcher.ts \"What is 2 to the power of 10?\" \\\n \"\" \\\n your_anthropic_key \\\n https://your-worker.workers.dev\n```\n\n### Step 3: Use the Monitor (for debugging)\n```bash\n# Get detailed execution metrics\nnode monitor.ts \"Calculate factorial of 5\" \\\n your_anthropic_key \\\n https://your-worker.workers.dev\n```\n\n**Done!** You're using the CLI tools.\n\n---\n\n## Common Issues & Quick Fixes\n\n### \"Container not ready\"\n**Solution**: Wait 2-3 minutes after first deployment\n```bash\nnpx wrangler containers list\n```\n\n### \"Docker daemon is not running\"\n**Solution**: Start Docker Desktop or Docker service\n```bash\ndocker ps # Should list containers\n```\n\n### \"ANTHROPIC_API_KEY not configured\"\n**Solution**: Set the secret\n```bash\n# Production:\nnpx wrangler secret put ANTHROPIC_API_KEY\n\n# Local (.dev.vars):\necho \"ANTHROPIC_API_KEY=sk-ant-your-key\" > .dev.vars\n```\n\n### \"Worker not found\"\n**Solution**: Deploy the worker\n```bash\nnpx wrangler deploy\n```\n\n### \"Execution timeout\"\n**Solution**: Increase timeout in request\n```json\n{\n \"question\": \"Your question\",\n \"timeout\": 60000\n}\n```\n\n---\n\n## Next Steps\n\n### 1. Customize Your Worker\nEdit `src/index.ts` to add custom logic:\n- Add authentication\n- Implement rate limiting\n- Add custom error handling\n- Create specialized endpoints\n\n### 2. Add Monitoring\n```bash\n# Watch logs in real-time\nnpx wrangler tail\n\n# Use the monitor tool\nnode monitor.ts \"your prompt\" your_api_key\n```\n\n### 3. Test Different Languages\n```bash\n# Python (default)\ncurl -X POST https://your-worker.workers.dev/execute \\\n -d '{\"question\": \"Fibonacci\", \"language\": \"python\"}'\n\n# JavaScript\ncurl -X POST https://your-worker.workers.dev/execute \\\n -d '{\"question\": \"Fibonacci\", \"language\": \"javascript\"}'\n```\n\n### 4. Integrate with Your App\n```javascript\n// Frontend integration\nconst response = await fetch('https://your-worker.workers.dev/execute', {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({ question: 'Calculate factorial of 5' })\n});\n\nconst result = await response.json();\nconsole.log(result.output);\n```\n\n### 5. Enable Advanced Features\nSee the main [README.md](./README.md) for:\n- Streaming output\n- Code Interpreter API\n- Caching strategies\n- Performance optimization\n\n---\n\n## Resources\n\n- **Documentation**: [README.md](./README.md)\n- **Debugging**: [SANDBOX_DEBUGGING.md](./SANDBOX_DEBUGGING.md)\n- **Component Info**: [claude-code-sandbox.md](./claude-code-sandbox.md)\n- **Cloudflare Docs**: https://developers.cloudflare.com/sandbox/\n- **Anthropic Docs**: https://docs.anthropic.com/\n\n---\n\n## Getting Help\n\n1. **Check logs**: `npx wrangler tail`\n2. **Use monitor**: `node monitor.ts \"test\" your_key`\n3. **Read debugging guide**: [SANDBOX_DEBUGGING.md](./SANDBOX_DEBUGGING.md)\n4. **Check container status**: `npx wrangler containers list`\n5. **Test health**: `curl https://your-worker.workers.dev/health`\n\n---\n\n**You're all set! Start executing code with Claude AI on Cloudflare's edge network.**\n"} |