首页 › Claude Code › 错误 › 挂起 / 卡住
概览安装CLI 参考文档定价与限制Agent SDK技能与插件GitHub网页、桌面与 IDE模型错误是否开源?教程学生指南QA 自动化与 Cursor 对比与 Codex 和 OpenCode 对比子智能体钩子MCP生态系统VS CodeOpenRouter速率限制中文指南
最后更新:2026 年 11 月

Claude Code 挂起、卡住或停止响应:如何定位卡住的位置并恢复

挂起总有具体位置:Claude Code 可能在等待 API、它启动的工具、MCP 服务器、你的终端,或它自身。每种情况的脱困方法都不同,通常在你打算使用 kill 之前,状态行就能告诉你属于哪一种。

TLDR

  • 等待 API → 加载动画伴随 token 计数,或显示*正在等待 API 响应*;这是 连接问题,而不是挂起。
  • 等待工具 → 工具状态行一直未结束; Esc 可将其取消。等待输入的 shell 命令或失控的 grep 通常是原因。
  • 等待你操作 → 审批或提问提示隐藏在屏幕外;按 Enter 或滚动屏幕。
  • 确实挂起(没有输出,对 Esc, Ctrl+C也没有反应)→ 终止进程,然后使用 claude -c恢复会话;检查下方的已知缺陷。

卡在哪里?先看屏幕,再看进程

# in the session
Esc            # cancel the current tool or turn
Ctrl+C (twice) # abort the turn / exit
# from another terminal
ps aux | grep -E "claude|node" | grep -v grep     # child processes still running?
top -o cpu       # is claude spinning or idle?
claude --debug   # next time: timestamps for every request and tool call
claude -c        # resume the last session after a kill

CPU 空闲但提示词处理冻结,意味着它在等待外部因素:网络流、MCP 服务器、子进程,或你看不到的提示。CPU 持续满载,意味着它在处理内部任务:解析庞大的工具结果、正则表达式回溯,或加载大型会话。内存持续增长,意味着它正在将工具结果或会话文件整体载入内存。

