核心结论
先判断错误属于哪一层：ECONNRESET、ETIMEDOUT、证书错误、stream disconnected 属于网络层，通常与代理、节点或线路有关；401、403、429、5xx 属于服务层，分别对应认证、地区/权限、频率/额度和服务端故障。403 换支持地区节点，429 等待或检查额度，1020 换节点，5xx 查看官方状态页。
错误代码是定位问题最直接的线索。本文把常见错误分成两层：网络层（连接本身出了问题）和服务层（连接成功，但服务端拒绝或出错）。
先分层
| 层级 | 典型错误 | 问题通常在 |
|---|---|---|
| 网络层 | 超时、连接重置、证书错误、流中断 | 代理配置、节点、线路 |
| 服务层 | 401、403、429、500、502、503 | 账号、地区、用量、服务端 |
网络层错误
ETIMEDOUT / 连接超时
请求在规定时间内没有得到响应。
- 代理是否生效（终端工具尤其要检查）；
- 节点是否可用，换节点测试；
- 详见 节点连接超时排查。
ECONNRESET / Connection reset
连接被中途重置。常见于直连线路被干扰、节点故障或代理客户端异常。换节点或线路；检查是否有其他代理软件冲突。
stream disconnected before completion / 流式输出中断
常见于 Codex CLI、Claude Code 等工具：模型正在输出时连接断开。
- 关闭自动测速切换，固定节点；
- 选择丢包更低的线路（专线或优质中转）；
- 详见 Codex 网络环境配置。
证书错误（CERT_*、self signed certificate）
- 检查系统时间；
- 是否开启了代理客户端的 MitM 功能；
- 企业网络可能使用 HTTPS 拦截，需要按公司规定配置根证书。
ENOTFOUND / 无法解析域名
DNS 解析失败，见 DNS 污染与泄露排查。
服务层错误
401 Unauthorized
认证失败：API Key 错误或过期、登录状态失效。重新登录或检查密钥。
403 Forbidden
被拒绝访问，最常见的两个原因：
- 地区不支持：错误信息中包含 region、country、unsupported_country 等字样，换到支持地区节点；
- 权限问题：账号没有对应权限或被限制。
Cloudflare 1020 Access denied
网站的防火墙规则拦截了你的 IP，通常是节点 IP 被标记。换同地区的其他节点。
429 Too Many Requests
请求过于频繁，或达到了订阅 / API 的用量上限：
- 等待一段时间；
- 检查订阅额度或 API 限额；
- 自动化脚本中加入重试与退避。
500 / 502 / 503 / 529
服务端错误或过载。不是你的问题：
- 查看 Anthropic 状态页 或 OpenAI 状态页；
- 稍后重试。
常见提示语对照
| 提示 | 层级 | 处理 |
|---|---|---|
| Unable to load site（ChatGPT） | 服务层 / 地区 | 换支持地区节点 |
| App unavailable / only available in certain regions（Claude） | 服务层 / 地区 | 换支持地区节点 |
| 目前不支持你所在的国家/地区（Gemini） | 服务层 / 地区或账号 | 换节点并检查 Google 账号 |
| Network error | 网络层 | 固定节点、换线路 |
| Something went wrong | 不确定 | 无痕窗口、关闭扩展、查状态页 |
排查思路
- 记录完整错误信息与时间；
- 判断网络层还是服务层；
- 服务层错误先看状态页，再看地区与账号；
- 网络层错误检查代理、节点与线路。
更多场景化的排查：Claude 连接失败、ChatGPT 登录失败。
参考资料与官方来源
产品政策与支持地区可能随时调整，请以官方页面最新内容为准。
常见问题
Q429 是被封号了吗？
不是。429 表示请求过多或达到用量限制，等待一段时间、降低频率或检查订阅额度即可。
Q同样是 403，怎么区分是地区问题还是账号问题？
看错误消息中的文字：包含 region、country、territory 等字样通常是地区问题；包含 permission、forbidden、organization 等多与账号或权限有关。
Q错误代码在哪里看？
网页端可以在浏览器开发者工具的网络面板查看；CLI 工具会直接在终端输出，部分工具支持开启详细日志。