面向 Claude Code 的开源应用

Claude Code 是 Happier 能够运行在其自身终端界面之内、而不是运行在它前面的智能体。打开 unified 终端运行时，Happier 会在共享的终端宿主里启动真正的 claude TUI，把该会话流式传送到你的设备上，并把你从应用里发出的内容直接敲进去——于是纠正可以落在正在运行的那轮里，而不必等它结束。接受纠正的是 Anthropic 自家的终端，而 Happier 替你按着键盘；这与隔着运行器谈论某个会话是不同的安排，也是本页存在的原因。

默认运行时是 Agent SDK 那一个，对大多数会话来说也是对的那一个。它能恢复对话，能列出那台电脑上的 Claude Code 会话，能把供应商状态带到第二台电脑上，并且在用量上限拦住你时，它可以去问上限是否真的已经解除，而不是让你自己猜。它不做的是把消息送进已经在运行的轮次：Anthropic 的文档把 Agent SDK 的流式输入写作排队的消息、按顺序处理，并可以中断。在两种运行时之间做选择，改变的只是这一个行为，而不是你的代码所在的位置。

登录仍然走 Anthropic 的流程，从你当下所在的地方发起。Claude Code 供应商页面会在你选定的电脑上运行 claude 并向它发送 /login，于是浏览器那步发生在将要保存凭据的那台电脑上，而不是你手里的手机上。Happier 会先到 Anthropic 安装程序放置可执行文件的地方去找——~/.local/bin、~/.local/share/claude 下带版本号的目录、Homebrew 前缀、~/.claude/local/cli.js——然后才提出把安装命令显示给你，因为在大多数电脑上它已经在那里了。

Claude Code 是 Anthropic 的终端编码智能体：你在仓库里运行 claude，它读取文件、修改文件并执行命令。Happier 不改变其中任何部分。happier claude 启动同样的可执行文件，在同样的目录里，用同样的登录，并把对话镜像到你已登录的每台设备上。

它换来的是可以走开。在工位上开始重构，去吃午饭的路上在手机上看 diff，回答它停下来等待的权限请求，回到座位时再在终端里接着这个会话。仓库始终留在它本来所在的那台电脑上。

引导和中断不是同样的动作，而 Claude Unified 讲的是前面那一个。中断会停下当前这轮并开启新的轮次；引导则是往正在运行的轮次里追加。Anthropic 的文档把 Agent SDK 的流式输入写作排队的消息、按顺序处理，并可以选择中断——这里的默认运行时就是它，对大多数会话来说也是对的那一个。Claude Code 自家的终端接受的是另外那种：在它工作时打字，指令就加入正在进行的工作。Unified 驱动的正是那个终端，所以应用可以从手机上做这件事。

无论哪种方式，都只有一个 Claude Code 进程。在 unified 模式下，终端和应用同时都是活的——你可以在电脑上的 TUI 里打字，同时这个会话也从手机上被回复，谁都不会被锁在外面。这就是这里“unified”的意思：同一个进程，同一份记录，而终端和应用二者都可以往里打字。

iOS 和 Android 应用、面向 macOS、Windows 和 Linux 的桌面应用，以及 app.happier.dev，都是通向运行在你电脑上的 Claude Code 进程的客户端 —— 而不是只读的镜像。回应一个权限请求、发送下一条指令、浏览仓库、阅读 diff。会话记录在离开你的电脑之前就已端到端加密，所以承载它的服务器持有的是密文。

Happier 安装在已经存放着你仓库的那台电脑上，而 happier claude 会在那里把 Claude Code 作为一个普通子进程启动，在你指定的目录里，用你自己登录好的身份。智能体和 Anthropic 之间没有网关，你的源码在别处也没有任何副本。

Happier 会在你的 PATH 上寻找 claude，并运行你安装的那一份。Anthropic 用安装脚本而不是软件包来分发它；Happier 可以把那条命令显示给你，但它不会自行执行厂商的安装脚本 —— 除非你明确允许，否则厂商的安装配方会被拒绝。

Anthropic 自己的安装与登录指南在 code.claude.com/docs/en/setup。Happier 不会镜像一份，因为把别人的安装说明抄一份过来，抄的就是一份会过期的东西。

Happier 这一侧的配置参考 —— Happier 文档中的 Claude Code。

Claude Code 是 Happier 可以指向“你连接过一次的凭据”的智能体之一，而不是指向那台电脑当下登录的账号。它接受 a Claude subscription or an Anthropic API key。

已连接服务是以凭据为键，而不是以智能体为键，所以同一份 Claude subscription 在每一台你连接过的电脑上，都能给任何接受它的智能体选用 — 这也正是把你自己的账号组成一个池、跨多台电脑使用会有帮助的原因。凭据的加密和解密都在你自己的设备上进行；文档页面 记载了各类配置档的规则，因为每个智能体接受哪些种类的配置档，正是会随版本变动的那类细节。

Claude Code 是 Happier 运行的 13 个命令行编码智能体之一，它们共用一份会话列表、一个权限收件箱、一套键盘快捷键和一份 MCP 配置。

You define an MCP server once and Claude Code receives it as native MCP inventory, next to whatever MCP servers it already had of its own.

这在你同时跑不止一个的日子里最要紧：不同厂商的会话并排摆着，点一下通知打开的是发出该请求的那个会话，而不是应用的首页。完整名单在这里。

在终端里输入 happier claude，会话就在你站着的地方启动，而同一个会话同时也在应用里。你在那个 shell 里读到的是 Happier 自己对会话的呈现 —— 会话记录、权限提示、工具输出 —— 而不是 Claude Code 的界面。没有人需要为了拿到一个手机客户端而放弃终端。

当你想用 Claude Code 自己的 TUI 时，在拥有该会话的电脑上运行 happier attach <session-id>，它就会在 tmux 里把会话交给你，而且历史记录已经在那里了。在默认运行时下这种交接是独占的：只要终端握着会话，你从应用发出的消息就会排在队列里等，而不是在你眼皮底下被打进去；等你把控制权交回来，它才会发出去。 统一终端运行时是另一种安排 — 共享终端宿主里只有一个 Claude Code 进程，终端和应用可以同时写入。

attach 指南列出了具体适用的情形，而不是把所有情形都许诺下来。

在存放你代码的那台电脑上执行一条命令，然后在你想工作的仓库里执行 happier claude。

分步说明在指南里。这一切都是 MIT 许可的，而 relay 是你可以自己运行的。