Claude Code 提示 Login expired 或 Not logged in 时,先确认出错会话实际使用哪份凭据。浏览器账号、订阅和终端里的认证身份可能不同。应按正确来源重新登录;等待用量重置不会续签过期凭据。
本文根据 2026 年 10 月 14 日核对的官方认证说明、错误参考与命令说明整理。它提供排查流程,不代表对你的账号做过实测,也不保证恢复。
修改账号前,先区分错误类型
单凭登录失败,不能判定封号、地区政策执行或预算耗尽。容量问题应参考用量限制排查,而不是反复登录。
记录完整提示、客户端版本、时间,以及问题发生在终端、编辑器、云会话还是 Remote Control。公开报告不要包含 Key、Token、登录码或私人项目资料。
在出错的进程里确认实际身份
在平时真正用来启动 Claude Code 的终端中运行:
已经进入交互式 Claude Code 会话时,可以使用:
这些检查有助于识别认证与配置,不能证明下一次模型请求必然成功。支持的版本还会在 CLI 的 JSON 状态结果中显示配置目录;比较两个启动入口时,可以私下检查。
个人终端能用、编辑器不能用,可能是继承的环境不同。使用不同配置目录的两次启动,也可能保存了不同账号。先找到差异来源,再决定修改哪一处。
检查认证相关设置是否存在,但不要打印其值。来源可能包括 API Key、认证 Token、选中的 Anthropic 配置档、凭据辅助程序或组织管理的网关。API 计费排查指南解释了非预期凭据为什么还可能改变付款账户。
不要把完整环境变量或凭据文件粘贴进求助消息。公司管理的电脑,应先问清要求使用哪种身份,再决定是否调整个人账号配置。
沿凭据本身的登录路径续签
普通交互式登录,按提示中的官方登录动作处理。Claude Code 会话内使用 /login,终端命令是:
选择预期账号与计费方式。官方 --console 参数会选择 Anthropic Console 的 API 用量计费,不是恢复 Claude 订阅的通用快捷方式。
Anthropic profile login expired 需要进一步区分。官方错误说明区分了手动指定与自动发现的配置档。应通过原来提供凭据的工具或管理员续签。通过官方支持的免 Key Console 登录创建的配置档,可以沿该方式更新;由其他工具创建的,应回到那个工具登录。
不要默认 /login 一定会替换同一份配置档。官方文档描述了某些情况下会新建 API Key 或切换当前访问方式。操作后再用 /status 确认。
API Key 或公司网关,应按供应商或管理员的流程恢复。再买订阅不会续签网关凭据;新建个人 Key,也不会恢复对受管理组织的访问权限。
登录成功,但原会话仍失败时查什么
一次检查一层:
- 重新打开同一个客户端,使用预期账号与配置目录。
- 检查是否继承了另一份 Key、Token、配置档或辅助程序,从而选中不同凭据。
- 与自己已使用的另一客户端做条件一致的对照。
- 查看官方服务状态,保留实际错误。服务事件不能证明所有账号都遇到了同一种故障。
- 保留组织策略提示,交管理员处理,不移除管理控制。
10 月 14 日发布的 Claude Code 2.1.299改进了云会话因 claude.ai 登录被拒绝或过期而无法启动时的提示。提示更清楚,不代表已自动续签。需要沿合适渠道升级时,可参考更新指南。
不要把删除配置或凭据目录当成通用修复。这样可能丢失历史与无关设置,却仍没查明最初的问题。
用一个小请求确认恢复
重跑大任务前,先保存项目文件,记录已经改过什么。对话报错不代表工具一定没有执行过。
确认凭据来源和可能产生的用量费用后,先发一个不涉及私人文件或修改的小请求,例如“回复 OK”,再尝试只读解释一个获准访问的文件。
确认回答在预期配置下完整结束。登录页面或状态检查成功,单独看都不够。如果换了模型或账号后才成功,应记录这个区别,不能据此判定原路径已经恢复。
仍然失败时,向支持人员提供脱敏错误、时间、版本、凭据来源名称和最小复现步骤。敏感账号资料只通过供应商正式支持渠道提供。
把项目延续与访问故障分开处理
恢复官方访问,与选择项目在哪运行,是两项任务。Agent.Space 不会撤销 Anthropic 的账号暂停,也不会给你新增原生 Claude 订阅权益。
如果需要一个共享位置保存文件,并让兼容的 Agent 推进项目,可以先了解 Agent.Space 上的 Claude Code,确认可用模型与费用,再创建工作空间执行一个小任务。这是工作方式的选择,不能用来证明原登录故障已经修好。
