【Claude】Usage credits required for 1M context 报错已解决关键词Claude Code、1M context、100万上下文、usage credits、扩展上下文、[1m] 模型、CLAUDE_CODE_DISABLE_1M_CONTEXT一、问题现象用着用着上下文升级被拦截你选了一个带[1m]后缀的模型或者对话上下文自然增长超过了 200K Token然后终端出现API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context翻译使用 1M100 万 Token上下文功能需要使用信用Usage Credits请运行/usage-credits开启或用/model切回标准上下文窗口。这个报错的特征出现在你主动选了[1m]模型或对话上下文意外超过 200K Token时消息里有Usage credits required需要使用信用提供了两条出路开启 Usage Credits 或切回标准模型。二、1M 上下文是什么为什么要收费2.1 标准上下文 vs 1M 上下文上下文规格Token 容量对应场景标准上下文约 200K Token绝大多数日常编码任务1M 扩展上下文约 100 万 Token分析整个代码仓库、处理超大文档1M 上下文能让 Claude 一次性看到更多内容——整个项目的所有文件、多个长文档并排处理——非常适合大规模代码重构或知识库检索。但它对推理资源的消耗也大幅高于标准上下文所以 Anthropic 不把它包含在所有计划的基础配额里。2.2 哪些计划直接包含 1M 上下文根据官方文档请以 claude.com/pricing 最新说明为准部分高级计划直接包含 1M 上下文无需额外付费Pro / Max 等计划1M 上下文变体需要通过使用信用Usage Credits的计量计费来启用Team / Enterprise由管理员控制是否开启。2.3 这是权利检查不是配额耗尽这是很多人的误区这个错误不是额度用完了而是这项功能你还没开启。即使你的会话额度、每周额度还有大把剩余只要没有开启 1M 上下文的计量计费它就会触发。三、两种触发场景场景一主动选了[1m]模型你在/model里手动选了claude-sonnet-4-6 [1m]或类似带[1m]后缀的模型然后每次发请求都报这个错。场景二对话上下文超过 200K Token自动触发你用的是普通模型但对话跑着跑着上下文积累超过了 200K Token 的阈值Claude Code 试图自动切换到 1M 模式来容纳更多内容触发了这个权利检查。这里有一个重要的版本差异v2.1.172 及以后当对话中途触发这个错误上下文超过 200KClaude Code 会自动把对话压缩回标准上下文限制以下并在之后把会话保持在标准限制内——无需你做任何操作它自己处理好了v2.1.172 之前的旧版本错误会在每个后续请求包括/compact上反复出现。如果你在旧版本上运行/clear来恢复。四、解决方案方案一切回标准上下文模型最简单如果你不需要 1M 上下文直接切回标准版/model在列表里选不带[1m]后缀的模型变体即可。标准 200K 上下文对绝大多数编码任务完全够用。方案二开启 Usage Credits 的计量计费如果你确实需要 1M 上下文通过使用信用开启/usage-creditsPro / Max 用户运行这个命令按实际使用的扩展上下文计量计费Team / Enterprise 用户需要向组织管理员申请开启。开启后1M 模型变体正常使用按超出标准上下文的部分计费。方案三升级版本旧版用户如果你在用v2.1.172 之前的版本且对话中途触发了这个错误并循环报错claude update更新到最新版本后Claude Code 会自动处理对话超过 200K 时的压缩这个循环报错就消失了。方案四查找并清理过时的 1M 模型 ID切回标准模型后如果错误仍然存在说明某处还在强制设置 1M 模型 ID。按优先级检查以下位置--model命令行标志看你启动 claude 的命令ANTHROPIC_MODEL环境变量env | grep ANTHROPIC_MODEL.claude/settings.local.json里的model字段项目的.claude/settings.json里的model字段全局~/.claude/settings.json里的model字段。找到对应[1m]的模型 ID删除或改为标准别名如sonnet、opus。方案五从模型选择器中完全移除 1M 选项如果你永远用不到 1M 上下文可以让它从/model列表里彻底消失export CLAUDE_CODE_DISABLE_1M_CONTEXT1写入~/.claude/settings.json的env块可以永久生效{ env: { CLAUDE_CODE_DISABLE_1M_CONTEXT: 1 } }五、验证与回归切模型后测试运行/model确认当前模型无[1m]后缀发一个普通请求确认不再触发开启 Usage Credits 后测试选[1m]模型发请求确认正常返回清理过时 ID 后/status确认当前活跃凭证和模型配置。六、避坑与最佳实践❌不要以为是额度耗尽这是功能权利检查剩多少额度都一样要么开启计量计费要么切回标准模型❌旧版本不要无脑/compactv2.1.172 前/compact也会触发直接/clear✅日常用标准模型200K 对编码任务足够1M 按需开避免意外计费✅明确知道 1M 用途再开整库分析、大文档处理才真的需要普通任务没必要。七、总结Usage credits required for 1M context是1M 扩展上下文的权利检查不是配额耗尽。主动用了[1m]模型 → 开启 Usage Credits 或切回标准对话中途超过 200K 自动触发 → v2.1.172 自动压缩处理旧版/clear切回标准后仍报错 → 按优先级查清所有可能设置了[1m]ID 的地方永久不用 1M →CLAUDE_CODE_DISABLE_1M_CONTEXT1。参考Claude Code 官方《错误参考》使用限制章节、官方扩展上下文文档、claude.com/pricing。 【Claude】Usage credits required for 1M context 报错已解决
【Claude】Usage credits required for 1M context 报错已解决关键词Claude Code、1M context、100万上下文、usage credits、扩展上下文、[1m] 模型、CLAUDE_CODE_DISABLE_1M_CONTEXT一、问题现象用着用着上下文升级被拦截你选了一个带[1m]后缀的模型或者对话上下文自然增长超过了 200K Token然后终端出现API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context翻译使用 1M100 万 Token上下文功能需要使用信用Usage Credits请运行/usage-credits开启或用/model切回标准上下文窗口。这个报错的特征出现在你主动选了[1m]模型或对话上下文意外超过 200K Token时消息里有Usage credits required需要使用信用提供了两条出路开启 Usage Credits 或切回标准模型。二、1M 上下文是什么为什么要收费2.1 标准上下文 vs 1M 上下文上下文规格Token 容量对应场景标准上下文约 200K Token绝大多数日常编码任务1M 扩展上下文约 100 万 Token分析整个代码仓库、处理超大文档1M 上下文能让 Claude 一次性看到更多内容——整个项目的所有文件、多个长文档并排处理——非常适合大规模代码重构或知识库检索。但它对推理资源的消耗也大幅高于标准上下文所以 Anthropic 不把它包含在所有计划的基础配额里。2.2 哪些计划直接包含 1M 上下文根据官方文档请以 claude.com/pricing 最新说明为准部分高级计划直接包含 1M 上下文无需额外付费Pro / Max 等计划1M 上下文变体需要通过使用信用Usage Credits的计量计费来启用Team / Enterprise由管理员控制是否开启。2.3 这是权利检查不是配额耗尽这是很多人的误区这个错误不是额度用完了而是这项功能你还没开启。即使你的会话额度、每周额度还有大把剩余只要没有开启 1M 上下文的计量计费它就会触发。三、两种触发场景场景一主动选了[1m]模型你在/model里手动选了claude-sonnet-4-6 [1m]或类似带[1m]后缀的模型然后每次发请求都报这个错。场景二对话上下文超过 200K Token自动触发你用的是普通模型但对话跑着跑着上下文积累超过了 200K Token 的阈值Claude Code 试图自动切换到 1M 模式来容纳更多内容触发了这个权利检查。这里有一个重要的版本差异v2.1.172 及以后当对话中途触发这个错误上下文超过 200KClaude Code 会自动把对话压缩回标准上下文限制以下并在之后把会话保持在标准限制内——无需你做任何操作它自己处理好了v2.1.172 之前的旧版本错误会在每个后续请求包括/compact上反复出现。如果你在旧版本上运行/clear来恢复。四、解决方案方案一切回标准上下文模型最简单如果你不需要 1M 上下文直接切回标准版/model在列表里选不带[1m]后缀的模型变体即可。标准 200K 上下文对绝大多数编码任务完全够用。方案二开启 Usage Credits 的计量计费如果你确实需要 1M 上下文通过使用信用开启/usage-creditsPro / Max 用户运行这个命令按实际使用的扩展上下文计量计费Team / Enterprise 用户需要向组织管理员申请开启。开启后1M 模型变体正常使用按超出标准上下文的部分计费。方案三升级版本旧版用户如果你在用v2.1.172 之前的版本且对话中途触发了这个错误并循环报错claude update更新到最新版本后Claude Code 会自动处理对话超过 200K 时的压缩这个循环报错就消失了。方案四查找并清理过时的 1M 模型 ID切回标准模型后如果错误仍然存在说明某处还在强制设置 1M 模型 ID。按优先级检查以下位置--model命令行标志看你启动 claude 的命令ANTHROPIC_MODEL环境变量env | grep ANTHROPIC_MODEL.claude/settings.local.json里的model字段项目的.claude/settings.json里的model字段全局~/.claude/settings.json里的model字段。找到对应[1m]的模型 ID删除或改为标准别名如sonnet、opus。方案五从模型选择器中完全移除 1M 选项如果你永远用不到 1M 上下文可以让它从/model列表里彻底消失export CLAUDE_CODE_DISABLE_1M_CONTEXT1写入~/.claude/settings.json的env块可以永久生效{ env: { CLAUDE_CODE_DISABLE_1M_CONTEXT: 1 } }五、验证与回归切模型后测试运行/model确认当前模型无[1m]后缀发一个普通请求确认不再触发开启 Usage Credits 后测试选[1m]模型发请求确认正常返回清理过时 ID 后/status确认当前活跃凭证和模型配置。六、避坑与最佳实践❌不要以为是额度耗尽这是功能权利检查剩多少额度都一样要么开启计量计费要么切回标准模型❌旧版本不要无脑/compactv2.1.172 前/compact也会触发直接/clear✅日常用标准模型200K 对编码任务足够1M 按需开避免意外计费✅明确知道 1M 用途再开整库分析、大文档处理才真的需要普通任务没必要。七、总结Usage credits required for 1M context是1M 扩展上下文的权利检查不是配额耗尽。主动用了[1m]模型 → 开启 Usage Credits 或切回标准对话中途超过 200K 自动触发 → v2.1.172 自动压缩处理旧版/clear切回标准后仍报错 → 按优先级查清所有可能设置了[1m]ID 的地方永久不用 1M →CLAUDE_CODE_DISABLE_1M_CONTEXT1。参考Claude Code 官方《错误参考》使用限制章节、官方扩展上下文文档、claude.com/pricing。