在 Claude Code 中遇到限制时,并非所有任务都必须迁移到 API。首先通过 /status 确认当前会话是使用订阅额度还是通过 API 密钥计费,情况就会有所不同。这并非为了绕过限制,而是通过理解按模型划分的限制和认证优先级,减少工作流中断的方法。
限制分为三类单独计算
Claude Code 的使用限制分为三种类型,且各自独立消耗 1。
- 会话限额:每 5 小时重置一次的短期限制。
- 每周总限额:将所有模型的使用量合并,按周计算。
- 每周模型限额:顶级模型另有单独的每周限制 1。
如果不了解此结构,仅凭“额度已满”这一句话很难理解整体情况。根据实际用户观察案例,Max 5x 计划用户的界面曾显示会话额度为 4%,每周总额度为 69%,每周模型(Fable)额度为 89% 2。也就是说,即使特定模型的额度即将耗尽,每周总额度可能仍有余量。
此外,网页聊天、桌面应用和 Claude Code 的使用量都会计入同一额度 2。如果频繁使用 Claude 聊天,用于编写代码的剩余额度也会随之减少。相反,运行多个子代理的复杂任务可能会在 5 小时会话重置之前先耗尽每周额度 1。

通过切换模型继续工作的情况

遇到限制时,首先要确认的是触达了“哪种限制”。
仅触发模型限额时
如果达到了仅适用于顶级模型(如 Opus、Sonnet、Fable 等)的单独每周限制,可以在 Claude Code 会话中使用 /model 命令切换到其他系列的模型,立即继续工作 1。正如前面提到的案例,当每周模型额度为 89% 但每周总额度为 69% 时,可以切换到尚有余量的其他模型,在总额度范围内继续工作 2。
但需要注意的是,每个模型的提示词缓存是分离的,因此切换后的第一个请求需要在没有缓存的情况下重新读取现有对话内容。在长对话会话中,可能会产生这一次的处理成本 3。
触发会话或每周总限额时
会话限额和每周总限额由所有模型共享。因此,当达到这两个限制时,即使切换到轻量级模型,工作仍会被阻止 1。不过,使用比平时更轻量级的模型可以减缓额度消耗的速度。
‘使用额度’并非重置权,而是转为按量付费
如果切换模型无法解决会话或每周额度区间的问题,可以使用‘使用额度’功能。
该功能容易让人误解其名称,它并不是将已经耗尽的额度重置为零。根据 Anthropic 客户支持说明,使用额度是指“在达到计划使用限额后,转为按量付费价格以继续工作”的功能 3。也就是说,这是一个将计费方式从被阻止切换为标准 API 费率的开关。
利用自动继续功能
等待而不使用额度也是一种方法。从 Claude Code v2.1.234 版本开始,默认启用了等待至重置时间自动恢复任务的功能 3。
- 如果保持会话开启,底部会出现类似
Usage limit reached · continuing automatically at 3:45pm的消息,并将在重置时间自动恢复之前停止的任务。 - 如果电脑休眠超过 30 分钟,则需要按
Enter键才能恢复。 - 如果距离重置时间还有 24 小时以上(如每周额度),或者是在后台运行的情况下,自动恢复不会生效 3。
启用使用额度后,除了订阅费用外还会单独计费。由于 Claude Code 每次请求都会发送整个对话,对话越长,令牌费用可能会越高。为避免意外支出,建议提前设置每月支出限额(spend limits) 3。
7 级认证优先级决定计费路径

