手机遥控 Claude Code 写代码？这个开源神器让我彻底解放双手

发现一个宝藏开源项目，把 Claude Code / Codex 接入手机端，端对端加密，随时随地动动手指让 AI 干活。

前言

最近发现了一个很有意思的开源项目 —— Happy Coder 。

它的核心思路非常简单粗暴：用手机 App 远程连接服务器上的 Claude Code 或 Codex ，这样你不管是在通勤、在咖啡馆、还是在床上，都可以拿出手机，给服务器上的 AI 编程助手下达指令，让它帮你写代码、跑任务。全程通信 端对端加密 ，代码不会以明文离开你的设备。

本文就来记录一下我的完整上手过程。

---

一、下载 App + 安装 Happy CLI

手机端 App:

• iOS：App Store 搜索 Happy Coder

• Android：Google Play 搜索 Happy Coder（ 注意 ：国内安卓用户没有 Google Play，可以自己拉取源码、去掉 Google 框架后自行编译 APK 安装）

• 也提供了 Web App 版本，直接浏览器访问即可

服务器/本地机器端 ，安装 CLI：

npm install -g happy-coder

二、启动并完成身份认证

安装完成后，用 happy 替代 claude ，用 happy codex 替代 codex ，直接运行：

# 替代 claude
happy

# 替代 codex
happy codex

它会询问你的认证方式，支持两种：

1. Mobile App（手机 App 扫码）

2. Web Browser（网页浏览器）

我选择了 Mobile App 方式。选完之后，终端会生成一个 二维码 ，同时也提供了手动输入的 URL：

三、手机端 App 扫码连接

打开手机上的 Happy App（搜索 Happy Coder 下载），进入 终端 页面，按照提示：

1. 安装 Happy CLI（已完成）

2. 运行它（已完成）

3. 扫描二维码

点击「打开相机」扫码后，App 会显示已连接的终端，状态为 在线 ：

四、Remote 模式：从手机操控 Claude

连接成功后，服务器端的终端会自动进入 Remote Mode ，可以看到：

• Session 已初始化

• 使用的模型：claude-opus-4-6

• 当前工作目录：启动happy的所在目录

• 可用工具列表（Task、Bash、Grep、Write、WebSearch 等一大堆）

此时在手机端发送一条消息，服务器端的 Claude 就会收到并响应：

可以看到 Claude 自动尝试调用了 mcp__happy__change_title 工具（这是 Happy 提供的 MCP 工具，用于同步会话标题到手机端）。

五、切换到 Local 模式

按下空格键，可以从 Remote 模式切换到 Local 模式 ，也就是直接在服务器本地使用 Claude Code 的标准交互界面：

Local 模式下，就是我们熟悉的 Claude Code 标准界面，显示了欢迎信息和最近活动。

六、手机端体验

手机 App 这边也同步显示了整个会话过程：

• 已切换到 remote 模式

• Claude 回复「Hi! How can I help you today?」

• 标题变更为「New Chat」

• 再切换到 local 模式

终端列表页面可以看到已连接的服务器，显示 最后活跃时间 ，方便管理多个远程终端：

七、关于中继服务器

默认情况下，Happy Coder 使用官方提供的公共中继服务（api.cluster-fluster.com），需要能访问外网。

好消息是它 只做中继，不存数据、不解密内容 ，通信本身是端对端加密的，官方服务器看不到你的代码。

但如果你在公司内网环境、或者对数据安全有更高要求，可以参考项目中的 Happy Server 组件自建中继服务端，好处是：

• 无需访问外网，内网直通

• 可以接入公司内部/本地部署的模型

• 彻底避免数据出境的合规风险

自建方案需要参考项目仓库中的 Happy Server 部分文档，这里不展开。

八、核心原理简析

Happy Coder 的本质，是一个 CLI Wrapper + PTY 子进程代理 + 事件流转发器 。

它做了什么？

• 启动真实的 Claude Code 进程

• 监听 stdin / stdout

• 拦截 agent 的行为流（token、工具调用、日志等）

• 转换为"可同步的事件流"，推送到手机端

类比来说，它就像你做行情客户端时的 socket 代理层 ，或者 tmux + logging + RPC 的组合。

用 happy 替代 claude 启动，剩下的交给它：

# 原来
claude

# 现在
happy

九、使用场景畅想

有了这个工具，我能想到的使用场景：

• 通勤路上 ： 掏出手机给服务器上的 Claude Code 下任务，到公司的时候代码已经写完了

• 会议间隙 ： 让 AI 先跑着跑测试、查 bug，你开完会回来看结果

• 躺平模式 ： 设定好任务，睡前发给 Claude，第二天起来验收

当然，目前还是有些限制的，比如需要权限确认时，App 会给你发送 推送通知 提醒（这是 Happy Coder 的核心功能之一），你可以直接在手机上回复，或者切回 local 模式在终端操作（ App 也有提示：Permissions shown in terminal only）。

如果你希望 Claude 全程自动执行、不弹任何权限确认，可以加上 --yolo 参数（这是 Happy 提供的语法糖，等价于 --dangerously-skip-permissions）：

happy --yolo

这样手机端就不会再收到权限推送，发完指令真正"不用管"了。 注意：仅在你完全信任项目内容时使用。

另外还有一个 happy daemon 命令，可以在后台运行一个守护进程，让你 离开电脑后也能从手机远程新建 session ，不需要保持终端开着：

happy daemon

十、总结

Happy Coder 是一个很有创意的工具，核心亮点：

• 🔐 端对端加密 ： 代码不以明文离开你的设备，安全有保障

• 🔔 推送通知 ： Claude / Codex 需要权限时主动通知你，不会傻等

• ⚡ 秒切设备 ： 手机和电脑之间随时一键切换

• 🛠️ 完全开源 ： MIT 协议，无遥测，无追踪，可自审代码

尤其适合：

• 有远程服务器 / VPS 的开发者

• 习惯用 Claude Code / Codex 的 AI 编程玩家

• 想把 AI coding 融入碎片时间的效率党

参考

• https://github.com/slopus/happy