[DOCS] VS Code docs missing rate limit warning banner with usage percentage and reset time

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/vs-code

Section/Topic

VS Code extension rate-limit feedback in the prompt UI, especially the prompt-box command menu, the "Run multiple conversations" status descriptions, and the "Claude Code never responds" troubleshooting section

Current Documentation

The VS Code guide currently says:

* Command menu: click / or type / to open the command menu. Options include attaching files, switching models, toggling extended thinking, viewing plan usage (/usage), and starting a Remote Control session (/remote-control). The Customize section provides access to MCP servers, hooks, memory, permissions, and plugins. Items with a terminal icon open in the integrated terminal.

And in the tab-status section:

When using tabs, a small colored dot on the spark icon indicates status: blue means a permission request is pending, orange means Claude finished while the tab was hidden.

And the troubleshooting section currently says:

### Claude Code never responds If Claude Code isn't responding to your prompts: 1. Check your internet connection: Ensure you have a stable internet connection 2. Start a new conversation: Try starting a fresh conversation to see if the issue persists 3. Try the CLI: Run claude from the terminal to see if you get more detailed error messages

No documentation currently explains that the VS Code extension can show a rate limit warning banner with usage percentage and reset time.

What's Wrong or Missing?

Claude Code v2.1.84 added a VS Code rate limit warning banner:

[VSCode] Added rate limit warning banner with usage percentage and reset time

The current docs explain how to open /usage, describe two tab-status indicators, and give generic troubleshooting steps, but they never mention the automatic warning banner itself. Users who see this banner in VS Code are not told:

1. what the banner means,
2. what the displayed usage percentage refers to,
3. what the reset time refers to, or
4. where to go for more detailed rate-limit status.

That leaves a user-facing VS Code warning state undocumented even though the extension now surfaces it directly in the UI.

Suggested Improvement

Add a short note to the VS Code guide, and the mirrored IDE integrations page, explaining the banner and linking it to /usage.

Suggested wording:

Rate limit warning: In VS Code, Claude Code can show a warning banner with your current usage percentage and the reset time for the relevant rate-limit window. Use /usage for full plan usage details and current rate-limit status.

This would fit naturally either near the prompt-box command menu (where /usage is introduced) or in the troubleshooting section where users look for explanations of unexpected UI states.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/vs-code | Primary VS Code extension guide; documents /usage, tab-status indicators, and troubleshooting, but not the automatic rate limit warning banner |
| https://code.claude.com/docs/en/ide-integrations | Duplicate IDE integrations page with the same missing VS Code banner explanation |

Total scope: 2 pages affected

Related reference:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/commands | /usage is already documented here as: "Show plan usage limits and rate limit status" |

Source: Changelog v2.1.84

Exact changelog entry:

[VSCode] Added rate limit warning banner with usage percentage and reset time