关闭聊天窗口时的处理机制

当用户发送消息后未收到回复就关闭聊天窗口(终端/Tab),Claude Code 的处理流程。


1. 信号触发

平台 信号 检测方式
Linux / WSL SIGHUP 终端关闭时内核发送
macOS TTY 吊销 无 SIGHUP,靠 30s 轮询检查 process.stdout.writable
Windows SIGTERM 窗口关闭事件
用户主动 Ctrl+C SIGINT 键盘中断

处理入口:gracefulShutdown.ts 的 setupGracefulShutdown()(注册于 entrypoints/init.ts:87)。


2. 取消正在进行的 API 请求

scss 复制代码
SIGHUP/SIGTERM/SIGINT
  → gracefulShutdown()
    → cleanupTerminalModes()       ← 恢复终端模式
    → printResumeHint()            ← 打印 "Resume with: claude --resume <id>"
    → 此时 AbortController 已被触发:
      queryLoop 中的 signal.aborted == true
      → anthropic.beta.messages.create({...params, stream: true}, { signal })
        中的 signal 触发 → SDK 抛出 APIUserAbortError
      → stream 被取消,不再接收后续数据

关键路径:用户发送消息时 onQueryImpl 创建一个 AbortController(REPL.tsx:4010),其 signal 传入 queryModel() → 传给 Anthropic SDK 的 messages.create() 作为 abort signal。shutdown 时该 controller 被 abort,SDK 中断 HTTP 流。


3. 刷新会话持久化

typescript 复制代码
// gracefulShutdown.ts:445
await runCleanupFunctions()
  → Project.flush()                    ← 将内存中 100ms 队列的待写入消息刷到 JSONL
  → Project.reAppendSessionMetadata()  ← 重新写入 session 元数据到文件尾部

已发送的用户消息 和 已收到的部分助手回复(如果有)会被写入 JSONL。如果一条消息都没收到,则只记录用户消息。


4. 执行 SessionEnd hooks

typescript 复制代码
// gracefulShutdown.ts:473
await executeSessionEndHooks(reason, { signal, timeoutMs })

允许用户配置的 SessionEnd hooks 执行(默认 1.5s 超时)。


5. failsafe 兜底

typescript 复制代码
// gracefulShutdown.ts:417
failsafeTimer = setTimeout(
  () => { cleanupTerminalModes(); printResumeHint(); forceExit(code); },
  Math.max(5000, sessionEndTimeoutMs + 3500),
)

若上述异步清理挂起超过 5 秒(或 hook timeout + 3.5s),强制退出进程。


6. 退出后

  • 打印 Resume this session with: claude --resume <sessionId> 提示
  • 进程 exit code = 129 (SIGHUP) / 143 (SIGTERM) / 0 (Ctrl+C)
  • JSONL 文件保留在磁盘上供后续 resume
  • 消息已部分写入 JSONL --- resume 后会看到已发送的消息,但回复可能不完整或不存在(取决于当时流到了哪里)

关键要点

问题 答案
已发送的消息会丢吗? 不会 --- runCleanupFunctions() 会将内存队列 Flush 到 JSONL
已收到的部分回复会保存吗? 会 --- 已 yield 的 assistant message 片段已写入
API 会继续处理吗? 不会 --- abort signal 取消后,API 收到 TCP 断开继续处理但结果被丢弃
能恢复会话继续吗? 可以 --- claude --resume <sessionId> 重新加载 JSONL 恢复上下文继续对话
相关推荐
Michaelyeung14 分钟前
Windows 上给 Claude Code 配 MCP,今天踩的 3 个坑,你看看你在不在坑里
claude
ZzT40 分钟前
三个 Claude 代码审查 skill 用了半年、1,306 条评论:最简单的修复率 68.9%,最复杂的 59.2%
ai编程·claude
一缕82年的清风3 小时前
告别手动搬砖!我是如何搭出一套“AI 全自动自媒体运营系统”,每天 10 分钟铺满 7 大平台的?
chatgpt·claude·gemini
stark张宇20 小时前
Vibe Coding 入门实战:用 Claude Code 跑通 AI 产品开发流程(上)
后端·claude·vibecoding
武子康21 小时前
ComfyUI 加载了动作 LoRA,H3-World 的时间绑定就接好了吗?
人工智能·机器学习·claude
ZzT1 天前
Claude Code 连续压缩 3 次,丢掉 33% 到 57% 的用户指令;/compact 后加一段提示词降到 0
ai编程·claude
threerocks1 天前
Fable 5.2 完整大师课:这些提示词会彻底改变你
claude
冬奇Lab2 天前
一天一个开源项目(第260篇):Plannotator —— 给 AI 编码 Agent 配一块「可批注的审阅台」,计划和代码改动都能在浏览器里逐条批示
人工智能·开源·claude
武子康2 天前
给 H3-World 叠加 Turbo,动作 LoRA 为什么还要重新验收?
人工智能·agent·claude
发现你走远了2 天前
05-权限不是开关:工具调用如何在放行、拦截与追问之间做决定
人工智能·agent·claude