Willem van den Ende d45c1c7739 Add README and simplify CLAUDE.md
Move user-facing setup instructions to new README.md and reduce
CLAUDE.md to essential project context for Claude Code.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-29 15:49:50 +00:00

49 lines
1.2 KiB
Markdown

# 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`.