[DOCS] [VS Code] Account & usage dialog `/usage` now shows per-skill/agent/plugin/MCP cache and long-context attribution, but neither `vs-code.md` nor `monitoring-usage.md` describes the new VS Code usage panel

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The "Use the prompt box" → "Command menu" subsection in docs/en/vs-code.md and the existing usage/cost pages. The v2.1.174 changelog adds usage attribution to the VS Code /usage dialog (cache misses, long context, subagents, and per-skill/agent/plugin/MCP breakdowns over 24h or 7d), but no docs page describes the new VS Code-specific panel.

Current Documentation

docs/en/vs-code.md (line 98) 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."

The v2.1.174 changelog entry reads:

"[VSCode] Added usage attribution to the Account & usage dialog (/usage) showing cache misses, long context, subagents, and per-skill/agent/plugin/MCP breakdowns over the last 24h or 7d"

docs/en/monitoring-usage.md documents OpenTelemetry metrics for the CLI but does not mention the VS Code Account & usage dialog. A search for "Account & usage" or "Account and usage" across the docs mirror returns no results in vs-code.md or monitoring-usage.md.

What's Wrong or Missing?

A. The /usage command menu entry in vs-code.md does not describe the dialog

Line 98 says the command menu includes "viewing plan usage (/usage)" but the word "usage" alone does not signal that the dialog also shows attribution breakdowns. A user opening /usage in VS Code and seeing per-skill/agent/plugin/MCP rows will not find any documentation path that explains them.

B. The new attribution fields (cache misses, long context, subagents, per-skill/agent/plugin/MCP) are not documented

The monitoring-usage.md page documents OTel metric names like claude_code.lines_of_code.count and event attributes, but the VS Code panel is its own UI surface and is not the same as the OTel events. Users looking up the panel from a VS Code screenshot have no docs path.

C. The 24h/7d time range toggle is undocumented

The panel supports a 24h vs 7d time range toggle. The monitoring-usage page documents the OTel retention story but not the VS Code dialog's time range. Users who want a longer window have no way to discover that the panel supports 7d.

D. The CLI claude /usage surface is also undocumented alongside the VS Code panel

For comparison, the CLI's /usage is mentioned in commands.md (no — only /usage-credits is mentioned there). The VS Code panel is a different surface with different attribution fields, and the docs should make that distinction explicit.

Suggested Improvement

Option A: Comprehensive fix

1. In docs/en/vs-code.md (line 98), expand the /usage mention:

> "* 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.
>
> The /usage command in VS Code opens the Account & usage dialog. As of v2.1.174 the dialog breaks down usage by cache misses, long-context requests, subagent dispatches, and per-skill / per-agent / per-plugin / per-MCP-server attribution. Use the 24h / 7d toggle to switch the time window. The same data is available in the CLI as a one-line summary; this dialog adds the attribution breakdown."

1. In docs/en/monitoring-usage.md, add a new short subsection at the end of the "Usage" overview that cross-references the VS Code panel:

> "### VS Code Account & usage dialog
>
> The VS Code extension also exposes an Account & usage dialog from the /usage command in the prompt-box command menu. The dialog shows the same cache misses, long-context, subagent, and per-skill/agent/plugin/MCP attribution that the OTel events report, summed over 24h or 7d. For OTel-side breakdowns see the metric reference below; this dialog is the in-IDE view, not a replacement for OTel export."

Option B: Minimum fix

Replace the /usage line in vs-code.md only. Leave the monitoring-usage.md cross-reference for a later pass.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/vs-code | 98 | "Command menu" — single-line mention of /usage does not describe the new Account & usage dialog |
| https://code.claude.com/docs/en/monitoring-usage | (overview) | OTel-focused usage docs do not cross-reference the VS Code panel |
| https://code.claude.com/docs/en/commands | 140 | /usage-credits is a different command from /usage; the docs should make the distinction clear for VS Code users who see both |
| https://code.claude.com/docs/en/changelog | 25 | Sole mention of the v2.1.174 addition; no cross-references |

Total scope: 3 pages affected, plus the changelog.

Cross-references:

• https://code.claude.com/docs/en/costs — the cost page documents plan-level usage; the new panel adds per-attribution detail and should be cross-referenced from the cost page
• https://code.claude.com/docs/en/skills — per-skill attribution in the panel maps to skill names visible in /doctor and the skill listing
• https://code.claude.com/docs/en/sub-agents — per-agent attribution maps to subagent frontmatter names
• https://code.claude.com/docs/en/mcp — per-MCP-server attribution maps to MCP server names configured in .mcp.json or via claude mcp add

Version: v2.1.174 (June 12, 2026)