Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] VS Code docs should clarify `/usage` opens the Account & Usage dialog [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#53078•Fetched 2026-04-25 06:12:56
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
coygeekcoygeek
Participants
coygeekcoygeek
Timeline (top)
labeled ×4
RAW_BUFFERClick to expand / collapse

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

Use the prompt box command menu description for /usage, plus the general /usage command and cost tracking descriptions when read from the VS Code context.

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.

The commands reference says:

/usage | Show session cost, plan usage limits, and activity stats. See the cost tracking guide for subscription-specific details. /cost and /stats are aliases

The cost tracking page describes the command as producing session token/cost details:

The /usage command provides detailed token usage statistics for your current session. The dollar figure is an estimate computed locally from token counts and may differ from your actual bill. For authoritative billing, see the Usage page in the Claude Console.

It then shows a plain-text session cost block:

Total cost: $0.55 Total duration (API): 6m 19.7s Total duration (wall): 6h 33m 10.2s Total code changes: 0 lines added, 0 lines removed

What's Wrong or Missing?

Changelog v2.1.120 includes this VS Code-specific behavior change:

[VSCode] /usage now opens the native Account & Usage dialog instead of returning plain-text session cost

The current docs do not explain the VS Code-specific behavior. The VS Code page only says /usage is for "viewing plan usage," and the linked command/cost docs still describe /usage in terms of session cost and plain-text token statistics.

That leaves VS Code users with an outdated expectation: typing /usage in the extension no longer returns a plain-text session cost result. It opens the native Account & Usage dialog instead.

Suggested Improvement

Update the VS Code page's command menu bullet to describe the current behavior explicitly, for example:

In VS Code, /usage opens the native Account & Usage dialog, where you can view plan usage, activity stats, and session/account usage details.

Also update the general /usage command and cost tracking docs to distinguish the CLI/plain-text behavior from the VS Code native dialog behavior. A short note near the /usage cost-tracking section would prevent users from expecting the same text output in both interfaces.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageLine(s)Context
https://code.claude.com/docs/en/vs-code91-99VS Code prompt box command menu says /usage is for viewing plan usage, but does not mention the native Account & Usage dialog
https://code.claude.com/docs/en/commands100/usage is described generically as showing session cost, plan usage limits, and activity stats, with no VS Code-specific dialog behavior
https://code.claude.com/docs/en/costs17-30Cost tracking docs describe /usage as returning detailed token statistics and show a plain-text session cost block

Total scope: 3 pages affected

Source: Changelog v2.1.120

Exact changelog entry: [VSCode] \/usage` now opens the native Account & Usage dialog instead of returning plain-text session cost`

extent analysis

TL;DR

Update the VS Code documentation to reflect the current behavior of the /usage command, which now opens the native Account & Usage dialog instead of returning plain-text session cost.

Guidance

  • Review the affected pages (VS Code, commands, and costs) to ensure consistency in describing the /usage command behavior.
  • Update the VS Code page's command menu bullet to explicitly describe the current behavior, as suggested in the issue.
  • Add a note near the /usage cost-tracking section to distinguish the CLI/plain-text behavior from the VS Code native dialog behavior.
  • Verify that the updated documentation accurately reflects the behavior of the /usage command in both VS Code and CLI interfaces.

Example

No code snippet is necessary for this issue, as it is related to documentation updates.

Notes

The suggested improvements should be applied to the affected pages to ensure accurate documentation and prevent user confusion.

Recommendation

Apply the workaround by updating the documentation to reflect the current behavior of the /usage command, as this will provide clarity and consistency for users.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#ssr#authentication setup#request error#file not found

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING