Claude Docker

Claude Docker

Containerized drop-in replacement for Claude Code - run worry-free in --dangerously-skip-permissions mode with complete isolation. Pre-configured MCP servers, host GPU access, conda environment mounting, and modular plugin system for effortless customization.

Prerequisites

Required:
- ✅ Claude Code authentication
- ✅ Docker installation

Everything else is optional - the container runs fine without any additional setup.

Quick Start

That's it! Claude runs in an isolated Docker container with access to your project directory.

Installer notes:
- Alias is added to your detected shell RC file (.bashrc, .bash_profile, .zshrc, or .profile)
- Persistent data defaults to ~/.claude-docker; override with CLAUDE_DOCKER_HOME=/path/to/writable/dir

Command Line Reference

Basic Usage

Available Flags

Environment Variable Defaults
Set defaults in your .env file:

Set this in your shell if you want to override the default persistent directory:

Examples

Optional Configuration

All configuration below is optional. The container works out-of-the-box without any of these settings.

Environment Variables (.env file)

All environment variables are completely optional. Only configure what you need:

Twilio SMS Notifications
Get phone notifications when long-running tasks complete:

Setup: Create a free trial account at https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account

Conda Integration
Mount your host conda environments and packages into the container:

All your conda environments work exactly as they do on your host system - no Dockerfile modifications needed.

System Packages
Additional apt packages beyond the Dockerfile defaults:

Note: Adding system packages requires rebuilding the image with claude-docker --rebuild.

Git & SSH…