Claude Code 登录失败怎么办:6 类原因逐条排查到根因封面图
AI 编程约 7 分钟

Claude Code 登录失败怎么办:6 类原因逐条排查到根因

AI 指南··◉ 0 浏览

Claude Code 登录失败的答案通常只有一句话:敲 /login 重新走一遍浏览器授权。但如果这一步做完重启还是同样的提示,问题就不在登录动作上,而在凭证链路。这篇不猜,按可以逐条验证的 6 类原因往下排。

先分清是「过期」还是「缺失」

Not logged in · Please run /login 和 Not logged in or token expired 是两回事。前者说明当前会话里没有找到任何一份可用凭证,后者说明找到了但已过期。排查方向完全不同:前者要查「凭证去哪了」,后者只需要刷新。搞混这两者,就会在 /login 和重启之间反复横跳半小时。

{{Claude Code 终端 Not logged in 提示截图}}

关键前提:凭证来源是有优先级的

Claude Code 会依次去找这些凭证来源:环境变量里的 ANTHROPIC_API_KEY、settings.json 里的 apiKeyHelper 脚本、云厂商凭证(Bedrock / Vertex AI)、/login 存下来的 OAuth token(在系统 Keychain 或 ~/.claude/ 下)、配置文件里的 authToken。高优先级的来源一旦存在,就会盖掉低优先级的。

这就是那个反复出现的情况:你明明 /login 成功了,但 shell 里还留着一个早就注销的 ANTHROPIC_API_KEY,Claude Code 拿这个无效 key 去请求,认证失败,表现和完全没登录一模一样。所以第一步不是修,是确认到底哪一份凭证被用上了。

env | grep -i anthropic

预期输出应该是空的,或者只有你明确想用的那一项。如果跳出 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 三件套里任何一个你不认识的,那就是嫌疑对象。

6 类原因,逐条排

原因一:环境变量残留盖掉了订阅登录

症状:/login 成功,重启仍然提示未登录,或者报组织被禁用、无效 key。

判断:env | grep -i anthropic 有输出,而你不记得配过。

处理:在当前 shell 临时清掉,重启 Claude Code 看是否恢复。

unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

如果这样就好了,去 ~/.zshrc、~/.bashrc、~/.zprofile 里删掉对应的 export 行,否则下次开终端又会回来。这一类占比最高,比 key 过期更常见。

原因二:settings.json 里写死了 env 块

症状:echo $ANTHROPIC_BASE_URL 显示的是对的地址,但 Claude Code 启动后仍然失败。原因是 settings.json 里的 env 块盖住了 shell 变量,两处配置打架,改了一处其实没生效。

处理:检查两个位置,~/.claude/settings.json 和当前项目下的 .claude/settings.json,重点看有没有 env 字段里塞了 base URL 或 auth token。

{{Claude Code settings.json 中 env 块与凭据优先级示意}}

原因三:OAuth token 过期

症状:提示里明确带 token expired,或者用了很久没登录过。

处理:/login 重走授权。如果 Keychain 里的旧记录卡住导致新 token 写不进去,先 /logout 再 /login;macOS 上 /logout 报错时,去钥匙串访问里搜 Claude Code 相关条目手动删除后再登录。

原因四:凭证没落盘到你以为的地方

症状:找不到 ~/.claude/ 下的凭证文件,以为没登录成功。其实凭证可能存在操作系统钥匙串里而不是明文文件。判断方式是用 /status 看是否识别到账号,这比翻目录可靠得多。找不到文件别去下所谓的凭证生成器,那等于把 key 交给第三方。

原因五:网络或代理拦掉了 api.anthropic.com

症状:登录时浏览器授权走完了,回到终端卡住或超时;或者报连接失败、证书错误。

判断:用 curl 探一下连通性。

curl -I https://api.anthropic.com

能拿到 HTTP 响应头说明连通性没问题。超时、证书校验失败或返回一个明显不是 Anthropic 的页面,就是代理或网络层的问题,常见于公司内网出口、代理软件的 TLS 拦截、hosts 被改过。

