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$100Pro 的 5 倍(每 5 小时)有(不公布具体值)Fable 另有单独周限额;含 $100/月 API credits,不能用于 Claude Code
Claude Max 20x$200Pro 的 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. 1

    每一轮都会重发整段对话

    读过的文件、工具输出、diff 都会随每条消息再计一次。会话开得越久,每一轮越“重”。

  2. 2

    Opus 比 Sonnet 耗得多

    官方建议日常编码用 Sonnet,难题再用 Opus;也可以用 /model opusplan(Opus 做规划、Sonnet 执行)。

  3. 3

    子 agent、agent 团队、定时任务各自消耗额度

    官方文档提到,agent 团队在 plan 模式下大约消耗 7 倍 token。

  4. 4

    缓存失效

    离开超过缓存寿命再回来,第一条消息要重新处理全部上下文。

  5. 5

    上下文越来越大

    大段粘贴、挂了很多 MCP 工具、CLAUDE.md 太长,都会让每一轮变大。

省额度:换任务时用 /clear,长任务中途用 /compact,用 /usage 看是哪类操作耗得最多。

撞上限后的 4 个选项

没有哪个选项永远最好,按你的用量和时间要求选。

选项怎么做代价适合谁
等重置看提示里的 resets 时间;Claude Code v2.1.234+ 可以在会话里自动等待并继续时间不赶工
升档Pro → Max 5x → Max 20x$100–$200/月,仍有每周上限每周都能用满的人
官方 usage creditsSettings > 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 天 / 月
常规15M0.6M0.15M0.15M$9.60$211
重度40M1.2M0.3M0.4M$23.20$510
极重度(多 agent / 长会话)120M3M0.8M1.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

查看 Claude 模型价格|/pricing

和订阅比

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. 1. 创建 API Key

    在 aicodewith 控制台创建 API Key。可以给这把 Key 设日 / 月消费上限。

  2. 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. 3. 重启并验证

    重启 Claude Code,发一条消息;用 /model 选 Opus 5.5 或 Sonnet 5.5;到 aicodewith 用量记录里确认请求已经到达。

只要环境里设了 API Key,Claude Code 就会优先走 API 计费,不再使用订阅额度。

想切回订阅

删掉上面的 env,在 Claude Code 里运行 /login。

Codex 用户:config.toml 配置教程

限额报错速查

Claude Code 的提示原文来自官方 errors 文档。

你看到的提示含义怎么办
You've hit your session limit · resets 3:45pm5 小时会话额度用完(跨模型)等待 / 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 context1M 上下文需要 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、Claude Code 为 Anthropic PBC 的商标;ChatGPT、Codex 为 OpenAI 的商标。本页与 Anthropic、OpenAI 无关联,也未获其认可。限额信息来自官方公开文档,核对于 2026-10-10,可能随时变化。