CoderLuii/HolyClaude

HolyClaude – Dockerコンテナ内の迅速なAI開発ワークステーション

何であるか – HolyClaudeは、公式の Claude Code CLI（Anthropicのコーディングアシスタント）とフルスタック開発環境をバンドルした、即時利用可能なDockerイメージです：

• Claudeとの対話用のWeb UI（CloudCLI）
• スクリーンショットやUIテスト用のヘッドレスChromium + Xvfb + Playwright
• 8つのAI-CLIツール（Claude、OpenAI Codex、Gemini、Cursor、TaskMaster、Junie、OpenCode、Pi）が事前インストール済み
• Node 26、Python、Git、データベースクライアントなど50以上の一般的な開発ユーティリティ
• s6-overlayによるプロセス監視
• amd64 & arm64のマルチアーキテクチャイメージと、ディスク使用量を抑えるスリムバージョン

すべてのスタックはコンテナ化されているため、「Claudeをインストール、Chromiumを修正、Xvfbを設定、権限を調整」といった煩雑な作業から解放されます。docker compose up だけで、既存のAnthropicサブスクリプション（Max/Pro）またはAPIキーと連携できる、常に稼働しているLinuxワークステーションが即座に利用可能になります。

---

クイックスタート（30秒）

mkdir holyclaude && cd holyclaude
cat > docker-compose.yaml <<'EOF'
services:
  holyclaude:
    image: coderluii/holyclaude:latest
    container_name: holyclaude
    restart: unless-stopped
    shm_size: 2g
    ports:
      - "127.0.0.1:3001:3001"
    volumes:
      - ./data/claude:/home/claude/.claude   # 認証情報とClaudeのメモリを永続化
      - ./workspace:/workspace               # あなたのコード
    environment:
      - TZ=UTC
EOF

docker compose up -d

http://localhost:3001 を開き、CloudCLIアカウントを作成し、Anthropicの資格情報を使用してログインすると、Claudeでコード作成がすぐに開始できます。

---

なぜHolyClaudeを使うべきか？

機能	HolyClaude	手動設定
Claude Code	事前インストール済み、即時利用可能	インストール、インストーラーのデバッグ、権限の修正が必要
Web UI	CloudCLIがバンドル済み、追加設定不要	自分でUIを探して設定する必要がある
ヘッドレスブラウザ	Chromium + Xvfb + Playwright、shm = 2GB	各コンポーネントを個別にインストール、共有メモリやサンドボックス設定を調整する必要がある
AI CLIs	8つのプロバイダー（Claude、Codex、Gemini…）が準備済み	各CLIを個別にインストールする必要がある
開発ツール	Node、Python、Git、DBクライアントなど	apt/npm/pipによる手動インストール
プロセス監視	s6-overlayが自動再起動	自分でsupervisord設定を書く必要がある
永続化	./data/claudeをバインドマウントすることで、再構築後も認証情報とClaudeのメモリを保持
マルチアーキテクチャ	amd64 & arm64イメージ。Raspberry Pi、NAS、クラウドVMで動作可能
更新	docker compose pull && docker compose up -d	数十のツールを手動で更新する必要がある

要するに、HolyClaudeは「私のマシンでは動く」という摩擦を排除し、再現可能で常に稼働するAI開発環境を提供します。

---

イメージバリアント

タグ	内容	適用シーン
latest（フル）	すべてのツールが事前インストール済み – Claudeコマンドの実行に待機ゼロ
slim	コアランタイムのみ；必要なツールはオンデマンドでインストール – ダウンロードサイズが小さい
X.Y.Z / X.Y.Z-slim	プロダクションの安定性を確保するための固定リリース

両バリアントとも amd64 および arm64 に対応しており、Docker Hubにサイズが表示されています。

---

認証とコスト

• Claude Max/Pro – CloudCLI UI（OAuth）でログイン – 既にAnthropicに支払っている金額と同額。
• Anthropic APIキー – UIにキーを貼り付け – 通常通りの課金方式。
• 認証情報のリレーなし：コンテナはファイル、バインドマウント、または環境変数からキーを読み取り、プロバイダーに直接接続。
• 他のAI CLI（Gemini、OpenAI Codex、Cursorなど）も同様に、それぞれのAPIキーで動作。

---

拡張・カスタマイズ

• 完全なcomposeテンプレート（READMEを参照）は、複数のオプションポート（Next.js、Vite、Cloudflare Workers、SSHなど）を公開し、.envでパスを上書き可能。
• リモートアクセス – ポート公開ではなく、TailscaleやCloudflare Tunnelによるセキュアな外部アクセスを推奨。
• Ollama – ローカルLLMをHolyClaudeと併用する方法についてのセクションあり。
• ローカルビルド – カスタムツールチェーンが必要な場合、ソースからイメージを再構築可能。

---

既知の制限とロードマップ

• Kubernetes対応は「近日中に」（Helmチャートの計画あり）。
• 現在のリリース（v1.6.4）には、カスタムFFmpegビルドおよび他のバンドルバイナリに存在する既知のCVEに対する「許容可能なリスク」のセキュリティマニフェストが含まれています。
• 今後の作業：より強固なコンテナハードニング、GPUサポート（オプション）、K8s用Helmチャート。

---

ヘルプの取得

• GitHubでイシューを開く。
• X（旧Twitter）@CoderLuiiでコミュニティに参加。
• 有用だと感じたら、PayPalまたはBuy Me A Coffeeで寄付を。

---

結論：HolyClaudeは、公式のオープンソースプロジェクトであり、完全なClaudeベースのAI開発ワークステーションを1つのDockerイメージにパッケージ化し、セットアップ時間を大幅に短縮し、通常のDocker関連の落とし穴を排除しています。