Claude Code · 用量上限
Claude Code 额度用完了?限额怎么算、有哪些办法
Claude Pro 和 Max 订阅在 Claude Code 里有两道上限:每 5 小时重置的会话额度和每周额度。撞上之后,你可以等重置、升档、打开官方 usage credits,或者把 Claude Code 指向一个按 token 计费的 API。本页把这四条路的代价摆在一起。
数据核对于
订阅限额是什么(2026 年 10 月)
下表只列官方公开的信息。官方不公布每周具体额度和消息条数,以你账号 Settings > Usage 里显示的为准。
| 方案 | 月费 | 5 小时窗口 | 每周限额 | 备注 |
|---|---|---|---|---|
| Claude Pro | $20(年付 $17/月) | 有 | 有 | Fable 需要 usage credits |
| Claude Max 5x | $100 | Pro 的 5 倍(每 5 小时) | 有(不公布具体值) | Fable 另有单独周限额;含 $100/月 API credits,不能用于 Claude Code |
| Claude Max 20x | $200 | Pro 的 20 倍(每 5 小时) | 有(不公布具体值) | 同上;含 $200/月 API credits |
| ChatGPT Plus(Codex) | $20 | 有 | 可能有 | 每 5 小时本地消息约 15–160 条(GPT-6.1 Sol,官方估算) |
| ChatGPT Pro(Codex) | $100 / $200 / $500 | 目前没有 | 有包含额度 | 用完可以购买 credits |
官方可以随时调整限额。Anthropic 还保留以其他方式限制用量的权利(每周 / 每月上限、模型或功能限制)。 数据核对于 2026-10-10.
官方来源:claude.com/pricingWhat is the Max plan? (Claude Help Center)Use Claude Code with your Pro or Max planCodex pricing (OpenAI)Using Codex with your ChatGPT plan (OpenAI Help)
为什么在 Claude Code 里很快撞上限
- 1
每一轮都会重发整段对话
读过的文件、工具输出、diff 都会随每条消息再计一次。会话开得越久,每一轮越“重”。
- 2
Opus 比 Sonnet 耗得多
官方建议日常编码用 Sonnet,难题再用 Opus;也可以用 /model opusplan(Opus 做规划、Sonnet 执行)。
- 3
子 agent、agent 团队、定时任务各自消耗额度
官方文档提到,agent 团队在 plan 模式下大约消耗 7 倍 token。
- 4
缓存失效
离开超过缓存寿命再回来,第一条消息要重新处理全部上下文。
- 5
上下文越来越大
大段粘贴、挂了很多 MCP 工具、CLAUDE.md 太长,都会让每一轮变大。
省额度:换任务时用 /clear,长任务中途用 /compact,用 /usage 看是哪类操作耗得最多。
撞上限后的 4 个选项
没有哪个选项永远最好,按你的用量和时间要求选。
| 选项 | 怎么做 | 代价 | 适合谁 |
|---|---|---|---|
| 等重置 | 看提示里的 resets 时间;Claude Code v2.1.234+ 可以在会话里自动等待并继续 | 时间 | 不赶工 |
| 升档 | Pro → Max 5x → Max 20x | $100–$200/月,仍有每周上限 | 每周都能用满的人 |
| 官方 usage credits | Settings > Usage 开启,或在 Claude Code 里运行 /usage-credits | 标准 API 价,需预充值,可设月度上限 | 偶尔超一点、想留在官方订阅里 |
| 改用按量 API | 给 Claude Code 配置 API Key 和 Base URL | 按 token 从余额扣费,不占 Claude 订阅额度 | 突击、溢出、团队按 Key 记账、国内网络 |
按量 API 按 token 计费,但仍有速率和并发限制,具体以我们的文档为准;你也可以给每把 API Key 设日 / 月 / 总消费上限。 docs.aicodewith.ai
算一笔账:一个 Claude Code 工作日要花多少
下面按 Opus 5.5 官方 API 价,估算三种强度的工作日。Claude Code 的 token 大部分是缓存读,所以缓存读的单价对总价影响很大。
假设
- Opus 5.5 官方价(每百万 token):输入 $4、输出 $20、缓存读 $0.20、5 分钟缓存写 $5。
- 每月 22 个工作日;token 构成见下表,按“百万 token”计。
- Anthropic 官方给出的参考:企业部署平均约 $13/开发者/活跃日,90% 的用户低于 $30/活跃日。“常规”和“重度”两档在这个范围内。
| 情景(每活跃日) | 缓存读 | 缓存写 | 未缓存输入 | 输出 | 官方 API / 日 | 22 天 / 月 |
|---|---|---|---|---|---|---|
| 常规 | 15M | 0.6M | 0.15M | 0.15M | $9.60 | $211 |
| 重度 | 40M | 1.2M | 0.3M | 0.4M | $23.20 | $510 |
| 极重度(多 agent / 长会话) | 120M | 3M | 0.8M | 1.2M | $66.20 | $1,456 |
同样的用量在 aicodewith 上
按当前公开价格计算,Claude 模型在 aicodewith 上起价为官方价的 19%(价格随渠道不同,以价格页为准)。
| 情景 | 官方 API / 日 | aicodewith 起 / 日 | aicodewith 起 / 月 |
|---|---|---|---|
| 常规 | $9.60 | 起 $1.82 | 起 $40.13 |
| 重度 | $23.20 | 起 $4.41 | 起 $96.98 |
| 极重度(多 agent / 长会话) | $66.20 | 起 $12.58 | 起 $277 |
Claude 模型单价(每百万 token)
| 模型 | 官方价 输入 / 输出 | aicodewith 起价 输入 / 输出 |
|---|---|---|
| Claude Opus 5.5 | $4 / $20 | 起 $0.76 / $3.8 |
| Claude Sonnet 5.5 | $2 / $10 | 起 $0.38 / $1.9 |
| Claude Haiku 5.5 | $0.1 / $0.5 | 起 $0.019 / $0.095 |
和订阅比
Max 5x 是 $100/月,Max 20x 是 $200/月,但都有 5 小时和每周上限;超出部分走 usage credits,按官方 API 价计费。
结论
如果你每周都能用满 Max,而且很少撞上限,Max 通常更划算。
按量 API 更适合:
- 撞上限后的溢出部分
- 用量不均匀,集中突击几天
- 不想被 5 小时窗口打断节奏
- 团队需要按 Key 记账和设预算
你的实际 token 构成可能差别很大。在 Claude Code 里用 /usage 或 /cost 查看自己的数字再算。
1 分钟把 Claude Code 切到 aicodewith
Claude Code 支持通过环境变量指定 API 地址和密钥。下面的配置和控制台里给出的一致。
1. 创建 API Key
在 aicodewith 控制台创建 API Key。可以给这把 Key 设日 / 月消费上限。
2. 编辑 ~/.claude/settings.json
把下面的 env 写进去(Windows 在 %USERPROFILE%\.claude\settings.json)。ANTHROPIC_BASE_URL 只填域名,不要带 /v1。
~/.claude/settings.json{ "env": { "ANTHROPIC_AUTH_TOKEN": "替换成你的_API_KEY", "ANTHROPIC_API_KEY": "", "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai" } }3. 重启并验证
重启 Claude Code,发一条消息;用 /model 选 Opus 5.5 或 Sonnet 5.5;到 aicodewith 用量记录里确认请求已经到达。
只要环境里设了 API Key,Claude Code 就会优先走 API 计费,不再使用订阅额度。
限额报错速查
Claude Code 的提示原文来自官方 errors 文档。
| 你看到的提示 | 含义 | 怎么办 |
|---|---|---|
| You've hit your session limit · resets 3:45pm | 5 小时会话额度用完(跨模型) | 等待 / usage credits / 切到按量 API |
| You've hit your weekly limit · resets Mon 12:00am | 每周额度用完 | 同上;换模型无效 |
| You've hit your Opus limit / Sonnet limit | 单个模型家族的额度用完 | 用 /model 换到另一个家族 |
| You've used 85% of your session limit | 预警 | 先 /compact,把 Opus 换成 Sonnet |
| Usage credits required for 1M context | 1M 上下文需要 usage credits | 用 /model 切回标准上下文 |
| Codex 提示 usage limit(用量已达上限) | Codex 的 5 小时或每周额度用完 | 等待 / 购买 credits / 用 API Key |
| 429 / rate limited(在 aicodewith 上) | 请求频率超出我们的速率限制 | 降低并发后重试,见 429 排查 |
常见问题
Claude Max 有用量上限吗?
有。每档都有每 5 小时重置的会话额度和每周额度,Anthropic 还保留以其他方式限制的权利。
Max 20x 每周能用多少?
官方只公布每 5 小时是 Pro 的 20 倍,不公布每周具体额度,以 Settings > Usage 显示为准。
Claude Code 和网页版额度是分开的吗?
不分开。claude.ai、桌面端和 Claude Code 共用同一个额度池。
每周限额什么时候重置?
每个账号有固定的每周重置时间,可在 Settings > Usage 查看,与订阅开始时间无关。
Max 附带的 API credits 能用在 Claude Code 吗?
不能。官方说明这部分只能用于 Claude Platform,不能用于 Claude Code 或 usage credits。
改用按量 API 后还受 5 小时限制吗?
按量 API 从你的余额按实际 token 扣费,不占用 Claude 订阅的 5 小时 / 每周额度。它仍有速率和并发限制(以我们的文档为准),你也可以给每把 API Key 设消费上限。
aicodewith 和 Anthropic 是什么关系?
aicodewith 是独立的第三方 API 服务,与 Anthropic 没有隶属或合作关系。Claude 是 Anthropic 的商标。
按量一定比 Max 便宜吗?
不一定。能稳定用满 Max 的话订阅通常更划算;按量更适合溢出、突击和需要按 Key 记账的团队。
1 分钟把 Claude Code 切到 aicodewith
按量 API 按 token 计费,但仍有速率和并发限制,具体以我们的文档为准;你也可以给每把 API Key 设日 / 月 / 总消费上限。
相关阅读
官方来源
- claude.com/pricing
- What is the Max plan? (Claude Help Center)
- Use Claude Code with your Pro or Max plan
- How do usage and length limits work?
- Manage usage credits for paid Claude plans
- Claude Code docs: errors
- Claude Code docs: costs
- Codex pricing (OpenAI)
- Using Codex with your ChatGPT plan (OpenAI Help)
Claude、Claude Code 为 Anthropic PBC 的商标;ChatGPT、Codex 为 OpenAI 的商标。本页与 Anthropic、OpenAI 无关联,也未获其认可。限额信息来自官方公开文档,核对于 2026-10-10,可能随时变化。