Happy Coder 教程：用手机远程掌控 Claude Code

发表于 分类于 阅读次数： Disqus： 本文字数： 1.1k 阅读时长 ≈ 4 分钟

离开电脑还在惦记 AI Agent 有没有跑完？Happy Coder 就是为此而生的——它把 Claude Code / Codex 的控制权延伸到你的手机和浏览器，让你随时随地都能盯着你的 AI 编码助手。

Happy Coder 是什么？

Happy Coder 是一个开源的 Claude Code / Codex 移动端 & Web 客户端，基于端对端加密，让你可以在手机（iOS / Android）或任意浏览器中查看、控制正在你电脑上跑着的 AI 编程会话。

它的核心原理很简单：在电脑上运行 happy claude（替代原来的 claude），会启动一个包裹层（wrapper）；当你想从手机接管时，会话会自动切换到远程模式；想回到电脑，在键盘上按任意键即可切回。

开源 & 无追踪：MIT 协议，代码可审计，无遥测、无埋点。你的代码从不以明文形式离开你的设备。

核心功能

功能 说明
📱 移动端监控 离开座位后仍可查看 AI 正在构建什么
🔔 推送通知 Claude Code / Codex 需要授权或报错时立即推送
⚡ 设备秒切 手机 ↔︎ 电脑，一键无缝接管
🔐 端对端加密 代码在传输中全程加密，服务器看不到明文
🛠️ 完全开源 可自审代码，无任何遥测

安装与配置

第一步：下载 App

平台 链接
iOS App Store — Happy Claude Code Client
Android Google Play — Happy
Web app.happy.engineering

在手机上安装好 App 后，按照 App 内引导完成账号注册/登录。

第二步：安装 CLI

确保本地已安装 Node.js（建议 18+），然后全局安装 happy：

1
npm install -g happy

安装完成后验证一下：

1
happy --version

旧版包名为 happy-coder，新版已迁移至 happy，直接装新版即可。

第三步：启动会话

用 happy claude 替代原来的 claude 命令：

1
2
3
4
5
6
7
8
# 原来你这样用
claude

# 现在改成
happy claude

# 使用 Codex 同理
happy codex

首次运行时，CLI 会引导你扫码或输入配对码，将当前会话与手机 App 绑定。绑定成功后，手机端即可看到实时输出。

基本使用流程

1
2
3
电脑启动会话            手机接管操作             切回电脑
     │                      │                      │
happy claude  ──────►  App 中查看/发指令  ──────►  键盘按任意键
  1. 在电脑上：进入项目目录，执行 happy claude，像平时一样开始 AI 编程任务。
  2. 离开电脑：打开手机 App，即可看到当前会话的实时输出流。
  3. 需要操作：直接在 App 里输入指令或给出权限确认；Claude Code 需要你审批时，App 会推送通知。
  4. 回到电脑：在电脑键盘上按任意键，控制权自动切回终端。

推送通知配置

推送通知是 Happy Coder 最实用的功能之一。在以下情况下你会收到通知：

  • Claude Code 请求执行危险命令，等待你的批准
  • 任务遭遇错误，Agent 暂停等待输入
  • 长时间任务执行完毕

App 内可以在设置 → 通知中自定义通知级别（全部 / 仅需要操作 / 关闭）。请确保系统层面已允许 App 发送通知。

项目结构（开发者参考）

Happy Coder 是一个 monorepo，包含四个子包：

包名 说明
happy-app Web UI + 移动客户端（基于 Expo 构建）
happy-cli 包裹 Claude Code / Codex 的命令行工具
happy-agent 远程 Agent 控制 CLI（创建、发送、监控会话）
happy-server 处理加密同步的后端服务

如需自部署服务端，参考 官方文档。

常见问题

Q：手机和电脑必须在同一 Wi-Fi 吗？ 不需要。同步通过 Happy 的加密中继服务器进行，手机用 4G/5G 也完全可以。

Q：我的代码安全吗？ 所有内容在离开你的设备前均已加密，服务器只转发密文，无法读取你的代码内容。

Q：支持 Windows 吗？ CLI 基于 Node.js，理论上 Windows / macOS / Linux 均支持。

Q：能同时在多台设备上监控吗？ 可以。多个设备登录同一账号后，都能看到实时输出；但同一时刻只有一个设备拥有输入控制权。

相关资源