Quota and cost math · checked 2026-09-22

Parallel agents quota and cost: one pool, N contexts

When several agents run at once, what is being spent: Claude's subscription-side 5-hour window and weekly cap, or this site's own daily API quota? The two clocks are counted apart here — unit prices are Anthropic's published rates as of 2026-09-22, cache reads and writes are tallied separately, and the worker count and context length are marked as assumptions, with the arithmetic laid out so anyone can re-run it.

Updated 2026-09-22

#5-hour window, weekly limit#N parallel agents#cache hits and cache writes#examples you can recompute

Four key points

Near-linear

Its own context per agent

Both pages read as linear: "Token costs scale linearly", "token usage is roughly proportional to team size". The one multiplier it gives (agent teams in plan mode) names its unit: "approximately 7x more tokens than standard sessions" - tokens, not the bill. What pulls it off xN is the fixed prefix per request: teammates load CLAUDE.md, MCP servers and skills, and no token count is given. Checked on 2026-09-22.

Prefix hit

Its own cache write per worktree

"The API caches by matching the start of each request, called the prefix" - hits are prefix hits. In Claude Code the cache is per machine and per directory: "each worktree has its own working directory", so N worktrees of one repo means N prefixes and N cache writes. The Claude Sonnet 5 row on the Anthropic price list (as of 2026-09-22): input $2, cache read $0.20, cache write $2.50 per MTok, 5-minute tier. Input over cache read is 10 times - a ratio of two listed numbers, not a bill up 10 times. Checked on 2026-09-22.

Reads local state

The bar shows the active account

The usage-tracking page says "Orca reads the local usage state each agent maintains on disk", then "No API calls, no extra auth.", and concludes "numbers update when the agent writes, not in real time". The bar covers the active account only, and estimated rows say "not a live bill from the provider". That page names only Claude Code, Codex, Gemini, OpenCode, Kimi Code and MiniMax; we extend it to nothing more. Checked on 2026-09-22.

One shared pool

Parallel gets no separate meter

Start with the errors page: "A single burst of heavy activity, such as a large workflow fanout, can exhaust the weekly allowance before the session window resets." Both allowances count at once — "Usage counts against the session and weekly allowances at the same time" — and running agents in parallel does not open a second meter. Everything under one account (claude.ai, Claude Code, Claude Desktop) draws on the same allowance. The vendor describes that allowance in messages and working time, not a token formula, so this page does not invent one. Checked 2026-09-22.

How the quota is metered

Quota is not metered by session count or by parallel width: the official model accumulates tokens against two windows, a 5-hour session and a weekly limit reset at a fixed time per account, and both are shared across all models. On one account claude.ai, Claude Code and Claude Desktop draw on the same limit, so running N agents in parallel opens no second ledger — the same fixed context is simply counted again. Keep the subjects apart: those windows belong to the Claude Code subscription; API metering keeps replenishing capacity instead of resetting it. Checked 2026-09-22.

The weekly tier this half year

The quota baseline moved twice this half year, both in one official article. The temporary bump reads From May 13, 2026 through September 13, 2026, your weekly usage limit in Claude Code was 50% higher, and the 5-hour layer was not part of it; from 2026-09-14 the weekly tier sits above its pre-promotion level — starting September 14, 2026, weekly limits in Claude Code are 25% higher than they were before the promotion — limited to Claude Code. So after 2026-09-14 a fan-out faces a weekly tier that is neither the promotional nor the pre-promotion figure, and multiples here stay the official sentence captured that day, not a percentage. Prices are current values: Sonnet 5 input $2, cache read $0.20, cache write $2.50 (as of 2026-09-22); the footer warns prices can change at the vendor's discretion. Checked 2026-09-22.

When we checked

2026-05-13

2026-05-13: a help-centre article states "From May 13, 2026 through September 13, 2026, your weekly usage limit in Claude Code was 50% higher. 5-hour usage limits were not affected by this promotion." The boost sat on the weekly layer only, the 5-hour window was untouched, it covered Claude Code alone (CLI, IDE extensions, desktop, web), and it ended on 2026-09-13. Checked on 2026-09-22.

2026-09-14

2026-09-14: the same article makes part of that boost permanent - "starting September 14, 2026, weekly limits in Claude Code are 25% higher than they were before the promotion for Pro, Max, Team, and seat-based Enterprise plans". Every weekly-quota statement here is written against the wording in force after that date. This page was checked on 2026-09-22.

2026-09-22

2026-09-22: the price figures and limit sentences here were captured from the official archives that day and compared word for word. The Claude Sonnet 5 row on claude.com/pricing gives input, output, cache read and cache write, and that page states "Price and plans are subject to change at Anthropic's discretion." Prices only read correctly with that date attached; strip it and they stop being true. Checked on 2026-09-22.

Verbatim in the docs vs community lore

Verbatim in the official text

