[DOCS] `/cost` docs still say the command isn't relevant for subscribers

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

Using the /cost command on the costs page, plus the /cost row in the built-in commands reference

Current Documentation

No current code.claude.com page documents the new per-model or cache-hit breakdown in /cost for subscription users.

The costs guide currently 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. The /cost command provides detailed token usage statistics for your current session: 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

The commands reference currently says:

/cost | Show token usage statistics. See cost tracking guide for subscription-specific details

What's Wrong or Missing?

A. The costs guide still describes /cost as not relevant for subscribers

Changelog v2.1.92 added:

Added per-model and cache-hit breakdown to /cost for subscription users

Current docs still tell subscribers that /cost is not relevant for them and send them to /stats instead. That guidance is now outdated if /cost includes subscription-user breakdowns.

B. The new subscriber-facing output is undocumented

The docs do not explain:

• that subscription users now get additional /cost output
• what the per-model breakdown covers
• what the cache-hit breakdown represents
• how the subscription-user view relates to /stats and to API billing-oriented /cost data

Suggested Improvement

Update the /cost documentation to distinguish API billing information from subscription-user analytics.

Specifically:

• revise the note so it no longer says /cost is irrelevant for subscribers
• clarify which subscription plans receive the new breakdown
• document that subscription users can see per-model and cache-hit breakdowns in /cost
• add a subscriber-focused example or sample output showing the additional sections
• update the /cost row in the commands reference so its “subscription-specific details” link points to actual documented subscriber behavior

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/costs | Primary /cost documentation currently says the command is intended for API users and not relevant for subscribers |
| https://code.claude.com/docs/en/commands | Built-in command table says /cost has subscription-specific details, but links to the outdated costs guidance |

Total scope: 2 pages affected

Source: Changelog v2.1.92

Exact changelog entry:

Added per-model and cache-hit breakdown to /cost for subscription users