整理自文档 · 错误码速查。遇到报错，先按状态码对一下：
| 状态码 | 常见原因 | 怎么处理 |
|---|---|---|
| 401 | API Key 缺失、无效或被禁用；Base URL 和协议不匹配；改了配置但工具没重启 | 核对 Key 和 Base URL，重启工具 |
| 402 | 余额不足 | 充值或减少用量 |
| 403 | 分组没开相应权限（比如图片生成）；或余额、订阅、计费资格不足 | 先看余额和订阅状态 |
| 404 | OpenAI 协议地址漏了 /v1、Anthropic 协议地址多写了 /v1；或当前分组不支持这个接口 |
按接入协议核对 Base URL |
| 429 | 当日额度用完；或并发、RPM、上游额度受限 | 额度用完见常见问题；限流就退避后重试 |
| 500、502、503、504 | 内部错误、上游暂时失败、没有可用上游账号、超时 | 有限次数重试；503 还要检查环境变量是否覆盖了 Key |
可以重试：429、502、503、504，以及网络中断、连接重置、读取超时。用指数退避重试 2～3 次。
不要重试：400、401，以及余额、权限、参数错误。请求本身有问题，换多少次都一样，先改请求。
几个最常见的报错原文：
401 Unauthorized: Incorrect API key provided：请求还在走官方接口，没有走灵眸503 No available accounts：Shell 环境变量覆盖了工具里配置的 Keystream disconnected before completion：断流，通常是代理或 VPN 切换了出口 IP400 Invalid signature in thinking block：同一个对话里跨分组切换了模型
排查时请记下响应头里的请求 ID，求助时附上请求 ID 和完整报错。不要贴出完整的 API Key。
还没解决？在本分类发帖，写清楚工具和版本、Base URL、模型名、完整报错（去掉 Key）。