Claude Code 报 You’ve hit your session limit 怎么办？5 种办法，附 5-hour limit 新旧对照（2026 实测）

Claude Code 弹出 You've hit your session limit，意思是你订阅账号的 5 小时用量用完了，跟网络、登录、封号都没关系。消息结尾写着重置时间，到点就能接着用；在交互式会话里，Claude Code 还会自己等到那个时间再继续干活。等不了的话，跑 /usage-credits 开 usage credits，超出的部分按 API 标准价计费。我们 2026 年 11 月 10 日在本机复现了这行报错，还发现从 Claude Code 2.1.312 起，同一个 5 小时额度的提示已经从 session limit 改成了 5-hour limit，下面有对照。

报错原文：四种额度，四种写法

官方 Error reference 把这几行放在同一节，原文如下：

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pm

Claude Code 会挡住之后的所有请求，直到消息里写的重置时间。session 和 weekly 两种额度所有模型共用，所以换模型没用。Opus 和 Sonnet 两种只管各自的模型系列，用 /model 换到系列之外的模型可以接着干。

这一节没列、但我们复现过的还有第五种：You've hit your Fable limit。Max 和 Ultra 有单独的 Fable 周额度，到顶就是这一行。

你看到的是 session limit 还是 5-hour limit

两个说法指同一个额度，区别只在 Claude Code 的版本。2.1.312 的 更新日志里有一条：

Changed usage limit messages to call the 5-hour window the "5-hour limit" instead of the "session limit"

所以 2.1.311 及更早的版本打印 You've hit your session limit，2.1.312 起打印 You've hit your 5-hour limit，处理办法完全一样。Claude 帮助中心和官方 Error reference 目前写的还是 session limit，搜索时两种写法都会遇到。

Ultra 要单独说一句：官方写明通过验证的 Ultra 账户没有 5 小时限制，只有周额度。所以这类账户看到的是 weekly limit；还没验证的 Ultra 账户有临时的 5 小时限制。

5 种办法，按省事程度排

1. 等到重置时间，会话别关

消息里的重置时间用你电脑的时区显示。我们这台测试机是北京时间，5 小时额度那条显示 resets 1:55pm，周额度那条带日期，显示 resets Nov 13, 9:56am。

• 5 小时额度：官方帮助中心写的是从你发第一条消息开始计时，满 5 小时整体重置。
• 周额度：重置时刻是固定分配给你账号的，不随你开始使用的时间变，在 设置 > Usage 里能看到下次重置。
• 交互式会话（v2.1.234 起，用 claude.ai 订阅登录）：Claude Code 会留在会话里等，重置后自己接着做。底部会出现 Usage limit reached · limit resets 3:45pm 和 Continuing automatically at 3:45pm · Esc to cancel 两行。会话要保持打开。
• 它不会重发你的上一条消息，续做时权限提示照常弹，所以你不在电脑前，任务可能卡在一个确认框上。
• 自动续做最多连续 3 次，之后停下来，跑 /rate-limit-options 选下一步。电脑睡眠超过约 30 分钟且额度已重置时，会提示 Press enter to continue。
• 想关掉：等待期间按 Esc 或 Ctrl+C，或在 /config 里关 Continue automatically at usage limit。桌面版的 Code 标签页里，session 额度卡片有一个 Auto-continue when limits reset 勾选项，周额度卡片没有；它和命令行那个设置互相独立，要分别关。

2. 开 usage credits，当场继续

在会话里跑 /usage-credits，Pro、Max、Ultra 用户会打开 claude.ai 的 设置 > Usage，在 Usage credits 一栏打开开关、设月度上限、买额度。用 API key 登录时这个命令不可用。

• 开了以后，撞到 5 小时额度、周额度或 Fable 周额度时，请求会改按 API 标准价从 credits 里扣，不会被挡。
• 它和 Max、Ultra 每月送的 100、200 美元 API 额度是两回事，API 额度不能抵 usage credits，也不能用在交互式 Claude Code 里。
• 设置里的月度上限一定要设，否则按官方说法会一直用到上限或余额用完。
• usage credits 买了不退款。官方还写了：2026 年 12 月 7 日及之后购买的，购买后 12 个月到期，之前买的不过期。官方只写了日期，没写具体时刻，所以换算不了北京时间。
• 正在自动等待时，你用 /usage-credits 加完额度，Claude Code 会立刻检查，额度可用就马上续做。

3. 报 Opus limit 或 Sonnet limit：换模型

