Sandbox Manager User Guide

Welcome to Sandbox Manager - your platform for creating and managing Claude Code development containers.

Getting Started

Accessing the Service

Open your browser and navigate to: https://sandbox.haiven.local

Logging In

1. Enter your username and password
2. Click "Sign In"
3. You'll be redirected to the dashboard

Creating Your First Container

Step 1: Click "Create New Container"

From the dashboard, click the prominent "Create New Container" button.

Step 2: Select Your Project

1. Click "Browse Projects"
2. Navigate to your project directory under /mnt/projects or /mnt/storage/repos
3. Select the directory containing your code

Step 3: Choose a Claude Model

Available models:
- claude-sonnet-4-5-20250929 (Default) - Best balance of speed and capability
- claude-opus-4-5-20251101 - Most capable, slower but thorough
- claude-sonnet-4-20250514 - Faster, good for simpler tasks

Step 4: Configure MCP Presets

Choose from:
- None - Basic Claude Code
- Documentation - Adds documentation browsing
- Development - Full developer toolkit (filesystem, git, search)
- Custom - Define your own MCP configuration

Step 5: Create

Click "Create Container" and wait for initialization (10-30 seconds).

Managing Containers

Dashboard Overview

Each container shows:
- Name and status indicator
- Model in use
- Project path
- Action buttons: Open Terminal, Start/Stop, Delete

Container States

• Running (green) - Active and ready
• Stopped (gray) - Paused but saved
• Error (red) - Problem occurred

Starting/Stopping

• Click Start to resume a stopped container
• Click Stop to pause (preserves your work)
• Stopping does NOT delete your files

Deleting Containers

1. Stop the container first
2. Click Delete
3. Confirm the action

Warning: Deleting is permanent. Save important work to your project directory first.

Using the Web Terminal

Opening Terminal

Click "Open Terminal" on any running container.

Basic Commands

# Start Claude Code
claude

# List files
ls -la

# View MCP config
cat ~/.mcp/config.json

Keyboard Shortcuts

Copy/Paste

• Copy: Select text, press Ctrl+Shift+C
• Paste: Ctrl+Shift+V

Working with Claude Code

Starting a Conversation

claude

Example Requests

• "Show me the files in this project"
• "Create a Python function that validates emails"
• "Explain how this code works"
• "Fix the bug in this file"

MCP Configuration

Understanding Presets

Development preset example:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-server-filesystem",
      "args": ["--root", "/mnt/projects/my-app"]
    },
    "git": {
      "command": "mcp-server-git"
    }
  }
}

Custom Configuration

Select "Custom" preset and edit the JSON to add your own MCP servers.

Note: MCP configuration cannot be changed after container creation. Create a new container to use different MCP servers.

Troubleshooting

Container Won't Start

• Verify project path exists
• Try with "None" MCP preset to isolate issues
• Delete and recreate the container

Terminal Won't Connect

• Check container is running
• Refresh the browser tab
• Try a different browser

Can't Find My Files

• Ensure you're in /mnt/projects/...
• Check the mounted project path in dashboard

MCP Not Working

• View MCP config: cat ~/.mcp/config.json
• Check container logs for MCP errors
• Recreate with verified preset

Tips & Best Practices

Container Organization

• Use descriptive names: blog-redesign, api-v2-dev
• One project per container
• Clean up unused containers regularly

Saving Your Work

• All work in the project directory persists
• Use git commits frequently
• Container-only files are lost on delete

Performance

• Stop containers when not in use
• Limit active containers to 3-5
• Use Sonnet for faster responses, Opus for complex tasks

Getting Help

1. Check this guide
2. Review README.md for technical details
3. Check container logs: docker logs sandbox-manager
4. Contact Haiven infrastructure team

Happy coding with Claude!