开源的AI编程工作站HolyClaude
简介
什么是 HolyClaude ？
HolyClaude是一款基于Docker的AI编程工作站，一条命令即可部署完整的AI开发环境。它将Claude Code CLI、Web UI、7个AI CLI工具、无头浏览器和50+开发工具打包在一个Docker容器中，开箱即用。
主要特点
-
一条命令部署：无需手动配置，
docker compose up -d即可启动完整的AI开发工作站 -
集成 Claude Code：运行的是官方
Claude Code CLI，不是代理或仿制品，支持现有的Claude Max/Pro订阅或API Key -
7 个 AI CLI 工具：内置
Claude Code、Gemini CLI、OpenAI Codex、Cursor、TaskMaster AI、Junie、OpenCode，一键切换 -
无头浏览器：预配置
Chromium + Xvfb + Playwright，支持截图、自动化测试和Lighthouse性能审计 -
50+ 开发工具：
Node.js 22 LTS、Python 3、Git、GitHub CLI、数据库客户端、格式化工具等一应俱全 -
进程管理：使用
s6-overlay作为PID 1，自动重启、优雅关闭、僵尸进程回收 -
多架构支持：支持
amd64和arm64，可在Linux、macOS、Windows WSL2、群晖/QNAP NAS上运行 -
双镜像选择：提供
latest（完整版）和slim（精简版）两种镜像，满足不同场景需求 -
开源免费：基于
MIT协议开源，可免费使用和修改
应用场景
-
AI 辅助编程：使用
Claude Code等AI工具进行代码编写、调试和重构 -
多模型对比开发：同时使用多个
AI CLI工具，对比不同模型的输出效果 -
自动化测试：利用内置的
Playwright和Chromium进行浏览器自动化测试和截图 -
快速原型开发：开箱即用的开发环境，无需花费数小时配置工具链
-
NAS 开发工作站：在群晖等
NAS上部署，随时随地通过Web界面进行AI编程
HolyClaude 是一个解决 AI 开发环境配置痛点的容器化方案，让你把时间花在写代码上，而不是配环境上。
安装
在群晖上以 Docker 方式安装。
在注册表中搜索 holyclaude，选择第一个 coderluii/holyclaude，版本选择 latest。
本文写作时，
latest版本对应为1.1.8版，而不是1.1.9；
镜像有点大，将近 11G
卷
在 docker 文件夹中，创建一个新文件夹 holyclaude，并在其中建两个子文件夹 data 和 workspace
docker/holyclaude/data /home/claude 存放设置、凭证、API Key 和 Claude 记忆等
docker/holyclaude/workspace /workspace 存放代码和项目文件
端口
本地端口不冲突就行，不确定的话可以用命令查一下
# 查看端口占用
netstat -tunlp | grep 端口号3506 3001
默认没有对外暴露端口
需要点 + 号自习添加
环境
TZ 时区，如 Asia/Shanghai
环境变量说明：
TZ用于设置容器时区，建议设置为Asia/Shanghai。其他环境变量如PUID、PGID、NODE_OPTIONS等均为可选，默认值已足够日常使用。
docker cli 安装
# 新建文件夹 holyclaude 和 子目录
mkdir -p /volume1/docker/holyclaude/{data,workspace}
# 进入 holyclaude 目录
cd /volume1/docker/holyclaude
# 运行容器
docker run -d \
--name=holyclaude \
--restart=unless-stopped \
-p 3506:3001 \
--shm-size=2g \
--cap-add=SYS_ADMIN \
--cap-add=SYS_PTRACE \
--security-opt seccomp=unconfined \
-v $(pwd)/data:/home/claude \
-v $(pwd)/workspace:/workspace \
-e TZ=Asia/Shanghai \
coderluii/holyclaude:latestdocker-compose 安装
将下面的内容保存为 docker-compose.yml 文件：
version: '3.8'
services:
holyclaude:
image: coderluii/holyclaude:latest # 完整镜像（使用 :slim 可下载更小的精简版）
container_name: holyclaude
hostname: holyclaude
restart: unless-stopped
shm_size: 2g # Chromium 需要，不要删除
network_mode: bridge
cap_add:
- SYS_ADMIN # 必需：Chromium 沙箱
- SYS_PTRACE # 必需：调试工具
security_opt:
- seccomp=unconfined # 必需：Docker 中运行 Chromium
ports:
- "3506:3001" # CloudCLI Web UI
volumes:
- ./data:/home/claude # 设置、凭证、API Key
- ./workspace:/workspace # 代码和项目文件
environment:
- TZ=Asia/Shanghai # 时区然后通过 SSH 登录到您的群晖，执行下面的命令：
# 新建文件夹 holyclaude 和 子目录
mkdir -p /volume1/docker/holyclaude/{data,workspace}
# 进入 holyclaude 目录
cd /volume1/docker/holyclaude
# 将 docker-compose.yml 放入当前目录
# 一键启动
docker-compose up -d
运行
在浏览器中访问 http://<群晖IP>:3506 即可进入 Web 界面
首次使用需要创建账号
设置 Git 名称和邮箱，没有的话可以点 Next 跳过
使用账号登录（OAuth 认证）或输入 API Key
提示：如果你已有
Claude Max/Pro订阅，直接通过Web UI的OAuth登录即可，无需额外付费。使用API Key的用户按Anthropic的计费规则付费。
设置好工作目录后
就可以开始编程了
注意事项
-
共享内存设置：
shm_size: 2g是必需的，Docker默认只有64MB，会导致Chromium标签页随机崩溃。重度浏览器使用可增加到4g。 -
权限配置：如果遇到文件权限问题，在环境中添加
PUID和PGID，值与宿主机用户一致（运行id -u和id -g查看）。 -
NAS 网络共享：如果工作目录在
SMB/CIFS网络共享上，需要启用CHOKIDAR_USEPOLLING=1和WATCHFILES_FORCE_POLLING=true以支持文件监听。 -
数据持久化：
./data目录存放所有凭证和设置，切勿删除整个目录。如需重新初始化，只需删除./data/.claude/.holyclaude-bootstrapped文件后重启容器。 -
安全建议：默认运行在
allowEdits模式，执行shell命令前会询问。信任环境后可在./data/.claude/settings.json中设置为bypassPermissions。 -
更新方式：运行
docker compose pull && docker compose up -d即可更新，数据不会丢失。 -
SQLite 限制：
SQLite数据库不建议放在网络共享上，CIFS不支持SQLite所需的文件级锁。
参考文档
CoderLuii/HolyClaude: AI coding workstation: Claude Code + web UI + 7 AI CLIs + headless browser + 50+ tools 地址：https://github.com/CoderLuii/HolyClaude
coderluii/holyclaude - Docker 镜像 | Docker Hub 地址：https://hub.docker.com/r/coderluii/holyclaude
HolyClaude 官方网站 地址：https://holyclaude.coderluii.dev
@所有人：写文不易，如果你都看到了这里，请点个赞和在看，分享给更多的朋友；为确保你能收到每一篇文章，请主页右上角设置星标。