使用 Happy 远程操作 Claude Code / Codex

## 简介 [Happy](https://happy.engineering/docs/quick-start/) 套件（Web/iOS/Android + Server + Cli）可以让我们远程操作 Claude Code 和 Codex。 ## 步骤 **1. 在懒猫微服安装 Happy Coder** https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.happycoder 里面整合了 Happy Web 和 Happy Server，并自动设置好了 `serverUrl`。  **2. 在远程机器安装 Happy Cli** ```sh npm install -g happy-coder ``` **3. 在远程机器运行 Happy Cli** ```sh export HAPPY_SERVER_URL=https://happyserver.xxx.heiyu.space export HAPPY_WEBAPP_URL=https://happyweb.xxx.heiyu.space # 启动 claude code happy # 启动 codex happy codex ``` 把 `xxx` 替换成你的懒猫设备名。 **4. 在 Happy Web 中远程连接 Happy Cli** 首次启动 `happy`，我们会看到这个界面：  选择 `Mobile App`，然后就会看到这样的界面：  复制红色框中的内容，回到 Web 界面中，点击「手动输入 URL」按钮，并把刚才复制的内容粘贴进去：  然后点击认证。 如果认证成功，将会看到这样的提示：  如果认证失败，请去看看 FAQ 中的解决方案。 **5. 远程操作 Claude Code / Codex 即可** 此时远程机器的 Claude Code / Codex 将会被 `happy` 接管：  我们的 Web 界面是这样的：  这时候就可以远程操作 Claude Code / Codex 了。  ## FAQ > 一句话总结： > 退出登录+ 重新认证可以解决大部分问题。 **0. Happy Cli 认证成功后如何 logout？** 运行下面命令 ``` happy auth logout ```  然后输入 `y` 即可。 > 也可以直接删除 `~/.happy` 目录。 **1. 如何使用 iOS / Android 的 App ？** 可以！你可以前往官网下载 App https://happy.engineering/docs/quick-start/ ，然后在右上角的按钮处修改 `serverUrl` 为 `https://happyserver.xxx.heiyu.space` （请确保结尾处没有 `/`）即可。  **2. 为什么认证时会出现「连接终端失败」的提示？**  这时候可以试试登出当前账号然后重新登录：    **3. 为什么认证时出现了「终端链接成功」的提示后页面没有跳转？**  这通常是该 `happy://terminal....` 已经被使用过了。 请参考 `FAQ` 中的「Happy Cli 认证成功后如何 logout？」一节，退出登录，然后重新认证。 **4. 为什么运行 Happy Cli 会报错？** > 报 500 错误  请参考 `FAQ` 中的「Happy Cli 认证成功后如何 logout？」一节，退出登录，然后重新认证。 > 报 405 错误  这通常是 `HAPPY_SERVER_URL` 填成了 `web` 的地址了。请确保启动 happy cli 时的环境变量是对的： ``` HAPPY_SERVER_URL=https://happyserver.xxx.heiyu.space HAPPY_WEBAPP_URL=https://happyweb.xxx.heiyu.space happy codex ```

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 更适合你。** --- ## 如何使用 应用安装后，直接使用默认的开始部署即可  填入刚才的 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，可以设置成后台常驻服务： ```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 编程助手从"你必须守着"变成了"它自己跑，你按需介入"**。 出门前交代任务，路上查进度，遇到问题手机放行，回来直接接着干——这种工作流一旦用顺了，效率提升是真实的。