在同时使用订阅和 API 密钥的环境中,计费路径可能会意外地被设置为 API。Claude Code 不会自动切换路径,而是从设置的凭证中选择优先级最高的一个。
截至 2026 年 10 月 10 日,认证文档中整理的优先级如下 4。
| 顺序 | 设置的凭证 | 计费路径 |
|---|---|---|
| 1 | CLAUDE_CODE_USE_BEDROCK 等云提供商变量 | AWS、Google Cloud、Azure 账户 |
| 2 | ANTHROPIC_AUTH_TOKEN | 发行该令牌的网关/代理 |
| 3 | ANTHROPIC_API_KEY | Console API 额度(预付费) |
| 4 | apiKeyHelper 脚本 | 脚本返回密钥的组织 |
| 5 | CLAUDE_CODE_OAUTH_TOKEN | 订阅计划用量(手动令牌) |
| 6 | 配置文件/联合身份凭证 | 发行该凭证的组织 |
| 7 | /login 订阅 OAuth | 订阅计划用量(默认值) |
如果环境变量中残留了 ANTHROPIC_API_KEY(第 3 级),并且通过 /login 登录了订阅(第 7 级),请求将由 API 密钥处理。
在笔记本电脑上进行对话时使用订阅,而后台自动化脚本会产生 API 费用并导致支出,原因就在于此。若要确认当前会话使用的是哪种凭证,可在 Claude Code 中输入 /status。如果登录信息和 API 密钥都存在,当前未使用的一方会显示为‘未使用’ 4。
使用订阅额度运行脚本:setup-token
如果希望自动化任务也能在订阅额度内处理而不产生 API 费用,可以使用 claude setup-token。此命令会为订阅认证生成一个 OAuth 令牌,生成的令牌仅显示在屏幕上,不会被保存。
# 1. 토큰 발급 후 복사
claude setup-token
# 2. 환경 변수에 저장하고, 기존 API 키는 삭제하여 우선순위 충돌 방지
export CLAUDE_CODE_OAUTH_TOKEN="복사한_토큰"
unset ANTHROPIC_API_KEY
# 3. 구독 한도로 실행 확인
claude -p "테스트 실패 원인을 요약해 줘"这里 unset ANTHROPIC_API_KEY 非常重要。由于 ANTHROPIC_API_KEY(第 3 级)的优先级高于 CLAUDE_CODE_OAUTH_TOKEN(第 5 级),如果残留 API 密钥,仍会收取 API 费用 4。
通过代理配置模型分离

与额度管理无关,如果希望根据任务类型分配不同的模型,可以利用 LiteLLM 等代理。将 Claude Code 的 ANTHROPIC_BASE_URL 设置为代理服务器地址,并将 ANTHROPIC_AUTH_TOKEN 设置为发行的虚拟密钥,请求就会经过代理 56。
使用此方式,可以将高价模型(如 Opus)原样通过原始 API 传递,并将低价模型(如 Haiku)路径映射到 DeepSeek 等替代模型 75。这样,可以在保留 Claude Code 内部子代理功能的同时,仅让产生费用的主要对话使用高级模型 7。不过,使用代理时,由于 ANTHROPIC_AUTH_TOKEN 属于优先级第 2 级,因此必须明确费用将向网关运营商而非订阅收取 4。
结论:首先通过 /status 确认当前路径
Claude Code 中的额度管理不仅仅是调节使用量,而是控制请求通过哪种凭证发出。如果触发了模型限额,可以通过 /model 切换到其他模型。如果是会话或每周总限额,则需要通过额度转为按量付费或等待自动恢复。
首先要做的是打开 /status,确认当前认证方式是订阅还是 API 密钥。如果意外地通过 API 计费,请追踪 .env 文件、settings.json 等位置是否有密钥被注入。
参考资料
- 클로드(Claude) 사용량 리셋 시간 정리: 5시간 세션 한도·주간 한도 리셋 규칙, 사용량 확인, 한도 걸렸을 때 선택지 · techworklog.com↩
- 클로드 코드 사용량 한도, 세션·주간·모델별로 따로 찬다 · sylabkr.com↩
- ↩
- Claude Code API 키와 구독 결제: 키를 승인하면 API 과금, -p는 항상 키 · blog.laozhang.ai↩
- Claude Code Quickstart | liteLLM · docs.litellm.ai↩
- Claude Code (CLI) | liteLLM · docs.litellm.ai↩
- 클로드에 딥시크 물부어먹는법 · gall.dcinside.com↩




