为什么 Happy Coder 要做实时同步¶
Happy Coder 不是让你在手机上写代码，而是把开发机的触手延伸到手机上。
每次跟别人介绍「我做了一个 Claude Code 的移动端 App」，对方第一反应都是：「你真的要在手机上写代码？」
不。绝对不是。整天在手机上写代码简直是折磨。
Happy Coder 做的事情本质上不一样：它延伸了你对开发机的控制力。核心原则只有一个——你应该能从任何地方、用同一个会话、零摩擦地与 Claude Code 交互。
两种路线：完整工作流 vs 轻量扩展¶
大多数移动端 AI 编程工具走的是「后台 Agent」路线，Happy Coder 选择了更轻量的延伸方案。
多数移动 AI 编程工具提供的是「后台 Agent」模式。这是一套完整的工作流方案：你从手机发请求，它们在云端沙盒里执行，生成代码、创建 PR、对接开发流程。这个方向没问题，对想要端到端移动编程体验的团队来说确实好用。
但这也意味着一种承诺。这些是商业产品，有托管成本、独立的 AI 用量计费、自己的规划-执行-Review 工作流。你不只是增加了一个能力——你是在引入一整套体系。
Happy Coder 故意走了不同的路。它是一个轻量的开源工具，不改变你现有的任何设置。你继续用自己的 Claude Code 订阅、自己的 IDE、自己的工作流。我们只做一件事：延伸你的触手。
实时同步：恰到好处的连接¶
在笔记本上运行 happy，就能通过 WebSocket 和手机双向实时通信。
当你在笔记本上运行 happy 命令时，它会包裹 Claude Code 并建立到手机的实时连接。你连接的不是沙盒或独立服务——而是直接连到你真实的 Claude Code 会话，跑在你真实的机器上，操作你真实的代码库。
在手机上输入一条消息，它会立刻出现在笔记本的终端里。Claude Code 的回复同时显示在两个设备上。放下手机，在笔记本上继续同一个对话。不用导出、不用交接、不用重建上下文。
这就是 Unix 哲学在移动开发上的体现：把一件事做好。这件事就是——延伸你的触手。
为什么这在实际中很重要¶
你换个设备继续交互，会话不中断、上下文不丢失。
想象一个典型场景：你在工位上用完整 IDE 审查一个复杂的重构，在文件间跳来跳去理解改动。然后你需要离开——可能去倒杯咖啡，可能要去开会。
有了 Happy Coder，你拿起手机，走路的时候继续给 Claude Code 描述下一步改动。回到工位时，这些改动已经在终端里执行了。会话没断过，上下文没重置。你只是换了一个用来交互的设备而已。
你真正需要它的那些时刻¶
最好的调试灵感往往不在电脑前产生，Happy Coder 让你能立刻行动。
你一定有过这种感觉——被困在某个没带笔记本的地方。也许你答应了一个社交活动没带电脑，因为「不会待太久」。结果两个小时过去了，你坐在那里脑子里有个想法在燃烧。你可以给自己写个备忘，但你真正想做的是快速试一下——看看 Claude Code 能不能实现你正在琢磨的方案。
或者你在诊所等叫号，突然想通了那个一直在纠结的 bug。你不需要在手机上做完整的 code review——你只想告诉 Claude Code「我觉得竞态条件出在事件处理器，不是状态更新」，然后看它发现了什么。
这些不是计划好的编程时段。你不是要替换桌面工作流。你只是想更灵活一点，在灵感来临时抓住它。有时候最好的调试，恰恰发生在你离开工位、大脑在后台处理问题的时候。Happy Coder 让你能立刻把这些洞察付诸行动。
我已经记不清多少次——在咖啡店、家庭聚餐、朋友家里——有了编程灵感却无法行动的那种特别的沮丧。代码库感觉遥不可及。当然，我可以在 GitHub 手机版上看看，写个详细的笔记。但我真正想做的是快速跑一个实验、给 Claude Code 一个方向调整、或者验证一个想法是否可行。
技术实现¶
WebSocket 双向通信，CLI 是数据源，手机是同步界面。
同步本身很直接：WebSocket 连接提供 CLI 和移动端之间的实时双向通信。CLI 是数据源头——它跑着 Claude Code，管理文件系统，执行命令。移动端是该会话的同步界面。
两个设备都能发起消息和接收回复。命令历史、上下文和状态在连接中持续保留。没有主/从关系——只是同一个会话的两个窗口。
这种简洁是有意为之的。通过聚焦于同步而非复制，我们避免了复杂的状态管理，保证了一致性。
手机端适合什么（不适合什么）¶
手机擅长自然语言描述和维持动力，精细操作仍需桌面。
我们明确一下这能做什么、不能做什么。
| 场景 | 适合设备 |
|---|---|
| 用自然语言描述改动和功能 | 手机 |
| Review Claude Code 的方案并给反馈 | 手机 |
| 离开工位时保持进度 | 手机 |
| 随时记录灵感 | 手机 |
| 规划和架构讨论 | 手机 |
| 跨多文件的代码审查 | 桌面 |
| 调试和测试 | 桌面 |
| 复杂 Git 操作 | 桌面 |
| 需要多窗口或精确编辑的任务 | 桌面 |
两者的力量来自在同一个持续会话中使用。你不是在手机和桌面之间二选一——你是在为当下的时刻选择合适的界面。
一个尊重真实工作方式的工具¶
编程有大量思考环节，而思考不总在桌前发生。
编程包含大量思考，而思考并不总发生在桌前。有时你最好的洞察来自散步途中、午餐时间、或者睡前那些安静的时刻。
Happy Coder 承认这个现实。它不试图在手机上复刻桌面环境（那从来行不通）。相反，它给你一个轻量的方式，无论身在何处都能维持与 Claude Code 的对话，确信回到桌前时一切都在你需要的位置。
目标不是改变你写代码的方式。而是移除那个人为限制——你只能坐在电脑前才能使用 AI 编程助手。通过实时同步延伸你的触手，Happy Coder 让你按自己的节奏、在任何灵感发生的地方与 Claude Code 协作。
Happy Coder 现已可用。需要在开发机上安装 Claude Code CLI 和 Happy Coder 移动端 App。