[DOCS] VS Code `/context` command missing native token usage dialog behavior

Open 💬 4 comments Opened Apr 28, 2026 by coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

/context command behavior in VS Code, especially in the prompt box / command menu guidance

Current Documentation

The VS Code page 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. Context indicator: the prompt box shows how much of Claude's context window you're using. Claude automatically compacts when needed, or you can run /compact manually.

The commands reference currently says:

| /context | Visualize current context usage as a colored grid. Shows optimization suggestions for context-heavy tools, memory bloat, and capacity warnings |

But the changelog for v2.1.121 says:

[VSCode] /context now opens a native token usage dialog

What's Wrong or Missing?

The docs still describe /context with the terminal-style colored-grid behavior and do not explain the VS Code-specific UI change introduced in v2.1.121.

For VS Code users, the main integration page does not mention that /context now opens a native token usage dialog, so the feature is harder to discover from the command menu and harder to recognize when troubleshooting context pressure.

Suggested Improvement

Update the VS Code docs to document the new behavior explicitly:

  1. In vs-code, add /context alongside /usage in the command menu description.
  2. Add a short note near the context indicator explaining that running /context in VS Code opens the native token usage dialog for a more detailed view.
  3. In the commands reference, keep the general /context description but add a VS Code note that this command opens a native token usage dialog there instead of the inline terminal visualization.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/vs-code | VS Code command menu and context indicator bullets omit the /context dialog behavior |
| https://code.claude.com/docs/en/commands | /context is described as a colored grid without a VS Code-specific note |
| https://code.claude.com/docs/en/errors | Troubleshooting tells users to run /context to inspect context pressure, but does not clarify how this appears in VS Code |

Total scope: 3 pages affected

Source: Changelog v2.1.121

Exact changelog entry: [VSCode] /context now opens a native token usage dialog

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