HolyClaude AI工作站一键部署教程：开箱即用的容器化开发环境

通过一条命令即可消除手动配置的繁杂步骤，快速搭建起一套功能完整的AI开发工作站。该方案集成了Claude Code、Web用户界面、无头浏览器、七个AI命令行工具以及超过五十种开发工具，所有组件均已实现容器化封装，核心优势在于提供即开即用的便捷体验。

Image

HolyClaude项目旨在简化AI工作站的部署流程。它通过一条指令封装了复杂的配置过程，让开发者能够迅速获得一个完备的AI开发环境。该环境不仅包含了Claude Code等核心AI编程助手，还提供了直观的Web操作界面、用于自动化测试的无头浏览器、多款高效的AI命令行工具以及涵盖开发全流程的各类实用工具，所有功能均运行在容器中，确保环境的一致性与隔离性，真正实现了开箱即用。

Image

目前支持的AI服务提供商包括：

  • Claude Code
  • Cursor
  • OpenAI Codex
  • Gemini

安装步骤详解

本项目推荐使用Docker Compose进行部署。以下是一个基础的docker-compose.yml配置文件示例：

services:
  holyclaude:
    image: coderluii/holyclaude:latest
    container_name: holyclaude
    shm_size: 2g
    ports:
      - 3001:3001
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./claude:/home/claude/.claude
      - ./workspace:/workspace
    restart: unless-stopped

关键配置参数说明（更详细的参数建议查阅官方文档）：

  • shm_size（共享内存）：由于集成了Chromium浏览器内核，建议至少分配2GB共享内存，以避免运行时出现随机崩溃的问题。
  • 3001（端口映射）：此端口用于通过浏览器访问HolyClaude的Web用户界面。
  • TZ（时区设置）：用于配置容器内部系统时区，确保时间显示正确。
  • /home/claude/.claude（卷挂载路径）：此目录用于持久化保存用户配置、身份凭证以及API密钥等重要信息。
  • /workspace（卷挂载路径）：此目录作为工作空间，用于存放所有的项目代码和开发文件。

使用流程与界面介绍

容器启动后，在浏览器地址栏输入 http://你的服务器IP地址:3001 即可访问HolyClaude的主界面。

Image

首次访问时，系统会引导你设置用户名和密码，以创建初始的管理员账户。

Image

接下来需要配置Git工具的个人信息，这部分信息将用于管理本地代码仓库。如果暂时不清楚具体用途，保持默认设置直接进入下一步即可。

Image

由于演示环境未绑定实际账号，此处跳过登录步骤。

Image

成功进入后，你将看到主编辑器面板。界面左下角是全局设置按钮。

Image

为了获得更清晰的截图展示效果，此处将界面主题切换为深色模式。

Image

首先，建议在设置中将界面语言更改为中文，以方便操作。

Image

你可以在此处登录自己已有的AI服务提供商账户。需要注意的是，当前界面可能不支持直接设置第三方的自定义API基础地址（BASE URL）。

Image

系统支持用户根据需求安装自定义插件以扩展功能。

Image

返回主面板，点击左上角的菜单可以开始创建新项目。

Image

根据实际需要选择项目类型，本示例将演示如何新建一个空白项目。

Image

如果不确定项目路径该如何填写，可以点击输入框旁边的文件夹图标，通过图形化界面浏览并选择目录。

Image

此处，我们创建了一个名为“test1”的新文件夹，作为新项目的存储位置。

Image

点击“下一步”按钮继续项目创建流程。

Image

确认信息无误后，点击“创建项目”按钮完成初始化。

Image

提示： 在之前Docker Compose配置中映射的/workspace工作路径下，同样可以看到刚刚创建的test1项目目录。

Image

项目创建完成后，就可以开始选择AI助手（Agents），并利用它们来构建你的具体应用了。

Image

不同的AI服务提供商会显示其对应的可用模型列表。不过，目前界面似乎不支持用户手动输入或自定义指定特定的模型标识。

Image

对于某些深度适配的厂商，界面还会提供一些特有的功能选项。

Image

项目总结与评价

总体而言，HolyClaude项目在功能集成和易用性方面表现出色，提供了一个看起来相当完善的容器化AI开发解决方案。然而，对于中国大陆地区的用户而言，其使用存在一定的门槛。起初，我们期望能够通过环境变量配置，将默认的Claude Code服务切换为国内可访问的其他提供商。虽然环境变量修改生效，但界面中如何同步切换对应的可用模型尚不明确，因此未能完全体验其核心功能。对于已经拥有国外主流AI厂商模型账号的用户，可以尝试部署并使用。

综合推荐指数：⭐⭐⭐（建议已拥有相关账号的用户部署） 使用体验评价：⭐⭐⭐（功能全面，但对国内用户适配不足） 部署难易程度：⭐⭐（流程简单，易于上手）