Claude Code 提示「You've hit your session limit」:额度 用完的 含义、重置与 解决
用 Claude 订阅登录的 Claude Code 会话用完套餐的某项用量限额时,会打印 You've hit your session limit · resets 3:45pm(或 weekly、Opus、Sonnet 的同类提示)。按 Claude Code 的报错参考文档(2026-10-24 核对),在提示里的重置时间之前,后续请求都会被拦下;会话限额和每周限额对所有模型共用,Opus 与 Sonnet 限额只管对应系列。这是 Claude 套餐的限额:可以等重置、开启 usage credits,或者把终端会话换一种计费方式。接到 Router One 的 Claude Code 会话,用 ANTHROPIC_AUTH_TOKEN 里的 Router One Key 把请求发往 https://api.router.one,由 Router One 计费,不占用 Claude 套餐;按 Claude Code 的认证文档(2026-10-24 核对),这个变量的优先级高于订阅登录。Router One 在中国大陆可直连,不需要 VPN,钱包可以用支付宝充值。
这条 提示是 什么 意思
按 Claude Code 的报错参考文档(2026-10-24 核对),订阅套餐带有滚动计算的用量额度,额度用完就会出现这条提示。同一次用量会同时计入会话额度和每周额度,所以一阵高强度使用(比如一次铺开很多任务的大型工作流)可能在会话窗口重置之前就先用完每周额度。Anthropic 帮助中心(2026-10-24 核对)写明,Claude 的 Pro 和 Max 都有 5 小时会话限额和每周限额,由 Claude 与 Claude Code 共用,两边的所有用量都计入同一份限额。Claude Code 的费用文档(2026-10-24 核对)对 Team 和 Enterprise 席位的说法相同:每个席位的额度按滚动的 5 小时窗口和每周窗口重置,并与 Claude 聊天共用。
各种 提示 分别要你做 什么
按 Claude Code 的报错参考文档(2026-10-24 核对),提示会写明用完的是哪一项限额、什么时候重置。表格最后两行是 spend limit 类提示,出现在本该由 usage credits 支付的请求碰上 usage credits 花费上限的时候:
| Claude Code 打印的内容 | 用完的是哪项限额 | 怎么办 |
|---|---|---|
You've hit your session limit · resets 3:45pm | 滚动会话额度,所有模型共用 | 等到重置;换模型不能恢复使用 |
You've hit your weekly limit · resets Mon 12:00am | 每周额度,所有模型共用 | 等到重置,或者开启 usage credits |
You've hit your Opus limit · resets 3:45pm | 只限 Opus 系列的额度 | 用 /model 换到 Opus 系列以外的模型,或者等重置 |
You've hit your Sonnet limit · resets 3:45pm | 只限 Sonnet 系列的额度 | 用 /model 换到 Sonnet 系列以外的模型,或者等重置 |
You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message | 套餐包含的用量覆盖不了这个请求,usage credits 也到了你设的月度花费上限 | Pro 和 Max 在 claude.ai 的 Settings > Usage 里调高上限,或者运行 /usage-credits |
You've hit your individual spend limit · ask your admin for a higher limit,以及 org's monthly spend limit、team's shared budget 的同类提示 | Team 或 Enterprise 组织为 usage credits 设的花费上限 | 请管理员调高;/usage-credits 会替你把申请发给管理员 |
- 如果用完的是套餐的某个窗口,spend limit 类提示还会写出这个窗口的重置时间,例如
· your session limit resets 3:45pm;到点就能恢复使用,不需要谁来调高上限。 - 按用量计费的组织里,提示里的 spend limit 会换成 usage limit,例如
You've hit your individual usage limit。
额度 用完 之前的 提醒
按 Claude Code 的报错参考文档(2026-10-24 核对),某个窗口快用完时,Claude Code 可能会提醒你,例如 You've used 85% of your session limit · resets 3:45pm;Anthropic 帮助中心(2026-10-24 核对)也写明,接近任何一项限额时都会看到提醒。想随时看到剩余额度:
- 在自定义状态栏里加上 rate_limits 字段。按 Claude Code 的状态栏文档(2026-10-24 核对),对 claude.ai 的 Pro 和 Max 订阅用户,这些字段包含滚动的 5 小时窗口和 7 天的每周窗口,各自给出已用百分比和重置时间,会话收到第一个响应之后才出现。
- 在 Claude 桌面应用里,点模型选择器旁边的用量环形图标。
什么时候 重置、在哪里查
提示里写着重置时间;按 Claude Code 的报错参考文档(2026-10-24 核对),/usage 会显示套餐的各项限额和各自的重置时间。/usage 里有两处容易看错:
- 按 Claude Code 的费用文档(2026-10-24 核对),出现
Showing last-known usage说明查询套餐限额的请求失败了,最常见的原因是用量接口被限流;rate limited until 3:14am这样的字样表示 Claude Code 在那个时间之前拿不到新的限额数据,并不表示你用 Claude 干活受到了限制。过了那个时间按 r 刷新即可。 - Session 区块里的美元数字,是 Claude Code 在本地按 token 数和牌价估算的(同一份文档)。它不是订阅实际花的钱;在接到 Router One 的会话里,它也不是 Router One 实际扣的钱。Router One 怎么计费,见本页后面。
让 Claude Code 在重置后 自动 接着跑
按 Claude Code 的交互模式文档(2026-10-24 核对),用 claude.ai 订阅登录的交互式会话默认开启自动继续,需要 Claude Code v2.1.234 或更高版本。Claude Code 会在打开的会话里等着,限额重置后自己接着做被打断的任务:
- 等待期间,会话底部显示
Usage limit reached · limit resets 3:45pm和Continuing automatically at 3:45pm · esc to cancel。保持会话开着;到点后 Claude Code 会让 Claude 从中断的地方接着做,不会重发你上一条消息。 - 想取消:这两行还在显示时,在空输入框里按 Esc 或按 Ctrl+C;也可以运行 /rate-limit-options,选 Don't continue automatically。
- 接着做的任务如果又撞上限额,Claude Code 最多连续再自动等两次,之后显示
Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again。 - 重置时间在 24 小时以后(每周限额可能是这种情况)时,Claude Code 不会自己开始等待;它弹出的用量限额选项菜单里,有一行以 Wait here, then continue automatically 开头,选它就会开始等待。
- Claude 桌面应用的 Code 标签页里,会话限额卡片上有 Auto-continue when limits reset 复选框,每周限额卡片上没有。
- Anthropic 帮助中心(2026-10-24 核对)还提到
Usage limit reached · wrapping up:一次回复进行到一半时碰上 5 小时会话限额,Claude Code 可能再工作一小会儿,把手头这一步做完,这部分用量计入每周限额。帮助中心写明这项功能正在逐步开放。
继续用的 办法:等、开 usage credits、换系列,或者 换计费 方式
按 claude.com/pricing(2026-10-24 核对),用到限额后,可以等重置、升级到更高的套餐,付费套餐还可以开启 usage credits,按标准 API 价继续用。具体来说:
- 等到提示里写的重置时间,或者让自动继续替你接着做。
- 用 /usage-credits 开启 usage credits。按 Claude Code 的费用文档(2026-10-24 核对),Pro 和 Max 用户运行它会在浏览器里打开 claude.ai 的 Settings > Usage;Team 和 Enterprise 成员有账单权限时打开组织的用量设置,没有时就向管理员发申请。这条命令只在用 claude.ai 订阅登录时可用,用 API Key 认证时不可用。
- 碰上的是 Opus 或 Sonnet 限额,就用 /model 换到这一系列以外的模型。按 Claude Code 的报错参考文档(2026-10-24 核对),每个模型的提示缓存各自独立,所以换模型后的下一个请求会把整段对话重新读一遍,没有缓存命中。
- 改用 Claude Console 账号。Anthropic 帮助中心(2026-10-24 核对)建议在集中写代码的冲刺阶段这样做,并写明设置了 ANTHROPIC_API_KEY 时,Claude Code 用这把 Key 而不是你的订阅,会话按 API 用量计费,不消耗套餐包含的用量。接 Router One 不需要 ANTHROPIC_API_KEY,保持未设即可。
- 让 Claude Code 走自带凭证的网关,比如 Router One。按 Claude Code 的认证文档(2026-10-24 核对),ANTHROPIC_AUTH_TOKEN 在凭证优先级里排第二,/login 的订阅登录排在最后;按它的网关文档(2026-10-24 核对),设置了网关凭证时,请求携带的是这个凭证而不是你的 claude.ai 登录,订阅的用量限额不适用于这些请求。只设 ANTHROPIC_BASE_URL 不会替换订阅:保存的登录仍是生效的凭证,订阅的限额和计费照旧。
- 云端会话仍走订阅:按同一份认证文档,云端会话始终使用订阅凭证,即使在云端环境里设置了 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 也一样。
用一键 命令把 Claude Code 接到 Router One
带上你的 Router One Key 运行一键命令。它会在缺少 Claude Code 时先安装,备份已有的 ~/.claude/settings.json,把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 写进这个文件的 env 块,再发一个测试请求验证连通。claude.ai 登录可以保留:按 Claude Code 的网关文档(2026-10-24 核对),设置这个变量期间,登录仍保存在本机、只是不用,删掉变量后 Claude Code 会重新使用它。运行 /status 确认:Auth token 一行写着 ANTHROPIC_AUTH_TOKEN,说明 Router One Key 是当前生效的凭证;如果是 Login method 一行写着 claude.ai 账号,说明变量没有传到这个会话。
curl -fsSL https://router.one/install/claude-code.sh | bash -s -- sk-your-api-key # Windows PowerShell: $env:ROUTER_ONE_API_KEY = "sk-your-api-key"; irm https://router.one/install/claude-code.ps1 | iex
用 Router One 套餐时:把模型 固定到 档位里的 型号
截至 2026-10-24 的套餐接口,claude-opus-5、claude-sonnet-5、claude-haiku-4-5 分别在三个 Router One 套餐的「高级模型」「中级模型」「普通模型」档,claude-opus-5-5、claude-sonnet-5-5 和 claude-haiku-5-5 不在任何套餐档位。按 Claude Code 的模型配置文档(2026-10-24 核对),v2.1.280 起默认模型是 Opus 5.5,v2.1.284 起 sonnet 别名解析为 Sonnet 5.5,v2.1.293 起 haiku 别名解析为 Haiku 5.5,所以不固定的话,即使订了套餐,这些请求也按 token 从钱包扣费。用套餐时,设置下面 Opus 和 Sonnet 的几行;如果是一键命令配置的,把它们写进 ~/.claude/settings.json 的 env 块,那里的值会覆盖 shell 里同名的 export。Haiku 这一行对所有人都是可选的:它让 haiku 别名的请求和后台任务改用 Claude Haiku 4.5。不订套餐时,所有模型都按公示单价从钱包扣费(单价见 /models),这几行只决定用哪个模型:
export ANTHROPIC_BASE_URL=https://api.router.one export ANTHROPIC_AUTH_TOKEN=sk-your-router-one-key unset ANTHROPIC_API_KEY export ANTHROPIC_MODEL=claude-opus-5 # 用套餐时:会话继续消耗套餐额度 export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5 # 用套餐时:/model opus 与 opus 子 agent 也走套餐 export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 # 用套餐时:sonnet 别名走套餐 export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 # 可选:haiku 别名与后台任务
经 Router One 时怎么 计费
不订 Router One 套餐时,每个请求按所指定模型的公示 token 单价从你的 Router One 钱包扣费(单价见 /models),网关发往模型的每个请求及其 token 数和费用都记在控制台 → 日志里。订了 Router One 的 Pro、Max 或 Ultra 套餐时,套餐档位列出的模型先扣该档位的额度,超出额度的调用按公示单价从钱包扣费:截至 2026-10-24 的套餐接口,上面固定的 claude-opus-5 在这三个套餐的「高级模型」档(各套餐额度见 /pricing)。Router One 对每把 Key 和每个账户的请求数与 token 数限额是平台默认值,可以发邮件到 support@router.one 申请调高;Router One 自己的错误码见错误码速查 https://router.one/zh/llm-api-error-codes 。
看起来 相似、但不是 这个 用量 限额的 提示
按 Claude Code 的报错参考文档(2026-10-24 核对),下面几种提示看着相近,意思不同:
| Claude Code 打印的内容 | 含义 |
|---|---|
API Error: Server is temporarily limiting requests (not your usage limit) | 服务端的短时限流,与套餐额度无关;v2.1.199 起,Claude Code 会先自动退避重试,重试不成功才显示 |
API Error: Request rejected (429) · … | 当前使用的 API Key 或云项目碰上了它配置的速率限制;设置了自定义 ANTHROPIC_BASE_URL 时,后半句写的是网关的地址。运行 /status 看当前生效的是哪个凭证 |
API Error: Usage credits required for 1M context · … | 1M token 上下文窗口的使用资格检查,不是额度用完;用 /model 换回标准上下文即可 |
Credit balance is too low | Claude Console 组织的预付 credits 用完了,或者环境变量里的 Console Key 发出了你本想记在订阅上的请求 |
spend limit reached,后面写着周期和重置时间 | Claude apps gateway 的运营方设的花费上限,不是套餐限额 |
Not logged in · Please run /login | 没有有效凭证传到这个会话(https://router.one/zh/claude-code-403 ) |
常见 问题
「You've hit your session limit」是 Router One 的报错吗?
不是。按 Claude Code 的报错参考文档(2026-10-24 核对),这是 Claude Code 在用 Claude 订阅登录的会话用完订阅用量限额时给出的提示。接到 Router One 的 Claude Code 会话,用 ANTHROPIC_AUTH_TOKEN 里的 Router One Key 把请求发往 https://api.router.one,由 Router One 计费。如果你以为这个会话走的是 Router One,运行 /status 看一下:按 Claude Code 的网关文档(2026-10-24 核对),Auth token 一行写着 ANTHROPIC_AUTH_TOKEN,说明网关凭证在生效;如果是 Login method 一行写着 claude.ai 账号,说明变量没有传到这个会话。
Claude Code 的额度 什么时候 重置?
就是提示里写的时间;按 Claude Code 的报错参考文档(2026-10-24 核对),/usage 会显示套餐的各项限额和各自的重置时间。Anthropic 帮助中心(2026-10-24 核对)写明,Claude 的 Pro 和 Max 都有 5 小时会话限额和每周限额,由 Claude 与 Claude Code 共用。同一次用量会同时计入这两项,所以一阵高强度使用可能在会话窗口重置之前就先用完每周额度。
为什么用 /model 换模型 也没用?
因为会话限额和每周限额对所有模型共用。按 Claude Code 的报错参考文档(2026-10-24 核对),只有 Opus 和 Sonnet 限额是按模型系列单独计算的,所以看到「You've hit your Opus limit」或「You've hit your Sonnet limit」时,用 /model 换到这一系列以外的模型才有用。每个模型的提示缓存各自独立,换模型后的下一个请求会把整段对话重新读一遍,没有缓存命中。
额度 重置后 Claude Code 能自己 接着跑吗?
能,限于用 claude.ai 订阅登录的交互式会话。按 Claude Code 的交互模式文档(2026-10-24 核对),Claude Code v2.1.234 及以后默认会在打开的会话里等待,显示「Continuing automatically at 3:45pm · esc to cancel」,重置后接着做被打断的任务;按 Esc、Ctrl+C 或运行 /rate-limit-options 可以取消。任务如果又撞上限额,最多连续再自动等两次。会话要一直开着:退出后再恢复会话,等待不会重新开始。
/usage 里显示 rate limited until 3:14am 是什么 意思?
意思是 /usage 没能刷新套餐限额。按 Claude Code 的费用文档(2026-10-24 核对),在那个时间之前 Claude Code 拿不到新的限额数据,这并不表示你用 Claude 干活受到了限制。这段时间里,/usage 可能显示它之前在本机加载的用量条,并注明 Showing last-known usage;过了那个时间按 r 就能刷新。
不想等,还能 继续用吗?
能。按 claude.com/pricing(2026-10-24 核对),付费套餐可以开启 usage credits(运行 /usage-credits),按标准 API 价继续用,也可以升级到更高的套餐。按 Anthropic 帮助中心(2026-10-24 核对),改用 Claude Console 的 API Key 后,会话按 API 用量计费,不消耗订阅包含的用量。也可以让 Claude Code 走自带凭证的网关,比如 Router One:把 Router One Key 放进 ANTHROPIC_AUTH_TOKEN 后,这个会话由 Router One 计费,档位列出该模型的 Router One 套餐先扣套餐额度,其余按公示单价从钱包扣费。云端会话始终使用订阅凭证。
接到 Router One 的 Claude Code 会话会 占用 Claude 套餐额度吗?
用 Router One Key 发出的请求由 Router One 计费,不记在 Claude 套餐上。按 Claude Code 的网关文档(2026-10-24 核对),设置了 ANTHROPIC_AUTH_TOKEN 这类网关凭证后,请求携带的是这个凭证而不是你的 claude.ai 登录,订阅的用量限额不适用于这些请求;登录仍保存在本机、只是不用,删掉变量后 Claude Code 会重新使用它。只设 ANTHROPIC_BASE_URL 不会替换订阅:登录仍是生效的凭证,订阅的限额和计费照旧。你在 Claude 应用里的聊天、Claude Code 的云端会话,以及 Claude 桌面应用里的 Claude Code 会话,仍算在 Claude 套餐上:按 Claude Code 的认证文档(2026-10-24 核对),桌面应用和云端会话不读取 ANTHROPIC_AUTH_TOKEN,用 OAuth 登录;只有使用第三方推理配置的桌面应用会话例外,改用该配置里的凭证。
Router One 的套餐 也有额度吗?
有。Router One 的 Pro、Max、Ultra 套餐按模型档位设月度额度:套餐档位列出的模型先扣该档位的额度,超出额度的调用,以及调用不在任何档位里的模型,都按公示单价从钱包扣费。截至 2026-10-24 的套餐接口,claude-opus-5 在三个套餐的「高级模型」档,claude-sonnet-5 在「中级模型」档,claude-haiku-4-5 在「普通模型」档;各套餐额度见 /pricing。每把 Key 和每个账户的请求数与 token 数限额是平台默认值,可以发邮件到 support@router.one 申请调高。
在中国 大陆能用这套 配置吗?
能。Router One 在中国大陆可直连、无需 VPN,Claude Code 的配置和在其他地区完全一样:同一条一键命令,或同样的几个环境变量。不需要 Claude 订阅,钱包可以用支付宝、银行卡或稳定币充值。