IP 判官 ipjudge.org
Muse Claude
美国家宽 IP 一键直连 · 不用搭 VPS 了解 广告 在新标签页打开

文章 ·

Claude Code 提示 Not logged in / token expired / 401：按这个顺序排查

看到 Not logged in 或 token expired，先重新登录并检查凭据保存，不要先把问题归因于出口 IP。只有报错变成 403、App unavailable in region 或明确的连接失败时，才进入网络、地区和出口排查。

一图看懂：Claude Code 登录错误先分四类Not logged in 或 token expired 先重新登录；频繁过期检查系统时间和凭据存储；登录成功后仍报 401 检查配置目录空间；403 或地区不可用才转向网络与地区检查。 登录错误先分四类 Not logged in / token expired先用 /login 重新认证，不先归因于出口 IP 短时间反复要求登录检查系统时间；macOS 再跑 claude doctor Login successful 后仍 API Error: 401网络主目录要检查空间与配额，再重新登录 403 / App unavailable in region再检查官方支持地区、网络过滤与实际出口 四类症状的排查入口不同；不要把所有 401 都当成 IP 问题。
先按错误类型分流：凭据过期与 403 / 地区问题不是同一条排查链。

Claude Code 提示 Not logged in 或 token expired，要先做什么？

先记录版本和认证状态，再重新登录一次。2026 年 11 月 6 日核对的官方命令是：

claude --version
claude auth status
claude auth login

已经进入交互会话时，也可以运行 /login。Anthropic 的登录排障文档明确写明：会话后再次要求登录，可能是 OAuth token 已过期；重新认证是第一步。

怎么提前看到登录什么时候到期？

升级到 Claude Code v2.1.318 或更新版本后，用 claude auth status 查看 loginExpiresAt。Anthropic 在v2.1.318 官方发布说明中新增了两项：认证状态输出登录到期时间，claude -p 的 JSON 输出增加 credential_expires_at；文本模式从到期前 10 天开始在 stderr 给出一行提醒。

发布说明没有承诺所有认证方式都会返回同一字段，所以脚本应允许字段为空，不要把“没有字段”写成“仍有效”。

Claude Code 登录过期排查顺序先看版本和认证状态，再重新登录；若频繁复发，检查系统时间、macOS Keychain 或网络主目录空间；只有出现 403、地区不可用或连接错误时才检查网络和出口。 建议按这个顺序处理 1确认版本与登录状态claude --version · claude auth status 2重新认证一次/login 或 claude auth login 3若复发，查本机凭据保存系统时间 · Keychain · 配置目录空间 4按新报错转入对应分支401 查凭据；403 / 连接错误查网络 排查前不要删除整个 ~/.claude：会连设置和历史一起删掉
先做最小诊断，再处理存储或网络；不要一开始就清空整个配置目录。

为什么刚登录不久又要求登录？

频繁复发时，先查系统时间和凭据能否可靠写入。官方文档说明 token 校验依赖正确时间；同一台机器的并行会话会共享保存的登录，并协调续期。

症状先查官方建议
偶发 token expired凭据自然到期运行 /login
短时间反复要求登录系统时间确认日期、时间和时区正确
macOS 反复掉登录login Keychain 可写性运行 claude doctor
Login successful 后仍 401网络主目录空间或配额腾出空间后重新登录

在 macOS 上，官方说明凭据通常保存在 login Keychain。若 Keychain 拒绝写入，Claude Code 可能改存到 ~/.claude/.credentials.json；claude doctor 会报告以 macOS Keychain is not writable 开头的警告。

API Error: 401 一定是 IP 问题吗？

不是；401 先表示当前请求没有被服务端接受为有效认证。若配置目录在网络文件系统上，官方文档特别指出：磁盘或配额已满时，claude auth login 仍可能显示 Login successful.，但新凭据没有保存成功，后续请求继续报 API Error: 401。

因此先确认认证状态和凭据存储，再看网络。IP 类型、ASN 或共享出口不能单独证明某个 401 的原因，Anthropic 也没有公布这种对应关系。

什么时候才要检查网络、地区和出口？

当错误明确指向 403、地区不可用、下载服务器不可达或 TLS / 代理连接失败时，再检查网络。官方排障页把裸 403 的可能原因列为地区不可用、企业代理或防火墙过滤，也建议先核对官方支持地区。

这时可以打开 Claude Code 出口检测，或在同一终端运行：

curl -sL ipjudge.org/cc | bash

它用于确认终端实际出口、代理变量和 Anthropic 相关域名的连通性，不会判断账号凭据是否有效。若官方服务状态页正在报告故障，应先等待状态恢复，不要反复清凭据。

需要删除 ~/.claude 再重装吗？

一般不需要；先用最小操作定位。官方文档提醒，删除整个 ~/.claude 会同时删除设置、允许的工具、MCP 配置和会话历史；而 /logout 也会移除保存的 MCP 登录与插件敏感值，需要重新授权。

只有在已备份、明确知道要清除哪些本地状态时才做删除操作。普通 token 过期通常只需 /login。

常见问题

claude auth status 没有 loginExpiresAt 怎么办？

先确认版本至少是 v2.1.318。字段仍为空时，只能说明当前输出没有可用到期时间，不能据此判断凭据有效或无效。

浏览器里的 Claude 能用，Claude Code 仍提示 Not logged in，说明什么？

说明两个客户端的登录状态要分开检查。先对 CLI 运行 claude auth status 和 /login。

重启电脑后所有会话一起要求登录正常吗？

可能发生，但频繁出现要检查版本、系统时间和凭据存储。官方说明 v2.1.211 之前的版本曾有睡眠唤醒后并行续期冲突，建议更新后再判断。

可以把 ~/.claude/.credentials.json 复制到别的机器吗？

不建议把凭据文件当普通配置复制或分享。应在目标机器用官方登录流程认证，并保护本机凭据存储。

401 之后换一个 IP 就能解决吗？

没有这个结论。先按官方流程验证凭据、时间和存储；只有新错误明确指向地区或连接时，才检查出口。

本文官方资料于 2026 年 11 月 6 日核对。相关：Claude Code 403 / 地区不支持 · Claude Code 终端代理设置 · WSL、Docker 与远程服务器出口 · 命令行工具检测

想知道你自己的 IP 属于哪一类？

检测我的终端走哪个出口