Home / Guides / Claude Code Usage
How to Check Your Claude Code Usage
Inside Claude Code, run /usage (/stats works too): it shows your plan usage limits and activity. In the browser, Settings > Usage on claude.ai shows how much of your 5-hour session you have used, the time remaining, and when your weekly limit resets.
Rather not check by hand? A Claude usage tracker keeps both limits and their reset times in view while you work.
Last updated 2026-09-30 · Every source below was checked on that date · By Soren Starck
On Windows? Claude usage in the Windows taskbar: a native app for Windows 10 and 11, with alerts before you hit a limit.
| Where | What it shows | Best for |
|---|---|---|
/usage in Claude Code | Plan usage limits, activity stats, and a breakdown of what counts against your limits | A check mid-session, without leaving the terminal |
| Settings > Usage on claude.ai | 5-hour session used plus time remaining; when your weekly limit resets | The account-wide picture, on any device |
| Claude Console, Usage page | API usage and what you are actually billed | Paying per token with an API key |
Reading /usage
/usage shows session cost, plan usage limits and activity stats; /stats opens the same view on its Stats tab, and /cost is another alias. On a Pro, Max, Team or Enterprise plan it adds a breakdown of what counts against your limits:
- Attribution: the share of recent usage from skills, subagents, plugins and individual MCP servers.
- Behavior flags: habits such as long context or cache misses, flagged when one accounts for 10% or more of recent usage.
- Loops: the heaviest scheduled tasks that ran recently, with their token totals.
Press d or w to switch between the last 24 hours and the last 7 days. These figures come from local session history on that machine, so usage from other devices or claude.ai is not included.
Documentedcode.claude.com: commands, /usage and /stats· verified 2026-09-30 Documentedcode.claude.com: plan usage breakdown· verified 2026-09-30
The dollar figure is not your bill
The Session block at the top of /usage shows token usage for the current session with a dollar figure. Anthropic says that block is intended for API users: Claude Code computes the figure locally at list price unless an administrator configures contracted rates through modelPricing, so it is an estimate, and on a Pro or Max plan your included usage is covered by the subscription, while usage credits are charged separately. For authoritative API billing, use the Usage page in the Claude Console.
Documentedcode.claude.com: costs, Session block· verified 2026-09-30
How much of your limit is left
Settings > Usage on claude.ai is the account-wide view. The current-session bar shows how much of your plan's 5-hour session limit you have used plus the time remaining; the weekly section shows when your weekly limit resets, for all models and for Fable. It is available on Pro, Max, Team and seat-based Enterprise plans.
Documentedsupport.claude.com: Settings > Usage· verified 2026-09-30
How the two limits work: Claude session limit and weekly limit. How they compare with OpenAI's: Claude Code vs Codex. When they reset: when do Claude tokens reset. Choosing a plan from what you see: Claude Pro vs Max. Claude failing with nothing used up? Check whether Claude is down right now.
When /usage cannot load
If the request for your plan limits fails, most often because the usage endpoint is rate limited, /usage shows the last usage bars it loaded on that machine within the past 60 minutes, with a note saying how old they are. Press r to retry.
Documentedcode.claude.com: when the usage request fails· verified 2026-09-30
Keeping it visible
Both views answer when you go and look, which is usually after Claude has already stopped you. SessionWatcher for Claude keeps your session and weekly usage, with their reset times, in the Mac menu bar or Windows taskbar and notifies you at 70% and 90% by default. Mostly waiting on resets? The Claude reset tracker tells you the moment a maxed-out limit frees up. On a Mac, the Claude usage widget for Mac puts the same numbers on your desktop (Pro). Comparing the options, SessionWatcher included? See the best Claude Code usage trackers for Mac and Windows.
It also keeps a running Claude Code token and cost table for today, the last 7 days, this month and the last 30 days, a daily usage history, and, with Pro, several Claude accounts side by side.
SessionWatcher
Stop running /usage.
Keep Claude Code usage in your menu bar or taskbar.
Native app for the Mac menu bar and the Windows taskbar. Track Claude, Codex and 18 more tools' usage, costs, and rate limits in real time.
“Fast, simple, and does exactly what it should. Definitely worth it.”
@nicojerome on GitHub
macOS 14+. Free for 7 days, no credit card.
Frequently asked questions
How do I check my Claude Code usage?
Run /usage inside Claude Code (/stats and /cost are aliases). On a Pro, Max, Team or Enterprise plan it shows your plan usage limits, activity stats and a breakdown of what counts against your limits. In the browser, Settings > Usage on claude.ai shows how much of your 5-hour session you have used, the time remaining, and when your weekly limit resets.
Documentedcode.claude.com: commands, /usage· verified 2026-09-30 Documentedsupport.claude.com: Settings > Usage· verified 2026-09-30
How do I see how much of my Claude limit is left?
Open Settings > Usage on claude.ai. The current-session bar shows how much of your plan's 5-hour session limit you have used plus the time remaining, and the weekly section shows when your weekly limit resets, for all models and for Fable.
Documentedsupport.claude.com: Settings > Usage· verified 2026-09-30
Is the dollar amount shown by /usage my actual bill?
No. The Session block is meant for API users, and Claude Code computes its dollar figure locally from token counts at list price unless an administrator configures contracted rates through modelPricing, so it is an estimate. On a Pro or Max plan your included usage is covered by the subscription, while usage credits are charged separately. For authoritative API billing, Anthropic points to the Usage page in the Claude Console.
Documentedcode.claude.com: costs, /usage· verified 2026-09-30
Why does /usage show less than claude.ai?
The /usage breakdown is computed from local session history on the machine you run it on, so usage from other devices or from claude.ai is not included. Settings > Usage is the account-wide view.
Documentedcode.claude.com: plan usage breakdown· verified 2026-09-30
What happens if /usage cannot load my limits?
If the usage request fails, most often because the usage endpoint is rate limited, /usage shows the last usage bars it loaded on that machine within the past 60 minutes, with a note saying how old they are. Press r to retry.
Documentedcode.claude.com: when the usage request fails· verified 2026-09-30
Sources
| Source | Used for | Verified |
|---|---|---|
| code.claude.com: commands reference | What /usage shows; /stats (opens on the Stats tab) and /cost as aliases. | 2026-09-30 |
| code.claude.com: costs docs | The Session block and its local dollar estimate, the plan usage breakdown and its local-history scope, the failed-request fallback, and the Claude Console for billing. | 2026-09-30 |
| support.claude.com: usage limit best practices | What Settings > Usage shows (session used plus time remaining; weekly reset for all models and for Fable) and which plans have it. | 2026-09-30 |
SessionWatcher is an independent product and is not affiliated with, endorsed by, or sponsored by Anthropic.