Skip to content

claude-usage-and-rate-limits.md

Latest commit

 

History

History
108 lines (69 loc) · 3.8 KB

claude-usage-and-rate-limits.md

File metadata and controls

108 lines (69 loc) · 3.8 KB

Claude Code：使用量、速率限制与额外用量

了解 Claude Code 中的使用量限制如何运作，以及如何在达到限制时继续工作。

← 返回 Claude Code 最佳实践 Claude

概述

订阅计划（Pro、Max 5x、Max 20x）上的 Claude Code 具有在滚动窗口上重置的使用量限制。三个内置斜杠命令帮助你监控和管理使用量：

命令 描述 适用于
/usage 检查计划限制和速率限制状态 Pro、Max 5x、Max 20x
/extra-usage 在达到限制时配置按量付费溢出 Pro、Max 5x、Max 20x
/cost 显示当前会话的 Token 使用量和支出 API 密钥用户

/usage —— 检查你的限制

显示你当前计划的使用量限制和速率限制状态。可用于检查在达到限制前还剩多少容量。

/extra-usage —— 在限制之外继续工作

/extra-usage 命令配置按量付费溢出计费，以便当你达到计划的速率限制时，Claude Code 可以继续无缝工作，而不是阻止你。

工作原理

  1. 你达到计划的速率限制（限制每 5 小时重置）
  2. 如果启用了额外用量且有可用资金，Claude Code 会继续不间断运行
  3. 溢出 Token 按标准 API 费率计费，与你的订阅费分开

设置

CLI 中的 /extra-usage 命令将指导你完成配置。你也可以在 claude.ai 上的设置 > 使用量网页上配置：

  1. 启用额外用量
  2. 添加支付方式
  3. 设置每月支出上限（或选择无限制）
  4. 可选地添加预付费资金，当余额低于阈值时自动充值

关键细节

详情 值
每日兑换限制 $2,000/天
计费 与订阅分开，按标准 API 费率
限制重置窗口 每 5 小时

已知问题

截至 2026年2月，/extra-usage CLI 命令是未记录的，可能会在没有明确配置选项的情况下打开登录窗口。目前通过 claude.ai 网页界面配置是更可靠的路径。

/cost —— 会话支出（API 用户）

对于使用 API 密钥认证的用户（非订阅计划），/cost 显示：

  • 当前会话的总成本
  • API 持续时间和实际时间
  • Token 使用量细分
  • 代码更改

此命令与 Pro/Max 订阅用户无关。

快速模式与额外用量

快速模式（/fast）使用 Claude Opus 4.6 并提供更快的输出。它与额外用量有特殊的计费关系：

  • 快速模式使用量始终计费到额外用量，从第一个 Token 开始
  • 即使你在订阅计划上还有剩余使用量，这也适用
  • 快速模式不会消耗你计划的包含速率限制

这意味着你需要启用并注资额外用量才能使用 /fast。

CLI 启动标志

两个启动标志与使用量预算相关（仅 API 密钥用户，打印模式）：

标志 描述
--max-budget-usd <AMOUNT> API 调用前停止的最大美元金额
--max-turns <NUMBER> 限制 Agent 回合数

有关完整列表，请参阅 CLI 启动标志参考。

来源
⚡