Claude Code OAuth 过期：无人值守怎么恢复
截至 2026-10-26，无人值守的 claude -p、cron 或 CI 里，保存的登录过期且无法刷新后，每个模型请求都会以 Login expired 失败。官方文档为 CI 与脚本给出的办法是 claude setup-token 生成的一年期 OAuth 令牌；也可以改用 API Key 或网关令牌。
更新于 2026-10-26
一把 Key 调用 Claude、GPT 与主流国产模型，按 token 计费，几分钟上手。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
核对要点
长期令牌有效期
claude setup-token 生成一年期 OAuth 令牌，设置到 CLAUDE_CODE_OAUTH_TOKEN；官方写明需要 Pro、Max、Team 或 Enterprise 订阅。
过期报错
已存登录过期且无法刷新后，每个模型请求都会以 Login expired 失败，直到重新登录。
续期提醒
登录到期前 3 天，Claude Code 启动时会提示登录即将到期，并提示运行 /login 续期。
无头模式注意
官方写明 --bare 不读取 OAuth 凭据与系统钥匙串，也不读取 CLAUDE_CODE_OAUTH_TOKEN；这种模式要用 ANTHROPIC_API_KEY 或 apiKeyHelper。
无人值守能用哪种凭据
截至 2026-10-26，官方 authentication 文档列出的凭据来源包括：订阅用户的长期 OAuth 令牌（claude setup-token 生成，设置到 CLAUDE_CODE_OAUTH_TOKEN）、Claude Console 的 API Key（设置 ANTHROPIC_API_KEY，非交互模式 -p 下存在就使用）、网关令牌（设置 ANTHROPIC_AUTH_TOKEN，按 Bearer 发送），以及接动态凭据的 apiKeyHelper。登录过期时，先运行 /login 重新登录，或改用长期凭据。
官方页面怎么说
官方 authentication 文档写明：登录到期前 3 天会出现续期提醒；过期且无法刷新后，每个模型请求会以 Login expired · Please run /login 失败；/status 的 Login 行会显示 Expired — log in again（需要 v2.1.210 及以上）。长期令牌用 claude setup-token 生成，需要 Pro、Max、Team 或 Enterprise 订阅。
时间线
社区有用户报告（Zenn，2026-10-23 发布）：Windows 任务计划程序在凌晨 3 点运行 claude -p，登录过期后进程在启动约 20 秒时退出，报错为 OAuth 会话已过期且无法刷新，退出码 1。
该社区文章（发布于当天）写到，无人值守时没有人能看到重新登录提示；作者 2026-10-18 早上发现，重新登录后手动重跑了脚本；文章写到，过期后能做的只有手动重新登录。
核对 code.claude.com 的 authentication、headless 与 CLI reference 页，以及 QCode 文档的 environment 页；凭据与报错的写法以这些页面 2026-10-26 的原文为准。
已确认 vs 未证实
已确认（官方页逐字可核）
官方写明：claude setup-token 生成一年期 OAuth 令牌，需 Pro、Max、Team 或 Enterprise 订阅；CLAUDE_CODE_OAUTH_TOKEN 适合 CI 与脚本；ANTHROPIC_API_KEY 在 -p 下存在即使用；ANTHROPIC_AUTH_TOKEN 用于网关；--bare 不读 OAuth 凭据、系统钥匙串与 CLAUDE_CODE_OAUTH_TOKEN；/status 的 Expired 行需要 v2.1.210 及以上。
未证实与官方未公布
社区有用户报告（Zenn，2026-10-23 发布）：2026-10-18 的一次无人值守运行在登录过期后启动约 20 秒退出，报错为 OAuth 会话已过期且无法刷新。这是用户报告，不是官方文档的报错列表。官方文档写明，agent view 或 Remote Control 的后台会话在凭据过期后会停止推进，直到重新登录；官方文档为 CI 与脚本提供的是 claude setup-token 生成的长期令牌。
订阅登录与 API 凭据怎么选
订阅登录与长期令牌
claude setup-token 生成一年期 OAuth 令牌，绑定 Claude 订阅；适合 CI 与脚本。--bare 模式不读这个变量。
API Key 与网关令牌
ANTHROPIC_API_KEY 来自 Claude Console，-p 下存在即使用；ANTHROPIC_AUTH_TOKEN 用于网关或代理，按 Bearer 发送。
排查步骤
① 看报错与状态：请求以 Login expired 失败，或 /status 的 Login 行显示 Expired，说明保存的登录已过期。② 能交互时在会话里运行 /login（或在 shell 里运行 claude auth login）重新登录；无人值守的机器改用 claude setup-token：它走与 /login 相同的浏览器授权流程，令牌打印在终端、不会保存，复制后导出为 CLAUDE_CODE_OAUTH_TOKEN。③ 如果脚本用了 --bare，改设 ANTHROPIC_API_KEY（Claude Console 创建）或 apiKeyHelper；--bare 不读 OAuth 凭据。④ 若通过网关接入，设置 ANTHROPIC_AUTH_TOKEN；它的优先级高于 ANTHROPIC_API_KEY。⑤ 把凭据写进 cron / CI 的环境变量或 secret，重跑一次确认退出码为 0。
用 QCode 的 Key 跑无人值守
QCode 文档的接入方式是设置 ANTHROPIC_BASE_URL=https://api.qcode.cc/api 与 ANTHROPIC_AUTH_TOKEN=你的 QCode Key（cr_ 开头）；文档写明三个接入域名能力相同，同一把 Key 通用。文档说明 Key 放在 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY，Claude Code 按 Bearer 发送；模型调用按 token 计费，各模型单价见 /models。个人套餐每单 30 天有效。不想包月？按量包 ¥26 起买一笔额度，7 天内用完为止；已有个人套餐的用户额度不够时买加油包。
常见问题
Claude Code OAuth token 过期会报什么错？
官方文档写的报错是 Login expired · Please run /login；登录到期前 3 天还会提示续期。
无人值守的 claude -p 能用什么凭据？
claude setup-token 生成的一年期 CLAUDE_CODE_OAUTH_TOKEN（需订阅）、Claude Console 的 ANTHROPIC_API_KEY、网关用的 ANTHROPIC_AUTH_TOKEN；另有 apiKeyHelper。
claude setup-token 的令牌有效期多久？
官方写 one-year OAuth token，即一年；需要 Pro、Max、Team 或 Enterprise 订阅，只能用于模型请求。
为什么 --bare 模式还是认证失败？
官方写明 --bare 不读取 OAuth 凭据、系统钥匙串和 CLAUDE_CODE_OAUTH_TOKEN；这种模式要用 ANTHROPIC_API_KEY 或 apiKeyHelper。
登录过期后怎么最快恢复？
交互环境运行 /login 重新登录；无人值守的机器改用长期令牌或 API Key，并用 /status 的 Login 行确认当前凭据。
QCode 的 Key 会走订阅登录吗？
QCode 文档的接入方式是设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 环境变量，Key 是 cr_ 开头的 QCode Key，不是订阅 /login。官方凭据优先级里，ANTHROPIC_AUTH_TOKEN 排在订阅 /login 之前。
信息来源
code.claude.com 的 authentication、headless 与 CLI reference 文档（2026-10-26 抓取）；Zenn 社区文章（2026-10-23 发布，用户报告）；QCode 文档 environment 与 cloud-servers 页、qcode.cc/pricing 与 /pay-as-you-go（2026-10-26 抓取）；qcode.cc/models。
相关阅读
Claude Code 按量包：不包月，7 天有效
一次买一笔额度，7 天内用完，不订阅；续买累加到同一把 Key。
Claude Code 不订阅也能用 2026年10月
不买 Claude 订阅时，Claude Code 的几种登录与接入方式。
Claude Code 云服务器（2026年10月）：安装与接入
在 QCode 云服务器上安装 Claude Code，并用 QCode Key 调用模型。
加密货币充值指南
9 种币、56 条网络，0 平台手续费购买 AI 编程 API 额度。
本页 Claude Code 事实核对时间为 2026-10-26，以 code.claude.com 的 authentication、headless 与 CLI reference 文档为准；QCode 接入与计费事实核对于 2026-10-26，以 docs.qcode.cc 与 qcode.cc/pricing 为准；模型可用性与单价以 /models 为准，官方调整不另行通知。