HAPI：让你的 AI 编程助手随时在线，人不在电脑前也能继续干活

## 先说说它到底解决了什么问题

用过 Claude Code、Codex 或者 Gemini CLI 的人应该都有这种体验：

你让 AI 跑一个比较长的任务，然后……你得一直守在电脑前。AI 每隔一会儿要问你"这个操作要不要允许"，你不在就卡住了；或者你出门了，不知道任务跑完没有，回来一看——它在等你确认某个权限，等了一个小时。

**HAPI 就是专门解决这个痛点的。**

它的核心逻辑很简单：在你本地电脑上跑一个"Hub（中枢）"，然后不管你人在哪里——手机、平板、别的电脑、浏览器——都能连上来查看进度、发消息、审批权限请求。AI 继续在你本地机器上跑，你只是多了一个随时随地遥控它的能力。


https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.hapi


---

## 它和 Happy 有什么区别？

很多人可能用过或者听说过 [Happy](https://github.com/slopus/happy)，HAPI 就是受它启发做的，但设计思路不太一样：


https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.happycoder


| 对比点 | Happy | HAPI |
|---|---|---|
| 架构 | 远程优先，替换 AI Agent | 本地优先，包装 AI Agent |
| 会话切换 | 切到远程后本地体验受影响 | 本地/远程无缝切换，不丢上下文 |
| 终端体验 | 有变化 | 完全原生，肌肉记忆不变 |
| 多模型支持 | 主要是 Claude Code | Claude Code / Codex / Gemini / OpenCode |
| 语音控制 | 无 | 有（需配置 ElevenLabs）|

更详细的对比，可以看这个[对比说明](https://github.com/tiann/hapi/blob/main/docs/guide/why-hapi.md)

简单说：**如果你重度依赖终端，喜欢在本地跑、只是想多一个手机监控通道，HAPI 更适合你。**

---

## 如何使用

应用安装后，直接使用默认的开始部署即可

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/fb1192e1-18ce-4f27-9a2c-1b88effc31da.png "image.png")

填入刚才的 token，点击登录

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/57332a52-288e-474d-b8d5-88afdcc96478.png "image.png")

进入主页，此时是空白的，因为还没有项目

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/75e291b1-2e50-40f0-9d31-705dd716c9f2.png "image.png")

我平时是在 Mac 笔记本上使用，先打开终端，执行命令

`npm install -g @twsxtd/hapi
`

执行成功后，输入
`hapi --version`

可以看到：
hapi version: 0.16.1

接着运行命令：
`HAPI_SERVER_URL=https://hapi.XXX.heiyu.space hapi agent claude-code`

同意授权后，即可看到 claude-code 的对话框

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/ee765261-007c-4096-bf5d-5e91cdf70523.png "image.png")

这时候，最快的方法其实是让 ClaudeCode 教你怎么调试通，直接告诉他你的地址，让他出现对话，关键指令：

`HAPI_API_URL=https://hapi.XXX.heiyu.space npx @twsxtd/hapi --print "你好，测试连接"`

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/2e2cfc5b-bd91-4a1f-9120-a1aaf155faec.png "image.png")

中间有授权的提示，直接点 Yes 就行，直到它最后给了我成功的提示：

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/1fb50649-65f0-46c4-9ec5-78ec8f2bb29a.png "image.png")

此时打开懒猫里的 HApi，可以看到对话了

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/eb381686-2652-4cbb-b16e-e20691d955b9.png "image.png")

如果要让会话保持在线，需要启动一个持久化的 agent 会话。同样道理，直接让 CC
告诉你如何做即可。

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/8837ce38-508a-4d28-8576-f11e43adcd7a.png "image.png")

只需要拿出手机，在懒猫的应用里操作就可以了

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/bbadba5e-3688-4d91-908a-7a35b9b52381.png "image.png")

你在家里开着电脑，启动一个 HAPI 会话，让 AI 帮你重构某个模块或者写一批测试。然后你出门买菜、去健身房——打开手机懒猫，就能看到 AI 现在在干什么，它改了哪些文件，Todo 完成了几条。
 
  
## 几个实用小技巧

**设置开机自启（macOS）**

不想每次手动开 Hub，可以设置成后台常驻服务：

```bash
# 创建 LaunchAgent 配置文件
# ~/Library/LaunchAgents/com.hapi.hub.plist
# 写入对应的 plist 配置，开机自动启动 hapi hub --relay
```
 

** Token 在哪里找**

第一次运行会自动生成 Access Token，存在 `~/.hapi/settings.json` 里：

```bash
cat ~/.hapi/settings.json | grep cliApiToken
```

Web 界面登录的时候用这个 Token。
 
---

## 小结

HAPI 最大的价值不是"多了一个手机端"，而是**把 AI 编程助手从"你必须守着"变成了"它自己跑，你按需介入"**。

出门前交代任务，路上查进度，遇到问题手机放行，回来直接接着干——这种工作流一旦用顺了，效率提升是真实的。