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

4 months ago

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

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

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

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

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

很多人可能用过或者听说过 Happy，HAPI 就是受它启发做的，但设计思路不太一样：

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

更详细的对比，可以看这个对比说明

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

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

填入刚才的 token，点击登录

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

我平时是在 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 的对话框

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

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

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

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

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

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

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

设置开机自启（macOS）

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

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

** Token 在哪里找**

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

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

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

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

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

作者

天天