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.
- 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.
| Half | Lives in | Answers | Retention |
|---|---|---|---|
| Remaining allowance | The /usage screen, claude.ai Settings, and the status line JSON | "Am I about to be cut off?" | Now only |
| Consumed history | JSONL session transcripts on disk | "What has this cost me?" | 30 days by default |
The seven categories
What each category of tool can see, as of August 2026.
| Category | Allowance | History | Scope | Effort |
|---|---|---|---|---|
| Built-in usage screens | Yes | 24h or 7d | This machine, or claude.ai | None |
| Status line scripts | Yes, live | Whatever you script | Claude Code | One config line |
| CLI parsers (ccusage) | No | Yes, complete | 15 agent CLIs, one machine | None |
| Browser extensions | Partial | Partial | claude.ai chat only | One click |
| Desktop and menu-bar gauges | Yes, live | Yes | Whatever they parse | An install |
| OpenTelemetry export | No | Yes, streamed | Org-wide | Real setup |
| Analytics APIs | No | Yes, per user | Org-wide | A script |
Start with what is already installed
Two of these ship with the product and cost nothing to try.
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.
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.
| Tool | Best at | Run it with |
|---|---|---|
| ccusage | Complete cost history across 15 agent CLIs | npx ccusage@latest |
ccusage statusline | Spend and burn rate in your prompt | bunx ccusage statusline |
| Claude Code Usage Monitor | Terminal dashboard with forecasting | uv tool install claude-monitor |
| A hand-written status line | Exactly the fields you care about | A shell script and jq |
| Browser extensions | claude.ai chat message counts | Your 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.
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 setup | Supported per-user route | Key type |
|---|---|---|
| Claude Console (API) | Claude Code Analytics API | Admin API key |
| Claude Enterprise | Enterprise Analytics API | Analytics API key |
| Claude for Teams | Spend report CSV in org analytics | Admin console login |
| Cloud providers | OpenTelemetry, or an LLM gateway | Your 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.
- 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.
- 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. - 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.
- 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.
- 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 question | Use |
|---|---|
| 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 Grafana | OpenTelemetry export |
| How much chat have I used? | claude.ai Settings, then Usage |
| All of the above, across agents | A 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.