# Claude Code Devcontainer

A secure, sandboxed development container for running Claude Code with network restrictions.

## Quick Start

### Option 1: VS Code (Interactive)

1. Copy the `.devcontainer/` folder to your project root
2. Open your project in VS Code
3. Press `Ctrl+Shift+P` → "Dev Containers: Reopen in Container"
4. Run `claude` in the terminal to authenticate and start

### Option 2: Command Line (Non-Interactive)

Copy both `.devcontainer/` and `run-container.sh` to your project, then:

```bash
# Make executable (first time only)
chmod +x run-container.sh

# Run with a prompt
./run-container.sh "explain the fibonacci sequence"

# Pipe input
echo "write a hello world function" | ./run-container.sh

# Analyze a file
./run-container.sh "explain this code" < myfile.js

# Interactive mode (no prompt)
./run-container.sh
```

## Requirements

- Docker
- VS Code with [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) (for Option 1)

## Security

The container runs with a firewall that only allows connections to:
- GitHub
- npm registry
- Anthropic APIs
- VS Code services

All other outbound traffic is blocked, making it safe to use `--dangerously-skip-permissions`.