目标是一个简单的承诺：

“我在终端里启动了 Claude Code。能不能不重新开始，直接在手机上继续？”

答案是可以。不过这句话里其实藏着两种不同的工作流：

• 你想保持同一个会话，只是在终端界面和手机界面之间切换
• 你想把一个已有的、在终端里启动的会话，在适合手机的界面里打开，而不必重新开始

Happier 是实现这一点的方式之一，走哪条路取决于会话最初是怎么启动的。

这篇指南两种都会讲，因为它们解决的是同一个问题（“在手机上继续”），但机制不同。

要点

1. 在运行 Claude Code 的机器上设置 Happier，并连接你的手机。
2. 如果会话是在 Happier 中启动的：使用 attach 加本地 ↔ 远程切换（同一个会话）。
3. 如果会话是在 Happier 之外启动的：把它作为直连会话（Direct sessions）打开，然后选择 接管并导入（Take over + import）。

常见做法及其取舍

• 直接在手机上开一个新会话：能用，但会丢失已有的上下文。

• 在手机上 SSH：能用，但会变成在小屏幕上做终端工作。

• Happier：根据会话的启动方式，提供两条实际可用的路径。 取舍：如果是直连会话，在同步之前它只能绑定在那台机器上。

如果你第一次接触 Happier（它是什么、在哪里获取）

Happier 是一款面向 Claude Code、Codex 和 OpenCode 等 AI 编程代理的开源配套应用（移动端 / 网页 / 桌面端）。

这里的工作流是：让 Claude Code 在你的机器上继续运行，用手机上的 Happier 接着做同样的工作，不用重新解释上下文。

开始设置：

• 如何在手机上使用 Happier
• GitHub: https://github.com/happier-dev/happier
• 安装 / 下载: https://github.com/happier-dev/happier#how-it-works
• Discord（社区与支持）: https://discord.gg/W6Pb8KuHfg

工作流 A：会话是在 Happier 中启动的（本地 ↔ 远程切换）

这是理想情况，因为它从一开始就是一个 Happier 原生会话。

是什么样子

• 从 Happier 应用启动一个 Claude 会话。
• 之后在同一台机器上运行 happier attach <session-id>。
• 现在你就进入了 Claude Code 的终端界面（本地模式）。
• 之后你可以切回手机继续（远程模式），而不需要新建会话。

分步操作

1. 从 Happier 应用启动会话（同步会话）。
2. 在拥有该会话的机器上：

happier attach <session-id>

3. 在终端里本地使用 Claude Code。
4. 想在手机上继续时，切回远程模式（切换到远程（Switch to remote），同一个会话）。

说明：

• 在装有 tmux 的机器上，这通常是基于 tmux 的 attach 流程。
• 在 Windows 上，请使用 Happier 的 Windows 会话模式，不要指望 tmux。

工作流 B：Claude Code 是在 Happier 之外启动的（直连 → 接管并导入）

当你已经有一个很重要的、提供商原生的 Claude 会话时，就用这个工作流。

分步操作

1. 在 Happier 中打开直连会话（Direct sessions）。
2. 在拥有该会话的机器上浏览 Claude 的提供商会话。
3. 把已有会话作为直连（Direct）会话打开。
4. 选择 接管并导入（Take over + import）。

会发生什么：

• Happier 导入提供商的对话记录。
• 该会话变成一个 Happier 同步会话。
• 从此以后，你可以把它当作普通的 Happier 会话使用（包括手机上的工作流）。

故障排查

症状：我看不到直连会话

可能原因：

• 直连会话被禁用了（实验性功能开关）

解决：

• 在服务器上启用直连会话

症状：我能 attach，但切不回远程

可能原因：

• 会话当前处于本地控制中，而且正在忙

解决：

• 等当前这一轮完成，或者使用待处理队列 / 中断的方式

相关指南

• 如何在手机上监控已有的 Claude Code 或 Codex 会话（直连会话）
• 如何用手机监控 Claude Code
• Claude Code 或 Codex 忙碌时，如何在手机上把消息排进队列