转圈指示器一直在转,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,再怪配置。
怎样几秒钟就脱离卡死?
手动脱身的方式在两个报告里都一样,也是最快的:中断,然后重新发送。你丢掉的是正在生成的那一轮,而不是整个会话。
- 按
Esc中断卡住的那一轮。 - 重发同一条指令,或者随便发一条短消息强制发起新请求。在 #26224 里,一句简单的追问常常就能把挂起的提示词解开。
- 如果总是在同一处卡住,问题在网络路径或服务商那边,不在你的提示词。这时候换一条线路,比继续重试有用。
第 3 步最关键。总是在同一段回来、计时又恰好贴着整数分钟的卡顿,是连接死亡的典型特征,重发解决不了根因。
怎样降低再次卡死的概率?
- 把 CLI 环境里的
API_TIMEOUT_MS降到 90 到 120 秒。用一次快速报错换掉漫长的空等,而且报错本来就会走重试。 - 把长轮次拆开。连接需要保持打开的时间越长,暴露在静默卡顿下的风险越大。
- 大任务之前先跑
/compact,让下一轮携带更少的上下文。 - 用
--debug-file开长会话,找卡顿那一行日志。没有日志,症状就是隐形的。 - 始终配好第二条线路。第一条卡住而你 15 分钟后才发现时,有没有地方可去,决定你这一天的状态。
Verboo Code 存在的意义之一就是做这条备用线路:同样的终端、命令行和 MCP 流程,订阅内 token 不限量。你的服务商连接卡住时,用 /model 换引擎,不用换工具,也不会丢掉会话。
![[CC] 卡住 15 分钟毫无响应:怎样脱身](/_next/image?url=https%3A%2F%2Fstorage.googleapis.com%2Fverboo-landing-page%2Fblog-uploads%2F1783232445352-verboo-code-cover.png&w=3840&q=75)
