Claude Code 无法登录 / 认证失败（Invalid API key / Please run /login / OAuth）的原因与解决方法
现在有故障吗？
Claude Code 官方状态正常。若此报错持续出现，多半是实现或你的运行环境问题。
更新于: 2026年6月6日 04:46 UTC
查看 Claude Code 的运行状态 →报错含义
Claude Code 无法登录或认证。常见原因包括 OAuth 登录回调超时、macOS 钥匙串被锁定无法存储令牌、API 密钥与 base URL 不匹配，或 DNS/网络问题。「Invalid API key · Please run /login」表示密钥无效或令牌已过期。
常见原因
- •OAuth 登录回调超时
- •macOS 钥匙串被锁定，无法存储认证令牌
- •API 密钥（sk-ant-…）与 base URL（官方还是 proxy）不匹配
- •在无浏览器环境（SSH/CI/Docker）中尝试了 OAuth
- •DNS/proxy/防火墙阻断了认证服务器
- •版本过旧或缓存损坏
解决方法
- 1.运行 /logout 彻底清除旧令牌，然后重新 /login
- 2.更新 Claude Code，删除 ~/.claude/cache，然后重试
- 3.在无浏览器环境（SSH/CI/Docker）中，请设置 ANTHROPIC_API_KEY 环境变量，而不是使用 OAuth
- 4.确保你的 API 密钥和 base URL 来自同一平台（官方密钥 → 官方 base URL）
- 5.运行 /doctor 一次性检查设置、认证和更新问题
- 6.在 macOS 上解锁钥匙串；检查网络 / proxy 设置
何时该等待 / 等待也无济于事的情况
这是认证 / 配置问题，等待无法自行解决。请重新执行 /logout 再 /login、更新并清除缓存，或在无浏览器环境中设置 ANTHROPIC_API_KEY。先运行 /doctor 是最快定位原因的方式。
Claude Code 宕机时的替代方案
相关报错
常见问题
Login / authentication failed 是什么？
Claude Code 无法登录或认证。常见原因包括 OAuth 登录回调超时、macOS 钥匙串被锁定无法存储令牌、API 密钥与 base URL 不匹配，或 DNS/网络问题。「Invalid API key · Please run /login」表示密钥无效或令牌已过期。
Login / authentication failed 如何解决？
运行 /logout 彻底清除旧令牌，然后重新 /login / 更新 Claude Code，删除 ~/.claude/cache，然后重试 / 在无浏览器环境（SSH/CI/Docker）中，请设置 ANTHROPIC_API_KEY 环境变量，而不是使用 OAuth / 确保你的 API 密钥和 base URL 来自同一平台（官方密钥 → 官方 base URL） / 运行 /doctor 一次性检查设置、认证和更新问题 / 在 macOS 上解锁钥匙串；检查网络 / proxy 设置