# Claude Code 提示「You've hit your session limit」：额度用完的含义、重置与解决 > https://router.one/zh/claude-code-usage-limit 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。 > 最后更新：2026-10-24 用 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 账号，说明变量没有传到这个会话。 `terminal` ```bash 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），这几行只决定用哪个模型： `~/.zshrc 或 ~/.bashrc` ```bash 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 订阅，钱包可以用支付宝、银行卡或稳定币充值。 ## 相关页面 - Claude Code 401 / 403 排查：https://router.one/zh/claude-code-403 - Claude Max 替代方案：https://router.one/zh/claude-max-alternative - Claude Code 国内直连：https://router.one/zh/claude-code-china - Claude Code 配置教程：https://router.one/zh/blog/claude-code-setup-guide - 在 Claude Code 里固定模型：https://router.one/zh/blog/claude-code-opus-5-5-setup - Codex 用量上限报错：https://router.one/zh/codex-usage-limit - 错误码速查：https://router.one/zh/llm-api-error-codes - CLI 配置指南：https://router.one/zh/docs/guides/cli-setup - Claude Code 报错参考（英文）：https://code.claude.com/docs/en/errors - 本页规范地址：https://router.one/zh/claude-code-usage-limit - 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ） - 定价：https://router.one/zh/pricing - API 文档（markdown）：https://router.one/zh/docs.md - 公司事实（markdown）：https://router.one/zh/facts/company.md