🌍 English | Español | Français | Italiano | Português | Deutsch | Русский | हिन्दी | 中文 | 日本語 | 한국어

HolyClaude

停止配置，开始构建。

一条命令。完整的 AI 开发工作站。Claude Code、Web UI、无头浏览器、7 个 AI CLI、50 多种开发工具——全部容器化并随时可用。

你本来要花 2 小时手动设置这些。或者你只需运行 docker compose up。

与你现有的 Claude Code 订阅兼容。 Max/Pro 方案、API 密钥——无论你有什么，它都能正常工作。

这是什么？

你懂的。你想用 Claude Code。但你也想在浏览器中使用它。还要有用于截图和测试的无头浏览器，配置好的 Playwright，所有的 AI CLI，以及 TypeScript、Python、部署工具、数据库客户端、GitHub CLI 等等。

于是你开始逐一安装这些工具。结果 Chromium 因为 Docker 的共享内存只有 64MB 而无法启动。接着 Xvfb 又没配置好。然后容器内的 UID 和宿主机不匹配，导致权限被拒绝。后来你发现当 WORKDIR 归 root 所有时，Claude Code 的安装程序会卡住。再后来，SQLite 在你的 NAS 挂载上锁了……就这样周而复始。

HolyClaude 就是我解决所有这些问题后构建出来的容器镜像。

我已经在我的服务器上每天运行它好几个星期了。每一个 bug 都被发现、诊断并修复；每一个边缘情况都被妥善处理；每一个“为什么在 Docker 中不起作用”的问题都得到了解答。

你只需要拉取这个镜像，运行它，打开浏览器，就可以开始构建了。

:credit_card: 使用你现有的订阅

这里运行的是真正的 Claude Code CLI。 不是封装器，不是代理，也不是山寨版。

你现有的 Anthropic 账户可以直接使用：

• Claude Max/Pro 方案 — 通过 Web UI（OAuth）进行认证，与桌面版 Claude Code 相同
• Anthropic API 密钥 — 通过 Web UI 设置，计费方式与平时一致
• 无需额外费用 — HolyClaude 是免费且开源的。你只需按照现有方式向 Anthropic 支付实际使用的费用。

HolyClaude 不会接触你的凭据。它们会被存储在本地的绑定挂载卷中（./data/claude/），就像你在物理机上一样。

↑ 返回顶部

目录

↑ 返回顶部

:zap: 快速入门

1. 为 HolyClaude 创建一个文件夹：

mkdir holyclaude && cd holyclaude

2. 创建一个 docker-compose.yaml 文件。复制以下模板之一：

• 快速模板 — 极简，无需配置，即开即用
• 完整模板 — 包含所有选项，文档齐全

3. 拉取并启动：

docker compose up -d

4. 打开 Web 界面：

http://localhost:3001

5. 创建一个 CloudCLI 账号（耗时约 10 秒），使用您的 Anthropic 账号登录，即可开始使用。

无需 .env 文件。无需预先配置。无需在开始之前阅读 40 页的文档。它就能直接运行。

↑ 返回顶部

:computer: 平台支持

↑ 返回顶部

:star2: 为什么选择 HolyClaude

我构建这个项目是因为厌倦了每次都要重复同样的设置。安装 Claude Code、搭建 Web 界面、在 Docker 中配置 Chromium、解决权限问题、调试进程管理等，每次都得重新来一遍。

于是我就做了一个容器，把这些都搞定。我还把可能遇到的所有问题都提前解决了，这样您就不用再操心了。

**每次手动搭建的最后一句话都是：“在我的机器上可以运行。”**而 HolyClaude 在任何机器上都能正常工作。

↑ 返回顶部

:credit_card: 订阅与认证

HolyClaude 运行的是 Anthropic 官方的 Claude Code CLI。您现有的账户可以直接使用。

支持的功能：

不支持的功能：

ChatGPT Plus/Pro 订阅用户： 您的订阅适用于 Codex CLI。在容器内运行 codex login --device-auth 即可使用 ChatGPT 账号进行认证。

其他包含的 AI CLI 工具：

HolyClaude 是免费且开源的。 您只需为使用的 AI 服务付费，这与您平时的支付方式相同。我们不会代理、拦截或接触您的凭据。它们会保存在您本地的绑定挂载目录中。

↑ 返回顶部

:package: 镜像版本

两种镜像，质量相同。根据需求选择适合的重量级版本。

