Claude Code 401 错误怎么解决？
快速回答
401 表示服务端没有接受当前身份信息。对 Claude Code 或兼容 API 工具来说，优先检查 API Key 是否正确生效、环境变量是否被旧值覆盖、Base URL 是否指向正确服务，以及该 Key 是否有目标模型的权限。
先看报错位置
| 情况 | 常见原因 | 优先操作 |
|---|---|---|
| 刚配置就报 401 | Key 复制错误或变量没有生效 | 重新复制 Key，重开终端后测试 |
| 之前可用，突然报 401 | Key 被撤销、额度账户变化或登录状态失效 | 到服务商后台确认 Key 状态 |
| 只有某一个服务商报错 | Base URL 或认证格式不匹配 | 核对该服务商的兼容 API 文档 |
| 换模型后报错 | Key 没有新模型权限 | 查看模型列表与账号权限 |
排查步骤
- 在服务商后台确认正在使用的 Key 没有被删除、禁用或更换。
- 重新复制 Key，确认开头、结尾没有空格、换行或引号。
- 检查终端实际读取的环境变量。修改环境变量后需要重新打开终端或重启对应工具。
- 核对 Base URL 是否为 API 地址，不要填成产品官网页面；是否需要
/v1以服务商说明为准。 - 用一个已确认可用的模型名做短请求测试，先排除模型名问题。
- 若仍是 401，保留报错中的状态码与请求时间，向服务商确认认证方式和 Key 权限。
不要这样处理
不要把 API Key 发到聊天、截图或工单正文
401 排查只需要确认 Key 是否存在、是否生效和是否有权限。展示 Key 的完整内容会造成泄露风险；需要核对时只保留前后少量字符。
不要同时改 Key、Base URL 和模型名
一次只改一个变量，才能知道是哪一项恢复了调用。最短路径是先用已知可用的 Key、Base URL 和模型组合测试。
不要把 401 当作 429
401 是认证或权限问题；429 多为额度、频率或并发限制。两者处理方式不同。
总结
Claude Code 的 401 通常不是代码逻辑问题，而是认证信息没有正确到达服务端。按 Key、环境变量、Base URL、模型权限的顺序检查，能避免无效地反复重装工具。