卡在哪里?先看屏幕,再看进程
# 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常见问题
为什么 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 的公开文档为依据,且经常发生变化;本页面的价格和模型列表读取自此网关的实时设置。