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

# 1. Clone and enter directory
git clone https://github.com/VishalJ99/claude-docker.git
cd claude-docker

# 2. Setup environment (completely optional - skip if you don't need custom config)
cp .env.example .env
nano .env  # Add any optional configs

# 3. Install (use sudo for GPU support)
sudo ./src/install.sh  # Or just ./src/install.sh without GPU

# 4. Run from any project
cd ~/your-project
claude-docker

**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

claude-docker                       # Start Claude in current directory
claude-docker --podman              # Use podman instead of docker
claude-docker --continue            # Resume previous conversation
claude-docker --rebuild             # Force rebuild Docker image
claude-docker --rebuild --no-cache  # Rebuild without using cache
claude-docker --memory 8g           # Set container memory limit
claude-docker --gpus all            # Enable GPU access (requires nvidia-docker)
claude-docker --cc-version 2.0.64   # Install specific Claude Code version

Available Flags

Flag	Description	Example

...