Claude Code 卡死、冻结、无响应？全套急救手册

卡在 “Compacting conversation…”（正在压缩对话）

上下文窗口快满时会触发自动压缩：Claude Code 把至今的对话总结成摘要再替换进去。会话真的很大时，这一步跑几分钟属正常——而且 v2.1.282 和 v2.1.284 确实修过真实的压缩故障：摘要请求被拒导致压缩失败、压缩完仍报 “Prompt is too long”。如果会话规模正常却磨蹭超过两三分钟，那就是卡住了，不是在干活。

1. 1会话确实巨大就先等两三分钟——v2.1.283 重做了压缩转圈提示，计时从压缩真正开始才走。
2. 2超过这个时间，先按 Esc 再按 Ctrl+C 取消压缩。官方文档确认 Ctrl+C 只取消当前操作，不会丢弃会话。
3. 3然后手动带重点压缩，让摘要丢掉大块工具输出，例如：/compact keep only the plan and the diff。
4. 4旧对话不要了就直接 /clear 重开——同时升级到 v2.1.284 或更新版本，把修好的压缩重试逻辑装上。

/compact keep only the plan and the diff/clear

卡在 “Almost done thinking…”（快想完了）

反直觉的是，这行转圈文案并不代表进度：官方成员在 issue #63387 里确认，这些轮换短语和模型真实的推理状态无关。所以 “almost done” 可以在屏幕上挂好几分钟，issue #55328 更是记录了扩展思考跑很久时 Esc 和 Ctrl+C 都按不动的回合。

1. 1先按一次 Esc 等几秒；转圈还在转就按 Ctrl+C。
2. 2输入还是没反应，就关掉终端标签页、开个新的，在原目录运行 claude --resume 把会话接回来。
3. 3如果每轮长任务都这样卡，先升级 Claude Code，再怀疑是 MCP 服务器或 hook 挂了——症状和思考卡死一模一样，/mcp 能看出哪个服务在作妖。

claude --resume

“Not responding — try stopping”（无响应，请尝试停止）

这条橙色横幅是 Claude Code 的看门狗：某个工具调用——通常是一条长 bash 命令——安静得够久，界面就递给你一个停止按钮。它只是提醒，不是诊断结论：Anthropic 自己的演示里，进程在横幅底下仍在正常干活；Claude Code 负责人 Boris Cherny 也公开征集过这个状态的录屏，说明团队已知悉并在调查。

1. 1先看底层命令是否还在出输出——安静编译中的构建不需要你去打断。
2. 2确认真卡住了，再按 Esc 或橙色停止按钮打断这一轮。
3. 3然后明确告诉 Claude 是你手动停止的——手动停止后模型可能误以为工具被拒绝，开始道歉而不是继续干活。
4. 4把长任务改成后台跑或拆小块跑，别再触发前台看门狗。

claude --resume

已知的粗糙边缘：Anthropic 自己演示这条横幅时，停止按钮弹出来的那一刻命令其实还健康——动手前先核实。

卡在 “Resuming container…”（云会话恢复容器中）

Claude Code 的网页端和移动端会话跑在云端容器里。重新打开旧会话意味着把容器重新拉起、再把对话记录流式载入——历史越大越慢。v2.1.286 修了一个真 bug：超大历史的会话因为容器在转录还在加载时就停机，从此再也醒不过来。

1. 1先等几分钟——冷启动恢复容器比新会话慢，而且没有进度条告诉你它在动。
2. 2把 CLI 升到 v2.1.286 或更新——claude update，或 npm install -g @anthropic-ai/claude-code——那个版本专门修了超大云历史永远醒不来的 bug。
3. 3升级后还冻着？刷新网页会话；还不行就另开新会话接着干。

claude updatenpm install -g @anthropic-ai/claude-code

社区方案，官方尚无回应：多名用户反馈容器五分钟左右会自己醒过来——过了这个点再判死刑。

启动时冻结

提示符还没出来就冻住，几乎都是本地问题：崩溃的 MCP 服务器、插件或 hook、损坏的状态文件，或扩展本身。v2.1.284 修了 VS Code 里 Restart Extensions 后标签页无响应的问题，v2.1.286 修了扩展停止响应时无限转 “Teleporting session…” 的转圈。应用内的 /doctor 需要会话活着才能跑，所以这一类要从 shell 开始。

1. 1在终端里运行 claude doctor——官方文档对「启动不了」场景的推荐正是它；它会检查安装并提出修复。
2. 2再用 claude --safe-mode 启动，它会为本会话禁用全部插件、MCP 服务器和 hook——能启动就说明凶手在这些自定义配置里。
3. 3逐个重新启用这些配置——或进去后跑一次 /mcp——揪出元凶，然后升级或删掉它。
4. 4VS Code 用户把扩展也一起升级——上面两个 2.1.28x 修复只在当前版本里存在。

claude doctorclaude --safe-mode

终端里冻结

最经典的全窗口假死——输入没反应、转圈不动、Ctrl+C 失灵——官方有标准流程：先尝试取消，必要时重启终端，然后恢复会话，两条路都不丢东西。至于编辑器内置终端里输出花屏、残影，那是另一个问题——GPU 渲染加速，一条命令就能修。

1. 1按 Ctrl+C 尝试取消当前操作。
2. 2窗口还是没响应，就整个关掉终端，重开一个。
3. 3在新终端里、同一个项目目录运行 claude --resume——官方文档承诺对话不会丢。
4. 4VS Code 内置终端里输出花屏？运行 /terminal-setup——它会关掉终端的 GPU 加速，花屏随之消失。

claude --resume/terminal-setup