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
2025-11-29 15:49:50 +00:00
2025-11-29 15:49:50 +00:00

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:

# 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

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.

Description
Variation on the claude-dev-container that also can be run from a terminal in API (-p) mode, for inclusion in scripts.
Readme 33 KiB
Languages
Shell 77.2%
Dockerfile 22.8%