企业官网建设流程全解析

HolyClaude是什么？一条命令拥有AI编程工作站：Claude Code + 8大AI CLI + 无头浏览器终极指南

【免费下载链接】HolyClaudeAI coding workstation: Claude Code + web UI + 8 AI CLIs + headless browser + 50+ tools项目地址: https://gitcode.com/gh_mirrors/ho/HolyClaude

HolyClaude 是一款开箱即用的开源 AI 编程工作站容器镜像：一条 Docker 命令即可运行官方Claude Code、CloudCLI Web UI、8 大 AI CLI（Codex、Gemini CLI、Cursor 等）、无头浏览器（Chromium + Playwright）和 50+ 开发工具。它直接复用你现有的 Claude Max/Pro 订阅或 API Key，不收取额外费用，支持 AMD64/ARM64 自托管。读完全文，你将在 5 分钟内搭建好完整 AI 编程环境，无需手动安装任何工具。

💡 为什么选择 HolyClaude：告别两小时手动配置

想用上 Claude Code，你通常需要：装 CLI → 找 Web UI → 配置 Chromium → 修 Docker 共享内存 → 处理权限问题……官方 README 直言：手动搭建要花 1~2 小时，而且每踩一个坑就要修一个坑。

HolyClaude 把这一切打包进一个容器：s6-overlay 进程守护、Chromium 无头浏览器、持久化会话，全部预先调好。

HolyClaude vs 手动搭建

🚀 一条命令安装：4 步启动 AI 编程工作站

第 1 步：创建目录

mkdir holyclaude && cd holyclaude

第 2 步：复制 Compose 模板。项目提供了现成文件，直接复制内容到你的docker-compose.yaml：

• 极简版：docker-compose.yaml（零配置，推荐新手）
• 完整版：docker-compose.full.yaml（所有选项均有注释）

第 3 步：拉取并启动

docker compose up -d

第 4 步：浏览器打开http://localhost:3001，花 10 秒创建 CloudCLI 账户，用你的 Anthropic 账号登录——完事了，没有 .env，没有预配置，没有 40 页文档。

📌 镜像默认绑定127.0.0.1，仅本机可访问，安全性有保障。

📦 容器里有什么：8 大 AI CLI + 50+ 开发工具

这不是一个最小容器，而是一整套开发工作站。核心是8 个 AI CLI 全部预装，一个Tab键的切换距离：

50+ 开发工具同样内置，Claude 干活时"零等待"：

• Node.js 生态：TypeScript、pnpm、Vite、ESLint、Prettier、Vercel、Cloudflare Wrangler、pm2、Prisma 等
• Python 生态：pandas、numpy、Playwright、FastAPI、matplotlib（均为预编译，免运行时 pip 安装）
• 系统工具：git、gh、ripgrep、fd、tmux、jq、ffmpeg、pandoc、数据库客户端（psql/redis-cli/sqlite3）等

完整清单见 Dockerfile，版本清单见 contracts/product-facts.json。

🖥️ 无头浏览器开箱即用：截图、测试、Playwright 自动化

容器内置Debian Chromium + Xvfb + Node/Python 双版本 Playwright，且全部版本锁定、构建时烘焙，运行时不会下载任何浏览器。

• Claude 可以直接截图、跑 Playwright 测试、做 Lighthouse 性能审计
• Compose 已配好shm_size: 2g（Docker 默认 64MB 会导致标签页随机崩溃）
• 架构细节见 docs/architecture.md

这意味着你可以直接对 Claude 说："打开这个页面截图""给这个按钮写个自动化测试"，它会立刻执行，而不是先花十分钟装环境。

🎯 订阅与认证：用你现有的 Claude 订阅，零额外成本

HolyClaude 运行的是Anthropic 官方 Claude Code CLI（不是包装器或代理）：

• Claude Max/Pro 订阅：通过 Web UI 走 OAuth 登录，与桌面端一致
• API Key：在 Web UI 中粘贴，按量计费
• ChatGPT 订阅用户：可用 Codex CLI 的codex login --device-auth登录
• 不想订阅？支持Ollama本地模型替代方案，见 docs/ollama.md

HolyClaude 本身免费开源（MIT 协议），不中转任何凭据，你只为 AI 使用量付费。

💾 数据持久化与升级：数据都存在哪里

升级只需两条命令，数据不受影响：

docker compose pull && docker compose up -d

⚠️ 切勿在容器内执行cloudcli update——镜像内置的是打过补丁的 CloudCLI，官方升级路径只有 Docker 镜像。

🌐 平台支持与远程访问安全建议

支持平台：Linux（amd64/arm64）、macOS（Docker Desktop）、Windows（WSL2）、群晖/QNAP NAS（SMB 挂载需开启轮询模式）。无特权环境可用 docker-compose.podman-rootless.yaml。

远程访问安全三原则：

1. ❌ 不要把 3001 端口直接映射到公网——Web UI 内含完整 Shell，一个泄露的密码 = 别人免费用你的 Claude
2. ✅ 用 Tailscale（个人/小团队）或 Cloudflare Tunnel（公网域名 + SSO）这类隧道方案
3. ✅ 需要直达终端时，可启用内置 SSH/Mosh（默认关闭，仅密钥登录）

完整安全说明见 docs/configuration.md。

❓ 新手常见问题

Q1：slim 镜像少装了工具，Claude 会卡住吗？不会。缺什么它装什么，npm/pip 包几秒搞定。slim 适合小 VPS、低磁盘、按流量计费的场景。

Q2：容器里权限模式是什么？默认acceptEdits：可读可写文件，执行命令遵循 Claude Code 权限提示。高级用户可编辑宿主机上的./data/claude/settings.json改为bypassPermissions（免确认执行，请只在可信工作区使用）。

Q3：浏览器标签页崩溃、白屏？确认 Compose 里有shm_size: 2g，重负载场景调至4g。

Q4：想让任务完成时通知我？设置NOTIFY_DISCORD/NOTIFY_TELEGRAM等 Apprise 变量（支持 100+ 服务），并在容器内touch ~/.claude/notify-on。未配置时完全静默，零开销。

更多问题排查见 docs/troubleshooting.md。

📚 延伸阅读

• 架构详解：docs/architecture.md
• 配置参考：docs/configuration.md
• 默认 Claude 设置：config/settings.json
• 容器入口逻辑：scripts/entrypoint.sh
• 版本记录：docs/CHANGELOG.md

想自己构建镜像？clone 仓库https://gitcode.com/gh_mirrors/ho/HolyClaude后执行docker build -t holyclaude .即可。

🔥一句话总结：你本来要花 2 小时手动搭建的东西，现在docker compose up一下就有了。把维护环境的时间省下来，去写代码吧。

【免费下载链接】HolyClaudeAI coding workstation: Claude Code + web UI + 8 AI CLIs + headless browser + 50+ tools项目地址: https://gitcode.com/gh_mirrors/ho/HolyClaude