[DOCS] Rate-limit options dialog is undocumented

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

The built-in commands reference entries for /extra-usage and /usage, plus any user-facing usage-limit guidance that explains what happens when a user actually hits their limit.

Current Documentation

The commands page currently says:

/extra-usage | Configure extra usage to keep working when rate limits are hit

and:

/usage | Show plan usage limits and rate limit status

No documentation currently explains that Claude Code shows a rate-limit options dialog when a user hits their usage limit, what choices that dialog presents, or how it relates to /extra-usage.

What's Wrong or Missing?

The docs mention commands related to rate limits, but they do not document the actual user-facing dialog that appears when a usage limit is reached.

That leaves users without guidance on:

1. When the rate-limit options dialog appears.
2. What options it offers.
3. How it relates to /extra-usage and /usage.
4. Whether the dialog appearing automatically is expected behavior or a bug.

This is now a documented product surface in practice, not a one-off internal UI detail. The v2.1.90 changelog includes:

"Fixed an infinite loop where the rate-limit options dialog would repeatedly auto-open after hitting your usage limit, eventually crashing the session"

That release note confirms the dialog is a real, recurring user-facing part of the product, but the docs still never describe it.

Suggested Improvement

Add a short note to the /extra-usage and /usage documentation explaining that when Claude Code hits a usage limit, it can show a rate-limit options dialog.

That note should explain:

1. When the dialog appears.
2. That it helps the user choose what to do next after hitting a limit.
3. That /extra-usage is the command for configuring extra usage outside the dialog as well.
4. That /usage lets users check their status proactively before the dialog appears.

If there is a more appropriate page for usage-limit behavior, the commands page should at least link to it from /extra-usage and /usage.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/commands | /extra-usage and /usage are documented, but the rate-limit options dialog itself is never explained |

Total scope: 1 page affected

Source: Changelog v2.1.90

"Fixed an infinite loop where the rate-limit options dialog would repeatedly auto-open after hitting your usage limit, eventually crashing the session"