测一家
首页/故障案例/Claude Code 升级后突然 401
CASE / 接入

Claude Code 升级后突然 401

同一套环境变量,升级客户端之后开始 401,回滚版本又正常。

症状模式可复现步骤证据优先

这个症状不能证明什么

先排除误判

401 不代表 Key 失效。客户端升级常改动认证头的名字或读取的变量名。

按这个顺序验证

4 STEPS
  1. 看新版本读取的环境变量名是否变了(BASE_URL / AUTH_TOKEN 的拼写)。
  2. 用 curl 带同样的 Key 请求一次,确认 Key 本身有效。
  3. 检查是否同时存在官方登录态和第三方配置,两者可能互相覆盖。
  4. 看客户端日志里实际发出的请求头(不要打印完整 Key)。

什么证据才算数

EVIDENCE

curl 的最小请求结果、客户端版本号、生效的环境变量名列表(值打码)。

结论怎么写

CONCLUSION

curl 通而客户端 401,问题在客户端配置;两者都 401,问题在 Key 或站点。

接下来做什么

ACTION

把第三方配置写进项目级配置或 shell 函数,不要改全局 profile;升级前先备份可用配置。

案例是症状模式,不是对任何具体站点的结论。写报告时请引用你记录到的请求 ID、时间戳和响应原文,不要引用本页。