编程 Happy Coder:手机远程操控Claude Code和Codex的工具,端到端加密,1.3万Star

2026-09-05 18:58:47

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,替代原来的 claudecodex 命令。这个 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

推荐文章

程序员茄子在线接单