它到底是什么

/rate-limit-options 不是"配置用量上限"的命令。它是用户碰到订阅 usage limit（用量上限）时使用的选项菜单，用来决定接下来怎么办。官方文档里明确提到它的地方是"等待用量窗口重置后自动继续"这个功能：开发者可以从 /rate-limit-options 里选择等待重置并自动继续被中断的任务。

官方 Manage costs 页面的原文要点：

• 在 Claude Code v2.1.234 或更高版本上，可以等待并在重置后自动继续被中断的任务。
• 这个等待有两种触发方式：Claude Code 自己启动，或开发者从 /rate-limit-options 里选择。
• 管理员可以在 managed settings 里设置 autoContinueAtUsageLimit，控制 Claude Code 是否自行启动这个等待。

它针对的是订阅计划（Pro/Max/Team/Enterprise）的 seat-based usage window。官方文档把这类提示归为"You've hit your session limit / weekly limit"。它不是 API 429 限流的处理命令。

怎么触发 / 怎么使用

/rate-limit-options

搜索结果里的信息（未在官方页面逐字核到）是：命中用量上限后，交互式订阅会话会显示类似 Usage limit reached · continuing automatically at [time] · esc to cancel 的提示。按 Esc，或运行 /rate-limit-options 并选择 "Don't continue automatically"，即可取消自动继续。同一个菜单也可以重新启动等待。

保存 / 配置 / 集成

官方 Settings reference 中的 autoContinueAtUsageLimit:

Costs 页面建议，想在整个团队范围内控制这个行为的管理员，把它放在 managed settings 里。

运行约束 / 限制

跟同类原语对比

常见坑

1. 历史 bug:Issue #14129 报告，在 Claude Code 2.0.67（macOS、VS Code 集成终端、Anthropic API）上，会话因上下文上限重置后，/rate-limit-options 会被反复自动执行。终端不断刷新，用户被迫运行 /compact，消耗了 20% 以上的 token。该 issue 已作为 #41719 的重复项关闭。
2. 别把它当成设置用量上限的命令。要调整额度，应使用 /usage-credits（订阅用户），或在 Console 或 Teams/Enterprise 的 admin settings 里设置 spend limit。

来源

• Manage costs effectively - Claude Code Docs
• Settings reference - Claude Code Docs
• Issue #14129: /rate-limit-options command repeatedly auto-executes after session reset