How to Track Claude Code Usage in 2026: Built-in Commands, ccusage, and Desktop Dashboards Compared

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 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:

• Daily, weekly, monthly, and per-session reports with USD cost estimates


• A 5-hour blocks report that maps directly onto Claude's billing windows


• Per-model breakdowns, cache token tracking, and date range filters


• Support for 15+ agent CLIs beyond Claude Code, including Codex, Gemini CLI, and Copilot CLI


• JSON export for piping into your own scripts

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.

Option 3: Claude Code Usage Monitor, the real-time view

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:

• 
  Automatic improvement suggestions. Blume watches how your agents actually behave, detects inconsistencies between your setup and your instructions (a CLAUDE.md rule your agent keeps ignoring, a hook that never fires, skills that overlap), and proposes concrete fixes you approve or reject. This is the part the CLI tools do not attempt: it does not just show you the damage, it suggests the repair.


• 
  Agent monitoring. See at a glance which agents are running, which are working, and which are stuck waiting for your approval, without cycling through terminal tabs.


• 
  Usage tracking for Claude Code and Codex plans, so the 5-hour window and weekly cap are visible in one place across tools.


• 
  Config management. Rules, skills, hooks, and the growing pile of dotfiles that agents depend on, managed centrally instead of drifting per-project.


• 
  Local storage. Conversation history stays on your device.

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.

Comparison table

Which one should you use?

• 
  You hit limits occasionally: the built-in /usage command is enough.


• 
  You want to understand a month of spending: ccusage.


• 
  You are rationing a Max plan hour by hour: Claude Code Usage Monitor.


• 
  You run multiple agents, or you suspect your agent config is quietly working against you: Blume.

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.

FAQ

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.