这两种只限一个模型系列。跑 /model 换到系列之外的模型就行。官方提醒，每个模型各有一份 prompt cache，换完以后的第一次请求要把整段对话重新读一遍，没有缓存命中，长会话会多耗一些额度。报 session 或 weekly 时换模型没用，别折腾。

4. 升级套餐

帮助中心写明，升级后新套餐的额度立刻生效。按 claude.com/pricing 2026 年 11 月 10 日的标价：Max 每月 100 美元，是 Pro 的 5 倍（每 5 小时和每周）；Ultra 每月 200 美元，每周是 Pro 的 10 倍。要不要升，我们另有一篇对比：Claude Pro、Max、Ultra 区别。一周撞不到两次的话，先别升。

5. 查谁在吃额度

Pro、Max、Ultra 上跑 /usage，除了额度条，还会列出最近用量按 skill、subagent、plugin 和各个 MCP server 的占比，加上带百分比的优化建议；按 d 和 w 在最近 24 小时和 7 天之间切换。数据来自本机的会话记录，不含其他设备和 claude.ai 网页。

官方在报错说明里提醒过：一次很重的操作，比如大型 workflow 一次拆出很多 agent，就可能在 5 小时窗口重置之前把周额度烧光。如果你是在周额度上撞墙，先看是不是有这种任务。

脚本里跑 claude -p 撞到限额

我们用 claude -p 测了：撞到限额时 stdout 会打出同一行字，退出码是 1。加 --output-format json 时，is_error 是 true，api_error_status 是 429，result 字段就是那行 You've hit your ...limit · resets ...。脚本可以按这三项判断，别去匹配 session 这个词，2.1.312 之后已经变成 5-hour。

无人值守想让请求自己等到重置，官方文档写了环境变量 CLAUDE_CODE_RETRY_WATCHDOG，以及 v2.1.305 起的 CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS（60000 到 10800000 毫秒，用来定期检查限额是不是已经提前解除）。这部分我们没测，按文档写。

我们测了什么，哪些只是照文档

先说方法，免得读成别的意思：我们在本机起了一个假服务端，对每个请求回 HTTP 429，并带上 anthropic-ratelimit-unified-* 响应头，声明哪个额度被拒、几点重置。Claude Code 用假的 OAuth token 进入订阅模式，ANTHROPIC_BASE_URL 指向这个假服务端。没有任何真实账号的额度被用完。

所以测到的是：Claude Code 收到这种 429 以后打印什么、退出码是多少。Anthropic 的服务器在什么时候判定你超限，我们没有也没法测。

• 测了：2.1.311、2.1.312、2.1.322 三个版本的提示文字；claude -p 的退出码和 JSON 字段；Opus、Sonnet、Fable、weekly 四种额度的提示；周额度重置时间带日期的显示格式。
• 没测，按官方文档：交互式自动续做和 Esc 取消；/usage-credits 的开通和计费；桌面版勾选项；升级套餐后额度是否立刻生效；/usage 的占比分析。
• 来源：Error reference、Interactive mode、Manage costs、How do usage and length limits work?、Usage credits、Claude Code CHANGELOG。官方页面 2026 年 11 月 10 日抓取。

常见问题

session limit 和 5-hour limit 是一回事吗？

是，同一个每 5 小时重置的额度。2.1.312 起 Claude Code 把措辞改成了 5-hour limit，帮助中心和报错文档还在用 session limit。

为什么我才用了一会儿就到顶了？

官方说，能用多少取决于对话长度、模型、附件和你用的功能，没有固定的条数；网页聊天、桌面端、手机、Cowork 和 Claude Code 共用同一个额度池。先在 /usage 看占比，再对照上面第 5 条。

这是 429 限流吗？

不是同一种。官方把 Server is temporarily limiting requests (not your usage limit) 单列出来，那是服务端的短时节流，和套餐额度无关，等一会儿重试；Request rejected (429) 是 API key 或云平台项目的速率限制。这两种见我们的 Claude Code 429 速查。

和 monthly spend limit 有什么区别？

monthly spend limit 是 usage credits 或组织设的月度花费上限，写法是 You've hit your monthly spend limit，处理办法不一样，见 monthly spend limit 实测。

Claude 额度到底怎么算？

5 小时额度、周额度和 Pro、Max 的差别，我们整理在 Claude 额度怎么算。官方重置活动和封号记录在 额度重置追踪。更多报错见 Claude Code 报错速查。想在终端里随时看 5 小时和每周额度，见Claude Code 用量监控。 如果是回复到一半断流，看 Claude Code Stream idle timeout 怎么解决。