【Claude】You've hit your session limit 会话限制报错已解决

关键词：Claude Code、session limit、weekly limit、Opus limit、使用额度、/usage、/usage-credits、Pro Max 计划

一、问题现象：Claude 突然"拒绝服务"

正在用 Claude Code 写代码，某个时刻所有请求突然被拦截，终端出现以下三条消息之一：

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

共同特征：

• 没有 API Error 前缀，不是服务端错误；
• 消息里带着明确的重置时间（今天下午 3:45、下周一 0:00 等）；
• Claude Code 直接拦截请求，不走自动重试。

很多人第一反应是"是不是服务挂了" "是不是网络问题"——都不是。这是你的账户（订阅计划）自己的使用配额到了上限，和服务器状态无关。

二、三种限制的区别

官方把订阅计划的用量控制设计成多层结构，三条报错对应不同维度：

报错	含义	重置周期
You've hit your session limit	短期（会话级）使用额度耗尽	当天某个时间点（滚动窗口）
You've hit your weekly limit	本周使用额度耗尽	每周一 0:00
You've hit your Opus limit	当前计划对 Opus 模型的特殊配额耗尽	当天某个时间点

重要认知：这些是滚动使用额度（rolling usage quota），不是"每月固定充值"那种模型。额度在一个滚动时间窗口内计算，窗口结束后自动重置——所以消息里会告诉你具体的重置时间。

关于 Opus 限制

Pro/Max 计划对 Opus 模型有独立的配额，和 Sonnet 等其他模型共享的额度是分开的。所以你可能遇到"Opus 用完了但 Sonnet 还能用"的场景。

三、根因分析：为什么会到限

3.1 订阅计划的配额逻辑

Claude Code 基于订阅计划访问 Claude API，每个计划包含一定的滚动使用额度：

• Pro 计划：适合个人开发，有相对较小的会话和每周配额；
• Max 计划：适合重度开发者，配额显著更高；
• Team / Enterprise：团队 / 企业级，由管理员控制总额度；
• Console API key：按 Token 计费，无固定配额（但有速率限制）。

3.2 Claude Code 的 Token 消耗比想象中大

Claude Code 不像聊天机器人"你问一句它答一句"那么简单。每一轮背后实际消耗包括：

• 系统提示（System Prompt）：每次请求都会携带，可能高达 20,000–30,000 Token；
• 工具定义：MCP 工具、内置工具列表，随工具越加越多；
• 整段对话上下文：所有历史消息；
• CLAUDE.md 内存文件：你的项目指令。

有人分析过：一次 40,000 个输入 Token 的请求，最终只生成了 30 个 Token 的有效输出——超过 80% 的成本被浪费在了上下文稀释（Context Dilution）上。这也是为什么明明"只聊了几下"就用完了额度。

3.3 高频操作模式加速消耗

以下场景是额度"刺客"：

• 跑多个并行 Sub-Agent（每个 Agent 继承完整上下文）；
• 频繁用 Opus（配额独立且消耗更快）；
• 反复重发长 Prompt；
• 持续开着大型 MCP 服务器（工具定义占满每次请求）。

四、解决方案

方案一：等待额度重置（最直接）

消息里已经告诉你什么时候重置：

You've hit your session limit · resets 3:45pm

等到那个时间点，额度自动恢复，继续用。没有任何需要操作的步骤。

方案二：运行 /usage 查看详情

想知道自己还剩多少、什么时候重置，运行：

/usage

这会展示你的计划限制、各类型额度使用情况，以及每项的重置时间。

方案三：购买 Extra Usage（临时扩容）

等不了重置，又急着要用？Pro 和 Max 计划可以在不升级套餐的情况下购买额外使用量（Extra Usage / usage credits）：

/usage-credits

按当前用量计费，临时扩充额度。Team 和 Enterprise 用户需要向管理员申请。

关于如何计费可以参考官方付费计划的使用信用（Usage Credits）说明。

方案四：在达到限制前监控用量

不想毫无预警地撞上限制墙，可以提前监控：

• 状态行自定义：在 Claude Code 的状态行（底部状态栏）加上 rate_limits 字段，实时显示剩余额度；
• 桌面应用：点击模型选择器旁边的使用环（usage ring），可以看到当前会话的剩余量。

方案五：升级计划获取更高基础限制

如果你的工作强度经常撞上限制，考虑升级到配额更高的计划：

• Pro → Max：适合全职开发者；
• Max → Team/Enterprise：适合团队场景。

升级后的配额从下一个计费周期生效。详见 claude.com/pricing。

方案六：切换到 API Key 模式（无固定配额）

如果订阅计划的额度结构不适合你的工作节奏（比如批量自动化），可以换用 Console API Key 模式：

export ANTHROPIC_API_KEY=你的key

Console API Key 按 Token 计量计费，没有会话 / 每周额度上限（但有速率限制 RPM/TPM/TPD）。代价是成本更透明，需要自己控制开销。

方案七：降低单次消耗，延长额度寿命

治本之道：减少每次请求的无效 Token 消耗。

• /compact 定期压缩：减少历史对话占用；
• /clear 开新对话：从干净状态重新开始新任务；
• 关掉不用的 MCP：/mcp disable <name>，减少工具定义 Token；
• 精简 CLAUDE.md：只保留当前任务相关的指令；
• 尽量用 Sonnet 而非 Opus：日常编码 Sonnet 足够，Opus 的独立配额更容易耗尽；
• 避免粘贴超长内容：用文件路径引用代替粘贴。

五、避坑与最佳实践

别犯的错

• ❌ 以为是服务器挂了：有具体重置时间的消息 100% 是配额问题，不是服务端故障。
• ❌ 去查 API key 或重新登录：配额耗尽和认证无关，/login 解决不了这个。
• ❌ 把 /usage-credits 当成长期解决方案：如果你经常买 Extra Usage，可能升级计划更划算。

该养成的习惯

• ✅ 任务开始前看一眼 /usage：知道自己有多少"子弹"再开干。
• ✅ 状态行监控：加上 rate_limits 字段，提前看到预警。
• ✅ 分阶段 /clear：每个大任务模块间开新对话，重置上下文积累。
• ✅ 模型按需选择：用 Sonnet 处理日常任务，只在需要深度推理时切 Opus。

六、区分配额错误和其他错误

错误	是配额问题？	关键区别	正确处理
You've hit your session/weekly/Opus limit	✅ 是	带重置时间	等重置 / 买 Extra Usage / 升级
Server is temporarily limiting requests	❌ 否	和账户无关	等几秒重试
Request rejected (429)	可能	可能是 API key 速率限制	查凭证 / 降并发
Credit balance is too low	❌ 否（另一种）	Console 预付信用耗尽	充值
500 / 529	❌ 否	服务端问题	等 / 换模型

七、总结

You've hit your session/weekly/Opus limit 是 Claude Code 订阅计划的使用配额耗尽提示。核心要点：

1. 有重置时间 = 是配额，不是故障——等到那个时间点就自动恢复；
2. 三种限制对应不同维度：会话级 / 每周 / Opus 独立配额；
3. /usage 看详情，/usage-credits 买扩容；
4. 想从根本上减少撞限频率，就降低 Token 消耗：/compact、/clear、关 MCP、少用 Opus；
5. 高强度需求考虑升级计划或切换 API Key 模式。

看到重置时间，喝杯咖啡等等；等不了就 /usage-credits 买个额外量，活儿继续。

---

参考：Claude Code 官方《错误参考》"使用限制"章节、claude.com/pricing、官方 usage credits 说明、社区 Token 消耗分析。