Happy Coder：在手机上控制 Claude Code 的完整指南
- 2025-12-17 14:46:28
- 技术博客 原创
- 74
Happy Coder：在手机上控制 Claude Code 的完整指南
你是否曾经在运行一个长时间的 Claude Code 任务时，不得不一直守在电脑前等待？或者在外出时突然需要检查 AI 编程助手的工作进度？Happy Coder 就是为解决这些痛点而生的开源工具。 本文将详细介绍 Happy Coder 的功能特性、安装配置和使用技巧，帮助你实现真正的移动编程体验。什么是 Happy Coder？
Happy Coder 是一个免费、开源的移动应用和 CLI 工具组合，让你可以从手机上控制和监控 Claude Code（以及 Codex）会话。它由三个核心组件组成：- CLI 程序 - 运行在你的电脑上，监控 Claude Code 的活动
- 移动应用 - 在手机上显示加密数据，支持 iOS、Android 和 Web
- 中继服务器 - 在设备间传递加密消息（无法读取你的数据）
整个系统采用端到端加密，使用与 Signal 相同的加密技术（TweetNaCl），确保你的代码隐私安全。
核心功能亮点
1. 无缝设备切换
在电脑和手机之间即时切换控制权。当你需要从手机接管时，只需在 App 中操作；想切回电脑时，按任意键即可。会话状态实时同步，不会丢失任何上下文。2. 智能推送通知
当 Claude Code 需要你的许可、遇到错误或完成任务时，手机会收到即时推送通知。再也不用守在电脑前等待了。3. 语音控制
不仅仅是语音转文字，而是真正的语音到行动（voice-to-action）。你可以通过语音命令来编码、调试和管理项目，实现完全解放双手的编程体验。4. 多会话管理
可以同时维护多个 Claude Code 会话，每个会话对应不同的项目，拥有独立的状态管理和对话历史。5. 权限控制
实时审批系统让你可以在执行前审查和授权文件编辑、MCP 工具操作等敏感动作。6. 离线优先设计
即使在网络不稳定的情况下，应用也会将任务排队并继续工作，非常适合网络环境不佳的场景。安装步骤
前置条件
- Node.js 20.0.0 或更高版本
- Claude CLI 已安装并完成认证（
claude命令可用）
第一步：安装 CLI 工具
打开终端，运行以下命令全局安装 happy-coder：npm install -g happy-coder
安装完成后，你将获得两个命令：happy（主命令）和 happy-mcp（MCP 桥接）。
第二步：下载移动应用
根据你的设备选择下载渠道：- iOS：App Store 搜索 "Happy: Claude Code Client"
- Android：Google Play 搜索 "Happy Coder"
- Web：访问 https://app.happy.engineering
第三步：认证登录
运行认证命令：happy auth login
你可以选择两种认证方式：
方式一：移动端认证- 选择 "Mobile" 选项
- 打开 Happy App
- 扫描终端显示的二维码
- 选择 "Web" 选项
- 在浏览器中完成 OAuth 认证流程
认证凭据会安全存储在 ~/.happy/access.key 文件中。
第四步：验证安装
运行以下命令检查安装状态：检查版本
happy --version
完整系统诊断
happy doctor
检查守护进程状态
happy daemon status
基础使用
启动会话
使用happy 替代 claude 命令启动会话：
happy
这将自动：
- 检查认证状态
- 启动后台守护进程（如需要）
- 以远程模式启动 Claude Code
- 显示二维码供移动设备扫描连接
使用 Codex 模式
如果你想使用 Codex 而不是 Claude Code：happy codex
连接移动设备
启动会话后，终端会显示一个二维码。打开手机上的 Happy App，扫描二维码即可建立安全连接。连接建立后，你可以：- 查看 Claude Code 的实时输出
- 发送指令和消息
- 审批权限请求
- 接收任务完成通知
常用命令详解
happy auth - 认证管理
登录
happy auth login
登出
happy auth logout
查看认证状态
happy auth status
happy daemon - 守护进程管理
守护进程是 Happy Coder 的核心，它在后台持续运行，管理多个会话的生命周期。查看守护进程状态
happy daemon status
启动守护进程
happy daemon start
停止守护进程
happy daemon stop
重启守护进程
happy daemon restart
happy notify - 推送通知
向你的移动设备发送自定义推送通知：happy notify "部署完成！"
happy doctor - 系统诊断
当遇到问题时，运行诊断命令检查系统状态：happy doctor
这将检查：
- Node.js 版本
- Claude CLI 安装状态
- 网络连接
- 守护进程状态
- 认证状态
happy connect - API 密钥管理
将 AI 服务商的 API 密钥存储到 Happy 云端：happy connect
高级配置
命令行选项
指定 Claude 模型
happy -m opus
设置权限模式（auto/default/plan）
happy -p auto
传递环境变量给 Claude Code
happy --claude-env KEY=VALUE
传递额外的 Claude CLI 参数
happy --claude-arg --verbose
环境变量配置
你可以通过环境变量自定义 Happy Coder 的行为：自定义 API 端点
export HAPPY_SERVER_URL=https://your-server.com
自定义 Web 应用 URL
export HAPPY_WEBAPP_URL=https://your-webapp.com
自定义数据目录
export HAPPY_HOME_DIR=/path/to/happy/data
禁用 macOS 休眠阻止
export HAPPY_DISABLE_CAFFEINATE=true
启用实验性功能
export HAPPY_EXPERIMENTAL=true
实际使用场景
场景一：监控长时间任务
当你让 Claude Code 执行一个需要几十分钟的重构任务时，不必一直守在电脑前。用 Happy 启动任务后，你可以去开会、吃饭，手机会在任务完成或需要输入时通知你。场景二：移动办公
在通勤路上或咖啡店，你可以通过手机继续昨天的编程会话。查看 Claude Code 的分析结果，审批文件修改，甚至通过语音下达新的指令。场景三：多项目管理
作为技术负责人，你可能同时管理多个项目。Happy Coder 让你可以在手机上快速切换不同项目的 Claude Code 会话，随时了解各个项目的进展。场景四：紧急调试
收到生产环境告警时，即使不在电脑前，你也可以立即通过手机启动 Claude Code 进行问题诊断，争取宝贵的处理时间。安全特性
Happy Coder 在安全方面做了大量工作：- 端到端加密 - 使用 TweetNaCl（与 Signal 相同的加密库）
- 本地加密 - 数据在传输前在本机加密
- 零知识架构 - 中继服务器无法读取你的代码和消息
- 会话密钥隔离 - 每个会话使用独立的加密密钥
- 完全开源 - 代码托管在 GitHub，可以自行审计
- 可自托管 - 支持部署私有服务器
注意事项
- 网络依赖 - 移动端功能需要互联网连接
- 电脑需运行 - 手机控制依赖电脑上运行的守护进程
- 电池消耗 - 长时间使用移动 App 可能增加电池消耗
- Claude CLI 前置 - 必须先安装并认证 Claude CLI
常见问题
Q: 连接不上移动设备怎么办？
- 确保电脑和手机都有网络连接
- 运行
happy doctor检查系统状态 - 尝试重启守护进程：
happy daemon restart - 重新扫描二维码建立连接
Q: 推送通知收不到？
- 检查手机的通知权限设置
- 确认 App 在后台没有被系统杀死
- 检查网络连接是否正常
Q: 如何更新 Happy Coder？
npm update -g happy-coder
更新后守护进程会自动检测版本变化并重新加载。
总结
Happy Coder 是一个设计精良的开源工具，它完美解决了 Claude Code 用户的移动办公需求。通过端到端加密确保安全，通过简洁的 CLI 设计降低使用门槛，通过丰富的功能满足各种场景需求。 如果你是 Claude Code 的重度用户，Happy Coder 绝对值得一试。它免费、开源、安全，能显著提升你的开发效率和灵活性。相关链接
- 官网：https://happy.engineering
- GitHub CLI：https://github.com/slopus/happy-cli
- GitHub App：https://github.com/slopus/happy
- iOS App Store：搜索 "Happy: Claude Code Client"
- Android Google Play：搜索 "Happy Coder"
- Web 版：https://app.happy.engineering
发表评论
