Claude API 请求超时或连接错误怎么办？

Claude API 请求超时或报连接错误时，第一件事是判断问题出在网络层还是服务端。方法很简单：在同一台机器上用 curl 通过代理访问 api.anthropic.com。curl 都连不上，问题在代理、DNS 或 TLS；curl 连得上但业务请求返回 429 或 5xx，问题在限流或服务端繁忙。两类问题的处理方式完全不同，混在一起排查只会浪费时间。

截至 2026 年 9 月，Anthropic API 与 Claude 网页端一样有地区要求，从中国大陆调用通常需要代理，节点应选择美国、日本、新加坡等支持地区。

快速判断

用 curl 验证网络层

先确认代理本身能到达 Anthropic API。端口以客户端设置为准，Clash Verge Rev 通常是 7897：

curl -x http://127.0.0.1:7897 -I https://api.anthropic.com

能返回响应头，说明代理与节点正常。再用实际的 API Key 发一个最小请求，模型名填写官方文档中的有效名称：

export HTTPS_PROXY=http://127.0.0.1:7897
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"MODEL_NAME","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

如果第一条成功、第二条返回 HTTP 状态码，说明网络是通的，接下来看状态码。如果第一条就失败，按下面的网络层步骤处理。

网络层问题的处理

1. 确认程序运行的终端或进程设置了 HTTPS_PROXY，新开的终端窗口需要重新设置。
2. 如果 SDK 不读取环境变量，在代码中显式配置代理，或开启客户端 TUN 模式。
3. 域名解析异常时，让 DNS 走代理端处理，参考 DNS 错误排查。
4. TLS 握手失败时先核对系统时间，再换节点，详见 TLS 错误排查。
5. 所有节点都超时，按 节点超时排查 检查订阅与客户端。

服务端问题的处理

429 限流：说明请求频率或并发超过了当前额度。降低并发，按指数退避重试，不要在失败后立即连续重发。

5xx 错误：通用含义是服务端出错或暂时繁忙。短暂等待后重试即可，持续出现时关注官方状态页面。

长请求中途超时：适当调大 SDK 超时时间，改用流式输出，并选择丢包率低的专线节点。Claude Code 场景的类似问题可以参考 Claude Code 网络连接失败怎么办。

总结

• 先用 curl 区分网络层与服务端问题，再对症处理。
• 网络层看代理是否生效、DNS 与 TLS 是否正常。
• 429 是限流，降低并发并退避重试；5xx 是服务端问题，稍后重试。
• 长请求用流式输出、调大超时，并选低丢包专线节点。