/usage
A Claude Code slash command, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.
Show session cost, plan usage limits, and activity stats. On a Pro, Max, Team, or Enterprise plan, includes a breakdown of what counts against your plan limits. /cost and /stats are aliases
Anthropic's own wording. Read off Commands, captured 2026-09-28.
In the changelogs
23Releases whose published page names /usage.
-
v2.1.305
/usage can suggest ways to save and queue a fix for you
/usage can now point out what is costing you most and suggest fixes such as
/compactor lower effort, which you can queue as a follow-upfound in this entry's text, named in this entry
-
v2.1.305
/usage can suggest ways to use less of your plan and queue the fixes for you
/usage can now look through your recent sessions, suggest ways to use less of your plan, and queue the fixes you choose as prompts
found in this entry's text, named in this entry
-
v2.1.305
A review checklist can now include what /usage found
A review prompt can now add a check listing what /usage measured over the last 7 days, asking the model to report each item with its share
found in this entry's text, named in this entry
-
v2.1.304
/usage now says when you can try again after a rate limit
When /usage is rate limited, its message now shows when it can be tried again instead of saying "try again in a moment"
found in this entry's text, named in this entry
-
v2.1.290
Remote Control users can run /effort, /model, /rename and /usage while Claude is working
Someone connected through Remote Control can now run
/effort,/model,/renameand/usagestraight away while Claude is mid-replyfound in this entry's text, named in this entry
-
v2.1.284
Gateway guide explains how to show dollar amounts in /usage and the status line
The bundled gateway guide now tells operators how to serve spending data so
/usageand the status line can show dollarsfound in this entry's text, named in this entry
-
v2.1.284
Gateway sign-ins can see dollar spend against their limit
With gateway sign-in and a spend limit, the status line data and usage panel now show dollars used, the limit and the period
named in this entry
-
v2.1.281
/stats footer shows the date-cycle hint only on the tabs view
The
/statsfooter now shows the date-cycling and copy hints only on the tabs viewfound in this entry's text, named in this entry
-
v2.1.281
/stats dialog no longer grabs focus on open
The /stats dialog no longer takes keyboard focus on its header when it opens
found in this entry's text, named in this entry
-
v2.1.280
Rate-limit/overage info gained monthly and channel-scoped overage tracking, plus a 'grace' state
Rate-limit status data now includes monthly and channel overage utilization plus a grace-period flag
found in this entry's text, named in this entry
-
v2.1.277
Usage-limit display can show a per-model breakdown
Usage/limit displays can now show a separate line per model instead of one combined limit
found in this entry's text, named in this entry
-
v2.1.273
New structured /usage response schema, explicitly marked experimental
The /usage command gains a formally defined, still-experimental structured data schema
found in this entry's text, named in this entry
-
v2.1.273
/usage command result gains a structured payload
The /usage command's reply can now carry structured data, not just the readable text report
found in this entry's text, named in this entry
-
v2.1.261
Two new SDK control-protocol request types: get_usage and reload_output_styles
SDK gains get_usage and reload_output_styles requests for pulling usage data and refreshing styles mid-session.
found in this entry's text
-
v2.1.223
Stats dialog gets a Suspense fallback, a taller frame and a colour fix
The usage stats dialog is taller, loads more smoothly, and its model chart colours no longer skip.
named in this entry
-
v2.1.221
Session state moves onto a pluggable storage backend
Session history, resume and usage can now read from a pluggable backend, though files are still used.
named in this entry, found in this entry's text
-
v2.1.221
Usage stats now count and show cache tokens
Usage stats now count cache tokens and show a read/write breakdown per model.
named in this entry
-
v2.1.187
Skill token footprint in
/usagefound in this entry's text
-
v2.1.119
Slash Command Aliases
found in this entry's text
- v2.1.118
-
v2.1.118
Unified /usage Command (replaces /cost)
found in this entry's text
-
v2.0.52
Extra Usage Display in /usage
found in this entry's text
-
v2.0.0
/usage Command
found in this entry's text
First cited
2The earliest release whose published evidence quoted /usage was v2.1.261, 4 Sep 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
0The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the slash command does. All slash commands.