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>
Claude Code Devcontainer
A secure, sandboxed development container for running Claude Code with network restrictions.
Quick Start
Option 1: VS Code (Interactive)
- Copy the
.devcontainer/folder to your project root - Open your project in VS Code
- Press
Ctrl+Shift+P→ "Dev Containers: Reopen in Container" - Run
claudein 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
- Docker
- VS Code with Dev Containers extension (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.
Description
Variation on the claude-dev-container that also can be run from a terminal in API (-p) mode, for inclusion in scripts.
Languages
Shell
77.2%
Dockerfile
22.8%