Happy 有三个核心概念：会话、机器和代理。

​
会话

会话是你与 AI 编程代理之间的对话。当你在终端中运行 happy 时，就会创建一个会话。会话包含：
  • 你与代理之间的消息序列
  • 代理类型（Claude、Codex 或 Gemini）和模型
  • 机器上的工作目录
  • 权限设置
会话可跨设备持续存在。你可以从终端启动一个会话，然后在手机上继续，反之亦然。

​
机器

机器是运行 Happy CLI 的计算机。当你安装 Happy 并启动第一个会话时，你的计算机会被注册为一台机器。 一台机器可以同时运行多个会话。Happy 守护进程（后台服务）管理机器上的会话——它跟踪活跃的会话，并允许移动应用远程启动新会话。

​
代理

代理是驱动会话的 AI 编程工具。Happy 支持三种代理：
代理命令描述
Claude CodehappyAnthropic 的编程代理（默认）
Codexhappy codexOpenAI 的编程代理
Geminihappy geminiGoogle 的编程代理
每种代理都有自己的模型和配置选项。你在创建会话时选择代理，也可以在多个会话中并行运行不同的代理。

​
它们如何协同工作

机器（你的笔记本电脑）
├── 守护进程（后台服务）
├── 会话 1 — Claude Code (sonnet-4-6)
├── 会话 2 — Gemini (gemini-2.5-pro)
└── 会话 3 — Codex (gpt-5.4)

你的手机（Happy 应用）
└── 可查看和控制全部 3 个会话
一切都经过端到端加密。Happy 服务器在你的设备之间同步加密数据，但无法读取你的消息或代码。详情请参阅加密。