Key takeaways
- Claude Code /usage shows session cost, plan usage limits and activity stats, and paid plans add a breakdown of what counts against the limit.
- /cost is an alias for /usage, and /stats opens the same screen on its Stats tab.
- The cost is a local estimate at list price, the figures cover one machine, and the activity view stops at seven days.
Claude Code /usage is a screen, not a stat dump. Type it at the prompt and it answers three questions: what this session has cost, how much of your plan is left, and what recent activity has been eating it. The footnotes are where the arguments start.
One command, three jobs
The Session block is the oldest part. It lists total cost, API and wall duration, lines added and removed, and a per-model line with input, output, cache read and cache write counts. A prompt cache line then adds requests, cache hit share and misses.
The plan section appears on Pro, Max, Ultra, Team and Enterprise plans: usage bars, activity stats, and a breakdown of what counts against your limits. It also suggests fixes, such as trimming a large CLAUDE.md file, and f runs the ones it can apply.
The activity section is the 24 hour and 7 day view, switched with d and w.
The aliases that confuse people
/cost is not a separate report. It is an alias for /usage. /stats is also an alias, and it opens the screen on the Stats tab. Blog posts that describe three different commands are describing one command with three doors.
Four numbers people misread
| What people say | What the docs say |
|---|---|
| The dollar figure is my bill | Computed locally from tokens at list price, and Anthropic calls it an estimate |
| It covers all my Claude use | Local session history on one machine, without claude.ai or other devices |
| It is my usage history | The view stops at seven days, and session files go after cleanupPeriodDays, 30 days by default |
| The counter by the spinner is the session total | That counter measures one turn's output, then resets |
Why the number climbs while you read
Claude Code sends the whole conversation with every request, so a one line question in a session open all day still draws on the day's context. Cache reads soften that, until a break longer than the cache lifetime causes a miss. Agent teams add load of their own: Anthropic says they use roughly seven times the tokens of a standard session when teammates run in plan mode.
How to read it without making it a hobby
Open it once a week, switch to the 7 day view, and write down two numbers: tokens and plan headroom. That is enough to spot a bad habit or a good month. For history, the terminal screen is the wrong shape. UsageAtlas is a free, open-source desktop tracker that reads local usage and keeps daily totals for tokens, requests, models and estimated cost, with no account needed for local tracking and prompts left unread. Its cost is an estimate too, which is the honest state of every figure here.
A note on the publication
TechTwitter IO is a satirical paper, and its leaderboards are jokes. For a command that decides whether you can keep working, read Anthropic's own docs and the screen in front of you. Save the satire for when a wrong number costs nothing.
FAQ
Why does the cost in /usage differ from my invoice?
Because it is a local estimate at list price. Contracted rates need a modelPricing table in managed settings, and even then Anthropic calls it an estimate, not a bill.
Can I see usage from my other laptop?
Not in /usage. Its figures come from local session history, so each machine reports its own slice. A tracker that saves history to a free account closes that gap.
Does the plan breakdown cover my whole history?
No. It covers the last 24 hours or 7 days, and its shares say how much of your usage a suggestion applies to, not how much it would save.
Frequently asked questions
What does /usage show in Claude Code?
A Session block with token counts, duration and an estimated cost, plus plan usage bars and activity stats on paid Claude plans. The paid view also breaks down what counts against your limits.
Is /usage the same as /cost?
Yes. /cost is an alias for /usage, and /stats is an alias that opens the screen on the Stats tab.
Does /usage work without a subscription?
Yes. The Session block is aimed at API users in particular, and Anthropic notes that for subscribers the session cost figure is not relevant to billing.
Sources
- Commands referenceAnthropic
- Manage costs effectivelyAnthropic
- Claude Code /cost and /stats now open /usageUsageAtlas

