Hapi 远程控制

Hapi 适合把本地或服务器上的 AI 编程会话“远程化”。你可以在浏览器、PWA，甚至移动端上查看任务、审批权限、看日志和继续会话。

官网：https://hapi.run

Hapi 能做什么

• 远程查看 Claude / Codex / Gemini 任务状态
• 在手机上批准或拒绝权限请求
• 查看文件、终端输出和 git diff
• 做跨设备会话控制

典型场景

• 代码任务在公司电脑上跑，你在手机上盯进度
• AI 会话在云服务器跑，你在浏览器里操作
• 需要远程审批工具调用或确认命令执行

安装基础服务

npx @twsxtd/hapi server

启动后通常会输出：

• 本地访问地址
• Token 凭证
• 默认端口

注意

首次启动给出的 Token 一定要保存。别人拿到 Token，就能进入你的远程控制面板。

启动对应 AI 后端

hapi claude
hapi codex
hapi gemini

不同命令对应不同后端。前提是你本地已经把这些工具配置好，例如已经能在终端里直接跑 claude、codex 或 gemini。

局域网访问

如果在同一局域网里，一般可以通过：

http://<server-ip>:3006

来访问 Hapi 页面。

公网访问

如果你想在外网使用，常见办法是：

• Cloudflare Tunnel
• Nginx 反向代理 + 域名
• Tailscale / 内网穿透工具

Cloudflare Tunnel 的接法

1. 在 Cloudflare 创建 Tunnel
2. 把服务地址指向 localhost:3006
3. 给它分配域名
4. 浏览器通过域名访问 Hapi

使用建议

先本地跑通，再做远程

先确保：

• claude / codex / gemini 本地能跑
• Hapi 页面本地能打开
• Token 登录没问题

再去做外网访问，不然排障会非常乱。

Token 别泄露

远程控制能力本质上是高权限入口，Token 要按密钥对待。

常见问题

页面打不开

先看三件事：

• Hapi 服务是否还活着
• 3006 端口是否开放
• Token 是否正确

公网访问慢

如果你已经用了 Cloudflare Tunnel，但延迟很高，可以看下一页：Hapi 进阶：优选 IP 配置

AI 后端不显示

通常是对应 CLI 根本没启动，或者 Hapi 找不到它的可执行命令。