Happy 是什么?2.45 万星的编码 Agent 编排台,把 Claude Code 装进手机(基础篇)

Happy 是什么?2.45 万星的编码 Agent 编排台,把 Claude Code 装进手机(基础篇)

上周有人问我:Claude Code 跑到一半停在权限确认,人已经在地铁上了,怎么办。以前的答案是内网穿透加 SSH,现在的答案里多了一个:Happy。

但先说清楚一件事——2026 年下半年,Happy 已经不是当年那个“手机遥控 Claude Code 的小工具”了。官方把主战场搬到了桌面版,原来的 npm CLI 进了维护模式。所以这篇按它现在的样子讲:它到底是什么、链路怎么走、怎么上手、哪里会踩坑。

一、它不是模型平台,是“马具”

Happy 官方给自己的定义是 harness(马具/运行时),不是又一个模型网关,也不是云沙箱。

拆开看是三个仓库,全部 MIT:

  • slopus/happy(2.45 万星):手机 App(iOS / Android / Web)、老的 CLI、以及中转服务器 Relay
  • happy-desktop:macOS / Windows / Linux 桌面版
  • happy-agent:桌面版跑在下面的 Agent 运行时

真正的核心是 Happy Agent——一个无头守护进程(headless daemon)。它跑 agent loop、工具、沙箱,还带一个存会话的 SQLite。桌面版只是它的一个窗口,两者通过本机私有 socket 通信。所以关掉窗口,会话还在跑;重启守护进程,会话从磁盘恢复,接着发消息就能续上上下文。

模型这块的思路是“每家用自己的原生壳”:Claude 用 Claude Code 的 prompts 和工具,GPT 系列用 Codex 的,Grok 用 Grok Build 的;Gemini 通过 Antigravity 跑,OpenCode 或任何 ACP agent 也能挂(beta)。外壳各用各的,外面的权限模型、沙箱、工具、transcript 是同一套——换模型不丢对话。

钱的部分最实在:它读的是你机器上 Claude Code、Codex、Grok CLI 已经登录的凭据,请求直接发厂商,Happy 不经手。没有 Happy 的模型套餐,也没有 key 要填。

二、链路:两端外连,中间只过密文

Happy 架构图:手机与电脑各自外连 Relay,Relay 只转发密文,Agent 在本机沙箱内跑
Happy 的链路:手机和电脑都主动外连 Relay,不开端口;密钥在设备端,Relay 只存转发不透明密文(点图看大图)

这张图里有两个关键点。

一是不开端口。手机和电脑各自主动连 Happy 的 Relay,谁都不需要公网 IP 或端口映射。消息在设备端加密,Relay 存的和转的都是不透明密文,它只知道“有这么几个会话”,读不到内容。手机能做的不只是看:回权限审批、回答提问、切模型、发加密图片。

二是执行留在本机。Agent 跑在你的电脑或服务器上,读写的是普通文件夹,权限落在 OS 沙箱里。团队模式则反过来:全队共用一个 Happy Agent,成员各自登录(WorkOS 或自己的 IdP),共享项目与会话;桌面端走 Tailcat——一个不用 Tailscale 账号的 WireGuard 隧道,Tailscale 的免费中继只看得到地址和时序,看不到内容。

三、怎么上手

桌面版(现在的主线):macOS 有签名公证的 dmg,也可以 brew install --cask slopus/tap/happy;Windows、Linux 有安装包。打开后它会自己起 Agent 运行时,并自动识别机器上已有的 Claude、Codex、Grok 登录态。最新一版 v0.0.103 发布于 11 月 5 日,该版本安装包累计下载 3.4 万次。

老 CLI(维护模式):npm i -g happy,然后 happy claude 或 happy codex。它只包 Claude Code 和 Codex 两个壳,能在终端里跑、手机接着看;新功能不再往这里加。

配对手机:桌面版进 Settings → Mobile Access,出二维码,手机装 App 扫码,再在电脑上确认一次,就通了。

第一件事找 Chief of Staff:这是 App 里的第一个 bot,用对话帮你加模型账号、导入项目、配对手机、部署远程 agent、建团队。比翻设置页快。

权限四档:只读、工作区写、Auto(读写放行,越界动作由另一个 agent 复核)、完整访问(在沙箱之外)。新手建议先停在 Auto,跑两天再决定要不要放开。

四、实话

  • 版本号还是 0.0.x。桌面版 7 月才建仓,109 星;主仓库挂着 678 个没关的 issue,另有 425 个 open PR。用可以,别指望它像成熟商业软件那样稳。
  • CLI 已进维护模式。你现在学的 happy claude 是旧路径,多模型、团队、子 agent 这些都在桌面版里。
  • 手机不等于云。Agent 跑在你自己机器上,电脑关机、断网、合盖休眠,手机就指挥不动。想让它在服务器上长跑,得单独部署远程 agent。
  • 语音要钱。走 ElevenLabs,30 天内免费 20 分钟,之后订阅;其余功能免费。
  • 有埋点。PostHog,随机安装 ID,带 IP,记录用了哪些功能、什么模型、什么系统;官方说不上传消息、代码、文件,设置里能关。
  • 还没做的:分叉一个正在跑的 provider 会话;“按名字加远程机器”的体验。
  • 和官方 Remote Control 的取舍:Anthropic 自带的 Remote Control 零安装、手机和浏览器都能接,但只管 Claude,且会话内容在连接期间存在它服务器上(TLS 之内)。Happy 是多厂商加端到端加密,代价是要装东西、版本还早。它能跑 Bedrock 上的 Claude 和 GPT,Remote Control 不支持 Bedrock。

所以适合谁:同时订了两家以上模型、经常要在手机上回审批、在意中间服务器读不到内容的人。不适合谁:只用 Claude 且想零配置、或者公司要求设备管控和审计的人——后者直接看官方方案。

想对照另一条路线(一个 App 管所有本地 coding agent),可以翻之前那篇 T3 Code 和 Worktrunk 的对比;Claude Code 本身的安装和登录,看这篇,权限白名单看这篇。

一句话:Happy 卖的不是模型,是“Agent 跑在你这,遥控器在你手上”。这句话在 2026 年值不值 2.45 万星,取决于你有几台机器、几个订阅、多不想回工位。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注