How to check your Claude usage
To check Claude usage on the web or desktop app, open Settings › Usage to view real-time progress bars for your 5-hour session and weekly account caps. In the Claude Code CLI, type /usage for current session token metrics, or run /statusline to display an always-visible token meter.
- Web / Desktop: Profile (lower-left) → Settings → Usage. Shows % used + exact reset time.
- Claude Code: Type
/usageto inspect active session input/output/cache tokens. - Statusline: Type
/statuslineto pipe live token metrics directly into your terminal prompt. - API Console: console.anthropic.com/settings/plans shows raw spend and token consumption for developers with direct API keys.
Comparison Matrix: What Each Surface Displays
Official tools provide different metrics depending on whether you are chatting or writing code.
| Surface / Method | Live % | Weekly View | Opus Split | Exact Tokens | History | Forecast | Per-Project | What it CAN'T do (Honest Limitations) |
|---|---|---|---|---|---|---|---|---|
| 1. Web / Desktop (Settings › Usage) | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ | ✗ | No token integers (percentages only), no historical burn velocity, cannot attribute tokens to specific projects or repos. |
| 2. Mobile App (iOS / Android) | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ | ✗ | Screen constraints; cannot view prompt-level token debug metrics or terminal telemetry. |
3. Claude Code (/usage) | ✗ | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ | Only reflects the current active terminal session; disappears when session closes; cannot show your 5h or weekly account % remaining. |
4. Claude Code (/statusline) | ✗ | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ | Requires custom script integration; tracks per-turn stdin tokens only, without multi-session persistence. |
5. Local Tracker (claudeusage) | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ | ✗ | Reports the same account-level percentages as the Usage tab, so it covers web chats too. No token integers, no stored history, no project attribution. |
| 6. Anthropic API Console | ✗ | ✗ | ✓ | ✓ | ✓ | ✗ | ✓ | Pay-per-token API accounts only; completely decoupled from consumer Claude Pro ($20/mo) and Max ($100/mo) subscriptions. |
Every Official Way to Check Claude Usage
Detailed walkthroughs ranked from standard consumer access to developer terminal integration.
Claude Web & Desktop: Settings › Usage
The primary graphical dashboard provided by Anthropic. It provides immediate, live status indicators across your active session and weekly quotas.
claude.ai) or launch the official desktop application.- Current 5-hour session progress bar + exact countdown to reset
- Current weekly all-models progress bar + scheduled reset day & time
- Dedicated Opus weekly allocation progress bar
- Usage Credits toggle and prepaid balance configuration
Claude Mobile App: Settings › Usage
The official iOS and Android applications mirror the web usage meters directly inside native settings.
Claude Code: The /usage Slash Command
When coding in the terminal with Claude Code, you do not need to switch back to the browser. Entering /usage renders an itemized summary directly in your shell.
Input Tokens: 42,120
Output Tokens: 3,480
Cache Read: 128,450
Cache Write: 24,100
Estimated Session Cost: $0.34
Note: Token totals reflect your current interactive CLI session. To check overall account plan limits, use Settings › Usage or configure a persistent statusline.
Claude Code: Persistent Statusline (/statusline)
Claude Code supports a real-time statusline rendered at the bottom of your terminal window. Running /statusline opens an interactive setup menu to toggle pre-built templates or configure a custom script.
How custom statusline scripts work:
When Claude Code updates, it pipes session telemetry as a JSON object into your script via standard input (stdin). Your script reads the JSON payload (containing current model, input/output tokens, cost, and context size) and outputs a single formatted line printed at the terminal footer.
Local Tracker CLI: Every Window On One Screen (claude-usage)
The official Usage tab shows your limits one screen at a time. This open-source tracker prints the same numbers in your terminal, in a menu-bar app, or on a localhost dashboard. It reuses the Claude Code login already on your machine, so there is no API key and no separate account.
Current session
82% remaining
Resets in 2h 18m (Sep 10 at 3:00 PM PDT)
Current week (all models)
61% remaining
Resets in 4d 3h (Sep 15 at 4:00 PM PDT)
It reports the percentages and reset times Anthropic returns for your account. It does not count tokens, keep usage history, or attribute usage to a project, and it needs a network connection to read your current numbers.
Anthropic Console (API Keys & Workspaces)
If you connect to Claude models through API keys rather than a consumer Pro/Max subscription, your usage is billed strictly pay-as-you-go per million tokens.
Navigate to console.anthropic.com › Settings › Plans & Billing or the Usage dashboard to inspect day-by-day token graphs, spend caps, and workspace breakdowns.
⚠️ The Official Visibility Gap
Every surface here, the official ones and the tracker alike, tells you where you stand right now. None of them answers:
- Longitudinal history: How this week compares to last week or last month. Anthropic exposes no history, so nothing downstream can show it.
- Project attribution: How much of your quota a particular repository or conversation consumed.
- Token integers for subscriptions: Pro and Max report percentages. Exact token counts exist only for API keys in the Console.
Treat any tool promising these for a Pro or Max subscription as estimating from your local Claude Code transcripts, not reading your real allowance.
Wondering what the limits actually are?
Compare 5-hour and weekly caps across Pro, Max, and Team tiers.