Happy Docs 中文文档

常见问题

基础问题

Happy Coder 是什么？

Happy Coder 是一个移动端 App，让你从手机控制多台电脑上的 AI 编程代理。

Happy Coder 免费吗？

完全免费，没有坑：

  • 无用量限制 —— 想跑多少会话就跑多少
  • 无设备限制 —— 所有设备都能装
  • 开源 (MIT) —— 随便 fork、修改、学习

有没有锁定效应？

没有任何锁定。 原因如下：

  • 开源 —— 全部代码在 GitHub 上
  • 可自建 —— 可以跑自己的中继服务器
  • 无需账号 —— 没有需要导出或迁移的数据
  • 基于原生 Claude Code —— 不是私有封装

你可以随时停用 Happy Coder，工作流零变动。你的 Claude Code 配置保持不变。

为什么说 Happy Coder 简单？

Happy Coder 去掉了移动端使用 Claude Code 的所有摩擦。

  1. 无注册流程 —— 下载即用。无需邮箱验证、账号创建、信用卡。这是真正的开发者工具，不是 SaaS 产品。
  2. 天然跨平台 —— 任何电脑（Mac、Windows、Linux）配任何手机（iOS、Android）。用 Android 手机控制 Mac Mini 上的 Claude Code，用 iPad 控制树莓派。
  3. 就是好用 —— 优雅处理网络问题，自动重连，离线排队消息。不会像 SSH 那样断掉或 tmux 崩溃。
  4. 智能错误处理 —— 检测常见问题并给出精确修复建议。端口被占用？告诉你哪个进程。Claude Code 找不到？指引安装路径。
  5. Unix 哲学 —— 只做一件事并做好：把 Claude Code 延伸到移动端。不试图成为 IDE、项目管理器或云平台。

为什么 Happy Coder 免费且开源？

三个原因：隐私、控制和可持续性。

隐私：你的代码是你的事。端到端加密加上开源代码，你可以验证我们看不到你的工作。有限的、匿名化的产品分析仅用于衡量核心功能和提前发现 bug，从不包含代码或对话内容。

控制：你拥有你的工具。自建中继服务器、修改代码、添加功能、删除功能——按你的需求塑造。

可持续性：开源项目无法对你"跑路"。当 VC 支持的创业公司激进转型或关门时，你就被晾在那了。只要你想用，Happy Coder 就一直能用。

Claude Code 有移动端 App 吗？

有！Claude Code 的移动端 App 就是 Happy Coder。 使用方式：

  1. 从 App Store (iOS) 或 Google Play (Android) 下载 Happy Coder
  2. 在电脑上安装配套工具：npm install -g happy
  3. 在电脑上运行 happy 启动连接
  4. 用手机扫描二维码完成配对

手机和电脑通过端到端加密实时同步，你可以在一个设备上开始编程、在另一个设备上无缝继续。

如何安装？

Happy Coder（移动端 Claude Code 客户端）：
1. 从应用商店下载 Happy Coder App
2. 在电脑上安装：npm install -g happy
3. 在电脑上运行 happy 命令
4. 用手机扫描二维码完成安全连接

Claude Code（桌面 CLI）：
- 用 npm 安装：npm install -g claude-code
- 设置 API key
- 支持 Mac、Windows 和 Linux

Claude（AI 聊天）：直接在浏览器里访问 claude.ai。

平台支持

手机上能用 Claude 吗？

需要区分两个产品：

Claude（AI 聊天）：可以，直接用手机浏览器访问 claude.ai。

Claude Code（开发者工具）：可以，通过 Happy Coder App！它让你从手机控制电脑上运行的 Claude Code。你可以：
- 在手机上开始编程对话
- 在笔记本/台式机的终端中继续同一个对话，就像在本机启动 Claude Code 一样
- 当 Claude Code 需要输入或代码准备好审查时收到推送通知

有 Apple App 吗？

Claude（AI 聊天）：Anthropic 有官方 iOS App，也可以用浏览器访问 claude.ai。

Claude Code：有！Happy Coder App 在 App Store 可下载，支持 iPhone 和 iPad。免费、100% 开源，是在移动端使用 Claude Code 的最佳方式。

手机上能写代码吗？

完全可以！ Happy Coder 为移动端编程设计，且聪明地区分了什么适合在手机上做、什么适合在桌面做：

适合手机的任务 适合桌面的任务
通勤时规划新功能 多窗口审查生成的代码
离开工位时头脑风暴 用完整 IDE 做精确编辑
用语音与 Claude Code 对话（橡皮鸭调试） 用所有工具测试和调试
睡前设置编程任务（Claude Code 在你睡觉时工作）
收到推送通知说代码改好了

核心优势在于同一个对话中无缝切换两端。

使用与功能

如何使用 Happy Coder？

  1. 下载安装 App
  2. 配置桌面连接（见上方安装步骤）
  3. 扫描二维码完成连接
  4. 从任何地方开始与 Claude Code 聊天
  5. 使用语音功能解放双手

哪个 Claude 模型最适合编程？

Claude-4.1 Opus 目前是编程的最佳模型。 优势包括：

  • 出色的代码理解能力
  • 智能问题解决
  • 处理大型项目的能力
  • 快速且准确的响应

