给你的代理一个全新的上下文,
又不丢掉来龙去脉
一项任务做了三个小时,上下文里塞满了旧日志和放弃的尝试,代理开始忘记自己做过的决定。你想让它干干净净地重新开始,但不是从零开始。
交接并重启替你完成交接:代理把进展写进项目中的一个文件,然后它的控制台在同一个标签页里开始一段新对话,第一条消息让它读这个文件并接着干。一次点击,一次确认,适用于 Claude Code、Codex 以及所有带 AgentsRoom 工具的代理 CLI。

长会话会被用旧。代理读过的每个文件、打印过的每段测试日志、试过又放弃的每种方案,都留在它的上下文窗口里。到了某个时候,有用的部分,也就是决定和计划,被埋在其余内容下面,回答质量随之下降。
常见的办法是手动交接:让代理把总结写进一个文件,输入 /clear,再粘贴一条消息作为新对话的开头,让它去读这份总结。这样可行,也有人专门写交接用的技能和提示词来加快速度,但它照样把你从手头的工作里拉出来:每个代理三步,每次都要。
在 AgentsRoom 里,这只是一个菜单项。代理自己写交接说明,因为它知道自己的上下文里什么最重要,并在它的轮次结束后自行重启。你只需把握一件事:新对话开头的第一条消息。
在真实应用中录制:一个 Claude Code 代理完成了三步重构中的第 1 步和第 2 步,然后右键点击它,选择交接并重启,只需确认一次。代理把进展到哪里、做了哪些决定、还剩什么写进项目中的一个文件,然后它的控制台在同一个标签页里以一段新对话重启。它读取这个文件,接着做第 3 步,5 个测试全部通过。
交接并重启能做什么
一个干净的上下文,从代理已经知道的东西出发,而不是从零开始。
一次点击代替三个步骤
右键点击一个运行中的代理,选择交接并重启,确认。不用输入 /clear,不用索要总结,不用粘贴提示词。控制台在同一个标签页里重新开始,角色、CLI 和模型都不变。
由代理亲自写的交接说明
代理把进展、做过的决定和剩下的工作写进项目中的一个文件:如果它的工作流程里有自己的交接文件,就写进那个文件,否则写进 .handoff/latest.md。文件留在磁盘上,你也可以读。
你的第一条消息,按代理保存
新对话以“Read your handover and continue”加上文件路径开头。在对话框里修改它,它就会为这个代理保存下来,在你账户的所有电脑和手机上都生效。
消息会等待新对话
从代理开始写交接说明的那一刻起,你或其他代理发给它的消息都会被暂存,并投递到它的下一段对话,不会在最后一秒落进旧对话里。
协调者可以提出,但不能决定
项目的协调者代理可以为某个队友申请交接,比如在它的上下文已满时。同一个对话框会打开,附上协调者的名字和理由,在你点击交接并重启之前什么都不会发生。
所有带 AgentsRoom 工具的 CLI
重启通过 AgentsRoom 工具完成,而不是依赖某个 CLI 的命令,所以在 Claude Code、Codex 以及其他加载了这些工具的代理 CLI 上效果都一样。没有这些工具的 CLI 会直接告诉你,这时你在它的控制台里输入 /clear 即可。
工作原理
四个步骤,你只需要做前两步。
- 1
打开代理菜单
右键点击一个在这台电脑上运行的代理,选择交接并重启。在手机上,长按该代理并选择同一项。
- 2
检查第一条消息
对话框会显示“下一段对话的第一条消息”,默认是“Read your handover and continue”。如果这个代理需要别的内容就改一下,它会保存下来供下次使用,然后点击交接并重启。
- 3
代理写交接说明
AgentsRoom 让代理把交接说明写进项目中的一个文件,并结束它的轮次。从这时起,发给它的消息会等待它的下一段对话。
- 4
控制台重新开始
轮次结束后,控制台在同一个标签页里以一段新对话重启。第一条消息加上交接文件的路径会替你发出,代理从上次停下的地方继续工作。

交接、/compact 还是 /clear?
/clear 会丢掉整段对话。任务已经完成、下一个任务与之无关时,它是合适的工具;在任务进行到一半时,它就是错误的工具,因为代理知道的一切都会随之消失。
/compact 在同一个会话中,把对话替换成 CLI 写的摘要。保留什么由不得你选,摘要只存在于上下文中,而一个被压缩过好几次的长会话,留下的是摘要的摘要。
交接并重启介于两者之间。代理亲自写交接说明,写在一个你可以阅读和修改的文件里,新对话开始时上下文里只有这份内容。这是给那些还没做完、但上下文已经用旧的任务准备的一招。代理没写下来的东西会随旧对话一起消失,所以事关重大时,值得看一眼这个文件。
限制
- 代理需要 AgentsRoom 工具(MCP)才能自行重启。不加载这些工具的 CLI 做不到,这个操作会提示你改为输入 /clear。
- 重启会等到代理的轮次结束。如果代理正在忙,操作提示它现在无法重启,等它回答完再试。
- 以下情况会被拒绝,并附上说明原因的消息:正在运行的 Agent Team 中的某个步骤、QA 测试期间,以及项目的终端显示在另一个窗口中时,此时请先把它们移回主窗口。
- 每个代理每 2 分钟最多重启一次,每小时最多 6 次,这样陷入循环的例行流程就无法反复重启一个代理。
- 这个菜单项只会出现在这台电脑上运行的代理上:在你账户的另一台机器上运行的代理不会有,项目助手也不会有。
- 代理没有写进交接说明的内容,会随旧对话一起丢失。
常见问题
问我们其他问题怎样在不丢失进度的情况下,给 Claude Code 代理一个全新的上下文?
它和 /compact 有什么区别?
交接文件放在哪里?
可以修改新对话的第一条消息吗?
代理能自己交接并重启吗?
它适用于 Codex 和其他 CLI 吗?
为什么提示代理现在无法重启?
延伸阅读
你可能还喜欢
代理分叉
一键分叉正在运行的 AI 代理,得到一个已经拥有整段对话的双胞胎:同样的角色、同样的 CLI、同样的上下文。或者在代理永远看不到的气泡里问一个旁路问题,它的终端照常运转。
令牌使用情况:每个会话:实时
AgentsRoom 为每个 Claude Code 会话提供实时 token 用量表:红色超量警报、缓存命中率,以及输入、输出和缓存的完整明细。100% 本地运行。macOS、Windows 和 Linux 上免费。
MCP : 代理可驾驶:手动或自动
四个 MCP 服务器让 Claude Code、Codex 等 CLI 驾驶 AgentsRoom 本身:读取 backlog、运行 dev 命令、使用 prompt library、操作内嵌浏览器。
给你的代理一个记得住的新开始
交接并重启已在 macOS、Windows 和 Linux 版 AgentsRoom 中提供,免费下载。
配套应用:随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。
