命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
停止当前后台会话并保留记录
/stop 是 Claude Code 中的一个有条件可用的 slash 命令——它只在你已经附着(attach)到某个后台会话内部时才会出现在命令列表里。执行后,它会停止当前后台会话,把它置为 Stopped(灰色) 状态、终止其运行中的进程;与此同时,该会话的对话记录(transcript)和 Claude 为其创建的任何 worktree 都会被保留在磁盘上。注意:进程退出并不等于会话被永久销毁——官方 agent-view 文档明确说明,进程退出后(∙ 图标)"You can still peek, reply, or attach, and Claude restarts from where it left off",即你仍可 peek / reply / attach,重新 attach 后 Claude 会从断点继续;事后也可通过 claude --resume 恢复。
核心区分:
/stop是"停止运行",不是"离开附着"。在附着进入后台会话后,按←、Ctrl+Z、/exit、双击Ctrl+C或双击Ctrl+D,这些操作都只会让你离开附着状态,会话进程继续在后台运行。只有/stop才会真正停止进程并把会话置为 Stopped 状态。
/stop
前提:你已通过 claude attach <session-id> 或 claude agents 的交互界面进入了某个后台会话。
claude stop <session-id>
<session-id> 是后台化时 Claude 打印的短 ID(例如 7c5dcf5d)。两种方式效果相同,CLI 形式适合在脚本或另一个终端窗口操作。
| 约束 | 说明 |
|---|---|
| 仅在附着状态下可用 | 普通前台会话里输入 /stop 不会识别此命令 |
| 停止运行(非永久销毁) | 停止后进程终止、会话转为 Stopped 状态,正在运行的 Claude 推理被中断;但 transcript 保留,可重新 attach 并从断点重启 |
| 对"自建 worktree"无影响 | 你自己手动创建并在其中启动的 worktree,/stop 不会删除;Claude 自动创建的 .claude/worktrees/ 下的 worktree 同样保留 |
| 操作 | 会话进程 | Transcript | Claude 创建的 Worktree |
|---|---|---|---|
/stop(或 claude stop) | 终止 | 保留 | 保留 |
离开附着(← / /exit / 双 Ctrl+C) | 继续运行 | 保留 | 保留 |
从 agent view 删除(Ctrl+X 两次:先 stop 后 delete) | 停止并从列表移除 | 保留(claude --resume 仍可用) | 删除(含未提交改动) |
/stop。/stop 后 transcript 仍在,可随时 claude --resume 回顾。claude stop <id> 批量清理超时会话,不需要打开 TUI。/exit 或 Ctrl+C 以为停止了会话:这些操作仅断开附着,后台会话进程依然存活并继续消耗 API 用量。确认是否真正停止,可用 claude agents 检查会话状态。/stop 与 agent view 的"删除"混淆:/stop 保留 worktree;从 agent view 界面删除会同时移除 Claude 自动创建的 worktree(包含其中未提交的改动)。若需保留文件,先合并或推送再删除。