A sandbox template for running Codegen sessions in a containerized environment using the Blaxel platform. This template provides a secure, isolated environment where Claude can execute code, work with files, and perform various development tasks safely.

• ✨ Features
• 🚀 Quick Start
• 📋 Prerequisites
• 💻 Installation
• 🔧 Usage
  • Running Locally with Docker
  • Deploying to Blaxel
  • Connecting to Sandbox
• 📁 Project Structure
• ❓ Troubleshooting
• 👥 Contributing
• 🆘 Support
• 📄 License

• Containerized sandbox environment for secure code execution
• Pre-configured development environment with essential tools
• Seamless integration with Blaxel platform for cloud deployment
• Local Docker support for development and testing
• Isolated file system for safe code experimentation
• Support for multiple programming languages and tools
• Easy connection and interaction with Claude Code sessions

For those who want to get up and running quickly:

# Or use blaxel CLI
bl create-sandbox YOUR-SANDBOX-NAME -y -t template-sandbox-codegen

# Navigate to the project directory
cd template-sandbox-claude-code

# Deploy to Blaxel
bl deploy

# Wait for your sandbox to be deployed
bl get sandbox YOUR-SANDBOX-NAME --watch

# Connect to your deployed sandbox
bl connect sandbox YOUR-SANDBOX-NAME

• Blaxel Platform Setup: Complete Blaxel setup by following the quickstart guide
  • Blaxel CLI: Ensure you have the Blaxel CLI installed. If not, install it globally:

    curl -fsSL https://raw.githubusercontent.com/blaxel-ai/toolkit/main/install.sh | BINDIR=/usr/local/bin sudo -E sh

  • Blaxel login: Login to Blaxel platform

    bl login YOUR-WORKSPACE

Clone the repository:

git clone https://github.com/blaxel-ai/template-sandbox-claude-code.git
cd template-sandbox-claude-code

No additional dependencies need to be installed as everything runs in containers.

Build and run the sandbox container locally:

# Build the Docker image
make build

# Run the container
make run

This will start the sandbox environment with ports 8080 and 3000 exposed for development.

When you are ready to deploy your sandbox to the cloud:

bl deploy

This command uses your code and the configuration in blaxel.toml to deploy your sandbox environment on the Blaxel platform.

Once deployed, you can connect to your sandbox:

bl connect sandbox YOUR-SANDBOX-NAME

Replace YOUR-SANDBOX-NAME with the actual name of your deployed sandbox.

• Dockerfile - Container configuration for the sandbox environment
• Makefile - Build and run commands for local development
• entrypoint.sh - Container startup script
• blaxel.toml - Blaxel deployment configuration (sandbox type)

1. Docker Issues:

   • Ensure Docker is running and accessible
   • Try docker --version to verify Docker installation
   • Check that ports 8080 and 3000 are available

2. Blaxel Platform Issues:

   • Ensure you're logged in to your workspace: bl login MY-WORKSPACE
   • Verify sandbox deployment: bl get sandboxes
   • Check deployment status: bl logs sandbox YOUR-SANDBOX-NAME

3. Connection Issues:

   • Verify the sandbox is running: bl get sandboxes
   • Check sandbox logs for errors: bl logs sandbox YOUR-SANDBOX-NAME
   • Ensure your Blaxel CLI is up to date

For more help, please submit an issue on GitHub.

Contributions are welcome! Here's how you can contribute:

1. Fork the repository
2. Create a feature branch:

   git checkout -b feature/amazing-feature

3. Commit your changes:

   git commit -m 'Add amazing feature'

4. Push to the branch:

   git push origin feature/amazing-feature

5. Submit a Pull Request

Please make sure to test your changes with both local Docker and Blaxel deployment.

If you need help with this template:

• Submit an issue for bug reports or feature requests
• Visit the Blaxel Documentation for platform guidance
• Check the Blaxel Sandbox Documentation for sandbox-specific help
• Join our Discord Community for real-time assistance

This project is licensed under the MIT License. See the LICENSE file for more details.