Claude Code ECONNRESET、“连接丢失”、“正在等待 API 响应 · 请检查网络”、“无法连接到 API”及证书错误—

错误消息

API Error: Connection dropped (ECONNRESET)
API Error: Connection lost mid-response
API Error: fetch failed
Unable to connect to API (ConnectionRefused)
Retrying in 0s · attempt 1/10
Waiting for API response · will retry in 2m 35s · check your network
API Error: Socket is closed
SSL certificate verification failed: unable to get local issuer certificate
Error: certificate has expired (CERT_HAS_EXPIRED)

问题在你这边还是对方？两分钟检查

curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" https://api.anthropic.com/v1/models -H "x-api-key: x" -H "anthropic-version: 2023-06-01"
# 401 in under a second = network path is fine, the problem is upstream or in Claude Code
# timeout / SSL error / 000 = the problem is on your side of the wire
env | grep -i -E "proxy|anthropic|node_extra|ssl"
claude --debug     # per-request timing and retry reasons in the log

如果 curl 很快返回 401，且没有设置代理变量，那么几乎可以确定是上游故障。以下问题报告属于这类情况： #87424 （未解决：桌面应用和 CLI 间歇性出现 ECONNRESET，未使用 VPN 或代理，自 13 年八月起出现，直到 21 年八月仍有多人确认）以及 #86473 （所有使用入口持续出现 ECONNRESET，但直接通过 HTTP 访问 API 正常）。本地操作无法解决这些问题；只能靠重试和等待。请查看 status.claude.com，如果问题跟踪器中有多人报告在同一小时遇到问题，就停止调试。

“正在等待 API 响应 · 请检查网络”

这条消息将问题归咎于你的网络，但它往往判断错误。 #82155 （未解决，15 个回应）：在已证实正常的网络上，全天频繁停顿数分钟，重试退避时间超过两分钟。 #76555 （未解决）：所有模型的每一次回复都需要等待。 #72059 和 #70534：尤其在咨询顾问模型时出现相同停顿，计时结束后则正常回复。退避时间呈指数增长，因此用户感受到的影响是等待，而不是失败；下面的变量可以缩短等待时间。

重试和超时变量

export CLAUDE_CODE_MAX_RETRIES=15               # default 10, capped at 15
export CLAUDE_CODE_RETRY_WATCHDOG=1              # keep retrying instead of giving up (unattended runs)
export API_TIMEOUT_MS=600000                     # per-request timeout, default 10 minutes
export CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS=60000 # give up on a silent stream sooner and retry
export CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2    # fewer parallel streams on a flaky link

降低首字节超时能改善不稳定连接的使用体验：客户端不再对永远不会响应的流等待整整十分钟，而是放弃该流并重试。对于同时运行多个流就会断开的连接（移动热点、某些 VPN），降低工具调用并发会有所帮助。

代理、VPN 和企业网络

设置 Claude Code 读取的代理变量： HTTPS_PROXY （以及 HTTP_PROXY, NO_PROXY）。仅在浏览器或 npm 配置中设置的代理对 CLI 不可见。
进行 TLS 检查的代理 会用自己的证书替换 Anthropic 的证书：这就是 unable to get local issuer certificate。将企业根 CA 证书导出为 PEM 文件，并设置 NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem。不要禁用验证。
原生版本上的 `CERT_HAS_EXPIRED` (#71727，2.1.19x）：问题在于内置的信任证书库，而不是你的时钟。 claude update；如果仍无法解决，npm 版本使用系统证书库。
macOS 重新安装后出现 `ConnectionRefused` (#75897）——本地代理或 VPN 客户端已关闭，但环境中仍保留其配置；清除代理变量和系统代理设置，然后重试。
VPN 出口变更 若发生在会话过程中，会重置所有已打开的流：每次重新连接预计会出现一次 ECONNRESET。

通过网关

将 Claude Code 指向一个网关（ANTHROPIC_BASE_URL=https://aiprimetech.io），网络路径就会改变：客户端与网关通信，由网关维持上游连接，并在某个账号饱和时换用另一个账号重试。它无法修复故障的本地网络，但对于上文遇到*上游连接重置*的用户，它消除了对单个账号的依赖，而且在订阅服务发生故障期间，同一个密钥仍可继续使用。切换前，请对网关主机运行 curl 检查，确认这条路径可用。

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

厌倦了与这个问题反复较劲？

改为通过 AI Prime Tech 网关运行 Claude Code：使用相同的 Claude 模型，由网关自己的上游账户提供服务，设置两个环境变量即可切换，新账户可获得 $5 免费 API 额度 使用优惠码 FIXIT — 无需银行卡。

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

使用优惠码 FIXIT 创建账户

常见问题

如何修复 Claude Code 中的“API 错误：连接已断开（ECONNRESET）”？

对 API 运行 curl：如果响应很快，而且你没有使用代理，则连接重置发生在上游；让客户端继续重试，并查看 status.claude.com.。如果 curl 也失败，请修复代理变量、VPN 或 CA 证书。

“正在等待 API 响应 · 将在……后重试 · 请检查网络”是什么意思？

Claude Code 未在超时时间内收到 API 响应，正在等待一段时间后重试。尽管提示这样写，问题往往并不出在你的网络；调低 CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS，让客户端更早放弃没有响应的流。

如何修复 Claude Code 中的“无法获取本地颁发者证书”？

代理正在重新签署 TLS 证书。将企业根证书导出为 PEM 格式，并将 NODE_EXTRA_CA_CERTS 设置为该文件。切勿禁用证书验证。

“将在 0 秒后重试 · 第 1/10 次尝试”是什么意思？

请求失败，Claude Code 正在重试；默认尝试 10 次，等待时间逐步增加，CLAUDE_CODE_MAX_RETRIES 可将次数提高到 15，而 CLAUDE_CODE_RETRY_WATCHDOG=1 可让无人值守运行持续重试。

通过网关运行 Claude Code

相同的模型，两个环境变量，面值 7.69231 倍的额度，或固定费率不限量方案。新账户：使用优惠码 FIXIT 可获得 $5 免费 API 额度。

获取 API 密钥查看不限量方案

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

Claude Code 连接错误：ECONNRESET、响应中途连接丢失、“正在等待 API 响应”、“无法连接到 API”、SSL 证书错误

TLDR