# 完整版 — 一切尽在掌握（推荐）
docker pull coderluii/holyclaude

# 精简版 — 简洁高效
docker pull coderluii/holyclaude:slim

latest 始终是完整版镜像。 对于使用 slim 版本的用户，请放心——当您让 Claude 执行需要某个缺失工具的任务时，它会在几秒钟内自动安装该工具。您将获得相同的功能，只是初始下载的体积更小。

↑ 返回顶部

:whale: Docker Compose — 快速版

“只想让它跑起来”的模板。将整个代码块复制到 docker-compose.yaml 文件中：

# ==============================================================================
# HolyClaude — 快速入门
# 直接运行：docker compose up -d
# 然后打开：http://localhost:3001

# ==============================================================================

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:
      - "3001:3001"                        # CloudCLI Web 界面
    volumes:
      #
      # ./data/claude — 您的设置、凭据、API 密钥以及 Claude 的记忆数据。
      #                  这些内容会在容器重建后依然保留。
      #                  切勿删除此文件夹——您的认证信息都存储在这里。
      #
      - ./data/claude:/home/claude/.claude
      #
      # ./workspace — 您的代码。所有项目都放在此处。
      #               绑定挂载，以便您从宿主机访问文件。
      #
      - ./workspace:/workspace
    environment:
      - TZ=UTC                             # 您的时区（例如，America/New_York、Europe/London）

然后：

docker compose up -d

打开 http://localhost:3001。创建一个 CloudCLI 账户。使用您的 Anthropic 账户登录。开始构建吧。

这就是全部的设置步骤。完成了！

为什么需要 SYS_ADMIN + seccomp=unconfined？ Chromium 在 Docker 容器内运行时需要这些权限——这是任何容器化浏览器的标准配置（Playwright 文档、Puppeteer 文档以及所有运行浏览器测试的 CI 流程）。如果没有它们，Chromium 启动时会崩溃。这并不是 HolyClaude 特有的安全风险。

为什么需要 shm_size: 2g？ 默认情况下，Docker 为容器分配 64MB 的共享内存。Chromium 会大量使用 /dev/shm 来渲染标签页。如果只有 64MB，标签页会频繁崩溃。对于在 Docker 中运行 Chromium 的场景，推荐至少设置为 2GB。

↑ 返回顶部

:whale2: Docker Compose — 完整版

相同的镜像，所有配置选项一应俱全。将以下完整内容复制到 docker-compose.yaml 文件中：

# ==============================================================================
# HolyClaude — 完整配置
# 所有选项均在注释中说明。
# 详细文档：https://github.com/CoderLuii/HolyClaude/blob/main/docs/configuration.md
# ==============================================================================

