Tracking third-party tool usage on Claude Max is two fields, not one, since April 4, 2026
Anthropic moved third-party tool billing off the flat Max plan into metered extra-usage at noon Pacific on April 4. The Cursor, Cline, Roo Code, aider, and OpenCode calls that used to silently draw from your $200/month allowance now bill at per-token API rates against a separate dollar bucket. Tracking the new picture means watching two fields on the same private endpoint at once.
Direct answer (verified 2026-05-11)
On Claude Max, watch two fields on claude.ai/api/organizations/{org}/usage: seven_day_oauth_apps.utilization (the OAuth-connected app weekly bucket) and extra_usage.used_credits (the dollar burn from third-party tool calls under the post-April-4 metered billing). The official Settings page shows both, but you have to refresh it manually. Source for the billing change: Anthropic's extra-usage support article.
The two fields, in the actual JSON
Both fields live on the same payload. The struct ClaudeMeter parses them into is in claude-meter/src/models.rs lines 4 to 28. Two of the eight optional fields carry the third-party-tracking signal:
And a representative payload, trimmed to just the two fields:
Reading them by hand with curl
You don't have to install anything to confirm the picture. Grab your Cookie header from DevTools at claude.ai/settings/usage, then run the two requests below. The Referer header is load-bearing; drop it and the endpoint returns 403.
Which tools land where, after April 4
The rule is simple but easy to forget: only Claude Code and claude.ai itself stay inside the plan. Everything else routes to the extra-usage bucket and charges per token.
| Feature | What the tool's own UI shows | Claude Max plan state |
|---|---|---|
| Claude Code | Visible in ccusage and Claude-Code-Usage-Monitor as local token counts | Inside the plan, draws against five_hour + seven_day + seven_day_opus / seven_day_sonnet |
| claude.ai web chat | Not visible anywhere except the server endpoint | Inside the plan, draws against the same weekly buckets |
| Cursor (Bring your own Claude) | Cursor's own dashboard shows tokens, not your Max account state | Third-party path, bills against extra_usage.used_credits post-April 4 |
| Cline | Cline shows local model-level token counts only | Third-party path, bills against extra_usage.used_credits post-April 4 |
| Roo Code | Roo Code does not surface Max plan state | Third-party path, bills against extra_usage.used_credits post-April 4 |
| aider / OpenCode / OpenClaw | No plan-state visibility from those tools' own UIs | Third-party path, bills against extra_usage.used_credits post-April 4 |
| Any custom script using your Anthropic API key | Console API dashboard at console.anthropic.com is the source of truth | Does not touch /api/organizations/{org}/usage at all |
Why local-log trackers miss third-party tool spend entirely
ccusage and Claude-Code-Usage-Monitor are excellent for their purpose: they parse ~/.claude/projects/*.jsonl and tell you which Claude Code session burned which model and at what cost. But Cursor, Cline, Roo Code, aider, and OpenCode do not write to that directory; their traffic is invisible to anything that reads only local logs. After April 4, that means a Max user whose dollar burn is dominated by Cursor calls will see ccusage report near-zero local usage while extra_usage.used_credits ticks past $50, $100, $150. The dollar number only exists server-side.
| Feature | ccusage / Claude-Code-Usage-Monitor | ClaudeMeter (server-truth) |
|---|---|---|
| Sees Claude Code traffic | Yes, via local ~/.claude/projects/*.jsonl | Yes, via server-side seven_day_oauth_apps + extra_usage |
| Sees Cursor / Cline / Roo Code / aider / OpenCode | No, none of these write to ~/.claude/projects | Yes, they all bill against extra_usage.used_credits |
| Sees the dollar burn from per-token metered billing | No, local logs do not see dollar charges | Yes, extra_usage.used_credits in the same payload |
| Distinguishes plan quota from metered $$ | Not applicable; only one side is visible | Yes, plan buckets and extra_usage rendered side by side |
| Data source | Local JSONL transcripts on disk | GET /api/organizations/{org}/usage (claude.ai session cookie) |
| License | MIT, no network, complementary | MIT, single HTTPS request per minute, no telemetry |
The five-step walkthrough
Open claude.ai/settings/usage signed in
That single page reads three private endpoints behind the scenes: /api/organizations/{org}/usage (seven Window buckets plus extra_usage), /api/organizations/{org}/overage_spend_limit (monthly_credit_limit and used_credits), and /api/organizations/{org}/subscription_details (next charge date). Two of those payloads carry the third-party numbers you need.
Find seven_day_oauth_apps
This is the weekly bucket the server uses to account for OAuth-connected app traffic. After April 4, 2026, the dollar billing for third-party tools moved off the plan, but this counter still ticks for accounts with OAuth integrations connected. The utilization field is either 0..1 or 0..100 depending on the bucket; ClaudeMeter normalizes with u <= 1 ? u * 100 : u in extension/background.js.
Find extra_usage.used_credits
Inside the same JSON payload. It is the literal dollars burned this month by third-party tool calls (and any overage from plan exhaustion). Compare it to monthly_limit to see how close you are to the ceiling you set. Anthropic also exposes the canonical month-to-date number on /api/organizations/{org}/overage_spend_limit for cross-check.
Decide whether you need both numbers at a glance
If you only run Claude Code and claude.ai, plan utilization is enough. If you keep Cursor or Cline open all day, extra_usage.used_credits is the one that matters and you want it in a sticky surface, not a tab you reload. ClaudeMeter polls both once a minute, so the menu bar number stays accurate without manual refreshes.
Install the menu bar app + extension
brew install --cask m13v/tap/claude-meter, then load the unpacked extension/ folder from github.com/m13v/claude-meter into chrome://extensions (or arc://, brave://, edge://). Visit claude.ai once. The extension reuses your existing session cookie with credentials: 'include' against the three endpoints above; no paste, no API key.
Why seven_day_oauth_apps still ticks
A common follow-up question: if the billing for third-party tools moved off the plan, why does the OAuth-apps weekly bucket still exist? Two reasons. First, the field is the server's accounting handle for OAuth-connected traffic regardless of how it routes through billing; removing it would break the Settings page. Second, Anthropic still rate-shapes OAuth-app traffic at the protocol layer to prevent runaway concurrency from any single integration, and the seven_day_oauth_apps window is the counter that throttle decision reads against. The plan dollars and the OAuth-apps window are separate mechanisms now; you need both fields to predict whether your next Cursor call is going to slow down (oauth_apps) or cost dollars (extra_usage), or both.
FAQ
What exactly changed on April 4, 2026 for Claude Max and third-party tools?
At noon Pacific on April 4, 2026, Anthropic stopped covering third-party tool usage under the flat Max subscription. Cline, Roo Code, aider, OpenCode, OpenClaw, Cursor, and anything else that authenticates with a Claude OAuth token (or relays your session) now bills at per-token API rates against your extra_usage balance. Claude Code and claude.ai are still inside the plan. Anthropic gave Max users a one-time $200 credit with an April 17 deadline; after that, third-party tool calls draw real dollars from the pay-as-you-go pool. Source: support.claude.com/en/articles/12429409-manage-extra-usage-for-paid-claude-plans, and Anthropic's pricing page.
So why is there still a seven_day_oauth_apps bucket if those calls aren't on the plan anymore?
Because the field exists on every Max account's /api/organizations/{org}/usage response regardless of how the billing routes. seven_day_oauth_apps tracks utilization attributed to OAuth-connected app traffic against an internal weekly cap that the server still maintains for accounting and rate-shaping. The field stays at zero on accounts with no OAuth integrations and ticks up when integrations are connected. The dollars-out side of third-party tools sits in the extra_usage block in the same payload, with used_credits and monthly_limit. Watching either one alone gives a partial answer.
Where do I see the dollar burn for third-party tools?
Two places on the same private endpoint: /api/organizations/{org}/usage carries the extra_usage block ({ is_enabled, monthly_limit, used_credits, utilization, currency }) and /api/organizations/{org}/overage_spend_limit carries the canonical month-to-date used_credits and the monthly_credit_limit you set. claude.ai/settings/usage renders both. ClaudeMeter parses both into Rust structs (ExtraUsage and OverageResponse in src/models.rs) and shows them next to the seven Window buckets, so you can see plan-quota exhaustion and dollars-spent at the same moment.
Can ccusage or Claude-Code-Usage-Monitor show third-party tool spend?
No. ccusage and Claude-Code-Usage-Monitor walk ~/.claude/projects/*.jsonl on disk; that ledger only exists for Claude Code itself, which writes those JSONL transcripts locally. Cursor, Cline, Roo Code, aider, and OpenCode do not write to ~/.claude/projects, so a local-log reader literally never sees them. The only place those calls show up is on the server: as movement on seven_day_oauth_apps (when the integration uses OAuth) and as used_credits ticking on the extra_usage block. ClaudeMeter and ccusage measure different things; they coexist rather than compete.
Why is 'claude max third party usage tracking' even a category?
Because $200/month Max users were running thousands of dollars of agentic work through third-party tools under the flat fee before April 4. The change repriced that work, and the same users who built workflows around it now need a live read on two numbers they did not need to watch before: how much OAuth-app utilization they have left this week, and how many dollars they have spilled into metered billing this month. The official UI shows both but you have to keep refreshing the page; the third-party tracking category exists to put them in a sticky surface.
Does Cursor count as a third-party tool for this?
Yes, on the Max-via-OAuth path. Cursor's 'Bring your own subscription' flow authenticates against your Claude account; after April 4 the calls it makes bill against extra_usage at per-token rates rather than coming out of your flat Max allowance. You'll see them show up as dollar movement on extra_usage.used_credits. The seven_day_oauth_apps bucket may also tick depending on how Cursor's integration is structured. If you point Cursor at a separate Anthropic API key instead, those calls don't touch your Max account at all and don't appear on /api/organizations/{org}/usage.
Can I curl the endpoint myself to check?
Yes. Sign in to claude.ai, open DevTools at claude.ai/settings/usage, copy the full Cookie header on the /usage request, grab your org UUID from /api/account memberships[0].organization.uuid, and run: curl -s claude.ai/api/organizations/$ORG/usage with the Cookie header you copied and a Referer header pointing at claude.ai/settings/usage. The Referer is load-bearing; drop it and you get 403. The JSON you get back has seven Window objects (five_hour, seven_day, seven_day_sonnet, seven_day_opus, seven_day_oauth_apps, seven_day_omelette, seven_day_cowork) and the extra_usage block. That single curl is a faithful snapshot; the reason a poller is worth installing is that the rolling denominators slide as old traffic ages out, so the numbers drift between snapshots.
Is ClaudeMeter open source and free?
Yes. MIT-licensed Rust core for the macOS menu bar app, Manifest V3 JavaScript for the browser extension, source at github.com/m13v/claude-meter. There's no telemetry: a single HTTPS request per minute to claude.ai with your own session cookie. The extension reads the same private endpoint claude.ai/settings/usage renders from, so the numbers match the official page exactly.
What about Safari, Linux, Windows?
Today the menu bar surface is macOS 12+ only. The browser extension targets Chrome, Arc, Brave, and Edge (Manifest V3). Safari and Linux/Windows menu bar are not on the roadmap. If you're outside the macOS+Chromium combo, the practical fallback for tracking the same two fields is to keep claude.ai/settings/usage open in a tab, or run the curl above on a cron. ClaudeMeter just removes the manual refresh; it doesn't change the underlying data source.
Want to read your own oauth_apps and extra_usage values together?
Fifteen minutes; we open claude.ai/settings/usage on your account, pull the JSON, and identify whether oauth_apps utilization or extra_usage dollars is the one biting your workflow first.
Related guides
Claude Max usage tracking: it is seven counters, not one
Full breakdown of the seven Window buckets the /api/organizations/{org}/usage endpoint returns, which one bites which workload first, and why combining them into a single bar hides the real story.
Reading the extra_usage block: dollars, not tokens
Field by field walkthrough of the metered-billing block on /api/organizations/{org}/usage. is_enabled, monthly_limit, used_credits, utilization, currency, and how each one is displayed in ClaudeMeter.
Open source Claude usage trackers: local-log vs server-truth
Seven OSS trackers sorted by what they actually read. Local JSONL counters cannot see third-party tool spend; server-truth tools can. The one tracker that uses your real browser cookie via credentials: 'include'.