### 多设备控制中心，编排由 100+ 个编程代理组成的团队
**在手机、桌面端和浏览器上都能用。**
Claude Code、Codex、OpenCode、Pi 等代理在你自己的机器上协同、并行工作。
会话可以跨代理派生子代理：例如让 Claude 请 Codex 做代码审查，或让 Codex 把工作委派给 Claude 子代理。会话中途也能切换代理。无论身在何处，都可以审批、引导、审查和提交。
**开源 · 可自托管 · 端到端加密**
English | 日本語 | 简体中文 | 한국어 | Español
快速开始 ·
下载 ·
文档 ·
自托管 ·
Discord
Happier 项目最新动态
Happier 免费且开源。
直接使用你现有的订阅和编程代理。
内置支持的代理（另有 30 多个）
任何支持 ACP 的代理都可以在设置中添加。
## 快速开始
### 1. 在电脑上安装
推荐从桌面应用开始：它会帮你配置好 CLI 和守护进程。
更喜欢用终端？不装桌面应用，直接安装 CLI 和守护进程
macOS/Linux：
```bash
curl -fsSL https://happier.dev/install | bash
```
Windows：
```powershell
iwr https://happier.dev/install.ps1 -useb | iex
```
如果你确实想用 npm 包：`npm install -g @happier-dev/cli`（[CLI 文档](https://docs.happier.dev/apps/cli)）。
要装在远程电脑或 devbox 上？在本机通过 SSH 完成配置
一条命令即可在远程主机上安装 CLI 和守护进程（已验证发布签名），并将其注册为你的一台机器：
```bash
happier machine setup --ssh user@host
```
如果远程机器上没有浏览器，可以在一台已登录的机器上运行以下命令，让远程机器完成登录：
```bash
happier auth pair-remote --ssh user@host
```
也可以直接在远程主机上以无头方式登录：`happier auth login --no-open --method web` 会输出一个授权 URL，在任意浏览器中批准即可。[机器与守护进程](https://docs.happier.dev/apps/daemon)
在应用中登录，或在首次运行时登录。
### 2. 添加手机
用同一个账号登录，你的会话、机器和设置都会同步过来。
### 3. 开始会话
**在应用中 →** 点击 **新会话**，选择机器、文件夹和代理。无需终端。
**或者在终端中**，在任意项目文件夹下运行：
```bash
happier # Claude Code
happier codex # Codex
happier opencode # OpenCode
```
无论哪种方式，会话都会同时出现在所有设备上：在终端里继续输入，在手机上跟进并审批，在浏览器里审查。运行 `happier --help` 可查看其他代理和命令。
## 功能一览
📱 在手机、桌面端或网页上运行你的代理
用手边的任意设备开始、引导、审查和审批会话。会话是跨设备的，无论在哪里都能接着同一个会话继续，包括已经在你机器上运行的 Claude Code、Codex 或 OpenCode 会话。继续会话
🖥️ 跨机器编排并行会话
想开多少会话都可以，并为每个会话选择机器、文件夹、代理和模型。不管会话运行在哪台机器上，都能在同一个列表里跟进。开始会话 · 机器与守护进程
🔄 会话中途切换代理
把会话从 Claude 原地切换到 Codex，或者切回来。会话保留原有的 ID、历史记录和设置，接手的代理会收到近期对话的摘要。换一个代理继续
🔔 需要你处理的事项都在收件箱
权限请求、代理的提问和未读会话会汇总到一个关注中心，覆盖所有会话和机器。点开推送通知，就会直接打开发出请求的那个会话。收件箱与审批
📝 审查 diff 并回传批注
浏览代理所做的改动，精确标出需要处理的代码行。批注可以直接发回同一个会话，也可以发到新会话。审查批注
🌿 在任意设备上使用 Git 和 worktree
暂存、提交、推送、创建分支和发起拉取请求，都不用离开应用。可以基于任意本地或远程分支，在独立的 Git worktree 中开始会话，也可以直接在当前文件夹中开始。Git · 新会话选项
📬 排队发送，随时引导
代理工作时可以把消息加入队列，并在执行前调整顺序或编辑。也可以在不打断当前轮次的情况下引导它。引导 · 待发送队列
🪪 订阅、账号池和用量限制
为同一项服务连接你拥有的多个账号，并把它们组成一个池。开启自动切换后，当某个账号达到用量限制或登录过期时，池会把会话转到另一个账号，工作不会中断。如果没有可切换的账号，Claude 会话会在限额重置后自动恢复。已连接服务与账号池 · 用量限制
📊 查看各账号用量
查看每个已连接账号和订阅还剩多少额度。对于 Claude 订阅，会显示 5 小时限额和每周限额，以及各自距离重置的时间。已连接服务
🤝 跨代理的子代理
一个会话可以把工作交给另一个代理。例如 Claude 可以在 Codex 上发起审查、规划或委派任务，你可以在会话的“代理”标签页中跟进每一次运行。委派的工作
🗂️ 文件、编辑器和终端
在任意设备上浏览、搜索和编辑会话文件夹中的文件。需要快速执行命令时，可以在已连接的机器上打开终端。文件与编辑器 · 内嵌终端
⌨️ 喜欢终端？那就继续用！
在 Claude Code、Codex 或 OpenCode 各自的终端界面中运行它们。Happier 会把这些会话同步镜像到每台设备，让你随时随地跟进、发消息和审批。Claude 统一终端
🎙️ 语音
语音助手会跟进你正在运行的会话，替你回应权限请求，并发送你口述的消息。可以使用 ElevenLabs 实时语音，也可以用端侧语音、OpenAI 兼容端点、Google Gemini 和 Google Cloud 或 Kokoro 搭建本地流水线。语音
### 更多功能
- **会话移交。** 把正在运行的 Claude Code 或 OpenCode 会话转移到另一台机器，需要的话可以连同工作树一起带过去。[会话移交](https://docs.happier.dev/sessions/session-handoff)
- **会话共享。** 邀请他人以查看或编辑权限加入，或发布一个只读的公开链接。[会话共享](https://docs.happier.dev/accounts/session-sharing)
- **把 Happier 用作 MCP 服务器。** `happier mcp serve` 让任意 MCP 宿主都能创建会话、发送消息和执行会话操作。[把 Happier 用作 MCP 服务器](https://docs.happier.dev/extending/happier-as-mcp-server) · [CLI](https://docs.happier.dev/apps/cli)
- **MCP 服务器只需配置一次。** 每台机器上的每个代理都能使用。[MCP 服务器](https://docs.happier.dev/extending/mcp-servers)
- **通过 SSH 添加机器**，在应用或 CLI 中都可以操作。[机器与守护进程](https://docs.happier.dev/apps/daemon)
- **自托管。** 自托管的中继运行相同的应用、加密和功能。[自托管](https://docs.happier.dev/self-hosting)
- **端到端加密。** 内容默认在你的设备上加密。[安全](#security)
分步指南请见 [guides.happier.dev](https://guides.happier.dev)。
## Happier 的工作原理
```
Phone Desktop Browser
│ │ │
└────────────────┼────────────────┘
│
▼
Happier relay (hosted or yours)
syncs end-to-end encrypted sessions
between your devices and machines
│
▼
Your machines (laptop, desktop, VPS, dev box)
the Happier daemon starts and manages
agent processes where your code lives
│
▼
Claude Code · Codex · OpenCode · Pi · ...
each agent talks to its own model
provider directly
```
中继负责存储和转发它自己无法读取的内容：会话内容在到达服务器之前就已在你的设备上加密。服务器只处理路由所需的信息，例如会话 ID、时间戳、轮次状态和用量元数据。你的代理仍然直接与各自的模型提供商通信。
## 自托管
一条命令即可运行你自己的中继：
```bash
happier relay host install --mode system
```
这会在当前机器上安装一个托管的中继服务并负责更新。如果是远程主机：`happier relay host install --ssh user@host --mode system`。
详细内容见[自托管文档](https://docs.happier.dev/self-hosting/self-host-runtime)（也可以通过 [happier.dev/self-host](https://happier.dev/self-host) 访问），另外也可以选择 [Docker](https://docs.happier.dev/self-hosting/docker) 或 [Proxmox](https://docs.happier.dev/self-hosting/proxmox)。
## 安全
- **内容默认端到端加密。** 代码、提示词、消息和对话记录在到达任何服务器之前就已在你的设备上加密。[加密](https://docs.happier.dev/security/encryption)
- **服务器会处理路由元数据。** 会话 ID、时间戳、轮次状态和用量元数据对中继可见，以便同步你的设备。
- **自托管运营者可以自行选择存储策略。** 自托管服务器可以根据自身部署配置其他存储策略。[服务器加密设置](https://docs.happier.dev/self-hosting/encryption)
- **模型流量只经过你的代理。** 每个代理直接与各自的模型提供商通信。
更多内容见[安全文档](https://docs.happier.dev/security)。
## 下载
| 平台 | 获取方式 |
| --- | --- |
| iOS | [App Store](https://apps.apple.com/app/happier-claude-codex-opencode/id6758554297) |
| Android | [Google Play](https://happier.dev/playstore) · [APK](https://happier.dev/apk) |
| macOS · Windows · Linux（桌面应用） | [happier.dev/download](https://happier.dev/download) · [所有桌面版构建](https://github.com/happier-dev/happier/releases/tag/ui-desktop-stable) |
| Web | [cloud.happier.dev](https://cloud.happier.dev) |
| CLI (macOS, Linux) | `curl -fsSL https://happier.dev/install \| bash` |
| CLI (Windows) | `iwr https://happier.dev/install.ps1 -useb \| iex` |
发布说明见[更新日志](https://docs.happier.dev/releases)。
### 发布渠道和每夜构建
以上方式安装的都是 **stable** 渠道。另有两个更新更快的渠道领先于它，并且可以并行安装（`happier`、`hprev`、`hdev`），所以试用它们不会影响你的 stable 环境：
- **preview**：新功能会先在这里上线，早于 stable。
- **dev**：包含最新改动的每夜构建。可能包含不完整的提交，随时可能出问题。
安装 preview 或 dev 构建
Preview（先是 macOS/Linux，然后是 Windows）：
```bash
curl -fsSL https://happier.dev/install-preview | bash
```
```powershell
iwr https://happier.dev/install-preview.ps1 -useb | iex
```
Dev：
```bash
curl -fsSL https://happier.dev/install-dev | bash
```
```powershell
iwr https://happier.dev/install-dev.ps1 -useb | iex
```
之后用 **`hprev`** 或 **`hdev`** 代替 `happier`。如果想让 `happier` 指向 dev 通道，可以在 `.bashrc`/`.zshrc` 中加入 `alias happier='hdev'`。
使用 `dev` 时，所有组件都必须来自 dev 版本（CLI、应用、守护进程和服务器）：托管云服务（cloud.happier.dev）运行的是 `stable`，因此 `preview` 和 `dev` 的功能在上面可能无法使用；而且 `dev` 没有托管的 Web 应用（要使用 dev 版 Web UI，请自托管 dev 服务器）。
移动端和服务器的 dev 构建：
- [iOS TestFlight](https://testflight.apple.com/join/PyRCsaS3)
- [Android dev APK](https://github.com/happier-dev/happier/releases/download/ui-mobile-dev/happier-dev-android.apk)
- 服务器镜像：[Docker Hub `happierdev/relay-server:dev`](https://hub.docker.com/repository/docker/happierdev/relay-server/tags/dev) · [GHCR](https://github.com/happier-dev/happier/pkgs/container/relay-server)
- Dev box（预装 CLI + 守护进程 + 代理）：[Docker Hub `happierdev/dev-box:dev`](https://hub.docker.com/repository/docker/happierdev/dev-box/tags/dev)
各渠道与发布标签的对应关系，以及每种安装方式如何更新：
[docs.happier.dev/releases/updates](https://docs.happier.dev/releases/updates)。
## 社区与贡献
Happier 以开放的方式开发，靠真实的反馈不断成长。如果你觉得有什么地方坏了、缺了或者用着别扭，欢迎告诉我们。
- Bug（请附复现步骤）：[GitHub issues](https://github.com/happier-dev/happier/issues)
- 想法和设计问题：[GitHub discussions](https://github.com/happier-dev/happier/discussions)
- 新闻、提问和快速反馈：[Discord](https://discord.gg/W6Pb8KuHfg)
- 代码、文档和开发环境配置：[CONTRIBUTING.md](CONTRIBUTING.md)
一个清晰的 issue 往往比一个拉取请求更有价值：说明你做了什么、预期是什么、实际发生了什么。
## 为什么叫“Happier”？
我们最初是 [Happy](https://github.com/slopus/happy) 的贡献者，向上游提交修复、改进和新功能。
我们每天都在工作中使用它，也是真心喜欢这个理念。
后来我们逐渐意识到，自己的需求需要更快的迭代，而这在主项目中很难放开手脚去尝试。
于是我们开始为自己构建这些功能。
经过数周的打磨、修复和对基础的扩展，我们决定把 Happier 分享出来，让更多人可以试用、使用，并一起决定它接下来的方向。
Happier 想探索一个迭代更快、协作更多的方向，同时由衷感谢 Happy 打下的基础。我们曾经喜欢、现在也依然喜欢 Happy。❤️ 没有它，就没有 Happier。
在瑞士开发。采用 MIT 许可证。
与 Anthropic、OpenAI 或 Google 无关联，也未获其背书。
