文档核实日期：2026 年 10 月 16 日。官方页面为持续更新的技术文档，未标注固定发布日期。

先分清错误

Claude 官方将 401 authentication_error 归为认证问题，包括密钥格式异常、已撤销或过期。402 指向计费问题，403 指向资源权限问题。先保存完整错误类型，避免把所有失败都当成余额不足。

建议排查顺序

  1. 确认请求发给谁。 记录 API 地址与所用 SDK；如果经过代理服务，先确认返回错误的平台，避免拿另一家平台的密钥直接调用。
  2. 确认程序读到了新配置。 在实际运行的服务器或容器中检查环境变量是否存在，只检查是否设置，别把密钥打印到日志。更新配置后，按部署方式重新加载进程。
  3. 检查密钥状态。 在对应平台确认密钥仍有效；如果已撤销或过期，重新创建并更新使用它的服务。
  4. 用最小请求复测。 暂时移除文件、工具和长对话，保留一条简单输入。若仍失败，记录发生时间、状态码和请求 ID，作为进一步排查依据。

以上步骤是本站根据官方错误定义整理的操作顺序。向他人求助时提供经过脱敏的配置和错误信息即可，不需要发送完整 API 密钥。

来源：Claude 官方文档：API errors。