「API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context」
更新于
「API Error: Usage credits required for 1M context …」表示你选的模型使用 1M token 上下文，而你的套餐只能通过 usage credits 使用它。Error reference 称之为权益检查而非额度用尽：额度有余量也会触发。等重置没用，/model 或 /usage-credits 才有用。
- 上次重置
- 09-04 20:08Z
- 状态
- 已超期
距上次重置已超过近期中位间隔的 1.5 倍。
- 预计下次
- 随时
- 距今天数
- 13.1
天
「API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context」是什么意思？
所选模型使用 1M token 的扩展上下文，而你的套餐只能通过 usage credits 使用它。Error reference 写得很清楚：「This is an entitlement check, not a quota exhaustion. It fires even when your session and weekly allowances have capacity remaining.」
Claude Code 在你用 /model 选模型时做这项检查，且只在直连 Anthropic API 时做。如果是对话中途上下文超过 200K token 才出现，现在的版本会自动把对话压缩回标准上限；v2.1.172 之前它会在每次请求时重复出现，只能用 /clear 恢复。
文案变过。v2.1.268 之前结尾是「run /usage-credits to turn them on, or /model to switch to standard context」，不提重启。issue #61828（2026 年 5 月）里还有更早的变体，让用户去 claude.ai/settings/usage 开通 usage credits 或用 --model；那条 issue 以「Usage limit reached」上报，而会话用量只有 2%、周用量 32%。
满的是哪个窗口？
| 窗口 | 何时刷新 | 在哪里看 |
|---|---|---|
| 没有：这是权益检查，不是用量窗口 | 不会刷新；这个错误与你用了多少无关 | /usage 显示会话与周进度条，它们仍会有余量 |
看到它该怎么办
- 运行 /model 选不带 [1m] 的模型
这样回到标准上下文窗口，是文档的第一步。
- 或者开通 usage credits
文案里提到 /usage-credits 时，运行它在 Pro / Max 上为 1M 变体开通按量计费，或在 Team / Enterprise 上向管理员申请。之后重启 Claude Code；重启前会话仍停在标准上限。
- 检查 1M 模型设在哪里
如果 /model 之后仍报错，可能有更高优先级的配置位置设了 1M 模型 ID；文档在 Setting your model 一节列出了这些位置。
- 把 1M 变体从选单里去掉
设置 CLAUDE_CODE_DISABLE_1M_CONTEXT=1，/model 里就不再出现 [1m] 模型。
什么时候重置？
你自己的窗口：这个错误不是窗口满了引起的，所以任何刷新都清不掉它。会话限额照常每 5 小时刷新、周限额在固定时刻刷新，帮助中心也说明 usage credits 不影响这个时间；解决办法是换模型或开通 usage credits，不是等。
全员重置：官方重置也不会改变套餐权益。上方板面记录的是 Anthropic 宣布的重置，每条链接原帖；没有哪一次会给只能靠 usage credits 用 1M 的套餐打开 1M 上下文。
相关报错
常见问题
等会话或周限额刷新能解决吗？
不能。Error reference 写明这是权益检查而非额度用尽，会话与周额度还有余量时也会触发。用 /model 切到标准上下文的模型，或开通 usage credits。
为什么 /usage 显示 2% 它却说 usage limit reached？
因为旧文案容易误读。issue #61828（2026-05-23）以「Usage limit reached」上报，会话用量 2%、周用量 32%；那份报告里的文案是更早的 1M 上下文变体，指向 claude.ai/settings/usage 与 --model。现在的版本写的是「Usage credits required for 1M context」。
v2.1.268 改了什么？
现在的文案会说明 credits 在重启 Claude Code 后生效。v2.1.268 之前结尾是「run /usage-credits to turn them on, or /model to switch to standard context」，不提重启。
长会话中途出现，需要做什么吗？
通常不需要。上下文超过 200K token 时，现在的版本会自动把对话压缩回标准上限并保持在那里。v2.1.172 之前它会在每次请求（包括 /compact）时重复出现，要用 /clear 恢复。
来源
- Claude Code docs: Error reference — "Usage credits required for 1M context"核实于 2026-09-18
- anthropics/claude-code issue #61828 (2026-05-23): [BUG] Claude Code shows 'Usage limit reached' despite session at 2% and weekly at 32% (older 1M-context wording)核实于 2026-09-17
- Claude Code docs: Error reference — "You've hit your session limit"核实于 2026-09-18
- Claude Help Center: Manage usage credits for paid Claude plans核实于 2026-09-17