services:
  holyclaude:
    image: coderluii/holyclaude:latest     # 完整镜像（若需较小下载量，请使用 :slim）
    container_name: holyclaude
    hostname: holyclaude
    restart: unless-stopped
    shm_size: 2g                           # Chromium 共享内存——重度浏览器使用时可调至 4g
    network_mode: bridge
    cap_add:
      - SYS_ADMIN                          # 必需：Chromium 沙箱机制
      - SYS_PTRACE                         # 必需：调试工具（strace、lsof）
    security_opt:
      - seccomp=unconfined                 # 必需：Chromium 对系统调用的要求
    ports:
      #
      # CloudCLI Web 界面——这是您唯一需要的端口。
      # 如果 3001 端口已被占用，可通过 `.env` 文件覆盖主机侧端口。
      #
      - "${HOLYCLAUDE_HOST_PORT:-3001}:3001"
      #
      # 开发服务器端口——根据需要取消注释。
      # 这些端口允许您通过宿主机浏览器访问容器内运行的开发服务器。
      #
      # - "3000:3000"                      # Next.js / Express
      # - "4321:4321"                      # Astro
      # - "5173:5173"                      # Vite
      # - "8787:8787"                      # Wrangler（Cloudflare Workers）
      # - "9229:9229"                      # Node.js 调试器
    volumes:
      #
      # 持久化数据
      #
      # ./data/claude — 设置、凭据、API 密钥以及 Claude 的记忆文件。
      #                  即使容器重建，这些数据也会保留。切勿删除此文件夹。
      #                  如需更改路径，可通过 `.env` 文件覆盖主机路径。
      #
      - ${HOLYCLAUDE_HOST_CLAUDE_DIR:-./data/claude}:/home/claude/.claude
      #
      # ./workspace — 您的代码和项目。您所构建的一切都存放于此。
      #               可从宿主机访问。
      #               如需不同根目录，可通过 `.env` 文件覆盖主机路径。
      #
      - ${HOLYCLAUDE_HOST_WORKSPACE_DIR:-./workspace}:/workspace
    environment:
      #
      # 时区
      # 完整列表：https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
      #
      - TZ=UTC
      #
      # 性能
      # Node.js 堆内存限制（单位：MB）。如果您处理大型 monorepo 并遇到内存不足错误，可以适当提高此值。4096 MB（4GB）是一个稳妥的默认值。
      #
      - NODE_OPTIONS=--max-old-space-size=4096
      #
      # 用户映射
      # 将这些值与宿主机用户匹配，以确保容器内创建的文件在宿主机上拥有正确的所有权。可在宿主机上运行 `id -u` 和 `id -g` 获取相应数值。
      #
      - PUID=1000
      - PGID=1000
      #
      # SMB/CIFS 网络挂载
      # 仅当您的卷位于 NAS、Samba 共享或 CIFS 挂载上时才启用。
      # 它们通过轮询方式实现文件监控，因为网络挂载不支持 inotify。本地存储则保持注释状态——轮询会消耗更多 CPU。
      #
      # - CHOKIDAR_USEPOLLING=1
      # - WATCHFILES_FORCE_POLLING=true
      #
      # 通知功能（可选）
      # 当 Claude 完成任务或发生错误时接收通知。
      # 使用 Apprise——支持 100 多种服务。此外，还需在容器内创建一个标记文件：touch ~/.claude/notify-on。
      #
      # - NOTIFY_DISCORD=discord://webhook_id/webhook_token
      # - NOTIFY_TELEGRAM=tg://bot_token/chat_id
      # - NOTIFY_PUSHOVER=pover://user_key@app_token
      # - NOTIFY_SLACK=slack://token_a/token_b/token_c
      # - NOTIFY_EMAIL=mailto://user:pass@gmail.com?to=you@gmail.com
      # - NOTIFY_GOTIFY=gotify://hostname/token
      # - NOTIFY_URLS=                                   # 通用配置：逗号分隔的 Apprise URL 列表
      #
      # AI 提供商密钥（可选）
      • CLAUDE Code 可通过 Web UI（OAuth）或 ANTHROPIC_API_KEY 进行认证。
      • 如需使用其他 AI CLI 或基于 API 的认证，请设置以下参数。
      #
      # - GEMINI_API_KEY=your_key
      # - OPENAI_API_KEY=your_key
      # - CURSOR_API_KEY=your_key

然后：

docker compose up -d

如果您想在不修改 docker-compose.yaml 的情况下更改主机侧端口或绑定挂载路径，可以将 .env.example 复制到 .env 文件中，并设置：

HOLYCLAUDE_HOST_PORT=3003
HOLYCLAUDE_HOST_CLAUDE_DIR=./data/claude
HOLYCLAUDE_HOST_WORKSPACE_DIR=./workspace

这些值由 Docker Compose 在宿主机上读取，而非容器内的环境变量。

各部分的功能说明：

每个环境变量都是可选的。 容器仅需设置 TZ=UTC 即可完美运行。其余配置都有合理的默认值，或可通过 Web 界面进行管理。

↑ 返回顶部

:wrench: 环境变量

完整参考。每个变量的默认值及其作用。

↑ 返回顶部

:rocket: 容器内部包含的内容

这不是一个极简容器。它是一个完整的开发工作站。

两种版本（完整版 + 精简版）

仅完整镜像（附加包）

完整镜像包含以上所有内容，此外还包括：

精简用户： 缺少某个包？问问 Claude 吧。它可以在几秒钟内安装 npm/pip 包。系统包（pandoc、ffmpeg）则需要 1-2 分钟。你仍然可以获得相同的功能——只是完整镜像无需等待。

↑ 返回顶部

:robot: AI CLI 提供者

七个 AI CLI。一个容器。没有其他 Docker 镜像能提供这样的组合。

Claude Code 是主要的 CLI。其他 CLI 的存在是因为有时你需要第二意见，或者想要特定模型的优势，又或是比较不同模型的输出。将所有这些 CLI 放在一个 Tab 键的距离内，正是这个镜像的意义所在。

↑ 返回顶部

:llama: 使用 Ollama

