📌 项目地址：slopus/happy | ⭐ 21,331 颗星 | 🔧 TypeScript | 📜 MIT
从痛点说起
你让Claude Code重构一个模块。它改到第37个文件，停下来问：“Apply change? (Y/n)”。你不在电脑前。对话卡死，直到你回来按回车。
Happy Coder处理的就是这件事。它给claude和codex命令加了一层包装，把终端输出和确认框加密同步到手机App。你在手机上点Y或N，AI继续跑。回到电脑前按任意键，控制权回到终端。
这个项目叫slopus/happy，TypeScript写的，MIT许可，GitHub上21331颗星。不是另一个AI代码生成工具，是Claude Code和Codex的远程控制层。
安装：三步，不改你原来的用法
第一步，下载App。iOS、Android、Web都有。链接在项目README里：
- iOS App：https://apps.apple.com/us/app/happy-claude-code-client/id6748571505
- Android App：https://play.google.com/store/apps/details?id=com.ex3ndr.happy
- Web App：https://app.happy.engineering
第二步，电脑上安装CLI：
npm install -g happyREADME里有个说明：这个包之前叫happy-coder，后来@franciscop把happy这个npm包名捐赠给了项目。如果你之前装过旧版，需要重新安装。
第三步，用happy替代claude或codex：
# 原来用 claude，现在用
happy claude
# 原来用 codex，现在用
happy codex用法和原来一样。AI启动后，手机App自动同步会话。需要确认时推送通知，点一下Y或N，AI继续跑。回电脑按任意键，终端重新接管。
README里写得很清楚：When you want to control your coding agent from your phone, it restarts the session in remote mode. To switch back to your computer, just press any key on your keyboard.
技术原理：加密代理，不是另一个AI
Happy Coder不是代码生成工具。它是claude和codex的代理。
当你跑happy claude时：
- 本地启动一个Claude Code进程。
- 通过
happy-server项目建立加密通道。 - 手机App订阅同一会话ID，接收加密的终端流和确认框。
- 所有键盘输入和输出文本，用设备密钥加密后传输。服务器只存密文。
README写的是“Your code never leaves your devices unencrypted”。如果你不信任公共服务器，可以自己搭happy-server（在packages/happy-server目录下）。
四个组件，普通用户只碰两个
- Happy App（
packages/happy-app）：Expo写的跨平台客户端，手机和Web界面。大多数用户装完App就够。 - Happy CLI（
packages/happy-cli）：happy命令本体，包装Claude Code/Codex并管理会话。大多数人只安装这个。 - Happy Agent（
packages/happy-agent）：底层CLI，支持用编程方式创建、发送、监控会话。适合写自动化脚本或集成CI/CD的人。 - Happy Server（
packages/happy-server）：处理加密封包和长连接。自己搭服务器时才需要。
核心功能是远程确认和推送通知。README列举了它的卖点：
- 手机端访问Claude Code和Codex
- 推送通知——AI需要权限或碰到错误时提醒你
- 即时切换设备——按任意键在手机和电脑间切换
- 端到端加密
- 开源，没有遥测和跟踪
谁真的需要它？
两个条件同时满足才值得装：
- 经常让AI做批量任务：重构几百个文件、自动测试、批量部署——每一步都可能需要确认。
- 经常离开电脑：午餐、通勤、会议，还想在手机上做简单的批准操作。
我试了下。周五下午让AI跑一个大型代码迁移，我去开会。AI卡在某个测试需要确认，手机弹通知，点一下继续。开完会回来，迁移已完成。省下30分钟等待时间。
反过来，如果你只是偶尔让AI写几次代码，确认框很少出现，那Happy Coder带来的额外步骤（装App、联网、开代理）不划算。
我试下来的感受：解决了最大痛点，但有三个局限
安装确实简单。npm install -g happy后直接跑happy claude，手机装App扫码配对，会话自动同步。推送通知很快，点一下确认，终端那边继续。反复按Y这个痛点被解决了。
但有几个局限：
- 必须联网：CLI和手机要通过服务器中转。没网络的开发环境（比如飞机上）用不了。
- 依赖公共服务器：虽然端到端加密，但有人可能想自己搭。
- 只支持Claude Code和Codex：不支持其他AI工具，也没有扩展接口。
作者背景
README写得很直白：“We’re engineers scattered across Bay Area coffee shops and hacker houses, constantly checking how our AI coding agents are progressing on our pet projects during lunch breaks.”
这群工程师中午吃饭时，总想看看AI写代码的进度，但必须守在键盘前。受不了了，自己写了这个工具。现在开源。没有遥测，没有跟踪，代码可审计。文档地址是https://happy.engineering/docs/，贡献指南在docs/CONTRIBUTING.md。
我的小建议
如果你正在用Claude Code或Codex做长时间任务，又经常离开电脑，这个工具省下不少等待时间。开源、可审计、没有遥测。
不推荐的情况：很少用AI写长任务、环境常断网、只用其他AI工具（比如GitHub Copilot或Cursor内置的AI）。
两个按钮，省掉你在终端前按几十次Y。值不值，看你是不是那个“中午吃饭还在想AI进度”的人。