API Error: The response stopped arriving 的含义与解决方法——Claude Code 的响应数据中途停止时

“API Error: The response stopped arriving”表示：响应正在输出时，连接仍然开着，数据却不再送达，于是 Claude Code 自己的监视计时器切断了这个连接。在此之前已经完成的输出会留在屏幕上。如果是交互式会话，回复 continue 就能从最后完成的地方接着做。

API Error: The response stopped arriving. The response above may be incomplete.

在 v2.1.227 之前，这条提示的文字是 Response stalled mid-stream。官方错误参考明确写了这次改名，发生的情况完全相同。查找用旧文字写成的资料或问题报告时，请用新旧两种文字都搜一遍。

1. 这条提示的含义——不是断开，而是“无声”

Claude Code 官方错误参考对这条提示的解释是：“连接一直开着，但不再传送数据，因此流式传输的空闲监视（idle watchdog）将其切断”。它不是 API 返回的错误正文，而是正在接收响应的 Claude Code 自己加上的注记。

同样是“中途停住”，Claude Code 会按原因换用不同的措辞。官方列出了下面 4 条，结尾的“The response above may be incomplete.（上面的响应可能不完整）”是共同的。

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.

第 1 行是响应途中服务器返回过载或 5xx 错误，第 2 行是连接断开，第 3 行是响应途中电脑进入了睡眠。只有第 4 行的这条提示表示既没有出错也没有断开，数据却不再到来。

负责切断的是 4 个监视计时器

根据官方的网络配置文档，Claude Code 有 4 个计时器，用来切断变得安静的数据流。这样，已经死掉的连接就不会一直卡住，而是能作为失败来处理。在响应开始流动之后起作用的，是下表中的前 3 个。

直连 Anthropic API 时，大致以字节级监视的 180 秒为准。也就是说，在这条提示出现之前，屏幕看起来会停住好几分钟。官方说明，如果请求还活着但 20 秒没有数据，会先出现下面这条横幅。它表示“还没有失败”，倒计时指的是到切断为止的时间（v2.1.185 之前是 10 秒，文字也不同）。

Waiting for API response · will retry in … · check your network

数据恢复后，横幅会自动消失。如果横幅没有消失、一直走到切断，而且部分输出已经完成，就会出现本文讨论的这条提示。

2. v2.1.227 起由“Response stalled mid-stream”改名而来

官方错误参考在 4 条提示的说明之后紧接着写道：“v2.1.227 之前，Connection lost mid-response 显示为 Connection closed mid-response，The response stopped arriving 显示为 Response stalled mid-stream”。在同一个版本里，输出开始前的那条提示也换了文字。

旧文字 Response stalled mid-stream 与模型没完没了地重复同一个词的现象一起出现的例子，整理在讨论 Response stalled mid-stream 与“court”无限循环的文章里。连接断开那一侧的提示，旧文字时代的报告见 Connection closed mid-response 的文章，改名后的文字见 Connection lost mid-response 的文章，分开讲解。

3. 与相似提示的区别

会出现哪一条提示，取决于响应进行到哪一步时停住。把官方“Automatic retries”的说明按响应的进展顺序排列，就是下面这样。

③ 不重新发送的理由，官方也写明了：在完成一段文字或一次工具调用之后重新发送请求，有可能把同一个工具调用执行两次。所以 Claude Code 会保留已完成的部分，不丢弃这一轮，而是加上注记。

与 Connection lost mid-response 的区别在于“断开还是无声”

两者都是在输出进行到一半之后出现的提示，已完成的输出都会保留，也都可以用 continue 接着做。不同的是停住的方式。lost 判定的是连接丢失，应怀疑本地线路的瞬断、VPN 重连或途中设备的切断。stopped arriving 判定的是连接还在，内容却不再流过来，而且是等到监视计时器的时间用完之后才切断的。因此，第 6 章讲的计时器调整只可能对 stopped arriving 这一侧起作用。

与 Streaming response ended… 的区别在于“停住还是空着结束”

据官方说明，Streaming response ended before any complete data was received 是响应一条可用数据都没送来就结束时的警告。Claude Code 会放弃流式传输，重新发送同一个请求，并继续这一轮。在交互式会话中，这个警告每个会话只出现 1 次（v2.1.239 之前是悄悄重新发送）。官方写道，常见原因是途中的代理或网关消耗或改写了响应正文。stopped arriving 则是响应来到一半之后停住，不会自动重新发送。

4. 已经做到一半的工作会怎样

按照官方的说明，Claude Code 会保留所有已完成的块，并在这一轮结束时丢弃最后那个没完成的块。屏幕上最后几句话或最后一次工具调用有时会缺失，就是这个原因。已经完成的工具调用会被执行，这一轮会根据其结果继续。不同的运行环境，停住之后的处理也不同。

用 -p 时停住的输出和继续方法

在非交互模式默认的文本输出中，Claude Code 会输出这一轮最后完成的文字块，并在其后接上这条提示（v2.1.219 之前只有提示，响应会被丢弃）。不过，如果手头没有留下已完成的文字，例如这一轮途中会话被压缩、那段文字已经消失，就只会输出提示（2026 年 9 月 26 日在官方错误参考中确认后补充）。使用 --output-format json 或 stream-json 时，这条提示放在 result 字段里。官方的做法是：等连接稳定之后，恢复会话并发送 continue。

# 继续上一次的会话
claude -p "continue" --continue

# 指定会话 ID 继续
claude -p "continue" --resume "$session_id"

