它是什么
Happy Coder(GitHub 18.8k ⭐)是一个开源的移动端和 Web 端 Claude Code 客户端。它的核心理念很简单:让 Claude Code 在你自己的电脑上运行,而你从任何设备上控制它。
手机、平板、Web 浏览器——都能成为你 Claude Code 会话的入口,但你永远不需要把代码送到别人的服务器上。所有 AI 推理在你自己的机器上发生,流量经过加密中继,服务器只能看到加密后的数据块。
安装方式:
npm i -g happy && happy
然后下载 iOS 或 Android App,或者直接打开 app.happy.engineering。
架构:三个部分
Happy Coder 由三层组成:
CLI 程序(happy) — 运行在你的电脑上。它启动 Claude Code,监听终端输出,加密后发送到中继服务器。桌面端的工作站。
移动 App — 运行在手机或平板上。从服务器拉取加密数据,渲染终端界面。发送输入指令,加密后传回 CLI。所有显示逻辑都在这里。
中继服务器(Relay Server) — 架在你电脑和手机之间的桥梁。只负责传递加密消息,无法解密内容。可以自托管,也可以用官方提供的公共服务器。
┌──────────────┐ 加密隧道 ┌─────────────────┐
│ 你的电脑 │ ←─────────────────→ │ 中继服务器 │
│ Claude Code │ │ ( Relay ) │
│ + happy CLI │ │ (零信任,无法 │
└──────────────┘ │ 读取数据) │
└────────┬────────┘
│
┌────────▼────────┐
│ 手机 / 平板 App │
│ (Happy Coder) │
└─────────────────┘
核心功能
1. 实时双向同步
设备之间完全对等。没有"主设备"和"副设备"之分——桌面和手机可以同时发送消息、接收回复、在同一会话中交替操作。在手机上开始规划,坐到笔记本前直接在 IDE 里 Review 生成的代码。
2. 多会话并行
可以同时运行多个 Claude Code 实例。一个做前端,一个做后端,一个跑 DevOps 任务。随时切换,互不干扰。
3. 语音编程
不是语音转文字然后粘贴——这是真正的 Voice-to-Action。说话,Claude Code 直接执行。"帮我把这个函数改成异步的",然后看它实时改代码。手完全空闲,灵感来的时候随时动手。
4. 端到端加密
Zero-Trust 架构设计。中继服务器只能看到加密数据块,无法读取你的代码或指令。Master secret 永远不会离开你的设备。支持自托管,完全掌控数据。
加密层级:
- Master Secret:账户级别,永远不离手机
- 机器密钥(Machine Keys):每台电脑一对,ONCE/MACHINE
- 会话密钥(Session Keys):每个 Claude Code 会话一个,ONCE/SESSION
- 数据加密密钥(DEK):对称密钥,实际加密内容
5. MCP 工具支持
完整的 MCP(Model Context Protocol)工具链支持。Claude Code 配置的 MCP 服务器,在 Happy Coder 中同样可用。权限提示弹窗让你在手机上也能精细控制每个工具的调用。
6. 493 个内置资源
官方维护了一个工具/Agent 库,包含各种专业化 Agent(法律顾问、智能合约审计、产品策略师……)、MCP 服务器配置、自定义 Slash 命令、Hooks 和模板。开箱即用。
7. 自托管选项
中继服务器可以完全自托管。Docker 一键部署,数据完全在自己的基础设施上流转。对于企业内网环境尤其有价值。
与其他方案对比
| Happy Coder | Omnara | Terragon | Cursor Mobile | |
|---|---|---|---|---|
| 代码运行位置 | 你的本地机器 | 你的本地机器 | 云端 VM | 云端 VM |
| 开源 | ✅ MIT | ✅ | ❌ | ❌ |
| 价格 | 免费 | 免费 | 付费 | Cursor Pro |
| E2E 加密 | ✅ | ❌ | ❌ | ❌ |
| 多会话并行 | ✅ | ? | ? | ? |
| 语音编程 | ✅ | ? | ? | ? |
| 自托管 | ✅ | ? | ❌ | ❌ |
核心差异:Happy Coder 是唯一一个"代码在你自己机器上 + 完全开源 + 免费 + E2E 加密"的方案。云端方案(Terragon、Cursor)在隐私和成本上都有代价。
适用场景
适合用 Happy Coder 的场景:
- 出门在外,用手机给 Claude Code 发任务,回来直接看 PR
- 通勤时用语音规划功能,坐到电脑前开始实现
- 同时跑多个 Claude Code 实例处理不同项目
- 对代码隐私有要求,不想让第三方看到
- 想省钱,不想为 Claude Code 云端访问付额外费用
不适合的场景:
- 没有自己的开发机器(需要一台电脑运行 CLI)
- 网络环境复杂,懒得配置中继服务器
- 需要 GPU 加速的大规模推理(这类需求本身就得上云)
快速上手
- 安装 CLI:
npm i -g happy && happy - 扫码连接:App 扫 CLI 生成的二维码,完成配对
- 开始编程:手机或电脑上输入指令,享受同一个 Claude Code 会话
- (可选)配置语音:开启 Voice Agent,彻底 hands-free
结语
Happy Coder 解决的是一个很实在的问题:Claude Code 只能在电脑前用。它没有重新发明 AI 编程,而是在"如何随时随地触达你已有的 Claude Code"这件事上做得很彻底。
开源 + 免费 + E2E 加密 + 多平台支持,让它成为一个值得信赖的选项。GitHub 18.8k ⭐ 和 1900+ commits 的活跃度也说明这不是一个半成品。如果你经常需要在移动中操控 Claude Code,值得一试。