持久会话

默认情况下,关闭 ServerCC 或离开终端时,Claude Code/Codex 会话会停止。持久会话改变了这一点 — Claude Code/Codex 会在服务器后台持续运行,你可以随时重连查看进度或继续对话。

前提条件

持久会话需要远程服务器上安装 tmux。大多数 Linux 发行版默认包含它,或者你可以通过包管理器安装:

# Ubuntu / Debian
sudo apt install tmux

# CentOS / RHEL / Fedora
sudo dnf install tmux

# macOS
brew install tmux

启动持久会话

会话选择器的"设置"区有一个专门的持久连接模式开关。打开后,点击新建会话(或点击历史会话中的任意一条)即可以持久方式启动或恢复该会话。

持久模式未开启时,同样的入口只会启动普通会话,离开终端后即终止。

提示

仅当服务器安装了 tmux 时,"持久连接模式"开关才会出现。服务器详情页面提供 Tmux 安装状态行,一眼就能确认。

重连持久会话

当持久会话在后台运行时,会话选择器顶部会显示"恢复持久会话"横幅。横幅显示:

  • 会话启动了多久
  • 交换的消息数量
  • Git 分支(如适用)

点击横幅即可重连。你将回到终端,所有之前的输出都可见,可以像从未离开一样继续与 Claude 对话。

离开持久会话

当持久会话运行时退出终端,会弹出对话框让你选择:

  • 保持持久会话 — Claude Code 在服务器上继续运行。稍后可以重连。
  • 停止持久会话 — 会话立即终止。Claude Code 停止运行。

你也可以在不重连的情况下结束持久会话 — 在会话选择器中向左滑动恢复持久会话条目,即可显示退出持久会话按钮。

使用场景

长时间任务

启动复杂的重构或功能实现任务,然后关闭 App,稍后再回来查看。Claude 会在你离开时继续工作。

不稳定的网络连接

如果网络连接不稳定,持久会话确保 Claude 的工作不会因断连而中断。恢复连接后重新连接即可。

进度监控

让 Claude 处理任务,然后定期重连查看进度、回答问题或批准文件更改。

提示

每个工作区同一时间只允许存在一个持久会话 — 该上限覆盖主分支及所有 worktree。达到上限时,会话选择器会禁用新建会话并提示你去恢复或者滑动退出已有会话。如果持久会话处于空闲状态(没有运行中的进程),它会被自动清理。

接管外部 Tmux 会话

ServerCC 还可以接管在 App 之外启动的 tmux 会话 — 例如你从桌面 SSH 客户端或其他终端开出的会话 — 只要里面正在运行 claudecodex。这样你可以在手机上继续长时间运行的任务,而无需重启。

打开服务器详情页面时,ServerCC 会扫描主机上正在运行代理的 tmux 面板,并列在主机 Tmux 接管区域。每一行显示工作目录(路径末段)、识别到的代理(Claude Code 或 Codex)以及面板启动时间。

点击某一行即可 attach。终端视图会打开现有面板,所有输出保留如初,你可以像从 ServerCC 启动的一样继续工作。

每日试用

外部 tmux 接管可免费试用 — 非 Pro 用户每天可使用 5 次;Pro 用户无限制。列表会显示"每日剩余"计数,方便随时查看次数。

另见:会话了解常规会话管理,后台与并行了解多实例运行,连接历史查看历史连接。