Claude Code 停了,不一定是模型坏了。2026 年更常见的情况是:你撞上了 Session Limit、每周额度,或单独的 Opus 限额。三条上限同时在跑,报错长得很像,处理方式完全不同。
Anthropic 不公布精确 Token 数字,而是用「相对 Pro 的倍数」描述套餐。本文按官方机制,把 Pro、Max 5x / 20x 的每周额度、5 小时滚动窗口、Token 消耗、重置时间,以及撞墙后走 API / Usage Credits 的成本说清楚。
先分清三条上限
Claude Code 订阅里同时存在三道闸。会话和每周额度跨模型共享,换 /model 救不了;只有 Opus 限额是模型专属。
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
| 上限 | 作用 | 形状 | 换模型有用吗 |
|---|---|---|---|
| Session(5 小时) | 防短时打满 | 滚动窗口,用量逐渐过期 | 否,全模型共用 |
| 每周额度 | 控制一周总量 | 按账号周期重置 | 否,全模型共用 |
| Opus 限额 | 保护最贵模型 | 单独计数 | 是,切 Sonnet / Haiku 可继续 |
Free 套餐不含 Claude Code。网页、Desktop、Claude Code 共用同一池子。
Pro 与 Max 每周额度怎么比
价格以 Claude 官方定价页 为准(2026 年 9 月):
| 套餐 | 月费 | 相对 Pro | 适合谁 |
|---|---|---|---|
| Pro | $20(年付约 $17) | 1× | 单会话、间歇使用 |
| Max 5x | $100 | 5× Session + 每周额度 | 全职每天用 Claude Code |
| Max 20x | $200 | 20× Session + 每周额度 | 多会话、大仓库、长时间 Agent |
社区经验(不是官方 Token 表,只作体感):Pro 大约每周 40–80 小时 Sonnet 有效计算;Max 5x 大约 140–240 小时 Sonnet,并另有一截 Opus 余量;Max 20x 可到 240–480 小时 Sonnet。实际能撑多久,取决于模型、上下文长度和工具输出量,不是「发了多少条消息」。
2026 年 5 月 6 日起,付费套餐的 5 小时窗口大约翻倍,高峰时段缩减也取消了。每周额度曾有 +50% 促销,以你账号 /usage 显示为准,不要拿去年的帖子当合同。
Fable 5 不要和每周额度搞混
Fable 5 是更贵的高阶模型,不是默认模型。Max / 高级席位可以把每周额度的最多 50% 花在 Fable 5 上——这是从同一池子里切一块,不是额外 50%。Pro 上 Fable 5 通常从第一请求就走 Usage Credits。
和 Cursor 比订阅值不值,可以对照 Cursor Pro 真实成本分析。
Session Limit:滚动 5 小时,不是整点清空
Session Limit 量的是过去 5 小时消耗的 Token,不是「每天 9 点重置一次」。
- 上午 9–11 点打满,额度会在下午逐渐回来,而不是卡在某一个整点瞬间回满。
- 报错会写出具体时间,例如
resets 3:45pm。那是窗口清空点,等待期间容量其实已在回升。 - 同一账号下的并行会话共用这一池。开 3 个窗口,消耗大约 ×3;Agent 团队在 plan 模式下,官方量级大约是普通会话的 7 倍。
Max 不会取消 Session Limit,只是把桶放大 5 倍或 20 倍。两个 Max 5x 账号($200)等于一个 Max 20x 的钱,但给你两套独立窗口——并行干活时往往更划算。
Token 消耗:真正烧额度的五件事
限额按 Token / 计算量计,不按回合数。一次 Opus 扫大仓库,可以比五十条短 Haiku 还贵。
- 模型选择:Opus / Fable 比 Sonnet、Haiku 贵数倍。机械活用
/model sonnet或 Haiku,难题再切回 Opus。 - 长上下文:整段对话每次请求都重发。开了一天的会话,回一句「继续」也在付整段历史。
- 缓存未命中:订阅下 Prompt Cache 大约 1 小时;走 Usage Credits 或 API Key 后往往掉到 5 分钟。中午休息过长,下午第一条会按全量输入计费。
- 工具输出:
grep吐出 4000 行、整份测试日志、6000 行源文件,都会进上下文并在后续回合重发。 - 并行与定时任务:多 Agent、定时任务每次带着完整上下文开火。空闲会话接近免费;后台摘要通常很低,但 scheduled task 不是。
省额度的操作顺序:无关任务用 /clear(免费),不要先 /compact(压缩本身也是一次大请求);CLAUDE.md 控制在约 200 行,细节放 Skill,按需加载。Skills 写法见 Claude Code Skills 模板大全。
# 会话内切换模型与思考力度
/model sonnet
/effort low
# 无关任务:先改名再清空,比 compact 便宜
/rename api-auth-fix
/clear
重置时间怎么看
| 上限 | 重置方式 | 去哪看 |
|---|---|---|
| Session 5 小时 | 滚动,报错给时刻 | 报错文案、/usage、status line |
| 每周额度 | 按账号周期(常见周一 0 点一类) | /usage、claude.ai → Settings → Usage |
| Opus 限额 | 独立周期 | 同上;切模型可立刻继续 |
/usage 来自本机会话历史,另一台电脑或 claude.ai 上的用量不会算进来。要看全账号,以网页 Usage 页为准。
自定义 status line 可持续显示两个窗口:
{
"rate_limits": {
"five_hour": { "used_percentage": 23.5, "resets_at": 1738425600 },
"seven_day": { "used_percentage": 41.2, "resets_at": 1738857600 }
}
}
撞墙之后:等、降级,还是买超额
- Session / 每周限额:换模型无效。等窗口回血,或用
/usage-credits按 API 价继续(可设月度封顶;日赎回上限常见为 $2,000)。 - Opus 限额:立刻
/model sonnet或 Haiku,工作能接着做。 - HTTP 429:这是 API 吞吐量限制,不是订阅窗口。先查环境里有没有误设的
ANTHROPIC_API_KEY,再降并发。
Team / Enterprise 没有账单权限时,/usage-credits 会向管理员发申请。走 Credits 后缓存寿命变短,同样工作会更「费」。
和「AI 操控电脑」能力的关系,见 Claude Code 与 OpenAI Computer Use 关系解读。
订阅 vs API:哪一种更便宜
订阅有 5 小时和每周窗口;API Key 没有这两道窗,只按 Token 和每分钟吞吐计费。Usage Credits 溢出价 = 标准 API 价。
官方标价(每百万 Token,2026 年 9 月,Claude API Pricing):
| 模型 | 输入 | 输出 | 缓存命中 |
|---|---|---|---|
| Haiku 4.5 | $1 | $5 | $0.10 |
| Sonnet 5 | $2 | $10 | $0.20 |
| Opus 5 / 4.8 | $5 | $25 | $0.50 |
| Fable 5 | $10 | $50 | $1(5.1 更低) |
粗算:一次中等 Agent 任务约 80k 输入 + 8k 输出,Sonnet 5 大约 $0.24;同样规模走 Opus 5 大约 $0.60。Prompt Cache 命中后输入可降到约 10%(Fable 5.1 约 2.5%)。Batch API 再打五折,但异步,不适合交互写代码。
怎么选:
- 每天一两段专注会话 → Pro 通常够。
- 工作日打满、常撞 Session → Max 5x。
- 多窗口并行、仓库大 → Max 20x,或两个 Max 5x 拆账号。
- 夜间批量、可异步 → API / Batch 往往比硬顶订阅便宜。
- 偶发超额 → Usage Credits,不必整月升级。
常见问题
Session Limit 是按消息条数算的吗?
不是。三条上限都按 Token / 计算量。上下文越长、工具输出越多、模型越贵,烧得越快。
切到 Sonnet 能解除 Session / 每周限制吗?
不能。只有 Opus 限额可以靠换模型立刻恢复。Session 和每周额度全模型共用。
Max 还有限额吗?
有。Max 只是把 Pro 的 Session 和每周额度乘以 5 或 20,机制不变。
API 有 5 小时和每周窗口吗?
没有。API 按 Token 计费,撞的是组织级吞吐(429),不是订阅窗口。
额度数字以谁为准?
以 /usage 和 claude.ai Usage 页为准。第三方文章里的小时数、消息数都是估算,Anthropic 可能随时调整倍数和促销。
额度用在刀刃上,机器也要稳
Claude Code 的限额跟的是云端 Token,但 Agent 要在本地读仓库、跑测试、开 MCP。笔记本一合盖,会话中断、缓存失效,下午第一条请求就会按全量输入计费。Mac mini 待机功耗大约 4W,适合 24 小时挂着终端,让 /usage 和滚动窗口按你的节奏走,而不是跟着合盖走。
Apple Silicon 统一内存让索引大仓库、并行测试更稳;macOS 原生 Unix、Homebrew、Docker、SSH 开箱即用,Claude Code 的 computer-use 也以 macOS 为主战场。和同价位 Windows 主机比,崩溃少、无人值守更合适,Gatekeeper 与 SIP 也降低长期挂 Agent 的风险。
如果你已经在为每周额度精打细算,一台稳定、低功耗的云端 Mac 能减少「会话被打断再重烧上下文」——立即了解套餐方案,把 Token 花在改代码上,而不是反复热身。
