Claude usage trackers compared: every option that works

Tracking Claude usage sounds like one problem and is really two: how much allowance is left, and how much has been consumed. Most tools do exactly one of those, and knowing which half a tool covers is the whole decision.

By the Continuum team. We build a workbench that runs Claude Code, Codex, and their peers, so the model rates quoted here are the ones our own cost analytics ship with.

The short version

Options fall into seven categories: the built-in usage screens, status line scripts, CLI parsers such as ccusage, browser extensions for claude.ai, desktop and menu-bar gauges, OpenTelemetry pipelines, and the organisation Analytics APIs. Session-file parsers see complete history but no remaining allowance; anything reading the status line JSON or the plan bars sees allowance but no long history. Very few see both.

What you need to know
  • Remaining allowance and consumed history come from different data sources. That is the whole map.
  • ccusage and its kin see history perfectly and remaining allowance not at all.
  • A status line script now gets live 5-hour and 7-day percentages, which used to be impossible locally.
  • Browser extensions cover claude.ai chat, not Claude Code.
  • The Analytics APIs are the only supported way to see a whole team.

The split that decides everything

Claude usage data exists in two unrelated places, and no amount of cleverness moves data from one to the other.

The two halves of the problem.

HalfLives inAnswersRetention
Remaining allowanceThe /usage screen, claude.ai Settings, and the status line JSON"Am I about to be cut off?"Now only
Consumed historyJSONL session transcripts on disk"What has this cost me?"30 days by default
Two unconnected data sources: remaining allowance from live plan state, and consumed history from JSONL files on disk, each read by its own set of toolsTWO SOURCES, TWO QUESTIONSREMAINING ALLOWANCEnow onlythe live plan stateam I about to be cut off?CONSUMED HISTORYkept 30 daysjsonl files on diskwhat has this cost me?/usage screenstatus line JSONa menu-bar gaugeccusagethe Analytics APIa menu-bar gaugereads bothNo parser produces the left column. No plan bar produces the right one.

The seven categories

What each category of tool can see, as of August 2026.

CategoryAllowanceHistoryScopeEffort
Built-in usage screensYes24h or 7dThis machine, or claude.aiNone
Status line scriptsYes, liveWhatever you scriptClaude CodeOne config line
CLI parsers (ccusage)NoYes, complete15 agent CLIs, one machineNone
Browser extensionsPartialPartialclaude.ai chat onlyOne click
Desktop and menu-bar gaugesYes, liveYesWhatever they parseAn install
OpenTelemetry exportNoYes, streamedOrg-wideReal setup
Analytics APIsNoYes, per userOrg-wideA script

Start with what is already installed

Two of these ship with the product and cost nothing to try.

01

In Claude Code

/usage

Progress bars for the 5-hour and weekly windows, a session block with tokens and cost by model, and an attribution breakdown by skill, subagent, plugin, and MCP server. Press d or w for the last 24 hours or last 7 days.

02

On claude.ai

Anthropic support directs Pro, Max, Team, and seat-based Enterprise users to Settings, then Usage, for the same two progress bars. Because the allowance is shared across claude.ai, Claude Desktop, and Claude Code, this is the one place that reflects everything at once.

The community tools worth knowing

The tools people actually run, and what each is best at.

ToolBest atRun it with
ccusageComplete cost history across 15 agent CLIsnpx ccusage@latest
ccusage statuslineSpend and burn rate in your promptbunx ccusage statusline
Claude Code Usage MonitorTerminal dashboard with forecastinguv tool install claude-monitor
A hand-written status lineExactly the fields you care aboutA shell script and jq
Browser extensionsclaude.ai chat message countsYour browser store

Claude Code Usage Monitor is the notable recent change in this list. Its 4.0 release moved to the official status line rate_limits as its primary data source rather than inferring limits from token counts, which is the difference between a guess and a reading.

Setting up OpenTelemetry

If you already run a metrics stack, this is the highest-leverage option, because Claude Code becomes just another service in the dashboards you already look at. It is also the only per-user route that works on Bedrock, Google Cloud, and Microsoft Foundry.

Minimum viable configuration.
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

You get eight metrics, including claude_code.token.usage, claude_code.cost.usage, claude_code.session.count, claude_code.lines_of_code.count, claude_code.commit.count, and claude_code.active_time.total, plus a set of events covering prompts, tool results, API requests, and errors. Metrics export every 60 seconds by default and logs every 5 seconds.

