Repolode
CoderLuii

CoderLuii/HolyClaude

一个 Docker 容器,集成 Claude Code、Web 界面、无头浏览器、多种 AI 编程 CLI 和 50 多种开发工具。

Star
2,590
Fork
271
未关闭 Issue
4
最近提交
7天前

这是什么?

HolyClaude 是一个容器化的 AI 开发工作站。它把 Anthropic 的 Claude Code CLI、基于浏览器的 Web 界面(CloudCLI)、配有 Xvfb 和 Playwright 的无头 Chromium,以及大量语言运行时、命令行工具和开发工具打包在一起,只需一条 docker compose 命令即可启动,无需逐个手动安装。

容器内运行的是官方 Claude Code CLI,可以通过 Web 界面使用 Claude Max 或 Pro 订阅登录,也可以填入 Anthropic API Key。其他内置的 AI 命令行工具包括 Gemini CLI、OpenAI Codex、Cursor 和 TaskMaster AI;完整镜像还额外包含 Junie、OpenCode 和 Pi。凭据和工作区文件保存在挂载的宿主机目录中,重建容器后依然保留。

项目提供完整版和精简版两种镜像,完整版预装全部工具,精简版只保留核心工具。镜像支持 AMD64 和 ARM64 架构,并提供 Docker Compose 模板、可选的 SSH/Mosh 远程访问、基于 Apprise 的通知,以及作为替代模型后端的 Ollama 配置。

核心功能

  • 01运行官方 Claude Code CLI,支持通过 Claude 订阅或 API Key 在 Web 界面登录
  • 02内置 Gemini CLI、OpenAI Codex、Cursor、TaskMaster AI,完整镜像另含 Junie、OpenCode 和 Pi
  • 03预配置 Xvfb 与 Playwright 的无头 Chromium,可用于截图和浏览器测试
  • 04预装 Node.js、Python、git、gh、数据库客户端等 50 多种开发工具
  • 05通过宿主机挂载目录在重建容器后保留设置和工作区
  • 06提供 AMD64 和 ARM64 镜像,分完整版与精简版

适用场景

  • 在家庭服务器或 NAS 上运行 Claude Code 等 AI 编程代理,无需本地配置
  • 为 AI 代理提供带浏览器的隔离 Linux 环境,用于端到端测试
  • 借助 Docker Compose 在多台机器上统一开发环境
  • 在同一环境中并排比较多个 AI 编程 CLI 的输出

快速上手

  1. 1

    为 HolyClaude 创建一个文件夹

    mkdir holyclaude && cd holyclaude
  2. 2

    使用 README 中的模板创建 docker-compose.yaml 文件

  3. 3

    拉取并启动容器

    docker compose up -d
  4. 4

    在 localhost:3001 打开网页界面并登录

使用前须知

  • 需要 Docker,并拥有 Claude 订阅或 Anthropic API 密钥才能使用 Claude Code。
  • 完整镜像体积较大,因为它打包了大量工具和浏览器。
  • 在某些主机上,权限、共享内存和挂载仍可能需要手动调整。

收录于专题

标签

常见问题

HolyClaude 是什么?
一个 Docker 容器,集成 Claude Code、Web 界面、无头浏览器、多种 AI 编程 CLI 和 50 多种开发工具。 HolyClaude 是一个容器化的 AI 开发工作站。它把 Anthropic 的 Claude Code CLI、基于浏览器的 Web 界面(CloudCLI)、配有 Xvfb 和 Playwright 的无头 Chromium,以及大量语言运行时、命令行工具和开发工具打包在一起,只需一条 docker compose 命令即可启动,无需逐个手动安装。
HolyClaude 可以免费使用吗?用的什么许可证?
HolyClaude 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
HolyClaude 还在维护吗?
活跃维护中。HolyClaude 最近一次提交是在 2026年10月18日。
HolyClaude 适合用来做什么?
在家庭服务器或 NAS 上运行 Claude Code 等 AI 编程代理,无需本地配置 为 AI 代理提供带浏览器的隔离 Linux 环境,用于端到端测试 借助 Docker Compose 在多台机器上统一开发环境 在同一环境中并排比较多个 AI 编程 CLI 的输出
HolyClaude 怎么安装和运行?
为 HolyClaude 创建一个文件夹: mkdir holyclaude && cd holyclaude 使用 README 中的模板创建 docker-compose.yaml 文件 拉取并启动容器: docker compose up -d 在 localhost:3001 打开网页界面并登录
在哪里获取 HolyClaude?
源代码和安装说明在 GitHub 上:https://github.com/CoderLuii/HolyClaude

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目