SSH 断开后让 Claude Code 继续运行:tmux 配方
用 tmux 让 Claude Code 在 SSH 断开后继续运行。重新连回同一个进程,检查持久性,并使用 AgentsRoom 需手动开启的设置。
代理正在你的服务器上干活。你合上笔记本。等你回来时,已经没有进程可以回去了。
我们收到的正是这样的需求:希望远程会话能在客户端断开后继续存在,好让用户从另一台机器接着做。我们的 SSH 启动方式本来就在主机上运行 CLI。但这还不够:进程仍然依赖那个交互式 SSH 终端。
我们在 AgentsRoom 1.198.0 中发布了这项改动。下面先讲手动配方,再讲应用怎么利用它。同样的生命周期问题也适用于 Claude Code、Codex 以及其他交互式编程 CLI。
终端要比连接活得更久
我们原来的远程启动使用一条附带终端的 SSH 通道。这条通道一消失,主机就可能发出挂断信号,代理随之退出。进程在远程,并不会因此自动变得持久。
tmux 给进程一个在主机上存活、与查看者无关的终端。它的入门指南描述的正是这种用法:保护远程程序不受连接中断影响,并能从另一台电脑访问它们。
这里讲的是让进程保持存活。至于在云端会话、手机远程操控和你自己的服务器之间怎么选,请阅读远程代理的三种含义。
先启动 tmux,再启动代理
在类 Unix 主机上,用你平常的 SSH 别名连接。把仓库路径换成你自己的:
ssh my-server
tmux -V
tmux new-session -s coding
cd ~/projects/my-repo
claude
如果用 Codex,把最后一行换成 codex。CLI 需要已在服务器上安装并登录。先在一个可以放心试验的仓库里开始。
按 Ctrl+B,然后按 D 分离。之后再重新连接:
ssh my-server
tmux list-sessions
tmux attach-session -t coding
tmux 手册记录了分离和连接。重新连接会回到仍在运行的终端。它不会重新发送任务,也不会启动另一个代理。
交付真实工作之前,先检查生命周期
你可以在不消耗代理额度的情况下检查这个配方。在新的 tmux 会话里,运行这条有限的命令来代替 CLI:
python3 -u -c 'import time; [(print(i, flush=True), time.sleep(1)) for i in range(60)]'
分离,断开 SSH,并在一分钟内重新连接。你离开期间数字应该一直在往上走。这是一套在你自己的主机上做的步骤,而不是我们在所有服务器配置上跑过的基准测试。
接下来,试一个简短的代理任务。重新连接后,检查它改动了哪些文件,以及它是否在等你回答。代理停在权限提示上等待时,会话也可以一直存活。让它保持存活,并不会让它变得自主。
我们在 AgentsRoom 里改了什么
打开已保存的 SSH 连接,启用 AgentsRoom 关闭后,让代理在此主机上继续运行。该选项默认关闭。主机需要 tmux 3.0 或更高版本。
然后打开一个远程项目,并在上面启动代理。CLI 会在主机上一个命名的 tmux 会话里运行。退出 AgentsRoom、让笔记本休眠或连接中断,都不会影响这个会话。再次打开同一个已保存的代理就会连接回去,包括从你账号下的另一台电脑。
我们在实现上做了四个选择,因为每一个都会改变用户的实际体验:
- 会话名称跟随代理的身份。重新打开这个代理会找到它的进程;新代理会得到新会话。
- 应用使用一个独立的 tmux 服务器,并跳过你个人的 tmux 配置。它不会打乱你手动管理的会话。
- 在应用内禁用了 tmux 前缀键。Ctrl+B 仍然留给编程 CLI 使用,Escape 也能直接送达,没有 tmux 惯常的延迟。
- 明确重启代理会替换远程进程。退出应用只会分离查看者。这两个操作必须产生不同的效果。
最后这个区别最重要。关闭代理的标签页,并不是让它继续工作的方式。请退出应用,或断开查看者的连接。如果你明确关闭或重启代理,AgentsRoom 也会尝试停止远程会话;如果主机无法访问,就不能保证停止成功。
如果没有 tmux 或版本太旧,应用会像以前一样启动。不要以为勾上复选框就证明了持久性:检查一下主机,并做一遍断开连接的练习。这些细节已于 2026 年 10 月 7 日对照已发布的实现核实。
当代理完全不应依赖你的电脑时
上面的设置让代理在主机上继续存活,但 AgentsRoom 仍然运行在你的电脑上,所以它一停,团队运行和触发器也会停止。从 1.252.0 版本(2026 年 11 月)起,应用本身可以运行在服务器上:
sudo apt install ./desktop_<version>_amd64.deb
agentsroom --server
ARM 服务器请使用 arm64 包。服务器会显示一个链接和一个短代码。在你的电脑或手机上打开链接,核对机器和代码,然后点击 连接。之后,agentsroom --server --open ~/my-repo 会打开一个项目。
没有窗口,也不需要 Xvfb 或 VNC。你的手机和其他电脑通过端到端加密中继查看服务器上的项目、启动它的代理并回答它们的问题,不需要任何入站端口。每个代理 CLI 都要安装在服务器上,并在那里登录,就像在笔记本电脑上一样。
有两项代价要权衡。这是完整的应用:空闲时约占 400 MB 内存,CLI 另算。而且没有屏幕的机器通常没有钥匙串,所以保存的 SSH 和数据库密码在那里会被拒绝。如果你只是想在工作时让代理跑在一台性能强的机器上,上面的 SSH 选项仍然更简单。
nohup 和 Mosh 的位置
nohup 让命令忽略挂断信号,正如它的手册所说明。它不会给你一个之后可以连接的交互式终端。它更适合输入和输出都已重定向的批处理命令,而不是可能会提问的代理。
Mosh 处理时断时续的连接和网络切换。它的文档也提醒,它同步的是可见屏幕,而不是完整的回滚记录。它可以和 tmux 一起使用;在主动退出客户端后仍让会话可用,和在不同网络之间漫游是两回事。
持久化解决不了的问题
主机仍然必须保持开机。重启会结束正在运行的进程。额度上限、CLI 崩溃或权限提问,仍然可能让进度停下。你重新连接回到的是当前屏幕;另一台电脑上显示过的控制台历史,并不保证会完整重现。
把工作留在下一个会话能读取的文件里:一份简短的任务笔记、改动本身以及验证结果。能存活下来的终端很有用。但一个状态只存在于那个终端里的任务,依然很脆弱。
远程访问页面介绍了如何访问你的代理。这个配方回答的是下一个问题:连接断开之后,是否还有代理可以访问。
常见问题
服务器上的编程代理能挺过 SSH 断开吗?
普通的交互式 SSH 终端不是一种持久化机制。失去终端可能会让代理停止。在断开之前,先在服务器上的 tmux 里运行代理,之后再重新连接到这个会话。服务器必须保持运行,而代理仍可能因为自身的原因停下。
我能从另一台电脑重新连接吗?
可以。以同一个主机用户连接到同一台服务器,然后连接到那个命名的 tmux 会话。在 AgentsRoom 里,为该 SSH 连接启用持久会话,然后从你账号下的另一台电脑打开同一个已保存的代理。启动另一个代理会创建另一个会话。
重新连接和恢复对话是一回事吗?
不是。连接到一个仍在运行的 tmux 会话,回到的是一个从未停止的进程。恢复已保存的对话,则是启动一个读取 CLI 历史记录的新进程。对话文件无法恢复正在运行的命令,也无法恢复已经退出的终端进程。
关闭 AgentsRoom 会停止持久运行的远程代理吗?
如果 SSH 连接启用了持久会话选项,并且主机上有 tmux 3.0 或更高版本,退出应用后代理会继续运行。明确关闭或重启代理,会请求停止或替换它的进程;主机无法访问时,这个操作无法得到确认。如果没有受支持的 tmux,启动会回到普通的 SSH 方式。
下载 AgentsRoom
在一个窗口中运行你所有项目的所有 AI 代理。
配套应用:随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。
继续阅读
如何看到 AI 编码代理在你的服务器上执行了什么
代理正在一台生产服务器上干活,终端里只显示它在调用一个工具。它到底执行了哪条命令,机器又返回了什么?会话转录事后会告诉你。本文讲我们如何让这一切在发生时就可见,最初试过什么,以及不用我们的应用也能做到同样效果的方法。
阅读全文Claude Code 里的 ultracode 是什么?它做什么,花多少
ultracode 是 Claude Code 的一个设置,不是强度档位:开启后,Claude 会为每个有分量的任务写一个 dynamic workflow,也就是一个运行多个子代理的脚本。本文讲怎么开启和关闭它、为什么它不是 max 强度,以及同一次代码审查在 Opus 5.5 上跑两遍的结果,一次用 xhigh,一次用 ultracode:令牌约为四倍,时间超过两倍,而且在 claude -p 里验证结果始终没有回来。
阅读全文Claude Code 的 Routines:哪些在云端运行,哪些留在你的机器上,以及怎么选
Routines(Anthropic 现在称之为 scheduled tasks,即定时任务)是 Claude Code 在你不在场时运行已保存提示词的方式:按计划、由 API 调用或由 GitHub 事件启动,作为一个 cloud session,在你仓库的全新克隆上运行。它们目前处于研究预览阶段。Claude Code 还有两种在本地安排工作的方式,即桌面应用的定时任务和 /loop,而三者的行为并不相同:最小间隔、对本地文件的访问、权限确认,以及笔记本睡眠时会发生什么。本指南结合文档中的限制把三者摆在一起,再解释为什么我们自己的七个夜间代理运行在一台本地机器上。
阅读全文