它是什么

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 加速的大规模推理(这类需求本身就得上云)

快速上手

  1. 安装 CLInpm i -g happy && happy
  2. 扫码连接:App 扫 CLI 生成的二维码,完成配对
  3. 开始编程:手机或电脑上输入指令,享受同一个 Claude Code 会话
  4. (可选)配置语音:开启 Voice Agent,彻底 hands-free

结语

Happy Coder 解决的是一个很实在的问题:Claude Code 只能在电脑前用。它没有重新发明 AI 编程,而是在"如何随时随地触达你已有的 Claude Code"这件事上做得很彻底。

开源 + 免费 + E2E 加密 + 多平台支持,让它成为一个值得信赖的选项。GitHub 18.8k ⭐ 和 1900+ commits 的活跃度也说明这不是一个半成品。如果你经常需要在移动中操控 Claude Code,值得一试。

项目地址:github.com/slopus/happy
官网:happy.engineering