Claude usage tracker
By Claude Resets · Updated
The best way to avoid a surprise lockout is a usage tracker you actually look at. Here are four ways to track Claude usage, from the built-in page to a usage tracker that sits right in your Claude Code terminal.
1. The built-in usage tracker: Settings → Usage
On claude.ai or in Claude Desktop, Settings → Usage is the official usage tracker. It shows how much of your 5-hour session and weekly limit is used, when each one resets, any separate model limit such as Fable, a breakdown by product (Claude Code, Chats, Cowork), your usage credits balance, and any saved reset card.
2. /usage: the terminal usage tracker
In Claude Code, the /usage command is the quickest usage tracker: it shows your plan limits and reset times without leaving the terminal. /cost shows what the current session has spent, which matters most on API billing. Neither is a live usage tracker, so you have to remember to run them.
3. A status line usage tracker
Claude Code can print a custom status line under the prompt, and that makes the most useful usage tracker of all because it is always visible. It is the usage tracker we use ourselves. For Pro and Max subscribers, the status line data includes rate_limits.five_hour and rate_limits.seven_day, each with used_percentage and resets_at.
Run /statusline and describe what you want, for example “show model, 5-hour % and weekly %”. Claude Code writes the script for you. The rate limit fields appear after the first response in a session and drop out once a window resets.
Example output
A minimal status line usage tracker looks like: [Opus] | 5h: 24% 7d: 61%. Colour it red past 80% and you will never be caught off guard.
4. Third-party usage trackers
Community tools such as ccusage read Claude Code’s local logs and build daily and per-session reports, a handy usage tracker for spotting which projects burn the most. They estimate from local data, so treat their numbers as a guide and Settings → Usage as the source of truth. Only install a usage tracker you trust, since it reads your session files.
What no usage tracker can show
Even the best usage tracker only looks backward. No usage tracker can tell you when Anthropic will reset limits early for everyone. That is what our home page estimates, using outages, launches and past resets, and what our email alert is for.
FAQ
Is there an official Claude usage tracker?
+
Yes: the official usage tracker is Settings → Usage on the web and in Claude Desktop, plus /usage in Claude Code.
Does the status line usage tracker work on every plan?
+
The rate limit fields are only included for claude.ai Pro and Max subscribers, or behind a Claude apps gateway with spend limits.
Why does my usage tracker disagree with Settings?
+
Third-party tools estimate from local logs and miss usage from chats and other devices. Settings → Usage is the source of truth.