原因六:系统时间错乱或服务端故障

症状:报 401 但凭证是新的;同时段社区里很多人在报同样的错。

处理顺序是先查状态页再动本地配置。打开 status.claude.com,看 Claude Code、Claude API 两行是不是绿的。这是Anthropic 官方状态页的口径,每次故障都会列出起止时间和受影响模型,10 月下旬就有连续几次请求错误率升高的记录。服务端故障期,本地怎么改都没用。

系统时间偏差过大也会让 OAuth 校验失败,date 看时间是否准,开了自动校时的机器基本不会遇到。

用 /doctor 做一次完整体检

逐条排太慢,直接跑 /doctor。它检查安装完整性、认证状态和配置冲突,把问题归到具体哪一层。推荐顺序是这样,别反过来:

  1. /doctor 体检,拿到问题分类
  2. /status 确认当前生效的凭证来源
  3. env | grep -i anthropic 查环境变量污染
  4. 查 settings.json 的 env 块
  5. 最后才去 status.claude.com 排除服务端

{{Claude Code /doctor 体检输出截图}}

报错速查表

报错形态 最可能的原因 第一动作
Not logged in · Please run /login 凭证缺失或环境变量残留 env 查残留,再 /login
Not logged in or token expired OAuth token 过期 /logout 后 /login
401 key 无效、base URL 指向错、服务端故障 /status 看凭证,再查状态页
组织已被禁用 / organization disabled 残留的旧 key 属于已注销组织 清 ANTHROPIC_API_KEY
浏览器授权后终端卡住 网络、代理或证书拦截 curl -I https://api.anthropic.com

预防:三条不让它再犯的习惯

不要在 shell 配置文件里同时留订阅登录和 API Key 两套凭证,这是绝大多数怪异报错的源头。换机器或迁移配置时先查一遍旧的环境变量,迁移工具很喜欢把 .zshrc 整段搬过来。CI 和后台进程用 API Key,交互式开发用订阅登录。

排查时还可以看用量和额度是否正常扣减,对照Claude Code 额度与限额说明。如果报的是速率限制而不是认证错误,那是另一个问题,看Claude Code 429 报错解决。

刚装完还没登录过的,先按 Claude Code Mac 安装教程走完环境。订阅方案值不值,Claude Code 订阅说明里算过账。

常见问题

Claude Code 提示 Not logged in 但密码和账号都没问题怎么办?

这通常不是账号问题。先敲 `/status` 看当前生效的是哪一套凭证,再在 shell 里执行 `env | grep -i anthropic` 查有没有残留的环境变量覆盖了订阅登录。

登录完成重启后又是 Not logged in,是什么原因?

大概率是凭证被更高优先级的来源覆盖了,最常见的是 `ANTHROPIC_API_KEY` 或 settings.json 里的 env 块。清掉残留后重启 Claude Code 验证。

Claude Code 401 和 Not logged in 有什么区别?

Not logged in 是客户端层面找不到可用凭证,请求可能根本没发出去。401 是请求到了服务端但服务端不认这份凭证,说明凭证存在但无效,要查 key 是否作废、base URL 是否指向别处。

怎么确认是不是 Anthropic 服务端故障?

打开 status.claude.com,看 Claude Code 和 Claude API 两行状态。如果该时段有故障记录,本地不用改配置,等恢复即可。

~/.claude 下找不到凭证文件是不是没登录成功?

不一定。凭证可能存放在操作系统钥匙串里而非明文文件。以 `/status` 显示的账号状态为准,不要因为找不到文件就去下载第三方凭证生成工具。

评论 (0)

?
0/1

还没有评论,来发第一条吧

网站上的服务均为第三方提供,
请用户注意自行甄别。

北京酷讯互动科技有限公司

备案京ICP备2024094994号-29

© 2026 AI345 · All Rights Reserved

用户服务协议·隐私政策