- CLI
- 0.2.17
- 预览 ref
- a2c45c8
要点
当 Claude Code 显示 You've hit your session limit · resets 3:45pm 时,你可以:
- 等待,让 Claude Code 自己继续。 在 v2.1.234 或更高版本并使用 claude.ai 订阅时,它会在打开的会话中等待,重置后接着完成任务。
- 如果是模型限制,就切换模型。 Opus 或 Sonnet 限制只针对该系列,所以用
/model就能继续。会话限制或每周限制覆盖所有模型。 - 开启用量额度。 Pro 和 Max 可以按标准 API 价格在超过限制后继续工作。运行
/usage-credits。 - 把工作转到 API 计费。 Claude Console 账号按 token 计费,没有 5 小时窗口。
- 升级套餐。 Max 5x 和 20x 会提高每个会话的额度。
- 在你自己的另一个账号上继续,或者用你已经付费的另一个代理继续。
哪种合适,取决于你碰到的是哪个限制、离重置还有多久,以及你更愿意付钱还是等待。
问题
限制往往在最糟糕的时候到来:重构做了一个小时,测试一半已经通过。会话停了,你建立起来的上下文就晾在那里。换个地方重来意味着全部重新解释,等待则意味着任务在重置前一直闲着。
第一步是仔细读提示,因为不同的限制有不同的解决办法。
第 1 步:弄清你碰到的是哪个 Claude Code 限制
来自 Anthropic 的 错误参考:
| 提示 | 含义 | 如何恢复 |
|---|---|---|
You've hit your session limit · resets … | 滚动的 5 小时窗口,所有模型共用 | 等待重置、用量额度或升级 |
You've hit your weekly limit · resets … | 每周限制,所有模型共用 | 每周重置、用量额度或升级 |
You've hit your Opus limit 或 Sonnet limit | 某个模型系列的限制 | 用 /model 切换到该系列以外的模型 |
You've hit your monthly spend limit 及类似提示 | 用量额度达到了支出上限 | 提高上限,或等待提示中写明的套餐重置 |
Server is temporarily limiting requests | 服务器端限流,不是你的配额 | 稍等片刻再试 |
Credit balance is too low | API 计费余额不足 | 给 Console 充值 |
运行 /usage 可以看到两个窗口及其重置时间。Claude Code 用量什么时候重置? 解释了窗口如何运作。
第 2 步:选择继续工作的方式
等待并让 Claude Code 自动继续
在用 claude.ai 订阅登录的交互式会话中,从 v2.1.234 起自动继续默认开启。你会看到:
Usage limit reached · limit resets 3:45pm
Continuing automatically at 3:45pm · esc to cancel保持会话开启。到重置时间时,Claude Code 会让 Claude 从停下的地方接着做任务。它不会重发你的上一条消息。Anthropic 交互模式页面 中的细节:
- 如果电脑休眠超过约 30 分钟,并且限制在此期间重置了,它会让你按 Enter。
- 它最多连续两次自行重新进入等待。之后会以
Automatic continue stopped after repeated usage-limit hits停止。 - 权限提示照常出现,所以你不在时继续的任务可能会停在某个提示上。
- 要关闭它,在
/config中使用 Continue automatically at usage limit。桌面应用在会话限制卡片上另有一个 Auto-continue when limits reset 复选框,两者相互独立。
这是零成本的选项。适合重置时间很近,或任务可以等的情况。
碰到 Opus 或 Sonnet 限制时切换模型
/model选择一个不属于触发限制的系列的模型。每个模型都有自己的提示缓存,所以下一次请求会在没有缓存命中的情况下重新读取整个对话。这一回合比平时更重,而且对会话限制或每周限制没有帮助。
开启用量额度
在 Pro 和 Max 上,用量额度可以让你按标准 API 价格在超过限制后继续工作。用订阅登录后运行 /usage-credits。它会打开 claude.ai 的 Settings → Usage,你在那里开启额度并设置每月支出上限。在 Team 和 Enterprise 上,它会向管理员申请更多额度。
Anthropic 帮助中心描述了额度接管后你会看到的内容:5-hour limit resets [time] - continuing with usage credits。
在需要之前就设好支出上限。按 API 价格,一次长时间的代理运行花钱很快。
转到按量付费的 API 计费
Claude Console 账号按 token 计费,没有 5 小时或每周窗口。Anthropic 的帮助文章把它列为高强度编程冲刺时的一个选项。切换就是换一种登录方式,所以不会把当前对话的计费一并带过去。先在 Console 中设置工作区支出上限。
升级套餐
如果你几乎每天都碰到 5 小时窗口,更大的套餐才是长久之计。Max 5x 每个会话的用量是 Pro 的 5 倍,Max 20x 是 20 倍。Anthropic 说新套餐的限制会立即生效。
在你自己的另一个账号或另一个代理上继续
有些人持有不止一个订阅,比如个人 Pro 套餐和工作席位。还有人同时为 Claude 和带 Codex 的 ChatGPT 套餐付费。这两种情况下,工作都可以在你已经付过费的地方继续。请遵守各服务商的条款。Anthropic 的 Consumer Terms 规定,你不得与他人共享账号凭据,也不得让他人使用你的账号。
手动这样做意味着新开会话并重新解释任务。下一节介绍如何不用从头开始。
在自己的多个账号之间延续同一个会话
如果你希望在自己的某个账号达到上限时会话能继续,并在手机上关注进展,Happier 是一款开源应用,可以在手机、桌面或网页上跨设备运行和编排 Claude Code、Codex 等代理。
账号池收纳你自己的账号
账号池把你自己的账号归在一起,比如你的个人订阅和工作订阅,都以你的身份登录,在你自己的电脑上使用。当其中一个达到用量上限时,Happier 可以把会话切换到另一个继续。
账号池的行为:
- 在你建立账号池之前,什么都不会切换。 创建账号池是在设置(Settings)→ 已连接服务(Connected services)中有意进行的操作。
- 新的 Claude 或 Codex 账号池默认开启自动回退。 如果你更想手动切换,在账号池选项中关闭自动回退(Automatic fallback)。
- 账号池内的切换不会重启 Claude Code 或 Codex。 新的登录会应用到正在运行的会话。
- 选择策略(Selection strategy)默认是最少受限优先(Least limited first)。另外还有优先级顺序(Priority order)和手动切换(Manual switching)。
- 预防性切换。 软切换阈值(Soft switch threshold)默认是剩余 15%,前提是另一个成员的配额数据更新。设为 0 则只在达到硬性上限时切换。
- 切换次数限制。 默认每个回合最多自动切换 1 次,每个会话小时最多 3 次。
- 恢复模式(Recovery mode)默认是能切换就切换,否则等待重置。其他模式有:等到重置、切换后恢复、关闭。
会话内的实时回退适用于 Claude 和 Codex。Gemini、OpenCode 和 Pi 也可以建立账号池,但它们的控件会提示该服务不能用于运行时账号回退。
用量上限横幅
当服务商要求会话等待时,会话会显示已达到使用限制(Usage limit reached)及重置时间,并提供限制重置后恢复(Resume when limit resets)、停止等待(Stop waiting)、立即检查限制(Check limit now)等操作,在账号池中还有立即切换账号(Switch account now)。Happier 恢复时会发送一条继续提示,而不是重放你最初的请求。
Continue with another Agent
如果你持有的另一个订阅是另一个代理的,Continue with another Agent 可以原地更换运行会话的代理,保留同一个会话和对话记录。它在当前代理空闲时可用,交接内容是有限的纯文本简报,所以之前回合中的图片不会带过去。如何在任务中途从 Claude Code 切换到 Codex 而不丢失上下文 中有完整步骤。
它做不到的
账号池不会提高上限、增加额度或缩短重置窗口。只有一个账号时,没有可以切换的对象。运行会话的电脑关机时,什么都不会继续。
已连接服务及其配额表在 Happier 0.2.17 中是实验性功能,默认关闭。在设置(Settings)→ 功能(Features)中开启已连接服务(Connected services),如果需要配额表,再开启已连接服务配额(Connected services quotas)。设置方法见 如何在手机上使用 Happier。Happier 在 GitHub 上,可以 在这里下载,还有 Discord。
预防下一次
- 关注用量表。 带
rate_limits字段的状态栏会一直显示 5 小时和每周的占比。见 如何查看 Claude Code 用量。 - 任务之间清空。
/clear不花任何代价。长会话中的每次请求都会重发历史记录。 - 按任务选模型。 Anthropic 的费用页面建议大多数编程用 Sonnet,复杂推理用 Opus。
- 简单工作降低 effort。 思考 token 按输出计算。
/effort可以调低。 - 保持
CLAUDE.md简短。 把工作流程说明移到技能中,技能只在使用时加载。 - 看看是什么在消耗。
/usage明细会按占比列出技能、子代理、插件和 MCP 服务器。
故障排查
自动继续没有启动
它需要 Claude Code v2.1.234 或更高版本、交互式会话和 claude.ai 订阅。在 API 计费下不会启动。检查 /config 中 Continue automatically at usage limit 是否开启。
切换模型没用
你碰到的是覆盖所有模型的会话限制或每周限制。切换模型只对 Opus 或 Sonnet 限制有用。
用量额度开着,但工作还是停了
看看提示内容。支出上限提示表示额度达到了你设置的每月上限,或者在自动充值关闭的情况下余额用完了。
常见问题
Claude Code 用量限制会持续多久?
会话限制按滚动的 5 小时窗口计算。每周限制在每个账号固定的时间重置。提示中会显示确切的重置时间。
能绕过 Claude Code 用量限制吗?
没有办法取消套餐的限制。你可以等待、通过用量额度或 API 计费多付一些、升级,或在你持有的另一个账号或代理上继续。
碰到限制会丢失会话吗?
不会。对话保留在打开的会话中。如果你关掉了,重置后用 claude --resume 就能找回来。
用量额度比套餐更贵吗?
它按标准 API 价格计费。拿一个月的额度支出和高一档套餐的价格比一比,看看哪个对你更便宜。