Files
2026-07-13 10:35:43 +00:00

93 lines
4.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/slopus/happy) · [上游 README](https://github.com/slopus/happy/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="/.github/logotype-dark.png">
<source media="(prefers-color-scheme: light)" srcset="/.github/logotype-light.png">
<img src="/.github/logotype-dark.png" width="400" alt="Happy">
</picture>
</div>
<h1 align="center">
Claude Code 与 Codex 的移动与 Web 客户端
</h1>
<h4 align="center">
随时随地使用 Claude Code 或 Codex,全程端到端加密。
</h4>
<div align="center">
[📱 **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)
</div>
<img width="5178" height="2364" alt="github" src="/.github/header.png" />
<h3 align="center">
步骤 1:下载应用
</h3>
<div align="center">
<a href="https://apps.apple.com/us/app/happy-claude-code-client/id6748571505"><img width="135" height="39" alt="appstore" src="https://github.com/user-attachments/assets/45e31a11-cf6b-40a2-a083-6dc8d1f01291" /></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="https://play.google.com/store/apps/details?id=com.ex3ndr.happy"><img width="135" height="39" alt="googleplay" src="https://github.com/user-attachments/assets/acbba639-858f-4c74-85c7-92a4096efbf5" /></a>
</div>
<h3 align="center">
步骤 2:在电脑上安装 CLI
</h3>
```bash
npm install -g happy
```
> 从 `happy-coder` 包迁移而来。感谢 [@franciscop](https://github.com/franciscop) 捐赠了 `happy` 包名!
<h3 align="center">
步骤 3:改用 `happy`,不再使用 `claude``codex`
</h3>
```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)。