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斗争。开始交付代码。