HolyClaude 可以与 Ollama 配合使用，作为 Anthropic 订阅的替代方案。只需设置两个环境变量，即可使用本地或云端模型。

完整设置指南请参见：docs/ollama.md

↑ 返回顶部

:building_construction: 架构

graph TB
    subgraph Docker 容器
        EP["entrypoint.sh"] --> BS["bootstrap.sh\n(仅首次启动)"]
        EP --> S6["s6-overlay\n(PID 1)"]
        S6 --> CC["CloudCLI\n(:3001)"]
        S6 --> XV["Xvfb\n(:99)"]
        CC --> CLAUDE["Claude Code CLI"]
        CLAUDE --> TOOLS["开发工具\n(Node、Python、Git...)"]
        CLAUDE --> CHROME["Chromium\n(无头模式)"]
        XV -.-> CHROME
    end

    subgraph 主机
        DATA["./data/claude"] -.->|绑定挂载| HOME["~/.claude"]
        WS["./workspace"] -.->|绑定挂载| WORK["/workspace"]
    end

    USER["浏览器"] -->|":3001"| CC

    style S6 fill:#2d3748,color:#fff
    style CC fill:#6366f1,color:#fff
    style CLAUDE fill:#f59e0b,color:#000

各部分如何协同工作

1. 容器启动 — entrypoint.sh 以 root 用户运行。将 UID/GID 映射为与主机用户一致，预先创建所需文件（防止 Docker 的“将其创建为目录”错误），并检查是否为首次启动。

2. 仅首次启动 — bootstrap.sh 只运行一次。复制默认设置、内存模板，并配置 Git 用户身份。创建一个标记文件（.holyclaude-bootstrapped），确保它不再运行。从那时起，你的自定义设置将被安全保存。

3. s6-overlay 接管 PID 1 — 这不是 supervisord。它是专为 Docker 设计的 s6-overlay，负责监督 CloudCLI 和 Xvfb。在崩溃时自动重启，转发信号，清理僵尸进程，并优雅地关闭。

4. CloudCLI 提供 Web UI — 监听 3001 端口。这是一个基于浏览器的界面，用于访问 Claude Code，支持项目管理、多会话以及插件功能（包括项目统计和 Web 终端）。

5. Xvfb 提供虚拟显示 — Chromium 即使在“无头”模式下也需要屏幕来渲染内容。Xvfb 提供了一个 1920x1080 的虚拟显示器，地址为 :99。这就是为什么 Playwright、截图和 Lighthouse 等工具可以直接使用的原因。

更多技术细节，请参阅 docs/architecture.md — 包括我们为何选择 s6 而不是 supervisord、为何将插件直接打包进镜像，以及为何使用 runuser 而不是 su。

↑ 返回顶部

:file_folder: 项目结构

holyclaude/
├── .github/                 # CI/CD 工作流、问题与 PR 模板
│   ├── FUNDING.yml          # 赞助/捐赠链接
│   ├── ISSUE_TEMPLATE/      # Bug 报告、功能请求、软件包请求
│   ├── pull_request_template.md
│   ├── SECURITY.md          # 安全策略
│   └── workflows/           # Docker 构建与推送自动化
├── assets/                  # Logo 和横幅图片
├── config/                  # Claude Code 配置
│   ├── claude-memory-full.md
│   ├── claude-memory-slim.md
│   └── settings.json
├── docs/                    # 扩展文档
│   ├── architecture.md
│   ├── CHANGELOG.md
│   ├── configuration.md
│   ├── dockerhub-description.md
│   ├── ollama.md
│   └── troubleshooting.md
├── scripts/                 # 容器生命周期脚本
│   ├── bootstrap.sh         # 首次运行设置
│   ├── entrypoint.sh        # 容器入口点
│   └── notify.py            # 通知助手 (Apprise)
├── s6-overlay/              # 进程监督 (s6-rc 服务)
├── Dockerfile               # 单阶段构建
├── docker-compose.yaml      # 快速启动 (最小配置)
├── docker-compose.full.yaml # 完整配置 (所有选项)
├── LICENSE
└── README.md

↑ 返回顶部

:floppy_disk: 数据与持久化

在执行 docker compose down && docker compose up 后仍然保留的内容：

• 你的 Anthropic 认证信息和 API 密钥
• Claude Code 的设置和记忆 (CLAUDE.md)
• ./workspace 中的所有代码
• Git 配置

需要重新操作的内容（10 秒钟）：

