HolyClaude

你是否曾为了搭建一个完美的 AI 编程环境而焦头烂额？

想要 Claude Code，却卡在 Docker 里的 Chromium 无法启动？

想要 Web 界面远程访问，却搞不定 OAuth 认证和反向代理？

想要 无头浏览器做自动化测试，却被 shm_size、Xvfb 和权限问题劝退？

想要顺便装上 Playwright, GitHub CLI, Python, Node.js，结果发现容器内 UID 不匹配，文件全是 root 权限？

HolyClaude 是一个开箱即用、完全容器化的 AI 编码套装。它将 Claude Code CLI、现代化 Web UI、预配置的无头浏览器、7 种主流 AI 命令行工具以及 50+ 开发神器打包进一个经过千锤百炼的 Docker 镜像中。

你不需要花 2 小时去调试环境，只需要 30 秒：

docker compose up -d

然后打开浏览器，开始构建。

核心亮点：为什么选择 HolyClaude？

1. 真正的“全家桶”，而非简单封装

HolyClaude 不仅仅是跑了一个 Claude Code。它是一个完整的云原生开发工作站：

• 核心引擎：官方原版 Claude Code CLI（非代理、非仿制），完美支持 Max/Pro 订阅或 API Key。
• Web 界面：集成 CloudCLI，提供与桌面版体验一致的 OAuth 登录和聊天界面，支持远程访问。
• 浏览器自动化：预装 Chromium + Xvfb + Playwright，已解决所有 Docker 共享内存 (shm_size) 和沙箱问题，直接可用。
• AI 工具矩阵：内置 7 大 AI CLI (Claude, Codex, Gemini, Cursor, TaskMaster, Junie, OpenCode)，一键切换模型提供商。
• 开发工具箱：预装 50+ 常用工具 (Git, GitHub CLI, Node.js, Python, Pip, NPM, SQLite, FFmpeg 等)。

2. 避坑指南：每一个 Bug 都被修复了

作者已经在生产环境中运行数周，解决了所有常见的 Docker 痛点：

• ✅ Chromium 启动失败？已配置正确的 shm_size 和沙箱参数。
• ✅ 权限错误？容器内 UID/GID 自动适配，挂载卷权限完美匹配。
• ✅ 安装程序挂起？修复了 Claude Code 在 root owned WORKDIR 下的安装死锁。
• ✅ SQLite 锁定？优化了 NAS 挂载下的文件锁机制。
• ✅ 进程守护？采用 s6-overlay 管理进程，自动重启、优雅关闭，比 restart: always 更可靠。

3. 无缝兼容你的现有订阅

HolyClaude 不触碰、不存储、不代理你的任何凭证。

• Claude Max/Pro 用户：直接在 Web UI 通过 OAuth 登录，就像在桌面端一样。
• API Key 用户：在 Web UI 输入 Key，计费直接走 Anthropic 官方。
• 数据安全：所有凭证以本地绑定挂载形式存储在 ./data/claude/，与裸机运行完全一致。

全平台支持

⚡ 快速开始 (Quick Start)

只需 4 步，即可拥有专属 AI 工作站：

1. 创建目录

mkdir holyclaude && cd holyclaude

2. 创建配置文件

新建 docker-compose.yaml，复制以下最简模板：

services:
  holyclaude:
    image: ghcr.io/your-repo/holyclaude:latest # 请替换为实际镜像地址
    container_name: holyclaude
    ports:
      - "3001:3001" # Web UI 端口
    volumes:
      - ./data:/home/node/data # 持久化数据
      - /var/run/docker.sock:/var/run/docker.sock # 可选：允许容器内调用 Docker
    environment:
      - TZ=Asia/Shanghai
    shm_size: '2gb' # 关键：确保浏览器正常运行
    restart: unless-stopped

3. 启动服务

docker compose up -d

4. 开始使用

• 浏览器访问：http://localhost:3001
• 使用 Anthropic 账户登录 (OAuth) 或输入 API Key。
• 立刻开始编码！

内置工具清单 (部分)

HolyClaude 预装了你可能需要的一切：

• AI 核心: claude, codex, gemini, cursor, taskmaster, junie, opencode
• 浏览器自动化: chromium, playwright, xvfb, fluxbox (窗口管理器)
• 开发运行时: nodejs (最新 LTS), python3, pip, npm, pnpm, yarn
• 版本控制: git, gh (GitHub CLI)
• 数据库: sqlite3, duckdb
• 多媒体: ffmpeg, imagemagick
• 系统工具: curl, wget, vim, nano, htop, jq

典型应用场景

1. 远程 AI 编程：在服务器部署 HolyClaude，通过 iPad 或任意浏览器访问强大的 Claude Code，随时随地写代码。
2. 自动化测试流水线：利用预装的 Playwright 和无头浏览器，让 AI 自动编写并运行 E2E 测试，截图、录屏一气呵成。
3. 多模型对比开发：在同一环境中无缝切换 Claude, GPT-4o, Gemini，对比不同模型生成的代码质量。
4. 安全沙箱环境：在容器内运行 AI 生成的未知代码，即使出错也不会污染宿主机环境。
5. NAS 家庭实验室：在群晖或威联通上部署，打造全家可用的智能编程中心。

常见问题 (FAQ)

Q: 我需要额外付费吗？

A: 不需要。HolyClaude 本身完全免费开源。你只需向 Anthropic (或其他 AI 提供商) 支付正常的 API 费用或订阅费。

Q: 我的数据存在哪？

A: 所有数据（包括聊天记录、配置文件、浏览器缓存）都保存在你挂载的 ./data 目录中，完全由你掌控。

Q: 可以在 Windows 上直接用吗？

A: 可以，但推荐使用 WSL2 + Docker Desktop 以获得最佳性能和兼容性。

Q: 如何更新？

A: 一行命令搞定：docker compose pull && docker compose up -d。无需手动更新内部安装的 50+ 个工具。