[DOCS] Commands docs still describe `/cost` and `/stats` as standalone commands after the `/usage` merge

Resolved 💬 2 comments Opened Apr 23, 2026 by coygeek Closed Apr 29, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

The commands table entries for /cost, /stats, and /usage, plus the /cost guidance in the cost tracking docs.

Current Documentation

The commands reference currently says:

| /cost | Show token usage statistics. See cost tracking guide for subscription-specific details | | /stats | Visualize daily usage, session history, streaks, and model preferences | | /usage | Show plan usage limits and rate limit status |

The cost tracking page also says:

The /cost command shows API token usage and is intended for API users. Claude Max and Pro subscribers have usage included in their subscription, so /cost data isn't relevant for billing purposes. Subscribers can use /stats to view usage patterns.

What's Wrong or Missing?

Changelog v2.1.118 says: Merged /cost and /stats into /usage — both remain as typing shortcuts that open the relevant tab.

The docs still present /cost, /stats, and /usage as three separate commands with separate purposes. They do not explain that /usage is now the unified command surface, and that typing /cost or /stats just opens the corresponding tab inside /usage.

That leaves the command reference and cost guidance outdated for users trying to understand which command is primary and what behavior to expect after v2.1.118.

Suggested Improvement

Update the commands reference to make /usage the primary documented command and describe /cost and /stats as typing shortcuts that open the Cost and Stats tabs within /usage.

Update the cost tracking page to match that model. For example, the subscriber note could explain that subscribers can open usage views through /usage, and that /stats remains a shortcut to the Stats tab rather than a separate standalone command.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 35, 83-94 | The commands table still documents /cost, /stats, and /usage as separate commands |
| https://code.claude.com/docs/en/costs | 17-23 | The cost tracking page still treats /cost and /stats as separate command surfaces |

Total scope: 2 pages affected

Source: Changelog v2.1.118

Exact changelog entry: Merged /cost and /stats into /usage — both remain as typing shortcuts that open the relevant tab

View original on GitHub ↗

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