Four blocks, all matching the official text captured 2026-09-22 word for word. Limits: Your session-based usage limit will reset every five hours, Max plans also have a weekly usage limit that applies across all models; the weekly tier resets at a fixed time assigned to your account; claude.ai, Claude Code and Claude Desktop share one limit. Parallelism: Each teammate runs its own context window, so token usage is roughly proportional to team size, and the only multiple the vendor gives is Agent teams use approximately 7x more tokens than standard sessions when teammates run in plan mode — about tokens, not money. Ceiling: Claude Code blocks further requests until the reset time shown in the message; switching models does not restore access. Orchestrator side: Orca reads the local usage state each agent maintains on disk — No API calls, no extra auth.

⚠️ Community lore, no official wording

Three claims the captured official text does not support. One, "parallel agents bust the cache, so the bill jumps to 10x or 50x": neither appears there — community feedback, no official wording. The official wording points the other way: Claude Code holds later agents so their first requests read the shared prefix instead of each processing it uncached. The only 10 here is $2 divided by $0.20: two table prices, not a bill increase. Two, "it warns at 80%": 80% is the orchestrator's own threshold (Orca: A warning chip when you cross 80% of a limit.), the Claude Code example says You've used 85% of your session limit. Three, "it switches accounts by itself when the quota fills": undocumented; the Usage Policy forbids keeping several accounts to evade limits. Documented: blocking until the reset time, or continuing in the open session on a subscription. Checked 2026-09-22.

Parallel or single session

N parallel agents

The parallel side multiplies by copies. The assumption is ours, the vendor publishes no token count: each agent re-sends a fixed 40000-token prefix, 5 agents, 20 rounds each, only that prefix priced. The Sonnet 5 row lists input at $2 per million tokens: one round = 40000 / 1000000 × $2 = $0.08, total = $0.08 × 5 × 20 = $8.00. The cache write is counted once per agent, in its first round, as an upper bound (the vendor also lets sibling agents re-read one another's prefix), at $2.50: 40000 / 1000000 × $2.50 = $0.10, so 5 agents add $0.50. Prices as of 2026-09-22.

One long session

The single-session side pays the fixed cost once: after the prefix is written, every round bills as a cache read at $0.20, and the list input price $2 divided by it is 10 — two numbers from the price table, not a bill multiplied by 10. A gap is what hurts: Cached prefixes automatically expire after a minimum of 5 minutes of inactivity, the cache rows carry the note Prompt caching pricing reflects 5-minute TTL, and after a model switch the next request re-reads the whole conversation with no cache hits. Checked 2026-09-22.

A three-step way to price the fan-out

1) Measure the fixed prefix P of one task: system prompt, tool definitions, CLAUDE.md, all re-sent each turn. Anthropic publishes no token count, so P = 40,000 is a stated assumption, not an official number. 2) Multiply by parallelism and turns: each teammate has its own context window and consumes tokens independently, and token usage is roughly proportional to team size; take N = 5, T = 20. 3) Price it off the Sonnet 5 row of claude.com/pricing as of 2026-09-22: input $2 / MTok, cache read $0.20 / MTok, 5-minute cache write $2.50 / MTok. Cold turn: 40,000 ÷ 1,000,000 × 2 = $0.08, then × 5 × 20 = $8.00. Fully cached: 40,000 ÷ 1,000,000 × 0.20 = $0.008, so $0.80. One write per agent: 40,000 ÷ 1,000,000 × 2.50 = $0.10, so 5 agents = $0.50. Input divided by cache read is 10 ($2 ÷ $0.20): two numbers on a price list, not a bill times 10. Output and tool results are outside this example.

What your own key can show you

Two clocks apart. The 5-hour window and the weekly cap are Claude subscription machinery, not ours. We sell an API: the only usage dimension left on personal plans is a daily limit. Your key shows expiry, today's usage, monthly quota and utilisation for active API keys; that endpoint is read-only, capped per minute and per day with seconds of cache, so it is no balance meter to poll forever. A personal key also allows 5 concurrent requests (as of 2026-09-22): more agents queue, they do not open a sixth lane. The orchestrator adds no aggregate ledger either — the bar follows the active account, and its cost line is not a live bill from the provider. No promise of savings, only numbers you can recompute (checked 2026-09-22).

FAQ

Can it switch accounts automatically once a limit is hit?

Not as a promise. What the docs specify is Claude Code blocks further requests until the reset time shown in the message, and the sanctioned way to resume is In an interactive session signed in with a claude.ai subscription, Claude Code can also wait in the open session and continue the interrupted task shortly after the reset — the same subscription waits out the reset, it does not hop accounts. Swapping models does not help either: session and weekly limits are shared across all models. More importantly the official usage policy lists Create or manage multiple accounts to evade detection or circumvent platform safeguards as prohibited. The weekly layer, per the docs, resets at a fixed time each week that is assigned to your account, independent of when you started (checked 2026-09-22).

Why do model or account changes break the cache?

For models the wording is explicit: Each model has its own prompt cache, so the next request re-reads the whole conversation with no cache hits. For accounts, what the docs actually say is Caches are isolated between organizations. Different organizations never share caches, even if they use identical prompts — move to another organization and the same prefix is written again, at 5-minute cache write tokens are 1.25 times the base input tokens price. Even staying put requires Cache hits require 100% identical prompt segments, so a branch name or a per-worktree path inside the prefix defeats the hit. The community figure of a 10 to 50 times bill has no official counterpart in the pages captured here: it is community feedback without an official wording, and this page does not write it as a cost claim (checked 2026-09-22).