问题跟踪器中的已知原因

  • `/rewind` 卡住,`Ctrl+C` 无效,需要 `kill -9` (#53011,21 个回应,在 2.1.1xx 版本中,任何规模的会话都可能出现)。一位 Anthropic 工程师未能在 2.1.233 上复现,因此请先更新;如果使用旧版本,请终止进程,然后使用以下命令恢复 claude -c ,而不是回退。
  • Remote Control 会话在执行过程中冻结,只有在本地执行 `Esc` 才能恢复 (#51267,未解决)。任何阻塞的工具或子进程都会使整个远程会话冻结,且无法远程取消;请缩短此类会话,并避免使用可能弹出交互提示的工具。
  • MCP 身份验证提示卡在 `Enter` (#42707,未解决)。请通过单独的 claude mcp 命令或浏览器完成服务器身份验证,然后重启会话。
  • 通过内嵌匹配器执行 `grep` 会耗尽所有内存 (#54394):在原生版本中,每个 shell grep 都会在一个 claude 进程中运行,并拥有独立的 V8 堆;对很长的压缩代码行使用回溯正则表达式,会使内存膨胀到数 GB,OOM 终止机制也会随之终止会话,WSL2 和 Linux 上均如此。避免对压缩文件使用无界正则表达式,排除构建输出和 node_modules,或安装系统版 ripgrep 并显式调用。
  • 在 `400 thinking blocks cannot be modified` 上陷入重试循环 (#63231)——对话历史无效,每次重试都会以相同方式失败。 /rewind 回退到该轮之前,或 /clear;请参阅 400 指南.
  • **云端 / 定时运行卡在“正在设置云端容器”**(#53691, #54528)——问题在服务端;本地无需处理,请取消并查看 status.claude.com.。
  • 恢复大型会话需要数分钟 ——启动时会重放对话记录。请恢复你需要的特定会话(claude -r),而不是最大的会话,并通过上下文压缩缩减超大会话。

启动时卡住

在执行 claude 后立即出现空白屏幕且没有提示符,通常是首次 API 调用没有返回:可能是代理变量指向了失效的代理、VPN、DNS,或无法访问的 ANTHROPIC_BASE_URL。请运行 连接错误指南中的 curl 检查,然后运行 claude doctor。如果启动缓慢但最终出现提示符,则是 MCP 服务器正在启动; claude mcp list 并移除那些超时的服务器。

始终不退出的子进程

如果 shell 工具打开编辑器、等待密码输入、持续跟踪日志或启动开发服务器,它就不会返回,这一轮也会一直等待。请告诉代理在后台运行服务器,并在命令可能要求交互输入时添加 --no-pager, -y 或 < /dev/null 。如果已经发生这种情况, Esc 可取消该工具;如果子进程不响应,请从另一个终端按 PID 终止它,该轮就会携带错误信息继续执行。

内存和 CPU 占用高

  • 工具结果会在会话期间保存在内存和磁盘中;读取一个 200 MB 的文件,就会形成一个 200 MB 的会话。只读取需要的部分。
  • 大量并行子代理会成倍增加所有资源开销; CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2 在配置较低的机器上。
  • 渲染缓慢的终端模拟器(某些 Windows 控制台、通过低带宽连接使用的远程 tmux)会让流式输出看起来像冻结了; claude --debug 可以显示 token 是否仍在到达。
  • 如果空闲时内存仍持续增长,请查找崩溃的 IDE 会话遗留的 claude 进程并终止它们(进程已退出,退出代码为 1 介绍了 Windows 上的孤儿进程情况)。

当问题出在 API,而非客户端时

如果会话每一轮都在同一位置卡住,显示一个小型加载图标,最终出现重试提示,那么通常是 API 链路缓慢或连接中断,而非客户端缺陷: 529 过载, 服务端限流 或连接被重置。通过网关(ANTHROPIC_BASE_URL=https://aiprimetech.io)时,负载已满的上游账号会被故障转移到另一个账号,从而缩短这类停顿。

厌倦了与这个问题反复较劲?

改为通过 AI Prime Tech 网关运行 Claude Code:使用相同的 Claude 模型,由网关自己的上游账户提供服务,设置两个环境变量即可切换,新账户可获得 $5 免费 API 额度 使用优惠码 FIXIT — 无需银行卡。

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

使用优惠码 FIXIT 创建账户

常见问题

为什么 Claude Code 卡住且没有响应?

它正在等待某个环节:API 流、它启动的工具、MCP 服务器,或屏幕外的审批提示。按 Esc 取消工具,连按两次 Ctrl+C 中止;如果完全没有响应,请终止进程并使用 claude -c 恢复。

如何解决 Claude Code 在 /rewind 时卡住的问题?

更新到当前版本;该卡顿问题曾在 2.1.1xx 上被报告,而 Anthropic 未能在 2.1.233 上复现。如果使用旧版本,请终止进程并使用 claude -c,而不是 /rewind。

为什么 Claude Code 占用这么多内存?

大型工具结果和会话记录会被完整保留,子代理会使其成倍增加,而在原生版本中,带回溯的 grep 正则表达式会在拥有大型 V8 堆的 claude 进程内运行。减少读取量、排除构建输出、降低并发。

Claude Code 启动时卡住且没有提示符。应该检查什么?

首次 API 请求没有返回:请检查代理变量、VPN、DNS 或无法访问的 ANTHROPIC_BASE_URL。对端点运行 curl,然后运行 claude doctor,并移除超时的 MCP 服务器。

通过网关运行 Claude Code

相同的模型,两个环境变量,面值 7.69231 倍的额度,或固定费率不限量方案。 新账户:使用优惠码 FIXIT 可获得 $5 免费 API 额度。

获取 API 密钥 查看不限量方案

AI Prime Tech 是独立的 API 网关,与 Anthropic 无关联,也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据,且经常发生变化;本页面的价格和模型列表读取自此网关的实时设置。

更多 Claude Code 指南

Claude Code 错误及修复方法Claude Code“API 错误:500”:含义及真正有效的修复方法Claude“过载”错误(API 错误 529):含义及应对方法Claude Code API 错误 400:提示词过长、工具使用并发问题及其他错误Claude Code OAuth 错误:超出 15000ms 超时时限,以及状态码 500“Claude Code 进程退出,退出码为 1”:如何找到真正的错误并修复Claude“提示词过长”“输入对于请求的模型而言过长”和“已达到上下文上限”:什么占满了窗口,以及如何释放空间已达到 Claude 使用上限:会话、每周和 Opus 上限、“指定的 API 使用上限”、“额度余额过低” — 以及应对方法Claude Code 401 和 403:身份验证凭据无效、API 密钥无效、“未登录”、host_not_allowedClaude Code 连接错误:ECONNRESET、响应中途连接丢失、“正在等待 API 响应”、“无法连接到 API”、SSL 证书错误Claude.ai 无法正常使用:“出了点问题”、容量限制、“已达到 5 小时上限”、“登录时出错”及其他问题