For an organisation

Which API you get depends on how your organisation signs in, and the two are not interchangeable.

Your setupSupported per-user routeKey type
Claude Console (API)Claude Code Analytics APIAdmin API key
Claude EnterpriseEnterprise Analytics APIAnalytics API key
Claude for TeamsSpend report CSV in org analyticsAdmin console login
Cloud providersOpenTelemetry, or an LLM gatewayYour own collector

The Claude Code Analytics API returns one UTC day of per-user records per call: sessions, lines added and removed, commits, pull requests, per-tool acceptance and rejection counts, and token and cost figures by model. Data lands with up to an hour of delay and the endpoint is free for organisations with Admin API access.

What to check before you trust one

Anything that reads your Claude Code transcripts is reading a plaintext record of every file the agent opened and every command it ran. Anthropic is explicit that these files are unencrypted and that a credential printed by a tool ends up in them. That raises the bar for what you install.

  1. Does it parse locally? A tracker that uploads transcripts to compute totals is exfiltrating source code and secrets to do arithmetic that runs fine on your machine. Aggregates can travel; transcripts should not.
  2. Does it deduplicate? Ask, or compare it against npx ccusage@latest. A tool that reports noticeably higher tokens for the same period is summing repeated records.
  3. Does it price at event time? Rates change. Claude Sonnet 5 moves from $2 and $10 per million input and output tokens to $3 and $15 on 1 September 2026, so a tracker using current rates will restate your July on that day.
  4. Does it cover the agents you run? A Claude-only number is not a spend report if half your work goes through Codex or Cursor.
  5. Does it keep history? Claude Code sweeps transcripts after 30 days by default. A parser with no store of its own inherits that horizon.

Picking by what you actually need

Your questionUse
Am I about to be cut off?/usage, or a status line, or a desktop gauge
What did last month cost?ccusage monthly
Which repo is expensive?A tool with per-repo bucketing
Why did this week burn so much?The /usage breakdown, pressing w
Which of my engineers uses it?The Analytics API for your setup
I want this in GrafanaOpenTelemetry export
How much chat have I used?claude.ai Settings, then Usage
All of the above, across agentsA desktop gauge plus the API

If you only need one half, take the simpler tool. ccusage is excellent and we check our numbers against it. The case for something larger begins when you are running more than one agent, more than one account, or more than one machine.

Questions people ask

For cost history on one machine, ccusage. For live allowance, the /usage screen or a status line script that reads rate_limits. For a team, the Analytics API that matches your sign-in. No single tool is best at all three.

Yes, if it reads the right source. Claude Code pipes rate_limits.five_hour and rate_limits.seven_day percentages to status line scripts, and the /usage screen and claude.ai Settings both draw the same bars. Session-file parsers cannot, because that state is never written to disk.

No. They track claude.ai in the browser. Claude Code runs in a terminal and its requests never pass through the browser, so an extension shows only your chat usage.

Yes. Anthropic support states that usage across claude.ai, Claude Desktop, and Claude Code counts toward the same five-hour and weekly limits on a subscription.

On the Console, the Claude Code Analytics API with an Admin key. On Enterprise, the Enterprise Analytics API with an analytics key. On Teams, the spend report CSV. On a cloud provider, OpenTelemetry.

Yes. The Claude Console has a usage page and a Claude Code dashboard for API organisations, and claude.ai has an analytics dashboard for Teams and Enterprise. Individual accounts get the in-product screens rather than a dashboard.

ccusage is open source and free. The OpenTelemetry exporter is built into Claude Code. The Analytics API is free for organisations with Admin API access. Continuum is free.

Either they are measuring different things (allowance versus consumption), or one of them is not deduplicating repeated records after resumes and retries, which inflates token totals.

Sources

Every figure above was read from these pages on August 2026. Vendors reprice without notice; if you find a stale number, tell us.

  1. Claude Code analytics and monitoring
  2. Claude Code: customize your status line
  3. Claude Code Analytics API
  4. ccusage on GitHub
Try it

Both halves,
every agent.

Live quota gauges and full spend history, across Claude Code, Codex, and every account you run. Free app.

free app · your subscriptions · local-first