上周五晚上,我正在外面吃饭,突然收到一条消息——测试环境的API报错了。换作以前,我得赶紧找个网吧或者回家处理。但这次,我只是掏出手机,打开Happy,发了几条指令,AI就在远程帮我把Bug修好了。
这体验说实话有点上头。以前我一直觉得AI编程工具都是桌面端的东西,手机顶多看看进度。但Happy这个开源项目让我意识到,AI编程完全可以移动化。
这个项目叫 Happy Coder,也叫 Happy,是一个给 Claude Code 和 Codex 用的移动端和 Web 客户端。核心功能很简单——让你在手机上随时随地接管 AI 编程会话。它支持端到端加密,代码永远不会以明文方式离开你的设备,这点让我比较放心。
今天聊聊这个项目到底怎么用、值不值得装。

这项目到底是干什么的
Happy 是一个开源工具,用于将你电脑上运行的 Claude Code 或 Codex 变成可以远程控制的服务。
工作原理是这样的:你在电脑上运行 happy claude 或 happy codex 代替原生的 claude 或 codex 命令。当你想从手机控制时,会在远程模式下重启会话,按任意键就能切回电脑控制。整个过程不需要任何额外配置。
项目包含几个核心组件:
| 组件 | 说明 |
|---|---|
| Happy App | Web UI + 移动端客户端,基于 Expo 开发 |
| Happy CLI | Claude Code 和 Codex 的命令行界面 |
| Happy Agent | 远程代理控制 CLI |
| Happy Server | 加密同步的后端服务器 |
支持 iOS App、Android App 和 Web App,三个平台都能用。
GitHub 上表现如何
说实话,18.1k Star 在编程工具里算是相当不错的成绩。
| 指标 | 数值 |
|---|---|
| Stars | 18.1k |
| Forks | 1.5k |
| Watchers | 67 |
| 贡献者 | 3 人 |
这个量级说明什么?独立开发者和小型团队对这个需求是有真实诉求的。1.5k 的 Fork 数也比较健康,意味着有一定二次开发社区基础。
最新版本 v1.1.6 是 2026年4月13日刚更新的,作者维护得挺勤快,没烂尾。
技术层面长什么样
项目技术栈很干净:
| 语言 | 占比 |
|---|---|
| TypeScript | 96.5% |
| JavaScript | 3.2% |
| Shell | 0.2% |
主要用到了这些技术:
- Expo:移动端开发框架,一套代码跑 iOS 和 Android
- pnpm workspaces:Monorepo 管理
- Docker:容器化部署,方便自建服务端
安装方式简单到没朋友:
npm install -g happy
之前包名叫 happy-coder,后来作者 @franciscop 把 happy 这个包名捐出来了,所以现在直接 npm install -g happy 就行。
它能做什么
用了一段时间后,我觉得这几个功能比较实用:
移动端监控和操控。在外出的路上,能随时查看 AI 编程的进度,遇到问题直接手机指挥修复。我上周那次 Bug 修复就是在饭桌上完成的。
推送通知。AI 需要授权或者遇到错误时,手机能收到推送。不用一直盯着电脑屏幕。
设备快速切换。一键从手机切到桌面,反过来也行。这个体验比想象的要流畅。
实时语音。这个我没重度用,但确实有这个功能,适合一些不方便打字但又需要保持编程的场景。
端到端加密。这是让我愿意用下去的核心原因。代码永远不会以未加密方式离开设备,Happy Server 只负责同步加密后的数据,服务端也看不到你的代码内容。项目开源,无遥测无追踪,可以自己审计代码。
谁适合用这个项目
根据我的体验,建议以下几类人重点关注:
独立开发者。特别是那种需要随时响应问题的,我以前出门都得带电脑,现在手机就够了。
远程工作者。有时候在外面处理点事,不一定方便开电脑,但能随时看看进度会安心很多。
AI编程爱好者。一直在用 Claude Code 或 Codex,想探索更灵活的操控方式。
不过有个前提——你的网络环境得相对稳定。自建服务端需要一点技术基础,如果你只想用现成的,Happy 也有托管服务可以直接连接。
典型使用场景
几个我实际用过的场景:
紧急 Bug 处理。上周五那个场景,API 报错需要快速修复。用手机操作,10分钟搞定,没耽误聚餐。
通勤时间利用。地铁上无聊的时候,可以用手机看看 AI 写的代码,给点方向性指导。
睡前检查。有时候代码在跑长时间任务,躺床上用手机看看进度,不用爬起来开电脑。
和其他工具比怎么样
说实话,这个赛道目前竞争对手不多。
Claude Code 官方只有桌面端,没有移动体验。Happy 基本上是第一个真正做移动端适配的开源方案,而且做得很完整。
对比一些类似的远程控制工具,Happy 的优势在于专注 AI 编程这个场景,不是通用的远程桌面。功能更垂直,交互也更适合 AI 编程的工作流。
当然,局限性也有——目前只支持 Claude Code 和 Codex,不支持其他 AI 编程工具。如果你用的是其他工具,这个项目帮不上忙。
有什么缺点
真实聊几个问题:
网络依赖。如果你网络不稳定,远程控制会有延迟。这个在 2G/3G 场景下特别明显。
移动端输入效率。手机打字始终不如键盘,如果你需要大量代码审查和编辑,效率还是会低一些。
学习成本。刚上手需要理解远程模式的概念,官方文档写得还行,但对于非技术背景的用户可能有点门槛。
怎么快速上手
建议按这个顺序来:
- 先安装 CLI:
npm install -g happy - 运行
happy claude或happy codex初始化 - 下载移动端 App(iOS/Android)或直接用 Web 版本
- 登录账号,授权设备
- 开始用
第一次用建议先熟悉一下 CLI 的各种参数,比如 happy help 可以查看所有命令。移动端 App 的交互逻辑比较直观,基本不用学。
如果你想自建服务端,GitHub 上有 Docker 部署方案,适合有服务器资源的开发者。
相关链接和资源
- GitHub 仓库:https://github.com/slopus/happy
- 安装命令:
npm install -g happy - 官方文档:https://slopus.github.io
- iOS App:App Store 搜索 Happy Coder
- Android App:Google Play 搜索 Happy Coder
Happy 是目前最适合移动场景的 AI 编程工具之一,18.1k Star 证明了它的实用价值。端到端加密、跨平台支持、远程控制这些核心需求都做得不错,用起来确实能提升灵活性。
适合需要移动办公或随时响应问题的独立开发者,对于固定工位工作的人价值相对有限。技术门槛不高,但需要稳定网络环境。

