wehub/davila7--claude-code-templates

Fork 0

Files

T

History

wehub-resource-sync bb5c75ce05

Component Security Validation / Security Audit (push) Has been cancelled

Details

Deploy to Cloudflare Pages / deploy (push) Has been cancelled

Details

chore: import upstream snapshot with attribution

2026-07-13 12:38:58 +08:00

cloudflare

chore: import upstream snapshot with attribution

2026-07-13 12:38:58 +08:00

docker

chore: import upstream snapshot with attribution

2026-07-13 12:38:58 +08:00

e2b

chore: import upstream snapshot with attribution

2026-07-13 12:38:58 +08:00

README.md

chore: import upstream snapshot with attribution

2026-07-13 12:38:58 +08:00

README.md

Claude Code Sandbox Components

Execute Claude Code in isolated cloud environments for secure code generation and development.

Available Sandbox Providers

E2B Sandbox (`e2b`)

Run Claude Code in E2B's secure cloud environment with pre-configured development tools.

Component: e2b/claude-code-sandbox.md

Files Created:

.claude/sandbox/e2b-launcher.py - Python launcher script
.claude/sandbox/requirements.txt - Python dependencies
.claude/sandbox/.env.example - Environment variables template

Cloudflare Sandbox (`cloudflare`)

Execute AI-powered code in Cloudflare Workers with global edge deployment and sub-second cold starts.

Component: cloudflare/claude-code-sandbox.md

Files Created:

.claude/sandbox/cloudflare/src/index.ts - Cloudflare Worker source
.claude/sandbox/cloudflare/launcher.ts - TypeScript launcher
.claude/sandbox/cloudflare/monitor.ts - Monitoring tool
.claude/sandbox/cloudflare/wrangler.toml - Cloudflare configuration
.claude/sandbox/cloudflare/package.json - Dependencies
.claude/sandbox/cloudflare/README.md - Complete documentation

Quick Start

E2B Sandbox

# Simple execution with API keys as parameters (recommended)
npx claude-code-templates@latest --sandbox e2b \
  --e2b-api-key your_e2b_key \
  --anthropic-api-key your_anthropic_key \
  --prompt "Create a React todo app"

# With components installation
npx claude-code-templates@latest --sandbox e2b \
  --e2b-api-key your_e2b_key \
  --anthropic-api-key your_anthropic_key \
  --agent frontend-developer \
  --command setup-react \
  --prompt "Create a modern todo app with TypeScript"

# Or use environment variables (set E2B_API_KEY and ANTHROPIC_API_KEY)
npx claude-code-templates@latest --sandbox e2b --prompt "Create a React todo app"

Cloudflare Sandbox

# Execute via deployed Cloudflare Worker
npx claude-code-templates@latest --sandbox cloudflare \
  --anthropic-api-key your_anthropic_key \
  --prompt "Calculate the 10th Fibonacci number"

# Local development and deployment
cd .claude/sandbox/cloudflare
npm install
npx wrangler secret put ANTHROPIC_API_KEY
npx wrangler deploy

# Test your deployment
curl -X POST https://your-worker.workers.dev/execute \
  -H "Content-Type: application/json" \
  -d '{"question": "Calculate factorial of 5"}'

Environment Setup

Get API Keys:
- E2B API Key: https://e2b.dev/dashboard
- Anthropic API Key: https://console.anthropic.com

Create Environment File:

# In your project/.claude/sandbox/.env
E2B_API_KEY=your_e2b_api_key_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here

Install Python Requirements (handled automatically):
- Python 3.11+
- E2B Python SDK
- python-dotenv

How It Works

Component Download: Downloads sandbox launcher and requirements
Environment Check: Validates Python 3.11+ installation
Dependencies: Installs E2B Python SDK automatically
Sandbox Creation: Creates E2B sandbox with Claude Code template
Component Installation: Installs any specified agents/commands/mcps/settings/hooks inside sandbox
Prompt Execution: Runs your prompt through Claude Code in the isolated environment
Result Display: Shows complete output and generated files
Cleanup: Automatically destroys sandbox after execution

Usage Examples

Basic Web Development

npx claude-code-templates@latest --sandbox e2b --prompt "Create an HTML page with modern CSS animations"

Full Stack with Components

npx claude-code-templates@latest --sandbox e2b \
  --agent fullstack-developer \
  --command setup-node \
  --prompt "Create a Node.js API with JWT authentication"

Data Analysis

npx claude-code-templates@latest --sandbox e2b \
  --agent data-scientist \
  --prompt "Analyze this CSV data and create visualizations"

Security Audit

npx claude-code-templates@latest --sandbox e2b \
  --agent security-auditor \
  --command security-audit \
  --prompt "Review this codebase for security vulnerabilities"

Security Benefits

✅ Complete Isolation: Code runs in separate cloud environment
✅ No Local Impact: Zero risk to your local system or files
✅ Temporary Environment: Sandbox destroyed after execution
✅ Controlled Access: Only specified components are installed
✅ API Key Security: Keys never leave your local environment

Future Sandbox Providers

✅ Production Ready Features (v1.20.3+)

Enhanced E2B Integration

