使用 AI 中转站时，最常见的崩溃现场不是完全没反应，而是返回一串错误码：401、403、429、503。很多人看到就开始重装工具，其实大多数问题都可以按错误码快速定位。
401：优先查 Key
401 Unauthorized 通常表示鉴权失败。最常见原因是 API Key 写错、复制时多了空格、key 已过期、填错了变量，或者中转站要求 Bearer Token 但你填到了普通 API Key 字段。
排查 401 时，不要先怀疑模型，也不要先换工具。先确认 key 是否完整、是否属于当前中转站、是否还有余额或权限。
403：优先查权限
403 Forbidden 通常表示你有 key，但没有权限完成这次请求。可能是套餐不支持这个模型，模型没有开通，IP 或来源被限制，也可能是中转站策略拒绝了某类请求。
429：优先查限流和额度
429 Too Many Requests 通常是频率太高或额度不足。AI 编程工具会连续发很多请求，比普通聊天更容易触发限流。
解决办法包括降低并发、换更高额度套餐、增加重试间隔，或者让中转站为代码工具单独配置更合理的限流策略。
503：优先查上游和模型映射
503 Service Unavailable 通常表示中转站或上游暂时不可用。对 Codex、Claude Code 这类工具来说，也可能是中转站没有支持某个内部模型名或工具链请求。
比如 Codex 自动审批阶段出现 503，就要重点查 codex-auto-review 这类模型名是否被中转站识别和路由。
推荐排查顺序
- 401 看 key；
- 403 看权限和套餐；
- 429 看额度和频率；
- 503 看上游状态、模型映射和中转站日志；
- 如果错误只在工具调用阶段出现，重点查流式输出、tool call 和特殊模型名。
如果你只是想稳定使用 Claude Code、Codex CLI、Gemini CLI、Cline、Roo Code 这类 AI 编程工具，不想自己维护模型映射、网络转发和错误排查，可以了解 YYLX.IO 鱼鱼连线。对普通用户来说，最省时间的方案往往不是自己搭一整套网关，而是直接使用已经整理好接入方式的 AI 中转站。
总结
错误码不是噪音，它是排查入口。把 401、403、429、503 分清楚，能少走很多弯路。
发表回复