• CloudCLI 网页账户 — 快速注册即可

重新触发首次引导设置：

# 删除哨兵文件 — 不要删除整个文件夹
rm ./data/claude/.holyclaude-bootstrapped
docker compose restart holyclaude

切勿完全删除 ./data/claude/。 你的凭据就存放在那里。如果你想进行全新引导，可以删除哨兵文件。如果想重置设置，可以删除特定的配置文件。但千万不要清空整个文件夹。

↑ 返回顶部

:lock: 权限

Claude Code 默认以 allowEdits 模式运行。这是最安全且实用的设置：

想完全绕过权限吗？（高级用户）

这是我个人使用的模式。在主机上编辑 ./data/claude/settings.json：

{
  "permissions": {
    "defaultMode": "bypassPermissions"
  }
}

绕过模式意味着 Claude 会在无需确认的情况下执行任何命令。 速度快、功能强大，如果你信任自己正在构建的东西，这正是你需要的。但 allowEdits 成为安全默认是有原因的。

↑ 返回顶部

:bell: 通知

离开电脑时也能知道 AI 代理何时完成任务。Claude Code、Codex 和 Gemini CLI 都会在任务完成后发送通知。使用 Apprise — 支持 100 多种服务，包括 Discord、Telegram、Slack、Email、Pushover、Gotify 等。

启用方法：

1. 在你的 docker-compose 文件的 environment 中添加一个或多个 NOTIFY_* 变量：

   - NOTIFY_DISCORD=discord://webhook_id/webhook_token
   - NOTIFY_TELEGRAM=tg://bot_token/chat_id
   

2. 在容器内：touch ~/.claude/notify-on

更多支持的变量和 URL 格式，请参阅配置文档。

禁用方法： rm ~/.claude/notify-on

触发通知的事件：

如果未配置，则完全静音。没有设置 NOTIFY_* 变量？没有标记文件？零网络请求。零日志垃圾。零开销。

↑ 返回顶部

:arrows_counterclockwise: 升级

# 拉取最新镜像
docker compose pull

# 使用新镜像重新创建容器
docker compose up -d

你的数据会保存在 ./data/claude 和 ./workspace 中——升级只会替换容器，而不会影响你的文件。

如果你想锁定某个特定版本而不是使用 latest：

image: coderluii/holyclaude:1.1.2   # 替代 :latest

↑ 返回顶部

:construction: 故障排除

- CHOKIDAR_USEPOLLING=1
- WATCHFILES_FORCE_POLLING=true

Simplified Chinese:

# 在你的宿主机上
id -u  # → 这是你的 PUID
id -g  # → 这是你的 PGID

- PUID=1000
- PGID=1000

请参阅 docs/troubleshooting.md 获取完整指南，其中包含所有 SMB/CIFS 的陷阱以及我们遇到并修复的所有 bug 的详细历史。

↑ 返回顶部

:warning: 已知问题

这些并不是 HolyClaude 的 bug — 它们是上游问题或有意的权衡取舍。

↑ 返回顶部

:hammer_and_wrench: 本地构建

想自己构建镜像而不是从 Docker Hub 拉取吗？那就动手吧：

git clone https://github.com/CoderLuii/HolyClaude.git
cd holyclaude

# 构建完整镜像
docker build -t holyclaude .

# 构建精简版镜像
docker build --build-arg VARIANT=slim -t holyclaude:slim .

# 为 ARM 架构（Apple Silicon、Raspberry Pi、AWS Graviton）构建
docker buildx build --platform linux/arm64 -t holyclaude .

然后在你的 compose 文件中使用 image: holyclaude 代替 image: coderluii/holyclaude:latest。

↑ 返回顶部

:bar_chart: 替代方案

HolyClaude 和其他方案相比如何？

HolyClaude 并不是与编码代理竞争——它是让它们运行得更好的 基础设施层。它就是你用来运行这些工具的容器。

↑ 返回顶部

:rocket: 路线图

接下来有什么计划：

你有什么想法吗？可以在 讨论区 发起讨论，或者在 功能请求 中提出。

↑ 返回顶部

:trophy: 使用 HolyClaude 构建的作品

正在使用 HolyClaude 构建什么吗？我们很想看看！

打开一个带有 showcase 标签的 issue，或者提交 PR 将你的项目添加到这里：

成为第一个在这里添加项目的人。

↑ 返回顶部

:handshake: 贡献

