概念
会话
本页内容
会话是在真实终端中运行的单个智能体或 Shell。直接聊天有自己的会话;任务中每个活动成员也各有一个会话。
运行时提供自己的终端界面、认证、命令和对话历史。Runner 承载终端、跟踪状态,并记录恢复所需的对话标识。角色是模板,会话是一次具体运行。
识别状态
工作中与空闲指示器帮助你找到活动智能体。支持的运行时通过钩子报告这些状态;其他运行时以终端活动作为基础判断。空闲并不证明任务通过了检查。部分运行时还会报告需要批准或回答的状态;差异见支持的智能体。
已停止或崩溃的会话没有可接收输入的智能体进程。选择下一步前请阅读终端和错误信息。
打开终端链接
将指针悬停在 URL 或文件路径上可高亮链接,然后在 macOS 上按住 ⌘ 或 Ctrl 点击,在 Windows 上按住 Ctrl 点击。URL 会在浏览器中打开;文件路径会在配置的编辑器中打开,并支持 :line[:column] 后缀。
当运行时将带下划线的 URL 换行到缩进行,或将超链接放在表格单元格中时,悬停任一片段都会高亮完整链接;按住修饰键点击任一片段都会打开同一目标。重新打开会话后链接仍可使用。
选择合适的操作
| 操作 | 效果 |
|---|---|
| 停止(Stop) | 结束进程,保留会话以便恢复 |
| 恢复(Resume) | 在运行时支持时继续已停止智能体记录的对话 |
| 重启任务成员(Restart) | 为该成员开始全新对话 |
| 分叉聊天(Fork) | 在支持分叉的运行时中,从当前对话创建另一条聊天 |
| 归档聊天(Archive) | 停止聊天并从活动列表移除;可在设置 → 已归档中找到 |
Shell 可以在原目录重启,但没有智能体对话可恢复。Shell 终端使用关闭而非归档。关闭窗口会保存布局,也可以让会话保持运行;关闭窗格或聊天标签页是另一项操作,请先阅读确认提示。
Claude Code 账号
配置了多个 Claude Code 账号时,新会话和恢复会使用当前账号。运行中的会话继续使用原账号。暂停的聊天会标明先前账号与当前账号;恢复会继续原始对话记录,分叉则在当前账号下保存新对话。显式设置的 CLAUDE_CONFIG_DIR 环境变量优先。
退出、重新启动与恢复
Runner 的后台服务 runnerd 独立于应用窗口管理进程。 设置 → 通用 → 退出 Runner 时(Settings → General → When Runner quits) 提供 每次询问(Ask) 、 保持运行(Keep running) 和 停止会话(Stop sessions) 。选择保持运行后,重新打开应用会连接到仍在运行的终端。
若进程因关机或更新而停止, 启动时恢复运行中的智能体(Resume running agents on launch) 控制自动恢复。手动停止的会话保持停止,直到你恢复它们。恢复依赖智能体保存的对话标识和历史;仅靠终端画面无法还原未保存的对话。
如果守护进程崩溃,Runner 会重新连接并为受影响会话提供恢复。反复出现故障时,使用 设置 → 诊断 → 打开日志文件夹(Settings → Diagnostics → Open log folder) 。对话丢失或启动失败时,请参阅故障排查。