Does splitting the task into more agents cost less?

Not necessarily; often the opposite. Every agent carries its own copy of the fixed prefix: Each subagent starts with a fresh, isolated context window, and each teammate has its own context window and consumes tokens independently, with token usage roughly proportional to team size; the workflows page adds that a single run can use meaningfully more tokens than working through the same task in conversation. Under this page's assumption P = 40,000, splitting one job into K parts pays that prefix K times — our arithmetic, not an official figure. The only multiplier Anthropic itself gives is plan mode agent teams at 7x more tokens than standard sessions, and that is tokens, not a bill seven times larger. The break-even test is one line: whether the duplicate reads you avoid exceed (K − 1) × P × the input price (checked 2026-09-22).

That 80 percent warning — whose number is it?

Start with provenance: 80 percent is the orchestrator's own threshold — its usage-tracking page says A warning chip when you cross 80% of a limit — while Anthropic's own example wording is 85% of your session limit; the two numbers are not the same thing. The layer it watches is a pair, five-hour session and weekly usage limits, defined mechanically as Percentage of the 5-hour or 7-day rate limit consumed, from 0 to 100, and those windows appears only for claude.ai Pro and Max subscribers, so an API key has neither. The readout itself is not live: numbers update when the agent writes, not in real time. Fine as a brake light, wrong as a reconciliation basis (checked 2026-09-22).

Does running agents in parallel trigger 429?

Two clocks again. On the API side limits are measured per model class in RPM, ITPM and OTPM, and going past them returns 429 with a retry-after; two official sentences land straight on parallelism: Short bursts of requests can exceed the limit and trigger rate limit errors, and a sharp jump in usage can also hit acceleration limits. That pool is sized where Limits are set at the organization level, so a fan-out never enlarges it, and capacity is refilled continuously rather than being reset at fixed intervals. On the subscription side the cap is not a 429: Claude Code blocks further requests until the reset time shown in the message. For API keys, cloud hosting and pay-as-you-go the docs say usage there is metered per request, so there is no reset to wait for — there is nothing to wait out. Our own key allows concurrency 5 (as of 2026-09-22); queueing is not a ban (checked 2026-09-22).

How do I estimate the real cost of a parallel run?

Follow the three-step example above, then add three limits. First, dates on unit prices: the official pricing page itself states Price and plans are subject to change at Anthropic's discretion, and the cache tier carries Prompt caching pricing reflects 5-minute TTL. Second, verify hits yourself: Cache hits require 100% identical prompt segments, so one differing byte in the prefix means no hit. Third, do not reconcile against the orchestrator: it covers 6 providers (Claude Code, Codex, Gemini, OpenCode, Kimi Code, MiniMax), it reads bookkeeping each agent writes to local disk (No API calls, no extra auth), its cost line is not a live bill from the provider, and the docs say Prefer the provider console for authoritative spend. On one account claude.ai, Claude Code and Desktop share one allowance, so you assemble the provider or key bill, not a sum of status bars (checked 2026-09-22).

Sources

Anthropic official: https://claude.com/pricing (lines 700 to 710 of the captured text are the Sonnet 5 block; 121 and 724 hold the change-reserved and TTL notes); https://code.claude.com/docs/en/errors, /costs, /agent-teams, /workflows, /statusline, /interactive-mode, /sub-agents; https://platform.claude.com/docs/en/api/rate-limits; https://platform.claude.com/docs/en/build-with-claude/prompt-caching; help-centre articles 11049741, 11647753, 12005017, 9797557. Third-party orchestrator: https://www.onorca.dev/docs/agents/usage-tracking. On this site: https://qcode.cc/pricing, /enterprise, /api-key-usage-query-guide, /claude-code-cost-optimization, /multi-tool-quota-rotation. All captured 2026-09-22; every external claim here keeps a dated raw capture and a word-for-word anchor you can re-check against the date printed on the page.

Match unit prices and concurrency

Unit prices and limit wording here were checked on 2026-09-22; the token volume, agent count and turn count in the example are this page's own stated assumptions. Nothing here promises that switching accounts or models keeps a run going, nor that following the arithmetic saves money — bring your own measured prefix to recompute.

Related reading

This page paraphrases documentation published by Anthropic and by a third-party orchestrator; we are affiliated with neither and hold no endorsement. Model prices, limit wording, coverage and status-bar behaviour are bounded by the texts captured on 2026-09-22, and the official pricing page itself reserves the right to change prices and plans. The token volume, agent count and turn count in the worked example are this page's own stated assumptions; only unit prices and multipliers have a source. Community claims of a bill multiplied many times over could not be verified in the official texts captured here, so they stay community feedback and are not written as cost claims. QCode is one provider of the reader's own key and is not responsible for the behaviour or the readouts of a third-party orchestrator (checked 2026-09-22).