claude-docker/README.md
Vishal Jain 23524659e8 Initial commit: Claude Docker setup
- Dockerfile with Claude Code and Twilio MCP integration
- Wrapper script for easy invocation from anywhere
- Auto-setup of .claude directory in projects
- SMS notifications via Twilio when tasks complete
- Installation script for zshrc alias
- Full autonomous permissions with --dangerously-skip-permissions
- Context persistence via scratchpad.md
2025-06-11 10:29:15 +01:00

1.8 KiB
Raw History

Claude Docker

A Docker container for running Claude Code with full autonomous permissions and Twilio SMS notifications.

Features

  •  Fully autonomous Claude Code environment

  • =<3D> SMS notifications via Twilio when tasks complete
  • = Safe containerized execution
  • =<3D> Simple one-command invocation
  • =<3D> Context persistence between sessions

Quick Start

1. Clone and Install

git clone https://github.com/VishalJ99/claude-docker.git
cd claude-docker
./scripts/install.sh
source ~/.zshrc

2. Configure API Keys

Edit ~/.claude-docker/.env with your credentials:

ANTHROPIC_API_KEY=your_key_here
TWILIO_ACCOUNT_SID=your_sid_here
TWILIO_AUTH_TOKEN=your_auth_token_here
TWILIO_PHONE_NUMBER=+1234567890
YOUR_PHONE_NUMBER=+1234567890

3. Use

Navigate to any project and run:

claude

Claude will:

  • Create a .claude folder in your project (if needed)
  • Start with full permissions in the container
  • Send you an SMS when tasks complete

How It Works

  1. Container: Runs Claude Code in an isolated Docker environment
  2. Permissions: Uses --dangerously-skip-permissions for full autonomy
  3. MCP Server: Integrates Twilio for SMS notifications
  4. Context: Maintains scratchpad.md for session persistence

Project Structure

your-project/
 .claude/                 # Auto-created
    settings.local.json  # MCP configuration
    CLAUDE.md           # Project instructions
 scratchpad.md           # Context persistence

Commands

  • claude - Start Claude in current directory
  • claude [args] - Pass arguments to Claude Code

Requirements

  • Docker
  • Anthropic API key
  • Twilio account (for SMS notifications)

Security

  • Claude only has access to the current directory
  • Container auto-removes after exit
  • No access to host system outside mounted directory

License

MIT