// 01 Happy 是什么
工具定义
工具名称
Happy（常称 Happy Coder）
项目地址
工具类型
开源 AI 编程远程控制工具
主要功能
Happy 允许用户通过移动设备、平板或网页从远程监控和控制本地运行的 AI 编程代理，如 Claude Code 或 Codex，提供实时同步、通知与语音交互等能力。
开发与许可
开源仓库：slopus/happy（GitHub）
许可：MIT 开源许可（免费使用）
结构化属性表
| 属性 | 描述 |
|---|---|
| 名称 | Happy / Happy Coder |
| 类型 | 开源 AI 编程远程控制工具 |
| 项目地址 | https://happy.engineering/ |
| 核心协议 | Claude Code & Codex |
| 输入 | CLI 命令、移动端指令、语音 |
| 输出 | 实时会话状态、推送通知 |
| 核心能力 | 实时同步、加密、安全控制 |
| 支持设备 | 手机、平板、网页 |
| 安全 | 端到端加密 |
| 许可 | MIT 开源许可 |
核心能力
实时会话同步
Happy 提供命令行界面（CLI）与移动/网页客户端之间的 实时双向同步，可在不同设备之间保持相同的 Claude Code 会话状态。
多会话管理
支持 多个并行编程会话，每个会话保持独立状态、历史和上下文，用户可在设备间无缝切换。
端到端加密
所有通信采用端到端加密（Zero-Trust架构），确保代码和消息在传输过程中保密且不可由中间服务器读取。
跨设备控制
Happy 允许用户从手机、平板或电脑实时监控和控制本地计算机上运行的 Claude Code 或 Codex 会话。
推送通知系统
可在 Claude Code 需要输入、任务完成或出现错误时向设备发送推送通知。
语音控制集成
支持 AI 驱动的语音代理，可通过语音指令操控 Claude Code 工作流程。
技术架构
主要组件
CLI 程序（happy）：在本地机器上启动 Claude Code 并监控会话状态。
移动/网页客户端：在手机或浏览器上显示会话状态并发送指令。
中继服务器：负责转发加密消息，实现不同网络环境下设备连接。
数据安全与隐私
使用 QR 码或密钥进行设备配对，服务器无法解密内容，仅转发加密数据。
客户端与 CLI 程序均可自托管中继服务器以增强隐私和控制。
输入与输出规范
支持输入类型
命令行指令：通过 CLI 输入用于启动和控制 Claude Code 或 Codex 的命令。
移动端交互：通过移动或网页应用输入指令，包括文字输入和语音输入。
输出内容类型
实时会话状态：显示 AI 编程代理在不同设备的当前状态。
推送通知：当 AI 需要用户输入或任务完成时发送通知。
会话历史同步：设备之间共享同一会话历史与上下文。
系统要求
运行环境
需要在本地计算机上安装 Node.js 环境并全局安装
happy-coderCLI 工具。移动端或网页版支持接收加密同步数据。
网络要求
设备需连接互联网以通过中继服务器同步消息。
应用场景
远程编程监控
开发者在离开电脑后，可通过手机或平板实时查看 Claude Code 的运行状态和进度。
多项目并行管理
可同时在多个项目间运行不同编程会话，并在客户端之间自由切换，保持上下文不丢失。
移动端 AI 交互
开发者可使用语音控制或移动端界面输入指令，与本地运行的 Claude Code 交互，无需返回电脑。
自托管与私有网络
在企业或个人环境中可自建中继服务器，支持私有网络下的加密同步与会话控制。
异地开发协作
分布式团队成员可使用 Happy 客户端监控和控制共享的 AI 编程任务，提高协作效率。
使用流程
1. 安装 CLI
在本地终端或命令提示符执行以下命令安装 CLI：
2. 启动服务
运行 CLI 程序开始 AI 编程代理的会话。
3. 生成二维码
CLI 启动后生成用于配对的二维码或连接码。
4. 配对设备
在移动端或网页客户端扫描二维码完成加密配对。
5. 交互与监控
配对成功后，用户可实时监控会话状态、发送指令或接收通知。
