HolyClaude

HolyClaude 是一个预配置的 Docker 开发环境，集成 Claude Code CLI、Web 界面、7 个 AI 工具和 50+ 开发工具，一条命令即可启动完整的 AI 编码 Agent 工作环境。 ## 快速开始 1. 确保本地已安装 Docker 和 Docker Compose，运行 Docker version 26.1.3, build b72abbb 确认。 2. 克隆 HolyClaude 仓库： 并进入目录。 3. 配置环境变量：复制 为 ，填入你的 Anthropic API 密钥（必填），以及可选的其他 AI 服务密钥。 4. 一条命令启动：运行 ，等待镜像拉取和容器初始化完成（首次约 5-10 分钟），即可通过浏览器访问 Web 界面。 ## 核心功能演示 **功能一：Claude Code CLI 集成** 在终端中执行 即可进入 Claude Code 命令行界面。你可以像在本地一样使用 Claude Code 的所有功能：代码编写、调试、重构、代码审查等。所有常用开发工具（git、node、python、go 等）已预装就绪，无需额外配置。 **功能二：CloudCLI Web 界面** 启动后访问 打开 CloudCLI Web 界面。这是一个可视化的操作面板，支持文件浏览、终端操作、AI 对话等功能。适合不习惯命令行的开发者，或需要同时查看多个终端会话的场景。界面内置了代码编辑器，支持语法高亮和自动补全。 **功能三：多 AI 工具切换** HolyClaude 预装了 7 个 AI 命令行工具，包括不同厂商的 AI 助手。通过 命令快速切换。每个工具的配置已预置完成，你可以根据不同任务选择最合适的 AI 工具，比如用 Claude 处理复杂推理，用其他工具处理特定领域的任务。 ## 实际使用案例 **场景一：新项目快速开发** 自由开发者小林接了一个紧急的 Web 项目，只有三天时间。他不想花半天配置开发环境，直接用 HolyClaude 一条命令启动。容器中已经包含 Node.js、Python、PostgreSQL 客户端、Redis 等常用工具。他通过 Claude Code 快速生成项目骨架，用 Web 界面实时预览，三天内顺利交付了项目。 **场景二：团队统一开发环境** 一个 5 人的远程开发团队经常遇到 在我机器上能跑 的问题。他们将 HolyClaude 作为标准开发环境，所有人的工具版本、配置完全一致。新人入职时只需安装 Docker，一条命令就能获得和老成员完全相同的开发环境，入职第一天就能提交代码。 ## 常见问题 FAQ **Q1：对电脑配置要求高吗？** 建议至少 8GB 内存和 20GB 可用磁盘空间。CPU 核心数越多体验越好，因为容器内会同时运行多个服务。Mac（Intel/Apple Silicon）、Windows（WSL2）和 Linux 均支持。 **Q2：如何把本地代码导入容器？** 最简单的方式是通过 volume 映射。在 中将本地目录挂载到容器内，如 ，修改后重启容器即可。也可以用 命令临时拷贝文件。 **Q3：API 密钥安全吗？** 密钥通过环境变量注入容器，不会写入镜像或日志。 文件已被加入 ，不会被意外提交。团队使用时建议通过 Docker secrets 或外部密钥管理服务注入，避免在配置文件中明文存储。 ## 小贴士 1. 资源限制配置：在 中添加 配置，防止容器占用过多系统资源。建议限制 CPU 和内存使用量，特别是同时运行其他应用时。 2. 数据持久化：将 和 目录挂载为持久卷，容器重建时不会丢失代码和配置。定期备份这些卷是个好习惯。 3. 快速重建环境：更新 HolyClaude 时运行 ，新版本自动拉取，配置和代码数据不受影响，升级无缝衔接。