CoderLuii/HolyClaude

AI coding workstation: Claude Code + web UI + 8 AI CLIs + headless browser + 50+ tools

HolyClaude – Docker 容器中的快速 AI 开发工作站

是什么 – HolyClaude 是一个即用型 Docker 镜像，捆绑了官方 Claude Code CLI（Anthropic 的编程助手）以及完整的全栈开发环境：

用于与 Claude 交互的 Web UI（CloudCLI）
无头 Chromium 浏览器 + Xvfb + Playwright，用于截图和 UI 测试
8 个 AI-CLI 工具（Claude、OpenAI Codex、Gemini、Cursor、TaskMaster、Junie、OpenCode、Pi）已预装
50 多个常用开发工具（Node 26、Python、Git、数据库客户端等）
通过 s6-overlay 实现进程监控
支持多架构镜像（amd64 & arm64），并提供适用于低磁盘环境的精简版本

整个栈都容器化，避免了“安装 Claude、修复 Chromium、配置 Xvfb、设置权限”等常见麻烦。只需 docker compose up，即可获得一个始终运行的 Linux 工作站，支持任何现有的 Anthropic 订阅（Max/Pro）或 API 密钥。

快速开始（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 = 2 GB	逐个安装，调整共享内存和沙箱设置
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、云虚拟机上运行
更新	`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 CLIs（Gemini、OpenAI Codex、Cursor 等）也通过各自的 API 密钥以类似方式工作。

扩展 / 自定义

完整 compose 模板（见 README）暴露多个可选端口（Next.js、Vite、Cloudflare Workers、SSH 等），并通过 .env 覆盖路径。
远程访问 – 不推荐暴露端口，建议使用 Tailscale 或 Cloudflare Tunnel 实现安全外部访问。
Ollama – 有章节说明如何在 HolyClaude 旁运行本地 LLM。
本地构建 – 如需自定义工具链，可从源码重建镜像。

已知限制与路线图

Kubernetes 支持即将推出（计划发布 Helm Chart）。
当前版本（v1.6.4）包含已知 CVE 的“可接受风险”安全清单，涉及自定义 FFmpeg 构建及其他捆绑二进制文件。
未来工作：更严格的容器加固、可选 GPU 支持、K8s 用 Helm Chart。

获取帮助

在 GitHub 上提交问题。
在 X（原 Twitter）@CoderLuii 加入社区。
如果觉得有用，可通过 PayPal 或 Buy Me A Coffee 捐赠支持。

总结：HolyClaude 是一个真正的开源项目，将完整的基于 Claude 的 AI 开发工作站打包为单一 Docker 镜像，大幅减少设置时间，并消除常见的 Docker 相关陷阱。