[CC] 卡住 15 分钟毫无响应:怎样脱身
返回博客
文章troubleshootingclaude codedev toolsprodutividadeanthropic

[CC] 卡住 15 分钟毫无响应:怎样脱身

Mafra2026年11月18日阅读约 4 分钟

转圈指示器一直在转,token 计数不动,也没有任何报错信息。五分钟过去,十五分钟过去,有时超过二十分钟。你按下 Esc,把同样的内容再发一次,回答几秒就回来了。

这就是 CLI 官方仓库中 issue #26224 描述的症状,2026 年 2 月提交,到 11 月仍然活跃,记录了连续提问时 5 到 20 分钟的卡死。这不是模型在思考,不是你的账号问题,也不是你的提示词问题:是一条连接悄无声息地死掉了,而没有任何 watchdog 发现它。

CLI 无报错卡死时,究竟发生了什么?

连接静默死亡。没有 FIN,没有 RST,没有 HTTP 错误响应。进程一直在等待永远不会到达的字节,而唯一能打断这段等待的计时器是 API_TIMEOUT_MS,客户端里它的默认值是 600 秒。

这个数字不是论坛传言。它就在你终端里运行的客户端代码中,位于发出请求和放弃等待之间:timeout: parseInt(process.env.API_TIMEOUT_MS || String(600 * 1000), 10)。如果连接在响应头到达之前就死了,在那之前不会有任何东西触发。

卡在哪一步本该提醒你的机制实际发生的情况
响应头之前首字节 watchdog根本没有启用,只剩 API_TIMEOUT_MS
流的中间流的空闲 watchdog卡顿仍然等同一个兜底值
收到 api_error 之后立即重试确实会重试,但要等时间耗尽之后

我把 CLAUDE_SLOW_FIRST_BYTE_MS 调大了,为什么没变化?

因为这个变量不会中断任何东西。根据同一仓库 issue #88178 的汇总报告,CLAUDE_SLOW_FIRST_BYTE_MS 默认 30 秒,只负责写日志和发送遥测。它不切断请求,不触发重试,也不提示用户。

这是一个会响的警报和一个只往文件里写字的警报的差别。你在日志里看到这个变量、把值调大,然后继续盯着同一个转圈。

变量控制什么默认值
API_TIMEOUT_MS客户端等待响应的时间600000(10 分钟)
CLAUDE_SLOW_FIRST_BYTE_MS记录慢卡顿的阈值30000(30 秒),不中断

为什么卡 15 分钟而不是 10 分钟?

因为桌面应用注入的值更大。issue #88178 的作者用 ps eww 沿进程链测量过:应用启动 CLI 时在环境里放了 API_TIMEOUT_MS=900000,而进程环境变量的优先级高于 settings 文件里的 env 块。

九百秒正好是 15 分钟,报告里实测的卡顿也正好落在这个数字上:900 秒、939 秒和 753 秒,每一次都以 api_error Request timed out 结束,每一次后面跟着的重试都在几秒内返回。同一个会话里卡两次,就是 #26224 标题里的 20 分钟。

实际影响:如果你用桌面应用并在 settings 里设了 API_TIMEOUT_MS,这个设置可能被忽略。先对 CLI 进程跑一次 ps eww,再怪配置。

怎样几秒钟就脱离卡死?

手动脱身的方式在两个报告里都一样,也是最快的:中断,然后重新发送。你丢掉的是正在生成的那一轮,而不是整个会话。

  1. 按 Esc 中断卡住的那一轮。
  2. 重发同一条指令,或者随便发一条短消息强制发起新请求。在 #26224 里,一句简单的追问常常就能把挂起的提示词解开。
  3. 如果总是在同一处卡住,问题在网络路径或服务商那边,不在你的提示词。这时候换一条线路,比继续重试有用。

第 3 步最关键。总是在同一段回来、计时又恰好贴着整数分钟的卡顿,是连接死亡的典型特征,重发解决不了根因。

怎样降低再次卡死的概率?

  • 把 CLI 环境里的 API_TIMEOUT_MS 降到 90 到 120 秒。用一次快速报错换掉漫长的空等,而且报错本来就会走重试。
  • 把长轮次拆开。连接需要保持打开的时间越长,暴露在静默卡顿下的风险越大。
  • 大任务之前先跑 /compact,让下一轮携带更少的上下文。
  • 用 --debug-file 开长会话,找卡顿那一行日志。没有日志,症状就是隐形的。
  • 始终配好第二条线路。第一条卡住而你 15 分钟后才发现时,有没有地方可去,决定你这一天的状态。

Verboo Code 存在的意义之一就是做这条备用线路:同样的终端、命令行和 MCP 流程,订阅内 token 不限量。你的服务商连接卡住时,用 /model 换引擎,不用换工具,也不会丢掉会话。

喜欢这篇文章吗?
把知识分享给你的朋友。
// 继续阅读

相关文章