Automatic File Download: Generated files are automatically downloaded to local ./e2b-output/ directory
Extended Timeouts: 15-minute sandbox lifetime with intelligent timeout management
Detailed Logging: Step-by-step execution monitoring with debugging information
Environment Verification: Automatic checks for Claude Code installation and permissions
Error Recovery: Retry logic for connection issues and comprehensive error handling

Advanced Debugging Tools

Real-time Monitor (e2b-monitor.py): System resource monitoring and performance analysis
Debug Guide (SANDBOX_DEBUGGING.md): Comprehensive troubleshooting documentation
Sandbox State Tracking: Live monitoring of file system changes and process execution

The system is designed to support multiple sandbox providers:

E2B (--sandbox e2b) - ✅ Fully Implemented - Cloud-based isolated execution environment with full Linux access
Cloudflare (--sandbox cloudflare) - ✅ Fully Implemented - Edge-based sandbox with global deployment and AI code execution
Docker (--sandbox docker) - 🔄 Future - Local containerized execution
AWS CodeBuild (--sandbox aws) - 🔄 Future - AWS-based sandbox environment
GitHub Codespaces (--sandbox github) - 🔄 Future - GitHub's cloud development environment
Custom (--sandbox custom) - 🔄 Future - User-defined sandbox configurations

Sandbox Comparison

Feature	E2B	Cloudflare	Best For
Cold Start	2-3 seconds	~100ms	Cloudflare for speed
Max Duration	Hours	30 seconds (Workers)	E2B for long tasks
Environment	Full Linux VM	V8 isolates + containers	E2B for flexibility
Languages	Any (full OS)	Python, Node.js	E2B for variety
Global Distribution	Single region	Edge network	Cloudflare for latency
Pricing Model	Usage-based	$5/month flat	Depends on volume
Setup Complexity	Low	Medium	E2B for simplicity
Local Development	Cloud only	Docker required	E2B for quick start
Claude Integration	Native template	API-based	E2B for turnkey
File Downloads	Automatic	API-based	E2B for ease

Troubleshooting

Python Not Found

# Install Python 3.11+
brew install python3  # macOS
# or visit https://python.org/downloads

API Keys Not Set

# Create .env file in .claude/sandbox/
echo "E2B_API_KEY=your_key_here" >> .claude/sandbox/.env
echo "ANTHROPIC_API_KEY=your_key_here" >> .claude/sandbox/.env

Dependencies Installation Failed

# Manual installation
cd .claude/sandbox
pip3 install -r requirements.txt

Component Architecture

claude-code-templates/
└── cli-tool/
    └── components/
        └── sandbox/
            ├── e2b/                              # E2B provider
            │   ├── claude-code-sandbox.md        # Component documentation
            │   ├── e2b-launcher.py               # Python launcher script
            │   ├── e2b-monitor.py                # Monitoring tool
            │   ├── requirements.txt              # Python dependencies
            │   ├── SANDBOX_DEBUGGING.md          # Debug guide
            │   └── .env.example                  # Environment template
            ├── cloudflare/                       # Cloudflare provider
            │   ├── claude-code-sandbox.md        # Component documentation
            │   ├── src/
            │   │   └── index.ts                  # Worker source code
            │   ├── launcher.ts                   # TypeScript launcher
            │   ├── monitor.ts                    # Monitoring tool
            │   ├── wrangler.toml                 # Cloudflare config
            │   ├── package.json                  # Dependencies
            │   ├── tsconfig.json                 # TypeScript config
            │   ├── README.md                     # Documentation
            │   ├── QUICKSTART.md                 # Quick start guide
            │   ├── SANDBOX_DEBUGGING.md          # Debug guide
            │   └── .dev.vars.example             # Environment template
            ├── docker/                           # Future: Docker provider
            ├── aws/                              # Future: AWS provider
            └── README.md                         # This file

The sandbox system integrates seamlessly with the existing Claude Code Templates component architecture, allowing any combination of agents, commands, MCPs, settings, and hooks to be installed and used within the secure sandbox environment.

Choosing the Right Sandbox

Use E2B when you need:

✅ Long-running operations (hours)
✅ Full Linux environment access
✅ Quick setup with minimal configuration
✅ Multiple programming languages
✅ Automatic file downloads
✅ Native Claude Code integration

Use Cloudflare when you need:

✅ Sub-second cold starts
✅ Global edge distribution
✅ Predictable flat-rate pricing
✅ High request volume
✅ Python/Node.js execution
✅ Production-grade reliability

README.md

Claude Code Sandbox Components

Available Sandbox Providers

E2B Sandbox (e2b)

Cloudflare Sandbox (cloudflare)

Quick Start

E2B Sandbox

Cloudflare Sandbox

Environment Setup

How It Works

Usage Examples

Basic Web Development

Full Stack with Components

Data Analysis

Security Audit

Security Benefits

Future Sandbox Providers

✅ Production Ready Features (v1.20.3+)

Enhanced E2B Integration

Advanced Debugging Tools

Sandbox Comparison

Troubleshooting

Python Not Found

API Keys Not Set

Dependencies Installation Failed

Component Architecture

Choosing the Right Sandbox

Use E2B when you need:

Use Cloudflare when you need:

E2B Sandbox (`e2b`)

Cloudflare Sandbox (`cloudflare`)