> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/slopus/happy) · [上游 README](https://github.com/slopus/happy/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
Claude Code 与 Codex 的移动与 Web 客户端
随时随地使用 Claude Code 或 Codex,全程端到端加密。
[📱 **iOS 应用**](https://apps.apple.com/us/app/happy-claude-code-client/id6748571505) • [🤖 **Android 应用**](https://play.google.com/store/apps/details?id=com.ex3ndr.happy) • [🌐 **Web 应用**](https://app.happy.engineering) • [🎥 **观看演示**](https://youtu.be/GCS0OG9QMSE) • [📚 **文档**](https://happy.engineering/docs/) • [💬 **Discord**](https://discord.gg/fX9WBAhyfD)
步骤 1:下载应用
步骤 2:在电脑上安装 CLI
```bash
npm install -g happy
```
> 从 `happy-coder` 包迁移而来。感谢 [@franciscop](https://github.com/franciscop) 捐赠了 `happy` 包名!
步骤 3:改用 `happy`,不再使用 `claude` 或 `codex`
```bash
# Instead of claude, use:
happy claude
# or
happy codex
```
## 工作原理
在电脑上,通过我们的封装层运行 `happy`,而不是 `claude`,或运行 `happy codex` 而不是 `codex`,即可启动 AI。当你想用手机控制编程代理时,会话会在远程模式下重新启动。若要切回电脑,在键盘上按任意键即可。
## 🔥 为何选择 Happy Coder?
- 📱 **移动端访问 Claude Code 与 Codex** - 离开工位也能查看 AI 正在构建什么
- 🔔 **推送通知** - Claude Code 与 Codex 需要权限或遇到错误时及时提醒
- ⚡ **即时切换设备** - 一键在手机或桌面之间接管控制
- 🔐 **端到端加密** - 你的代码绝不会以未加密形式离开你的设备
- 🛠️ **开源** - 可自行审计代码,无遥测、无追踪
## 📦 项目组件
- **[Happy App](https://github.com/slopus/happy/tree/main/packages/happy-app)** - Web UI 与移动客户端(Expo)
- **[Happy CLI](https://github.com/slopus/happy/tree/main/packages/happy-cli)** - Claude Code 与 Codex 的命令行界面
- **[Happy Agent](https://github.com/slopus/happy/tree/main/packages/happy-agent)** - 远程代理控制 CLI(创建、发送、监控会话)
- **[Happy Server](https://github.com/slopus/happy/tree/main/packages/happy-server)** - 加密同步的后端服务器
## 🏠 我们是谁
我们是一群散落脚湾区咖啡馆与黑客屋的工程师,午休时总在查看 AI 编程代理在我们个人项目上的进展。Happy Coder 源于一个痛点:离开键盘时没法偷看一眼 AI 编程工具在帮我们做副业项目。我们相信最好的工具来自解决自己的痛点,并与社区分享。
## 📚 文档与贡献
- **[文档网站](https://happy.engineering/docs/)** - 了解如何高效使用 Happy Coder
- **[贡献指南](docs/CONTRIBUTING.md)** - 如何参与贡献、PR 规范与开发环境配置
- **[在 github.com/slopus/slopus.github.io 编辑文档](https://github.com/slopus/slopus.github.io)** - 帮助改进我们的文档与指南
## 许可证
MIT 许可证 - 详见 [LICENSE](LICENSE)。