HolyClaude

Name: HolyClaude
Author: CoderLuii

I hit every Docker + Claude Code bug so you don't have to.

One container. Claude Code, web UI, 5 AI CLIs, headless browser, 50+ tools. All configured. All working.

Get Started

Works with your existing Claude Max plan or Anthropic API key. Free and open source.

GitHub | Docker Hub

Quick Start

From zero to AI coding in 30 seconds. No, really.

Create a folder

$ mkdir holyclaude && cd holyclaude

Create a `docker-compose.yaml`

docker-compose.yaml

services:
  holyclaude:
    image: coderluii/holyclaude:latest
    container_name: holyclaude
    hostname: holyclaude
    restart: unless-stopped
    shm_size: 2g                  # Chromium needs this
    network_mode: bridge
    cap_add:
      - SYS_ADMIN              # Chromium sandboxing
      - SYS_PTRACE             # Debugging tools
    security_opt:
      - seccomp=unconfined     # Chromium in Docker
    ports:
      - "3001:3001"            # CloudCLI web UI
    volumes:
      - ./data/claude:/home/claude/.claude
      - ./workspace:/workspace
    environment:
      - TZ=UTC

Launch it

$ docker compose up -d

Open the Web UI

Open http://localhost:3001

Create a CloudCLI account, sign in with your Anthropic account, and build something.

That's the whole setup. You're done. No .env files. No pre-configuration. No reading 40 pages of docs.

What You Get

Every tool Claude needs. Pre-installed. Pre-configured. Zero wait time.

Claude Code CLI

The real deal. Anthropic's official CLI, pre-installed and ready to go.

CloudCLI Web UI

Web interface for Claude Code on port 3001 with project management, multiple sessions, and plugins.

5 AI CLIs

Claude Code, Gemini CLI, OpenAI Codex, and Cursor. Plus TaskMaster AI for task management.

Headless Chromium

Chromium + Playwright pre-configured. shm, sandbox, seccomp — all solved.

50+ Dev Tools

Git, Node.js, Python, GitHub CLI, ripgrep, fzf, bat, jq, tmux, htop, and dozens more.

s6-overlay

Real process supervision. Auto-restart, graceful shutdown, clean logs. Not a hack.

Multi-arch

AMD64 + ARM64. Intel, AMD, Apple Silicon, Graviton. It just runs.

Bind Mount Persistence

Your code lives on your host. Credentials survive container rebuilds. Always.

Why This Exists

Because you've already spent a weekend debugging Chromium in Docker.

	HolyClaude	Doing it yourself
Setup	30 seconds	1-2 hours (if it goes well)
Claude Code	Pre-installed, pre-configured	Install, configure, debug installer hanging
Web UI	CloudCLI included with plugins	Find one, install it, wire it up
Browser	Chromium + Playwright, configured	Fix shm, fix sandbox, fix seccomp...
Dev tools	50+ tools, ready	apt-get / npm / pip for the next hour
Updates	docker pull && up	Update 50 tools, pray nothing breaks

"I got tired of re-doing the same Docker setup every time — installing Claude Code, wiring up a web UI, fixing Chromium's shm/sandbox/seccomp, debugging permissions. So I containerized all of it and hit every bug so you don't have to."

— CoderLuii

Pick Your Size

Two flavors. Same quality. Pick your weight class.

RECOMMENDED

Latest

Full image. Batteries included. Node.js, Python, all 5 AI CLIs, deployment tools, PDF libs, data viz. Claude never has to stop and install something.

$ docker pull coderluii/holyclaude

MINIMAL

Slim

Core tools only. Claude installs extras on-demand. Smaller download, faster deploy. Same capabilities.

$ docker pull coderluii/holyclaude:slim

Your Account, Your Keys

This runs the real Claude Code CLI. Not a wrapper. Not a proxy. Not a knock-off.

Works

✓
Claude Max plan — Sign in through CloudCLI. Same OAuth flow as desktop.
✓
Anthropic API key — Set it in the web UI. Pay-per-use, same billing.

Does NOT Work

✗
ChatGPT subscription — Different company. OpenAI API keys work with Codex CLI (also included).

Other Tools Included

HolyClaude ships with 3 additional AI CLIs and a task runner:

Gemini CLIAPI key

OpenAI CodexAPI key

CursorAPI key

TaskMaster AItask runner

HolyClaude is free and open source. You only pay your AI providers for usage, same as you already do. We don't proxy, intercept, or touch your credentials.

Missing a Tool?

HolyClaude is built for the community. Request a package and it ships in the next release.

Request a Package

Open a GitHub issue — tell us what tool or library you need and why.

Alternatives

HolyClaude vs. every other way to run AI coding agents.

	HCHolyClaude	DockerVanilla Docker	DevconDevcontainer	BareBare Metal
Setup	1 cmd	DIYWrite Dockerfile	ConfigConfig + VS Code	Manual
CLIsAI CLIs	5	DIY	SomeVia features	DIY
Web UI	Yes	No	VS CodeVS Code only	No
Browser	Ready	Hard	Hard	Native
IsolateIsolation	Full	Full	Full	No
Arch	Both	DIY	MaybeDepends	Native