Command reference ยท Claude Code
/usage
Also shows plan limits and activity stats, not just API costs
/usage shows you how much you've used in the current session: token counts, an estimated cost figure, and โ on Pro, Max, Team, and Enterprise plans โ your plan limits and activity stats.
Claude Code calculates the cost figure in the session block locally from the token counts at standard list prices; it can therefore differ from your actual bill and is mainly relevant for API users. On a subscription plan, /usage additionally shows a breakdown of what counts against your limit โ by skill, subagent, plugin, and individual MCP servers, plus notes on cost drivers like long context or cache misses at a 10% share or higher. Use d/w to switch between the last 24 hours and the last 7 days. The numbers come only from the local session history on this device โ other devices or claude.ai are not included.
Aliases: /cost and /stats (the latter opens directly to the stats tab).
๐ THE SAME TASK (โSHOW COST/TOKEN USAGEโ) ON OTHER PLATFORMS
โ WHEN TO USE IT?
Regular cost overview
Call /usage to keep an eye on token counts, estimated costs, and โ on subscription plans โ plan limits before starting a bigger task.
Find usage drivers by skill
After a long /batch run, check /usage and use the breakdown by skill, subagent, plugin, and MCP server to see what consumed the largest share.
โ WHEN NOT TO?
Checking context window usage
/usage shows token consumption, costs, and plan limits, but not how full the current context window is.
Better: use /context, which visualizes context usage as a colored grid.
Needing a binding invoice total
The dollar figure in the session block is calculated by Claude Code locally from token counts at standard list prices โ this can differ from the actual invoice, since promotional pricing and discounts aren't factored in.
Better: For binding billing, use the usage page in the Claude Console.
SOURCES
- Claude Code docs (official) โ code.claude.com
MORE COMMANDS ยท Claude Code