持久会话
默认情况下,关闭 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 客户端或其他终端开出的会话 — 只要里面正在运行 claude 或 codex。这样你可以在手机上继续长时间运行的任务,而无需重启。
打开服务器详情页面时,ServerCC 会扫描主机上正在运行代理的 tmux 面板,并列在主机 Tmux 接管区域。每一行显示工作目录(路径末段)、识别到的代理(Claude Code 或 Codex)以及面板启动时间。
点击某一行即可 attach。终端视图会打开现有面板,所有输出保留如初,你可以像从 ServerCC 启动的一样继续工作。
外部 tmux 接管可免费试用 — 非 Pro 用户每天可使用 5 次;Pro 用户无限制。列表会显示"每日剩余"计数,方便随时查看次数。