欢迎贡献代码。这个项目源于真实的日常使用，只有更多人使用它并发现边缘情况，它才会变得更好。

1. 克隆仓库
2. 创建分支（git checkout -b feature/something）
3. 提交更改
4. 推送到远程仓库
5. 发起 PR

如有 bug、功能请求或疑问，请 提交 issue。

联系我们

想添加某个工具吗？

请使用 📦 软件包请求 问题模板。请注明软件包名称、安装方法以及应针对的版本（完整版/精简版）。

↑ 返回顶部

:heart: 支持

HolyClaude 是免费的开源项目，由一位每天都在使用它的开发者维护。

如果它为你节省了时间，你可以通过以下方式提供帮助：

• 给这个仓库点个赞 — 这是你能做的对提升知名度最有帮助的事情
• 分享它 — 告诉朋友、发布帖子、发推文
• 提交问题 — bug 报告和功能请求能让 HolyClaude 对每个人都有用
• 贡献代码 — 欢迎随时提交 PR

↑ 返回顶部

:scroll: 第三方软件

HolyClaude 的 Docker 镜像包含了第三方软件，每种软件都有自己的许可证。值得注意的组件如下：

完整的详细信息，包括修改说明，请参阅 [THIRD-PARTY-NOTICES]。HolyClaude 自身的源代码采用 MIT 许可证。

↑ 返回顶部

:page_facing_up: 许可证

MIT — 请参阅 LICENSE。您可以按任意方式使用它。

↑ 返回顶部

HolyClaude 快速上手指南

HolyClaude 是一个开箱即用的 AI 开发工作站容器，集成了 Claude Code CLI、Web UI、无头浏览器（Headless Browser）、7 种 AI 命令行工具以及 50+ 开发工具。无需繁琐配置，一条命令即可启动。

环境准备

系统要求

HolyClaude 支持多种平台和架构，请确保您的环境满足以下条件之一：

前置依赖

1. Docker: 已安装并正在运行。
2. Docker Compose: 建议使用 v2 版本（通常随 Docker Desktop 或新版 Docker Engine 自带）。
3. 账号准备:
   • Claude Max/Pro 订阅用户: 可直接通过网页端 OAuth 登录。
   • 按量付费用户: 准备好您的 Anthropic API Key。
   • 注：本工具免费开源，您只需向 AI 提供商支付实际使用费用。

安装步骤

1. 创建项目目录

在终端中执行以下命令创建文件夹并进入：

mkdir holyclaude && cd holyclaude

2. 创建配置文件

在当前目录下创建 docker-compose.yaml 文件。您可以直接使用以下最小化配置模板（零配置，开箱即用）：

version: '3.8'

services:
  holyclaude:
    image: coderluii/holyclaude:latest
    container_name: holyclaude
    ports:
      - "3001:3001"
    volumes:
      - ./data:/home/user/data
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped
    # 针对部分 NAS 或特殊文件系统，如需优化文件监听可取消下面注释
    # environment:
    #   - CHOKIDAR_USEPOLLING=true

镜像选择说明：

• latest: 全功能版（推荐），预装所有工具，启动无需等待下载。
• slim: 精简版，体积更小，缺失的工具会在首次使用时自动安装。

3. 启动服务

执行以下命令拉取镜像并后台启动容器：

docker compose up -d

首次运行会自动下载镜像，根据网络情况可能需要几分钟。

基本使用

1. 访问 Web 界面

容器启动后，在浏览器中打开以下地址：

http://localhost:3001

2. 初始化与登录

1. 创建 CloudCLI 账户: 首次访问时，按照提示创建一个本地管理账户（仅需 10 秒）。
2. 绑定 AI 账号:
   • 订阅用户: 点击登录，使用您的 Anthropic 账号进行 OAuth 授权（与桌面版流程一致）。
   • API Key 用户: 在设置界面直接填入您的 Anthropic API Key。
3. 开始构建: 登录成功后，您即可在浏览器中使用完整的 Claude Code 环境，包括代码编辑、终端操作、网页截图测试等功能。

3. 验证其他 AI 工具（可选）

进入容器终端可验证预装的其他 AI CLI 工具：

docker exec -it holyclaude bash
# 在容器内尝试运行其他工具，例如：
codex --help
# 或配置 Gemini (需设置环境变量 GEMINI_API_KEY)

一切就绪，现在您可以停止手动配置环境，专注于开发了。