另外，关于用钩子自动恢复，Issue #87972 的报告者写道：“旧文字的时代 Stop 钩子会触发，能自动继续，但大约在改名的同时就不再触发了”。这是报告者的观察，官方没有说明以前的行为是否是有意设计的。按照现在的官方文档，钩子可以用来记录或通知，但无法让这一轮重新开始。

5. 原因——官方写了什么，用户报告了什么

这条提示只告诉你“数据不再到来”这个结果，从提示本身看不出为什么停住。下面按可信程度分开整理。

官方把这条提示放在错误参考的“Server errors”一节。该节开头写着“大多数来自 Anthropic 的服务等推理提供商一侧”，但官方对这条文字的说明只到上面的机制为止。究竟是停在本地线路、途中设备还是服务器，官方并没有指明。

#88900 和 #90005 都写道，本地线路看不出异常却停住了。不过，仅凭这一点并不能断定原因在服务器端。正如 #90005 的报告者自己所写，短时间的通信测试无法再现“保持打开几分钟的连接中途沉默”的情况。

6. 停住时的处理步骤

按从上到下的顺序排列，越靠前越省事、效果越大。如果只出现一次，做到第 2 步就可以了。

写在 ~/.claude/settings.json 中的例子（把字节级监视设为 10 分钟）。

{
  "env": {
    "CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS": "600000"
  }
}

7. 确认是否已经解决

不要因为一次没出现就算完事，要在跑同等规模的工作时检查下面 4 点。

# 查看版本
claude --version

# 一边记录调试日志一边启动
claude --debug

# 统计包含这条文字的会话日志文件数（macOS、Linux）
grep -rl "The response stopped arriving" ~/.claude/projects/ | wc -l

# 同样，统计包含这条文字的行数（PowerShell）
Get-ChildItem "$HOME\.claude\projects" -Recurse -Filter *.jsonl | Select-String -SimpleMatch "The response stopped arriving" | Measure-Object

次数请只作为参考。#90005 的报告者写道，某段 85 分钟内屏幕上停了 15 次，会话日志里留下的记录却只有 1 条。即使会话日志是 0 次，自己也记下屏幕上停住的次数会更可靠。

8. 报告时要留下的信息

官方错误参考列出了问题无法解决时的 4 个渠道。

• 在 Claude Code 中执行 /feedback。会话记录和说明会发送给 Anthropic，也可以打开一个已填好内容的 GitHub Issue。使用 Bedrock、Vertex 等提供商时，不会发送，而是保存在本地
• 在 shell 中执行 claude doctor，查看对安装情况的只读诊断
• 在 status.claude.com 确认故障
• 查找 GitHub 上已有的 Issue。新旧两种文字都要搜索

9. 已确定的事与未确定的事

10. 总结

“API Error: The response stopped arriving”表示响应输出到一半之后，连接仍然开着，数据却停了，Claude Code 的监视计时器将其切断。它和 v2.1.227 之前的 Response stalled mid-stream 是同一回事，已完成的输出会保留下来。请先确认工作的状态，再回复 continue。

如果反复出现，就按顺序尝试：更新版本；逐一排查 VPN、代理和网关；设法缩短单次响应。仅在链路会长时间沉默的环境中，才有延长字节级监视时间这个办法。它与连接本身断开的 Connection lost mid-response 要怀疑的地方不同，所以请先对照提示的文字。其他错误整理在 Claude Code 常见错误与解决方法汇总中。

FAQ

Q. “API Error: The response stopped arriving”是什么意思？
A. 意思是响应正在输出时，连接仍然开着，数据却不再送达，于是 Claude Code 的监视计时器切断了这个连接。这是在完成一段文字或一次工具调用之后停住时的提示，之前的输出都会保留。

Q. 它和“Response stalled mid-stream”是不同的错误吗？
A. 是同一个。官方错误参考明确写着，v2.1.227 之前这条提示是 Response stalled mid-stream。只是显示的文字变了，并不是出现了新的故障类型。

Q. 回复什么才能接着做？
A. 请回复 continue，它会从最后完成的块继续。如果停在文件操作或命令执行的途中，先用 git status 等确认实际状态再回复，会更稳妥。

Q. 调大重试次数就不会再出现了吗？
A. 不会。在这个场景下，为了不把同一个工具调用执行两次，Claude Code 本来就设计为不重新发送。CLAUDE_CODE_MAX_RETRIES 起作用的是输出开始之前的失败。

Q. 它和“Connection lost mid-response”有什么不同？
A. lost 判定的是连接本身断开，stopped arriving 判定的是连接还在但数据不再到来。两者已完成的输出都会保留，都能用 continue 接着做，但调整监视时间只可能对 stopped arriving 这一侧起作用。

参考的一手资料

• Claude Code — Error reference（官方文档）：The response above may be incomplete 的 4 条提示与 v2.1.227 的改名、v2.1.222 之前的误报、Automatic retries、等待横幅、No response from API、Streaming response ended before any complete data was received、Report an error
• Claude Code — Enterprise network configuration（官方文档）：4 个监视计时器与默认时长、设置用的环境变量、调试日志、向后台代理传递设置的方法
• Claude Code — Environment variables（官方文档）：CLAUDE_STREAM_IDLE_TIMEOUT_MS、CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS、API_FORCE_IDLE_TIMEOUT 的说明
• Claude Code — Hooks reference（官方文档）：以 API 错误结束的一轮触发的 StopFailure
• Claude Code — Run Claude Code programmatically（官方文档）：用 --continue、--resume 恢复
• anthropics/claude-code — CHANGELOG（官方）：v2.1.222、v2.1.227、v2.1.229、v2.1.232、v2.1.246、v2.1.257 各条目
• GitHub Issue：#88900、#90005、#89027、#87246、#87972（均为用户报告。2026 年 9 月 22 日确认）