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, cache reads and writes are priced separately, and the worker count and context length are marked as assumptions set for this example, with the arithmetic laid out so anyone can re-run it.
Updated 2026-10-20
Prices change: on QCode, Claude, GPT and Chinese models are billed per token — live rates on /models.
- Billed per token — live rates on /models
- Pay by card (Visa / Mastercard), Apple Pay, Google Pay or crypto
- Self-service: top up and activate instantly
Four key points
Its own context per agent
Both official pages read as linear: the agent teams page writes that token costs scale linearly, and in one team every teammate runs its own context window with token usage roughly proportional to team size. The only multiple given (agent teams in plan mode) names its unit as well: about 7 times the tokens of a standard session — tokens, not the bill. What pulls it off that multiple is the fixed prefix per request: teammates load CLAUDE.md, MCP servers and skills, and the official text gives no token count for them.
A model switch re-reads the whole conversation
Hits are prefix hits: the cache stores the shared prefix at the start of a request, and the official text says a hit requires the prefix to match word for word, including all text and images up to and including the block marked with cache control; caches are also isolated between organizations and never shared, even for identical prompts. In Claude Code each worktree is a separate working directory with its own files and branch, so N worktrees of one repository mean N prefixes. The Claude Sonnet 5 row of the Anthropic price list: input $2, cache read $0.20, cache write $2.50 per MTok on the 5-minute tier, and the price list notes that the cache tier is priced on a 5-minute TTL.
Warned first, blocked after
The official quota page says the session and weekly limits are shared across all models, then that a subscription session can stay open and continue after the reset, and concludes that parallel runs change only the total, not the cost of one request. The bar covers the 5-hour or 7-day limit consumed, from 0 to 100, and the reset time; which account it covers, the official text does not settle. That page names only Claude Code, Claude Desktop and claude.ai for the shared quota; we extend it to nothing more. Before the line is reached the official text warns first: the session limit is 85% used, and it shows the reset time. On the API side the limits are RPM, ITPM and OTPM, an excess returns 429, and the concurrency of this key is 5, so the extra agents queue instead of being blocked. Checked on 2026-10-20.
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 — so 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 official text describes that allowance in messages and working time and gives no token formula, so none is invented here.
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; on the API side capacity is refilled continuously rather than being reset at fixed intervals. For usage-based billing the official text says usage is metered per request, so there is no reset to wait for.
Quota wording, recent
The quota baseline moved twice this half year, both in one official article. The temporary bump ran from 2026-05-13 through 2026-09-13, with the weekly usage limit in Claude Code 50% higher and the 5-hour layer not part of it; from 2026-09-14 the weekly tier sits above its pre-promotion level — the weekly limits in Claude Code are 25% higher than they were before the promotion, for Pro, Max, Team and seat-based Enterprise plans — and it is 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 of that day, not a percentage. Two other dated items can be checked: on 2026-03-16 the official usage policy got an explainer on agents that lists creating or managing multiple accounts to evade detection or circumvent platform safeguards as prohibited; on 2026-08-10 the official changelog of that week published the Claude Code Desktop auto-continue after a usage limit resets. Prices are current values: Sonnet 5 input $2, cache read $0.20, cache write $2.50 (as of 2026-10-20); the footer warns prices can change at the vendor's discretion. Checked on 2026-10-20.
When we checked
2026-05-13: a help-centre article states that from 2026-05-13 through 2026-09-13 the weekly usage limit in Claude Code was 50% higher and that the 5-hour limits were not affected by that 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. The official text gives a concrete percentage in this one place only, so every multiple here stays the official sentence of that day. Checked on 2026-10-20.
2026-09-14: the same article makes part of that boost permanent — the 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. Checked on 2026-10-20.
2026-10-20: the price figures and limit sentences were compared word for word with the official archives of that day. The Claude Sonnet 5 row on claude.com/pricing gives the unit price for input, output, cache read and cache write, and that page states that prices and plans are subject to change at Anthropic's discretion — prices only read correctly with that date attached.
What the official text covers vs what it leaves out
Official wording, checked item by item
The limits, the parallelism and the behaviour at the ceiling all line up with the official documentation. Limits: a paid subscription carries two of them — «Your session-based usage limit will reset every five hours.» is the official wording for the 5-hour one, the other resets once a week; claude.ai, Claude Code and Claude Desktop share a single allowance on one account, and the weekly limit resets at a fixed time every week. Parallelism: every teammate runs its own context window, and another official page writes «Token costs scale linearly»; the only multiple the costs page gives is agent teams in plan mode at about 7 times the tokens of a standard session, and that is tokens, not money. At the ceiling: Claude Code blocks further requests until the reset time shown in the message, switching models does not restore access, and on a subscription it can wait in the open session and continue shortly after the reset.
Where the official text stays silent
Three things the official documentation does not spell out. One, the formula that turns a subscription quota into tokens: the official text describes the quota through how many messages you can send and how long you can work and gives no formula in tokens, so that layer is checked against the status bar and the provider's bill. Two, how many tokens one workflow or agent team run costs: the official wording gives only the direction — every teammate carries its own context, and a single run can use meaningfully more tokens than working through the same task in conversation — and no task-level token count. Three, the concrete values of the weekly and the 5-hour limit: the help centre publishes the reset rules only, no absolute numbers, so that layer is read off the counters. The 2026-09-22 version also recorded three claims the official documentation 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, and the official wording points the other way, since Claude Code holds later agents so their first requests read the shared prefix instead of each processing it uncached. Two, "it warns at 80%": 80% is not official wording, the Claude Code example says You've used 85% of your session limit, and the two numbers have different subjects; the price list's $2 / MTok input and $0.20 / MTok cache read are official unit prices, and no official 80% threshold exists. 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 on 2026-10-20.
Parallel or single session
N parallel agents
The parallel side multiplies by copies. The official text gives no token count, so only this can be checked: every agent carries its own context, and token usage is roughly proportional to team size. The only multiple the Claude Code costs page gives is agent teams in plan mode at about 7 times the tokens of a standard session — a token count, not a money amount. The assumptions set for the example are the fixed prefix P = 40,000, the agent count N = 5 and the turn count T = 20, so only that one prefix is counted. Unit prices come from the Claude Sonnet 5 row of the price list: input $2 / MTok, cache read $0.20 / MTok, cache write $2.50 / MTok, with both cache rows priced on a 5-minute TTL.
One long session
The single-session side pays the fixed cost once: after the prefix is written, every later round is billed as a cache read at $0.20 / MTok, the price list notes that the cache tier is priced on a 5-minute TTL, and the official text says cached prefixes expire after 5 minutes of inactivity. Against the price list, the listed input price is $2 / MTok and the cache read is $0.20 / MTok; how far apart those two numbers are is a division inside the price list, not a multiple the bill grows by. What hurts there is a gap: switch models and the next request reads the whole conversation again with no cache hit, even when the content is word for word identical.
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. The official text gives no token count, so P = 40,000 is an assumption set for this example, not an official number. 2) Multiply by parallelism and turns: the official text says each teammate runs its own context window and that token usage is roughly proportional to team size; take N = 5, T = 20. 3) Price it off the unit prices of the official price list, taken from the Claude Sonnet 5 row of claude.com/pricing: input $2 / MTok, cache read $0.20 / MTok, 5-minute cache write $2.50 / MTok. A cold round and a fully cached round each multiply that prefix by the N and T above; the cache write is counted once per agent as an upper bound. 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, billed per token; per-model rates are listed on the Models page. The usage query endpoint for your key is read-only: it can query only the API keys on your own account, it cannot create, change or spend balance, and the query token itself has per-minute and per-day caps with seconds of cache, so it is not a meter to poll endlessly. One more constraint on parallelism: a personal plan's API key allows 5 concurrent requests, and further agents queue instead of opening an extra lane. Out of quota? Do not wait for the reset — with an active personal plan buy a booster pack, without one buy Pay-as-you-go Packs, which start at $4 for a one-time quota you use within 7 days (top-ups start at $5).
FAQ
Can it switch accounts automatically once a limit is hit?
Do not expect that; the official text makes no such promise. What the docs specify is that Claude Code blocks further requests until the reset time shown in the message, and swapping models does not help either: session and weekly limits are shared across all models. The sanctioned way to resume is to leave the session open on a subscription and continue the interrupted task shortly after the reset — the same subscription waits out the reset, it does not hop accounts. More importantly the official usage policy lists Create or manage multiple accounts to evade detection or circumvent platform safeguards as prohibited, so switching account at the cap is not an official route. The parallel side is the same: a few more agents do not open a second line, they hit the same 5-hour window and the same weekly limit. The official text describes subscription quota through how many messages you can send and how long you can work, and gives no formula in tokens, so any conversion is checked against the status bar and the provider's bill. 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 on 2026-10-20.
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, even when the content is word for word identical. For accounts, what the docs actually say is that caches are isolated between organizations and that 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 the prefix to match 100% identical prompt segments, so a branch name or a per-worktree path inside the prefix defeats the hit. For worktrees the official wording is that each worktree is a separate working directory with its own files and branch. The community talk of a bill exploding once the quota is burned has no official counterpart in the official pages: it is community feedback without an official wording. Checked on 2026-10-20.
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 the 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 the extra prefixes you pay for. Checked on 2026-10-20.
What does the official text warn you with before the cap, and is a figure like 80 percent official wording?
Start with provenance: the official text warns that a window is almost used up and sets no percentage of its own — 80 percent is not official wording, and the official pages give no 80% threshold — while Anthropic's own example wording is 85% of your session limit. The layer it watches is a pair, five-hour session and weekly usage limits, defined mechanically as the percentage of the 5-hour or 7-day rate limit consumed, from 0 to 100, and those windows appear only for claude.ai Pro and Max subscribers, so an API key has neither. So read the number only after checking which credential you are on. Fine as a brake light, wrong as a reconciliation basis: the official documentation has no fixed percentage threshold, only this kind of warning. Checked on 2026-10-20.
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, which the official text answers by ramping traffic up gradually. 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; the extra agents queue, and queueing is not a ban. Checked on 2026-10-20.
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 that prices and plans are subject to change at Anthropic's discretion, and the cache tier carries the 5-minute TTL note. Second, verify hits yourself: cache hits require 100% identical prompt segments, so one differing byte in the prefix means no hit. Third, reconcile against the provider's bill or against this site's key: claude.ai, Claude Code and Desktop share one allowance on an account, so you assemble the provider or key bill, not a sum of status bars. The token volume, the agent count and the turn count in the example are assumptions set for it, so do not read them as official numbers when you copy the example; prices follow the price list, limits follow the subscription, and the two must not be mixed. Checked on 2026-10-20.
Sources
Officially from Anthropic: price list https://claude.com/pricing (lines 1259 to 1268 of the official pricing page are the Claude Sonnet 5 block, line 129 holds the change-reserved note and line 1223 the 5-minute TTL note); docs https://code.claude.com/docs/en/costs, /errors, /agent-teams, /workflows, /sub-agents, /statusline, /interactive-mode, /prompt-caching, /whats-new/2026-w33; platform docs https://platform.claude.com/docs/en/api/rate-limits, /build-with-claude/prompt-caching; help-centre articles 11049741, 11647753, 12005017, 12429409, 17007452, 9797557, 14552983. Also on the QCode site: https://qcode.cc/pricing, https://qcode.cc/api-key-usage-query-guide, https://qcode.cc/claude-code-weekly-limit-october-2026, https://qcode.cc/pay-as-you-go. All of it comes from the official pages.
Match unit prices and concurrency
Unit prices and limit wording follow the official documents; the token volume, agent count and turn count in the example are this page's own stated assumptions. Out of quota? Do not wait for the reset — with an active personal plan buy a booster pack, without one buy Pay-as-you-go Packs, which start at $4 for a one-time quota you use within 7 days (top-ups start at $5).
Related reading
Claude Code weekly limit, October 2026
The rules in force, the fixed weekly reset time, and the ways out the official text offers after a cap: wait for the reset, upgrade the plan, or buy usage credits; help-centre text re-checked 2026-10-13.
Claude Max alternative: three paths and the metered math
Checked 2026-11-04: the three Claude Max alternatives, official Pro / Max / Ultra prices and limits, metered API billing and concurrency, switching and mixing.
Orca agent development environment guide
What it is, what it is not, how it runs agents in separate worktrees, plus install steps and name-collision traps.
Crypto payment guide
Nine coins, 56 networks, zero platform fee for AI coding API credits.
Prices and limit wording are as of 2026-10-20, paraphrased from Anthropic's public documentation and price list; the official price list itself reserves the right to change prices and plans, and its cache tier is priced on a 5-minute TTL. The token volume, agent count and turn count in the worked example are this page's own stated assumptions; only the unit prices and the multiple come from the official pages. QCode is one provider of the reader's own key.