HolyClaude:一条命令的AI编码工作站

HolyClaude:终极一条命令AI开发工作站

停止配置,开始构建。

您花费了数小时(甚至数天)与Docker权限、Chromium共享内存限制、Claude Code安装程序挂起以及权限拒绝错误作斗争。HolyClaude解决每一个问题

一条命令即可获得: - ✅ Claude Code CLI(您现有的Max/Pro订阅可用) - ✅ CloudCLI Web UI (http://localhost:3001) - ✅ 无头Chromium + Xvfb + Playwright(截图、测试、Lighthouse) - ✅ 7个AI CLI:Claude、Gemini、OpenAI Codex、Cursor、Junie、TaskMaster、OpenCode - ✅ 50+开发工具:Node.js 22、Python 3、pnpm、git/gh、ripgrep、100+ npm/pip包 - ✅ 多架构:AMD64 + ARM64(Raspberry Pi、Apple Silicon、AWS Graviton)

mkdir holyclaude && cd holyclaude
# 从仓库复制docker-compose.yaml
 docker compose up -d
# 打开 http://localhost:3001

仅此而已。 您的Anthropic认证通过Web UI OAuth流程工作。无额外费用。MIT许可。GitHub 1.7k星。

HolyClaude为何存在

手动设置 = 2+小时痛苦: - Chromium崩溃(shm_size=64MB → 2GB修复) - 权限拒绝(PUID/PGID不匹配) - Claude安装程序挂起(WORKDIR根目录所有) - SQLite在NAS挂载上锁定 - SMB共享上文件监视器损坏

HolyClaude = 30秒docker compose up。每一个边缘情况都已处理。

内部内容(完整镜像)

AI CLI(Tab键切换): Claude、Gemini、Codex、Cursor、Junie、TaskMaster、OpenCode

语言与构建工具: - Node.js 22 + pnpm + TypeScript + Vite + esbuild - Python 3 + pandas/numpy + FastAPI + requests

浏览器自动化: Chromium + Xvfb(:99) + Playwright(预配置)

部署: Vercel、Netlify、Cloudflare Workers、Azure CLI

数据处理: PDF生成(7个库)、Excel/Word/PowerPoint、ffmpeg、pandoc

系统: git/gh、ripgrep/fd/fzf、tmux、htop、psql/redis-cli

快速启动(复制粘贴即用)

创建docker-compose.yaml

services:
  holyclaude:
    image: coderluii/holyclaude:latest
    container_name: holyclaude
    restart: unless-stopped
    shm_size: 2g
    cap_add:
      - SYS_ADMIN
      - SYS_PTRACE
    security_opt:
      - seccomp=unconfined
    ports:
      - "3001:3001"
    volumes:
      - ./data/claude:/home/claude/.claude
      - ./workspace:/workspace
    environment:
      - TZ=UTC
docker compose up -d
open http://localhost:3001  # 使用Anthropic登录

使用您现有的订阅

Claude Max/Pro: Web UI OAuth(与桌面应用相同) API密钥: 在设置中粘贴 无额外费用 - HolyClaude是免费开源软件

其他提供商也支持: - OpenAI/ChatGPT:codex login --device-auth - Gemini:GEMINI_API_KEY - Cursor:CURSOR_API_KEY

平台支持

平台 状态 备注
Linux amd64 推荐
Linux arm64 Pi 4+、Oracle Cloud
macOS Docker Desktop
Windows WSL2 + Docker
Synology/QNAP NAS就绪

生产就绪

  • 持久化: ./data/claude(凭证)、./workspace(代码)
  • 进程监督: s6-overlay(自动重启、优雅关闭)
  • 更新: docker compose pull && docker compose up -d
  • 权限: PUID/PGID映射
  • 通知: Discord/Telegram/Slack/Email (Apprise)

精简版 vs 完整版镜像

标签 大小 最适合
:latest 完整 零等待时间
:slim 精简 VPS、按量计费带宽

精简版会自动安装缺失包。完整版预构建一切。

日常用户构建

"这是我每天在服务器上运行的东西。" - CoderLuii

1.7k ⭐ 190 forks。MIT许可。积极维护。

GitHub仓库 - 给它星标、分叉、用它构建。

停止与Docker斗争。开始交付代码。

原始文章: 查看原文

分享这篇文章