Happy Coder:手机远程操控Claude Code和Codex的工具,端到端加密,1.3万Star
用 Claude Code 的人,都有一个共同的痛点。你在电脑前让 AI 写代码,写到一半,人得出门。出门之后,你完全不知道它干了啥——是卡住了等你授权,还是已经跑完了,还是报错了。回来一看,Claude Code 弹了个权限确认框,等了你 40 分钟,白等。
Happy Coder 就是来解决这个问题的。
GitHub 地址:https://github.com/slopus/happy
目前 13,000+ Star,1,000+ Fork,MIT 协议开源。
它干了什么
一句话:让你在手机上远程操控 Claude Code 和 Codex。
在电脑上装个 CLI,手机上装个 App(iOS / Android 都有),两端通过端到端加密同步。你人在外面,打开手机就能看到 AI 的实时输出。需要授权?手机上点一下。想发新指令?直接打字。想切回电脑?键盘上随便按个键,控制权立刻回来。
技术栈是 TypeScript monorepo,包含 CLI、Expo 移动端、Web 端、后端服务四个模块。
核心机制
Happy Coder 不是简单的远程桌面或屏幕共享。它的做法是:在本地跑一个 CLI wrapper,替代原来的 claude 或 codex 命令。这个 wrapper 会启动一个后台 daemon 进程,通过 Socket.IO 跟服务器保持长连接。手机端连上同一个账号后,所有会话消息、权限请求、Agent 状态,都通过 WebSocket 实时同步。
关键点在于加密。所有内容在离开你的设备之前就已经加密了,服务器只存密文。用的是 AES-256-GCM + NaCl secretbox 双方案,每个会话有独立的数据加密密钥。服务器看不到你的代码,看不到你的对话内容。
不只是看
如果只是看输出,开个 SSH 就行了。Happy Coder 还做了几件事:
- 推送通知:AI 遇到报错或者等授权,手机会弹通知,不用一直盯着屏幕。
- 后台 daemon 管理:CLI 启动后会常驻后台,自动维护机器状态,支持多会话并行。
- RPC 工具桥接:手机端可以远程触发本地的 shell 命令、文件读写、ripgrep 搜索。不是简单的消息转发,是真正的远程操控。
Web 端同样可用,不想装 App 的话,浏览器打开 app.happy.engineering 也能用。
安装
一行命令:
npm install -g happy-coder
然后用 happy 替代 claude,用 happy codex 替代 codex。手机端去 App Store 或 Google Play 搜「Happy Claude Code Client」下载,配对完成即可使用。
架构设计
项目是标准的 monorepo 结构,五个包:
- happy-cli:核心 CLI + daemon
- happy-app:Expo 移动端 + Web 端
- happy-agent:远程 Agent 控制
- happy-server:后端同步服务
- happy-wire:协议定义层
daemon 的设计比较讲究。本地起一个 HTTP 控制服务器绑定 127.0.0.1,CLI 通过 IPC 跟它通信。会话可以从终端前台启动,也可以从手机远程触发。状态同步用乐观并发控制,每次更新带版本号,防止多端冲突。
总结
这个工具解决的是一个很具体的场景:你让 AI 写代码,但你不能一直坐在电脑前。端到端加密是加分项,代码是敏感数据,经过第三方服务器中转的方案,加密是底线。
不过也有局限。目前只支持 Claude Code 和 Codex 两个 Agent,Gemini CLI 的支持还在路上。而且它依赖自己的后端服务做中转,虽然加密了,但如果你连中转都不想要,得自己部署 happy-server。
适合经常需要离开工位、但又不想中断 AI 编程流程的开发者。如果你一直坐在电脑前写代码,用不上。
GitHub 项目:https://github.com/slopus/happy