1. 项目定位与用途
Happy 是 Claude Code 和 Codex 的官方跨平台客户端，定位为远程 AI 编程助手控制器。它提供统一的移动端、Web 端和命令行接口，让开发者可以通过手机或浏览器随时监控、控制和接收 AI 编码代理的通知。项目核心价值在于打破设备限制，实现真正的随时随地编码，同时通过端到端加密确保代码隐私。
项目档案应用项目
slopus/happy 是什么？用途、安装与使用指南
Happy 是 Claude Code 和 Codex 的跨平台客户端，支持移动端、Web 端和 CLI，提供端到端加密、实时语音和设备间无缝切换。本文介绍其功能、架构、安装和使用方法。
AI 总结
Happy 是一个跨平台客户端应用，提供移动端、Web 端和 CLI 工具，用于远程控制 Claude Code 和 Codex AI 编程助手，支持端到端加密、实时语音和设备间无缝切换。
中文项目介绍
Happy 是一个专为 AI 编程助手设计的远程控制客户端，支持 Claude Code 和 Codex。
它解决了开发者无法在离开电脑时访问和控制本地 AI 编码代理的痛点，通过移动设备实时监控进度、接收推送通知，并在多设备间即时切换控制权。
核心功能包括：移动端和 Web 端访问、端到端加密保障代码隐私、实时语音交互、推送通知、设备间无缝切换。
技术架构上，项目采用 monorepo 组织，包含 Happy App（Expo 移动端/Web UI）、Happy CLI（命令行封装）、Happy Agent（远程代理控制）和 Happy Server（后端服务）。后端基于 Node.js + Fastify，使用 Socket.IO 进行实时通信，数据存储依赖 Postgres、Redis 和 S3。协议设计强调加密边界和向后兼容，支持 legacy（NaCl secretbox）和 dataKey（AES-256-GCM）两种加密模式。
详细信息与使用说明
2. 解决的问题
Happy 解决了三个核心问题：一是开发者无法在离开电脑时查看 AI 编码进度的不便；二是缺乏移动端控制 AI 代理的官方方案；三是远程通信中的代码安全和隐私担忧。通过将本地 CLI 包装为可远程控制的服务，并配合加密同步，Happy 让 AI 编程助手真正实现了"随身携带"。
3. 适用场景
主要适用场景包括：外出时通过手机查看 AI 编码进度；接收 AI 需要权限或错误的即时推送通知；在手机和电脑之间快速切换控制权；对代码传输有高安全要求、需端到端加密的团队协作。特别适合使用 Claude Code 或 Codex 进行 side project 开发的独立开发者，以及需要随时监控自动化编码任务的工程师。
4. 安装方式
安装分三步：第一步下载移动端应用，iOS 用户从 App Store 下载，Android 用户从 Google Play 下载，或直接使用 Web 版本；第二步在计算机上全局安装 CLI 工具，执行 `npm install -g happy`；第三步使用 `happy claude` 或 `happy codex` 命令替代原有的 `claude` 或 `codex` 命令。仓库中未明确给出从源码构建的详细步骤。
5. 使用方式
基本使用流程：在计算机终端运行 `happy claude` 或 `happy codex` 启动 AI 会话；在移动端应用中连接同一账户并启动会话，系统会自动重启为远程控制模式；按键盘任意键可切换回计算机本地控制。CLI 还提供子命令如 `doctor`、`auth`、`connect` 等用于诊断、认证和连接管理。详细使用指南参考官方文档网站。
6. 技术架构与特点
Happy 采用模块化 monorepo 架构，包含六个核心包：happy-app（Expo 移动端/Web）、happy-cli（命令行工具）、happy-agent（远程代理控制）、happy-server（后端服务）、happy-wire（通信层）、happy-app-logs（日志查看）。后端基于 Node.js + Fastify，使用 Socket.IO 处理实时事件，数据层采用 Postgres（持久化）、Redis（缓存/事件总线）、S3（文件存储）。协议设计遵循小表面区域、显式事件类型、乐观并发等原则，加密支持 legacy 和 dataKey 两种模式，确保向后兼容。
思维导图
Happy
Happy App
移动客户端 (Expo)
Web UI
Happy CLI
命令封装 (claude/codex)
守护进程
API 客户端
Happy Agent
会话管理
远程控制
状态监控
Happy Server
Fastify HTTP API
Socket.IO 实时通信
事件路由
数据存储 (Postgres/Redis/S3)
Happy Wire
通信协议
加密层
核心特性
端到端加密
设备切换
推送通知
实时语音
常见问题
Happy 如何保证代码安全？
Happy 采用端到端加密机制，支持 legacy（NaCl secretbox）和 dataKey（AES-256-GCM）两种加密模式。代码在传输和存储过程中均保持加密状态，服务器无法解密内容。密钥通过临时密钥对进行包装，确保只有授权设备能解密。
是否必须付费使用 Happy？
Happy 本身是 MIT 许可的开源项目，可免费使用。但底层依赖的 Claude Code 和 Codex 服务由 Anthropic 提供，可能需要相应 API 配额或订阅，这部分费用需用户自行承担。
支持哪些操作系统和设备？
Happy 提供 iOS 和 Android 移动应用，以及 Web 应用。CLI 工具支持 macOS、Linux 和 Windows。所有组件通过加密通道协同工作，实现跨平台远程控制。
如何从手机切换回电脑控制？
当会话在远程模式（手机控制）下运行时，只需在电脑终端按下任意键，Happy 会自动将控制权切换回本地计算机，无需额外操作。
Happy 与直接使用 Claude Code 有何区别？
直接使用 Claude Code 仅限于本地终端操作；Happy 在其基础上增加了远程控制层，允许通过移动设备监控、接收通知和切换控制权，同时提供端到端加密和统一的多设备体验，但需要运行额外的 Happy Server 服务。