Agent.Space 博客

Claude Code 登录过期?先查账户与凭据来源

排查 Claude Code 登录过期和未登录提示,识别实际账户、配置目录与凭据来源,按官方流程重新认证并验证小请求。

Claude Code 提示 Login expired 或 Not logged in 时,先确认出错会话实际使用哪份凭据。浏览器账号、订阅和终端里的认证身份可能不同。应按正确来源重新登录;等待用量重置不会续签过期凭据。

本文根据 2026 年 10 月 14 日核对的官方认证说明、错误参考与命令说明整理。它提供排查流程,不代表对你的账号做过实测,也不保证恢复。

修改账号前,先区分错误类型

提示或现象首先确认什么
Not logged in/Please run login当前会话是否有可用凭据?
Login expired哪个已保存登录或配置档需要续签?
Invalid API key目标凭据对这个接口是否有效?
账号暂停或组织受限官方通知与审核流程要求什么?
带重置时间的用量限制哪个用量表已经耗尽?

单凭登录失败,不能判定封号、地区政策执行或预算耗尽。容量问题应参考用量限制排查,而不是反复登录。

记录完整提示、客户端版本、时间,以及问题发生在终端、编辑器、云会话还是 Remote Control。公开报告不要包含 Key、Token、登录码或私人项目资料。

在出错的进程里确认实际身份

在平时真正用来启动 Claude Code 的终端中运行:

sh
claude --versionclaude auth status --text

已经进入交互式 Claude Code 会话时,可以使用:

text
/status

这些检查有助于识别认证与配置,不能证明下一次模型请求必然成功。支持的版本还会在 CLI 的 JSON 状态结果中显示配置目录;比较两个启动入口时,可以私下检查。

个人终端能用、编辑器不能用,可能是继承的环境不同。使用不同配置目录的两次启动,也可能保存了不同账号。先找到差异来源,再决定修改哪一处。

检查认证相关设置是否存在,但不要打印其值。来源可能包括 API Key、认证 Token、选中的 Anthropic 配置档、凭据辅助程序或组织管理的网关。API 计费排查指南解释了非预期凭据为什么还可能改变付款账户。

不要把完整环境变量或凭据文件粘贴进求助消息。公司管理的电脑,应先问清要求使用哪种身份,再决定是否调整个人账号配置。

沿凭据本身的登录路径续签

普通交互式登录,按提示中的官方登录动作处理。Claude Code 会话内使用 /login,终端命令是:

sh
claude auth login

选择预期账号与计费方式。官方 --console 参数会选择 Anthropic Console 的 API 用量计费,不是恢复 Claude 订阅的通用快捷方式。

Anthropic profile login expired 需要进一步区分。官方错误说明区分了手动指定与自动发现的配置档。应通过原来提供凭据的工具或管理员续签。通过官方支持的免 Key Console 登录创建的配置档,可以沿该方式更新;由其他工具创建的,应回到那个工具登录。

不要默认 /login 一定会替换同一份配置档。官方文档描述了某些情况下会新建 API Key 或切换当前访问方式。操作后再用 /status 确认。

API Key 或公司网关,应按供应商或管理员的流程恢复。再买订阅不会续签网关凭据;新建个人 Key,也不会恢复对受管理组织的访问权限。

登录成功,但原会话仍失败时查什么

一次检查一层:

  1. 重新打开同一个客户端,使用预期账号与配置目录。
  2. 检查是否继承了另一份 Key、Token、配置档或辅助程序,从而选中不同凭据。
  3. 与自己已使用的另一客户端做条件一致的对照。
  4. 查看官方服务状态,保留实际错误。服务事件不能证明所有账号都遇到了同一种故障。
  5. 保留组织策略提示,交管理员处理,不移除管理控制。

10 月 14 日发布的 Claude Code 2.1.299改进了云会话因 claude.ai 登录被拒绝或过期而无法启动时的提示。提示更清楚,不代表已自动续签。需要沿合适渠道升级时,可参考更新指南。

不要把删除配置或凭据目录当成通用修复。这样可能丢失历史与无关设置,却仍没查明最初的问题。

用一个小请求确认恢复

重跑大任务前,先保存项目文件,记录已经改过什么。对话报错不代表工具一定没有执行过。

确认凭据来源和可能产生的用量费用后,先发一个不涉及私人文件或修改的小请求,例如“回复 OK”,再尝试只读解释一个获准访问的文件。

确认回答在预期配置下完整结束。登录页面或状态检查成功,单独看都不够。如果换了模型或账号后才成功,应记录这个区别,不能据此判定原路径已经恢复。

仍然失败时,向支持人员提供脱敏错误、时间、版本、凭据来源名称和最小复现步骤。敏感账号资料只通过供应商正式支持渠道提供。

把项目延续与访问故障分开处理

恢复官方访问,与选择项目在哪运行,是两项任务。Agent.Space 不会撤销 Anthropic 的账号暂停,也不会给你新增原生 Claude 订阅权益。

如果需要一个共享位置保存文件,并让兼容的 Agent 推进项目,可以先了解 Agent.Space 上的 Claude Code,确认可用模型与费用,再创建工作空间执行一个小任务。这是工作方式的选择,不能用来证明原登录故障已经修好。