WenHaoFreeHappy Coder 使用指南：用手机操控 Claude Code 或 Codex 编程
当你离开电脑，却仍想继续推进 Claude Code 或 Codex 的任务时，Happy Coder 提供了一条更顺滑的路径：把本机的 AI 编程会话“投射”到手机上，让你在通勤、休息或会议间隙也能掌控进度。
本文基于 Happy Coder 官方站点与开源仓库信息进行整理，帮你快速理解它的定位、能力边界与落地流程。
Happy Coder 是什么？
Happy Coder 是一款 Claude Code 与 Codex 的移动/网页客户端。它通过在电脑端启动 CLI（happy），把会话同步到手机或 Web 端，让你随时查看进度、继续对话、接管操作。官方站点将其描述为“在手机和桌面上控制 Claude Code，开源且支持端到端加密”。
核心定位一句话：让 AI 编程会话从“只能在电脑前使用”变成“随时可控”。
参考：
它是如何工作的？
Happy Coder 由三部分组成：
- CLI 程序（happy）：运行在你的电脑上，启动 Claude Code/Codex 会话。
- 移动端 App / Web App：显示会话并允许你继续操控。
- 中继服务器：只转发加密数据，不读取内容。
官方文档明确指出：你在本机运行 happy 或 happy codex，即可用手机接管并继续同一会话。详情见官方文档与 README。
参考：
Happy Coder 的核心能力
基于官网与开源仓库信息，可总结为以下几个重点能力：
- 手机端接入 Claude Code/Codex：随时查看与继续会话。
- 端到端加密：消息传输加密，服务器仅做转发。
- 多端同步：同一会话可在电脑和手机之间切换。
- 开源可审计：MIT 许可，可自行评估或部署。
参考：
快速上手（官方步骤整理）
1. 安装移动端或 Web 端
官方提供 iOS、Android 以及 Web 端入口：
- iOS / Android：从应用商店下载安装
- Web：https://app.happy.engineering
参考：
2. 本机安装 CLI
npm install -g happy-coder文档说明：Happy 需要 Node.js 18+。如果你的 Node 版本较旧，需要先升级。
参考：
3. 启动会话并扫码绑定
happy --auth运行后会显示二维码，用手机 App 扫码绑定。
参考：
4. 用 happy 替代 claude / codex
# Claude Code
happy
# Codex
happy codex此时，你可以在手机上继续同一会话。
参考：
适合的使用场景
- 长任务监控：让 Claude Code 在电脑端跑长时间任务，手机端随时接管。
- 碎片化办公：会议间隙继续修补 prompt 或确认生成结果。
- 多项目并行：电脑上多会话运行，手机端重点盯一个进度。
安全与隐私建议
Happy Coder 官方强调端到端加密，但实际安全仍取决于你的使用习惯：
- 避免在公共 Wi-Fi 上直接传输敏感指令。
- 电脑端保持系统更新与磁盘加密。
- 只在可信设备上保持登录。
参考：
Stills 快照清单（快速上手卡片）
如果你想用“静态快照”方式快速复盘步骤，可用下面这份 Stills 清单：
- 安装移动端 App
npm install -g happy-coderhappy --auth扫码绑定happy/happy codex启动会话- 手机上继续对话或接管
这份清单可以作为手机端的“随手卡”，帮助你在 1 分钟内完成配置。
常见问题（FAQ）
Q1：Happy Coder 支持哪些平台？
官方提供 iOS、Android 与 Web 端客户端，同时电脑端需要安装 CLI。
参考：
Q2：必须用 happy 吗？能直接用 claude/codex 吗？
官方推荐用 happy 替代 claude，并用 happy codex 替代 codex，这样才能把会话接入移动端。
参考：
Q3：会话是否安全？
官方强调端到端加密，服务器仅转发加密数据。若你有更高安全要求，可进一步关注自托管方案。
参考：
总结
Happy Coder 本质上是 Claude Code 与 Codex 的移动遥控器。它不是替代 IDE，而是让你在离开电脑时也能控制 AI 编程会话的“入口”。对于需要随时追踪任务进度的开发者而言，这是一个轻量但实际价值很高的工具链补强。
如果你希望把 AI 编程变成随时可用的生产力，这类“移动端控制层”将越来越重要。