Hapi 远程控制

Hapi 是一款把 AI 编程 Agent（Claude Code / Codex / Gemini CLI 等）跑在远端服务器、用本地浏览器或手机接管的远程控制工具。后端 LLM 走 why01 中转，配置和你在桌面跑 CLI 完全一致。

实操以官方文档为准

本页基于公开信息和截图整理，we 未实际跑过完整部署——具体安装方式（Docker / 单二进制 / 其他）、UI 路径、版本差异以该项目官方仓库 / 发布页为准。本页只保证「填进 why01 的两个值是固定的」（Base URL + Key）。

你需要它当且仅当

• 想让 Agent 7×24 跑在 VPS 上，不依赖本地电脑常开
• 在路上 / 用手机时也要随手查看或干预跑着的任务
• 同一台机器上要并发跑多个 Agent，互不打架

如果只是本地偶尔跑跑 claude / codex，不需要 Hapi。

它能做的事

• 远程运行：在 Linux VPS 上把 Agent 起起来，跑长任务（重构、批量改、长链思考）
• 浏览器接管：本地任意浏览器（含手机）接到 Hapi 的 Web 端，看实时输出、发新指令
• 任务并发：多个独立的 Agent 任务并行运行，按工作区隔离
• 会话恢复：网络断开 / 浏览器关掉，任务在远端继续跑，下次连上来看进度

安装

Hapi 是第三方项目，请从其官方仓库 / 发布页获取最新安装方式（本站不引用三方下载链接以免链接失效，避免被中间人替换）。

通用流程：

1. 在远端 VPS 上按官方文档装 Hapi（通常是 Docker compose 或单二进制）
2. 把 Hapi 的 Web 端口（默认情况下不要直接暴露公网，建议套 nginx + 鉴权 / 走 Tailscale）
3. 浏览器打开 Hapi UI，按下一段配置 provider

接入 why01

在 Hapi 的 provider / LLM 配置里填 why01 即可，字段与桌面 CLI 一致：

Base URL:  https://s1.why01.top
API Key:   sk-...（控制台 → 令牌管理 创建）

Base URL 末尾 /v1 看 Agent 类型

• Hapi 内部跑 Claude Code：https://s1.why01.top（不带 /v1）
• Hapi 内部跑 Codex / OpenAI 协议：https://s1.why01.top/v1
• 不确定就先按 Agent 自己的官方文档要求，why01 这边不做强制

常用操作

新建一个 Agent 任务

Hapi UI → 「新建任务」 → 选 Agent 类型（Claude Code / Codex / ...） → 选工作目录 → 输入任务指令 → 启动。

查看运行日志

任务列表点进去看实时输出。已结束的任务保留历史日志，可回看。

中断 / 继续任务

页面上有「中断」按钮——发送中断信号给远端 Agent 进程。中断后还可以发后续指令让 Agent 继续上下文（取决于 Agent 本身支不支持续跑）。

多任务并发

每个任务一个独立会话，互不影响。建议同一台 2 核机器并发不超过 3 个 Claude Code 任务——再多会因 LLM 响应等待积压而变得没意义，不如分散到多台。

计费与额度

Hapi 本身只是远程控制层，真正花钱的是底层 LLM 调用——这部分由 why01 按 token 实际用量计费，与你本地跑 Claude Code 没区别。Hapi 不会带来额外计费。

Agent 长任务容易烧 token

让 Agent 自由探索代码库 / 反复重试时，长上下文 + 多轮工具调用会让 token 消耗远高于人工对话。建议：

• 给一个 Key 单独设额度，专门给 Hapi 用，烧光只停这一个 Key
• 控制台「日志」过滤这个 Key 看实时用量，发现异常立即禁用

安全提醒

• Hapi Web 端不要直接暴露公网——它能远程操作你 VPS 上的 shell。最少要套个反向代理 + 强口令，更稳的做法是只在 Tailscale / WireGuard 内网开放。
• API Key 写在 Hapi 配置里 = 写在 VPS 文件系统上——VPS 被入侵 = Key 泄露。给 Hapi 用的 Key 单独建一个、加额度上限，万一泄露损失可控。

网络优化

国内访问 VPS / VPS 访问 why01 节点慢，可以考虑优选 IP 配置。

下一步

• Hapi 进阶：优选 IP 配置
• Claude Code 配置
• 令牌额度设置