How to check Claude Code usage?
Type `/usage` inside Claude Code to see your current session usage, plan-limit bars, and a breakdown by skills, subagents, and MCP servers. Press `d` or `w` to toggle the last 24 hours or 7 days. In VS Code, open the Account & usage dialog. API/Console users see authoritative billing on the Usage page at platform.claude.com/usage.
Why — the first-principles explanation
There are two different numbers you might want, and they come from two places. The first is how much of your plan you've used—the session and weekly windows. The second is dollar cost, which only truly matters for API/metered billing. Claude Code shows both, but from different sources.
The `/usage` command reads your local session history on that machine to estimate token counts and cost, and it fetches your plan-limit bars from Anthropic. That's why it notes the figures are approximate and don't include usage from other devices or from claude.ai—your laptop can't see what your desktop did. The dollar figure it shows is a local estimate, handy for awareness but not your official bill.
For authoritative money numbers, subscribers rely on their plan (usage is included, so cost isn't billed per token), while API and Console users check the Usage page in the Claude Console, which is the system of record. Teams and Enterprises get org-wide analytics and CSV spend reports in the admin console. So the rule of thumb: use `/usage` for a quick in-session check, and the Console for the real bill.
An example that makes it click
Think of `/usage` like the trip computer in your car—it estimates your gas used and miles left this drive, instantly, right on the dashboard. It's great for a quick glance, but it only knows about this car, this trip. The official fuel bill comes from the gas station's receipt—that's the Claude Console for API users. One is a handy live estimate; the other is what you actually pay.
How to do it
- Inside a Claude Code session, type `/usage` and press Enter.
- Read the session block (token usage and estimated cost) and the plan-limit bars below it.
- Press `d` for the last 24 hours or `w` for the last 7 days to change the window.
- In VS Code, open the Account & usage dialog (requires Claude Code v2.1.174+) and toggle Day/Week.
- For official billing, API/Console users open platform.claude.com/usage; Team/Enterprise admins use the org analytics spend report.
Key facts
- The `/usage` command shows session token usage, plan-limit bars, and a breakdown by skills, subagents, and MCP servers.
- Press `d` or `w` in `/usage` to switch between the last 24 hours and last 7 days.
- `/usage` figures are approximate and computed from local session history, so other devices and claude.ai usage aren't counted.
- In VS Code, the same breakdown appears in the Account & usage dialog (Claude Code v2.1.174 or later).
- Authoritative billing for API/Console users is on the Usage page at platform.claude.com/usage.
Anthropic's agentic coding tool that works in your terminal.
Affiliate link — we may earn a commission at no cost to you.▶ The 60-second explainer (script)
How do you check your Claude Code usage? The fastest way: inside a session, just type slash-usage. You'll see your current session's token count and an estimated cost at the top, and below it, bars showing how much of your plan limits you've used. Press d for the last 24 hours or w for the last 7 days. It even breaks usage down by skills, subagents, and MCP servers, so you can see what's eating your budget. Two things to know. First, those numbers are approximate—they're computed from this machine's session history, so usage on other devices or on claude-dot-ai isn't included. Second, the dollar figure is a local estimate, not your official bill. If you're a subscriber, usage is included in your plan, so cost isn't billed per token. If you're on the API, your real bill lives on the Usage page in the Claude Console. And in VS Code, the same breakdown shows up in the Account and usage dialog. Quick check in-session, official numbers in the Console.
What authoritative sources say
People also ask
What command shows my Claude Code usage?
Type `/usage` inside a session. It shows session tokens, plan-limit bars, and a breakdown by skills, subagents, and MCP servers.
Does /usage count usage from all my devices?
No. It reads local session history on the current machine, so other devices and claude.ai usage aren't included.
Where's my official bill?
API/Console users check platform.claude.com/usage. Team/Enterprise admins use the org analytics spend report. Subscribers' usage is included in the plan.
Can I see usage in VS Code?
Yes. Open the Account & usage dialog with a Day/Week toggle (requires Claude Code v2.1.174 or later).