🧠 docker-claude-code

claude but dockerized, goth-approved, and dangerously executable. This container gives you the Claude Code in a fully isolated ritual circle – no cursed system installs required.

💀 Why?

Because installing things natively is for suckers. This image is for devs who live dangerously, commit anonymously, and like their AI tools in containers.

🎞️ What's Inside?

• Ubuntu 22.04 (stable and unfeeling)
• Go 1.25.5 with full toolchain (golangci-lint, gopls, delve, staticcheck, gofumpt, gotests, impl, gomodifytags)
• Latest Node.js with comprehensive dev tools (eslint, prettier, typescript, ts-node, yarn, pnpm, nodemon, pm2, framework CLIs, newman, http-server, serve, lighthouse, storybook)
• Python 3.12.11 via pyenv with linters, formatters, testing (flake8, black, isort, autoflake, pyright, mypy, vulture, pytest, poetry, pipenv)
• Python libraries pre-installed (requests, beautifulsoup4, lxml, pyyaml, toml)
• Docker CE with Docker Compose (full containerization chaos)
• DevOps tools (terraform, kubectl, helm, gh CLI)
• System utilities (jq, tree, ripgrep, bat, exa, fd-find, silversearcher-ag, htop, tmux)
• Shell tools (shellcheck, shfmt)
• C/C++ tools (gcc, g++, make, cmake, clang-format, valgrind, gdb, strace, ltrace)
• Database clients (sqlite3, postgresql-client, mysql-client, redis-tools)
• Editors (vim, nano)
• Archive tools (zip, unzip, tar)
• Networking tools (net-tools, iputils-ping, dnsutils)
• git + curl + wget + httpie + Claude Code
• Auto-Git config based on env vars
• Auto-generated CLAUDE.md in workspace (lists all available tools for Claude's awareness)
• Startup script that configures git, updates claude, and runs with --dangerously-skip-permissions

📋 Requirements

• Docker installed and running

⚙️ Quick Start

🚀 Quick Install

There's an install script that sets everything up automatically:

curl -fsSL https://raw.githubusercontent.com/psyb0t/docker-claude-code/master/install.sh | bash

Or if you prefer manual control:

Create settings dir

mkdir -p ~/.claude

🥪 Generate SSH Keys

If you don't have an SSH key pair yet, conjure one with:

mkdir -p "$HOME/.ssh/claude-code"
ssh-keygen -t ed25519 -C "claude@claude.ai" -f "$HOME/.ssh/claude-code/id_ed25519" -N ""

Then add the public key ($HOME/.ssh/claude-code/id_ed25519.pub) to your GitHub account or wherever you push code.

🔐 ENV Vars

Variable	What it does
CLAUDE_GIT_NAME	Git commit name inside the image (optional)
CLAUDE_GIT_EMAIL	Git commit email inside the image (optional)
CLAUDE_WORKSPACE	Host path to mount and work in (set automatically by wrapper script)

To set these, export them on your host machine (e.g. in your ~/.bashrc or ~/.zshrc):

export CLAUDE_GIT_NAME="Your Name"
export CLAUDE_GIT_EMAIL="your@email.com"

If not set, git inside the container won't have a default identity configured.

Create a Wrapper Script

Put this in your /usr/local/bin/claude (or wherever your chaos reigns):

#!/usr/bin/env bash

# Git identity - use env var if set, otherwise empty
CLAUDE_GIT_NAME="${CLAUDE_GIT_NAME:-}"
CLAUDE_GIT_EMAIL="${CLAUDE_GIT_EMAIL:-}"

# Convert PWD to a valid container name (slashes to underscores)
sanitized_pwd=$(echo "$PWD" | sed 's/\//_/g')
container_name="claude-${sanitized_pwd}"

# Check if the container is running
if docker ps --format '{{.Names}}' | grep -q "^${container_name}$"; then
    echo "🟢 Container '$container_name' is running. Attaching..."
    docker attach "$container_name"
    exit 0
fi

# Check if container exists but stopped
if docker ps -a --format '{{.Names}}' | grep -q "^${container_name}$"; then
    echo "🔄 Container '$container_name' exists. Starting and attaching..."
    docker start -ai "$container_name"
    exit 0
fi

echo "🔧 Creating and running new container: '$container_name'"
docker run -it \
    --network host \
    -e CLAUDE_GIT_NAME="$CLAUDE_GIT_NAME" \
    -e CLAUDE_GIT_EMAIL="$CLAUDE_GIT_EMAIL" \
    -e CLAUDE_WORKSPACE="$PWD" \
    -v "$HOME/.ssh/claude-code:/home/claude/.ssh" \
    -v "$HOME/.claude:/home/claude/.claude" \
    -v "$PWD:$PWD" \
    -v /var/run/docker.sock:/var/run/docker.sock \
    --name "$container_name" \
    psyb0t/claude-code:latest

Make it executable:

sudo chmod +x /usr/local/bin/claude

Now you can summon Claude like so:

claude

🦴 Gotchas

• This tool uses --dangerously-skip-permissions. Because Claude likes to live fast and break sandboxes.
• SSH keys are mounted to allow commit/push shenanigans. Keep 'em safe, goblin.
• The host directory is mounted at its exact path inside the container (e.g. /home/you/project stays /home/you/project). This means docker volume mounts from inside Claude will use correct host paths.
• The container user's UID/GID is automatically matched to the host directory owner, so file permissions just work.
• Docker socket is mounted so Claude can spawn containers within containers. Docker-in-Docker madness enabled.

📜 License

WTFPL – do what the fuck you want to.