Claude-4 Sonnet 同样是很好的编程模型。Claude Code 和 Happy Coder 会自动为你的任务选择最佳模型。

定价

Claude Code 多少钱？

Claude Code 使用订阅制，超额部分按量计费：

项目 说明
典型费用 每月 $20、$100、$200 档
免费层 Claude Code 没有免费使用额度
App 免费 Happy Coder App 和 Claude Code CLI 本身不要钱
企业方案 有团队特别计划

实际花费取决于：编程任务的复杂度、对话长度、使用的 AI 模型。

App 功能

Happy Coder 移动端 App 包含：

  • 开源 —— MIT 许可（代码在 github.com/slopus/happy）
  • 原生移动设计 —— 专为手机和平板打造
  • 无缝工作流 —— 与电脑完美同步
  • 端到端加密 —— 代码隐私无忧
  • 语音交互 —— 与 Claude Code 免提对话
  • 推送通知 —— 代码准备好了第一时间知道
  • 离线友好 —— 网络差也能排队任务

与竞品对比

Claude 比 ChatGPT 更适合编程吗？

两者各有所长，但 Claude Code 有独特优势：

  • 更好的项目理解 —— 了解你的整个代码库
  • 移动端编程 —— 通过 Happy Coder 随时随地工作
  • 直接编辑文件 —— 修改你的实际代码文件
  • IDE 集成 —— 支持 VS Code、Cursor 等编辑器
  • 大项目处理 —— 更擅长复杂的多文件项目

ChatGPT 在解释代码和生成示例方面同样出色。最佳选择取决于你的工作流和需求。

技术问题

手机和桌面之间延迟多少？

通常约 300ms。 包括：
- 加密/解密时间（约 10ms）
- 网络往返（平均约 200ms）
- 处理开销（约 90ms）

对比：SSH 通过移动网络通常有 100-200ms 延迟，但移动端体验极差。

能同时跑多个 Claude Code 会话吗？

可以！支持多种方式并行：
- 不同机器上的不同会话
- 同一机器上的多个会话（不同端口）
- 在手机上即时切换会话
- 每个会话维护独立的上下文和历史

支持 MCP 工具吗？

完全支持所有 MCP (Model Context Protocol) 工具：
- 现有 MCP 配置无需修改即可使用
- 桌面上所有 MCP 工具通过移动端都能用
- 权限提示会在手机上弹出等你批准
- 自定义 MCP 工具完全支持

能用自定义 Claude Code agents 吗？

可以，所有自定义 agents 完美兼容：
- ~/.claude/agents/ 中的 agents 自动同步
- 自定义斜杠命令在移动端可用
- 切换 agent 时保留对话上下文
- 可以从手机创建新 agent

断网了怎么办？

Happy Coder 优雅处理断线：
- 消息在设备上排队直到恢复连接
- Claude Code 在电脑上继续工作
- 网络恢复时自动重连
- 不丢消息、不断会话
- 从断点处无缝接续

能在 Claude Code 执行前审查代码变更吗？

可以，Happy Coder 会展示：
- 所有变更的文件 diff
- 文件操作的权限提示
- 回滚到 checkpoint 的能力
- 完全可见 Claude Code 正在做什么

安全与隐私

Happy Coder 或中继服务器能看到我的代码吗？

不能。 一切都是端到端加密的：
- 加密发生在你的设备上，发送前就已完成
- 中继服务器只看到加密数据块
- 只有持有共享密钥的设备才能解密
- 我们确实无法读取你的代码，即使想也不行

公司的私有代码安全吗？

安全，Happy Coder 为企业级场景设计：
- 端到端加密保护你的知识产权
- 可将中继服务器自建在你的基础设施上
- 自建时没有任何数据触及我们的服务器
- 开源代码可审计
- 有限的、匿名化的产品分析仅用于衡量核心功能和发现 bug

Happy Coder 收集什么数据？

Happy 收集有限的、匿名化的产品分析数据，用于衡量核心功能表现和提前发现 bug。我们不收集消息内容、代码或其他加密会话内容。

  • 分析记录简单的操作和结果，如连接、发送消息、App 更新
  • 事件可能包含基本的 App、操作系统和设备上下文，用于诊断可靠性问题
  • 你可以在 App 设置中关闭分析

中继服务器存储的加密数据块我们无法读取。

故障排除

"Claude Code not found" 错误

Happy Coder 需要先安装 Claude Code：

npm install -g claude-code
claude-code --version  # Verify installation
happy  # Now this should work

二维码扫不上

常见修复方法：
1. 提高屏幕亮度
2. 清洁摄像头镜片
3. 放大二维码：happy --qr-size large
4. 使用手动码：happy --no-qr（显示可手输的文本码）

"Port already in use" 错误

其他进程占用了端口 8765：

# Find what's using the port
lsof -i :8765

# Kill it
kill -9 [PID]

# Or use a different port
happy --port 8766

无法连接中继服务器

检查是否在公司防火墙后面：
1. 尝试用蜂窝数据代替 WiFi
2. 请 IT 部门将 relay.happy.engineering 加入白名单
3. 或者自建中继服务器

需要更多帮助？