Source: https://aiprimetech.io/zh/claude-code/errors/claude-code-hangs/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › [错误](/zh/claude-code/errors/) › 挂起 / 卡住

[概览](/claude-code/zh/)[安装](/claude-code/zh/install/)[CLI 参考文档](/zh/claude-code/cli/)[定价与限制](/claude-code/zh/pricing/)[Agent SDK](/zh/claude-code/sdk/)[技能与插件](/zh/claude-code/skills/)[GitHub](/zh/claude-code/github/)[网页、桌面与 IDE](/zh/claude-code/web-and-desktop/)[模型](/zh/claude-code/models/)[错误](/zh/claude-code/errors/)[是否开源？](/zh/claude-code/open-source/)[教程](/claude-code/zh/tutorial/)[学生指南](/zh/claude-code/for-students/)[QA 自动化](/zh/claude-code/qa-automation/)[与 Cursor 对比](/zh/claude-code/vs-cursor/)[与 Codex 和 OpenCode 对比](/zh/claude-code/vs-codex/)[子智能体](/zh/claude-code/subagents/)[钩子](/zh/claude-code/hooks/)[MCP](/zh/claude-code/mcp/)[生态系统](/zh/claude-code/ecosystem/)[VS Code](/zh/claude-code/vscode/)[OpenRouter](/zh/claude-code/openrouter/)[速率限制](/zh/claude-code/rate-limits/)[中文指南](/claude-code/zh/)

最后更新：2026 年 11 月

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

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

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

## 启动时卡住 

在执行 claude 后立即出现空白屏幕且没有提示符，通常是首次 API 调用没有返回：可能是代理变量指向了失效的代理、VPN、DNS，或无法访问的 ANTHROPIC_BASE_URL。请运行 [连接错误指南](/zh/claude-code/errors/connection-lost/)中的 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](/zh/claude-code/errors/process-exited-code-1/) 介绍了 Windows 上的孤儿进程情况）。 

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

如果会话每一轮都在同一位置卡住，显示一个小型加载图标，最终出现重试提示，那么通常是 API 链路缓慢或连接中断，而非客户端缺陷： [529 过载](/zh/claude-code/errors/overloaded-529/), [服务端限流](/zh/claude-code/errors/usage-limit-reached/) 或连接被重置。通过网关（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 创建账户](/register?promo=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 密钥](/register?promo=FIXIT) [查看不限量方案](/zh/plans/)

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

## 更多 Claude Code 指南

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