If you use Claude Code on a Pro or Max plan, you have probably hit the wall mid-session: the 5-hour window runs out, or the weekly cap kicks in, usually right when the agent was in the middle of something important. The fix is not to code less. It is to see your usage before it becomes a problem.
This post covers every practical way to track Claude Code usage in 2026, from built-in commands to community CLIs to desktop dashboards, and when each one makes sense.
Disclosure: I work on Blume, one of the tools covered below. I have tried to keep the comparison factual so you can pick what fits.
/usage
inside Claude Code for your current session and weekly limits/cost
to see running spend in the current sessionnpx ccusage@latest
claude-monitor
)Now the details.
Claude Code subscriptions enforce two overlapping limits:
This matters because the two limits fail differently. The 5-hour window surprises you in the afternoon. The weekly cap surprises you on a Thursday. A good tracking setup makes both visible.
Claude Code ships with everything you need for a point-in-time check:
/usage
shows your current 5-hour window and weekly usage with reset times (subscription plans)/cost
shows running API spend for the session (API key users)/status
shows account and model details/context
shows how full your context window isThere is also the Usage dashboard on claude.ai under Settings, which shows the session bar and weekly usage in a browser.
Good for: quick checks before starting a long session.
The gap: no history, no trends, no warning before you hit a limit, and nothing at all about what your agents are doing while you are away from the terminal.
ccusage is the most widely used community tool. It reads the local JSONL logs that coding agents already write to disk and turns them into cost reports. No account, no telemetry, runs with a single command:
npx ccusage@latest
What you get:
Good for: understanding where your tokens went, especially across weeks or months.
The gap: it is a report, not a monitor. You run it, read it, and close it. It will not tell you that your current session is on pace to hit the limit in 40 minutes.
Claude Code Usage Monitor fills exactly that gap. Install it with uv tool install claude-monitor
(or pip/pipx), run claude-monitor
, and you get a live terminal dashboard with progress bars, burn-rate analysis, and predictions about when you will hit your limit.
Notable features:
Good for: heavy users who live inside the 5-hour window and want to pace themselves.
The gap: it monitors Claude Code subscriptions only, and it monitors usage only. If you also run Codex or Cursor, or you care about what the agents are doing rather than just what they are spending, you need something broader.
Blume approaches the problem from a different angle. Usage tracking is one part of it, but the premise is that usage is a symptom. The underlying question is whether your coding agents are set up correctly at all.
Blume is a desktop app that sits alongside Claude Code, Codex, and Cursor and gives you:
Good for: anyone running more than one agent, or anyone whose CLAUDE.md and hooks have grown past the point where they can eyeball whether the setup still makes sense.
The gap: it is a desktop app, so if you want something scriptable in CI, ccusage's JSON export is the better fit.
| Built-in commands | ccusage | Usage Monitor | Blume | |
|---|---|---|---|---|
| Interface | In-session | CLI report | Live terminal UI | Desktop app |
| Real-time warnings | No | No | Yes | Yes |
| Historical reports | No | Yes | Yes (opt-in) | Yes |
| Tools covered | Claude Code | 15+ agent CLIs | Claude Code | Claude Code, Codex, Cursor |
| Shows what agents are doing | No | No | No | Yes |
| Suggests setup fixes | No | No | No | Yes |
| Scriptable output | No | JSON | JSON/CSV | No |
| Price | Included | Free, OSS | Free, OSS | Free to start |
/usage
command is enough.These are not mutually exclusive. A common stack is /usage
for quick checks, ccusage in a monthly review, and a desktop app running in the background for everything else.
Does Claude Code share limits with claude.ai chat?
Yes. Subscription usage draws from one pool across Claude Code, claude.ai, and Cowork. A heavy chat session eats into your coding budget.
How do I see when my limit resets?
Run /usage
in Claude Code, or check Settings > Usage on claude.ai. Both show reset times for the 5-hour window and the weekly cap.
Do these tools send my data anywhere?
ccusage and Claude Code Usage Monitor read local log files and run entirely on your machine. Blume stores conversation history locally on your device.
What about tracking Codex or Cursor usage too?
ccusage covers many agent CLIs for cost reports. Blume tracks Claude Code and Codex plan usage and monitors agent activity across Claude Code, Codex, and Cursor.
If you have a tracking setup that works well for you, I would genuinely like to hear about it in the comments, especially if you are juggling more than one agent.