Anthropic Documents How Default Models Change. The Bill Arrived Before the Explanation Did.
Anthropic's April email disclosed a 1.67× price jump when it changed Claude Code's default model. The mechanism was in the docs for months. The compounding cost math wasn't.
On April 30, 2026, Anthropic changed the default model for most Claude Code organizational accounts from Sonnet 4.6 to Opus 4.7. An email told subscribing organizations the switch was coming and added one sentence about cost: "This may result in higher-cost usage." It disclosed three specific multipliers. It did not model what they compound to.
The mechanism that changes your default model is documented in Anthropic's own docs. The number that tells you what it costs — the combined ~2.4× multiplier from price, tokenizer, and effort — was not.
I am one paying Claude Code subscriber. My June 28–29 invoices came to $53.47 and $49.04 in 24 hours; my Aug–Dec 2025 baseline was a few $50 invoices every three to four weeks. Some of that increase is real editorial output — more agents, a full KB pipeline, multi-session workflows. I want to say so precisely, because conflating them would discredit this analysis. The ~2.4× per-call multiplier is the model-switch signal. Workload growth is a separate confound. Only one was in the email.
What the Docs Page Says — and Doesn't
Anthropic's code.claude.com/docs/en/model-config documents default-model-resolution by account tier. Wayback Machine archives of this page predate April 30 — a November 2025 snapshot states "The behavior of default depends on your account type" and documents Max-tier fallback behavior. The page has been updated as models launched; the current tier table reflects today's defaults. What it has not contained, across versions, is cost quantification. The mechanism is not hidden. The math is.
- Max, Team Premium, Enterprise pay-as-you-go, Anthropic API: Opus 4.8
- Claude Platform on AWS: Opus 4.7
- Pro, Team Standard, Enterprise seat: Sonnet 5
What the page does not contain: any quantification of cost. It tells you which model activates. It does not tell you the three multipliers stack — 1.67× per-token price, input-token inflation from the tokenizer, up to 30% effort overhead — into a combined ~2.4× per-call increase for unchanged workloads. Documenting the switch and disclosing the impact are not the same disclosure.
The Sonnet 5 Contrast Is Load-Bearing
On June 30, 2026, Anthropic published its Sonnet 5 launch post. Footnote 2: "The same input can map to more tokens: roughly 1.0–1.35× depending on the content type. The introductory pricing is set so that the transition to Sonnet 5 is roughly cost-neutral."
Anthropic wrote that sentence. It offset the tokenizer change with cost-neutral pricing and increased rate limits. None of these appeared in April's email about Opus 4.7. OneHuman's argument is not that Anthropic never discloses this — it did, clearly, on June 30. The argument is the contrast: Anthropic knows how to write that sentence, and chose not to in April.
The Recursive-Opacity Problem
There is one angle this story has that no outside journalist can report from experience.
OneHuman publishes via Claude Code. I discovered the default-model change by investigating my own invoices inside a Claude Code session. That investigation ran at Opus 4.8 rates, because the switch had not yet been configured away. Every minute spent inside the inflated pricing investigating the inflated pricing billed at the inflated pricing. Anthropic provides no line item for "tokens spent investigating why you're being charged more." That is a billing architecture, not a conspiracy — and the watchdog's own infrastructure is the subject of the watchdog's own report.
What the Docs Don't Resolve
The docs say the default alias "updates over time." Subscribers can set ANTHROPIC_MODEL to claude-sonnet-4-6 to hold a specific model. Claude Code itself recommended Sonnet 5 for workloads that don't need the extended agentic reasoning Anthropic describes as Opus 4.8's differentiator.
What the docs don't resolve: the 4.7-to-4.8 transition. No email announcing that change has surfaced. Anthropic confirmed Opus 4.8 in its July 1 X post. The docs list it. A subscriber notice does not appear to exist.
What Happens Next
30 days: does the next default-change notice include a cost-quantified multiplier, the way Sonnet 5's footnote did? 90 days: the default alias updates over time — the next transition tests whether April was one-off or structural. 6 months: watch whether the class-action (BNA #8) produces billing-transparency commitments.
Bottom Line
The April email disclosed the switch. The docs disclose the mechanism. What neither discloses is the combined ~2.4× cost multiplier in quantified form. Anthropic closed that gap on June 30 for Sonnet 5. It has not closed it retroactively for April. The opt-out is real. The model upgrade is real. The disclosure gap is also real. A watchdog's job is not to pick one.
Sources
- Anthropic Claude Code docs — model-config — verified July 2, 2026; Wayback Machine confirms page acknowledging tier-based defaults predates April 30, 2026; current tier table reflects July 2026 model lineup
- Anthropic — Claude Sonnet 5 launch post, Footnote 2 — June 30, 2026
- Anthropic X post (@AnthropicAI, July 1, 2026) confirming Opus 4.8 as Claude Code fallback — screenshot on file
- Anthropic April 2026 email to Claude Code organizations — screenshot on file
- r/ClaudeAI thread: reddit.com/r/ClaudeAI/comments/1ukn4l0 — OneHuman acknowledged the docs page in-thread
- OneHuman prior coverage: Anthropic Throttle · Naming Opacity · Claude Max Class Action
Verified · July 2, 2026
Independent. AI-assisted. Human-verified. No ads. No affiliates. No investors.
Share This Article
"Anthropic's April email told me my Claude Code default was switching to a more capable model. It did not tell me the compounding cost effect was ~2.4×. Those are not the same disclosure."
"Anthropic disclosed the identical tokenizer multiplier for Sonnet 5 — in a footnote, with a cost-neutral offset. The April Opus 4.7 email had neither. Anthropic knows how to write that sentence. It chose not to in April."
"I spent two hours inside Claude Code verifying why my bill doubled. That verification ran at Opus 4.8 rates — because the default-model switch I was investigating had not yet been applied to my session. Recursive opacity is real and it is billable."
"The mechanism that changes your Claude Code default is documented. The number that tells you what it costs you is not. Documenting the switch and disclosing the impact are not the same thing."
Related: Claude
- • Anthropic Sued Over Claude Max: Plaintiff Says the 20x Plan Delivers 6–8x
- • Claude Doubled Your Limits, Moved Into Office, and Started Scanning Your Sessions
- • Claude Absorbed Figma, Canva, and 9 Work Apps. Your Phone Is Now the Control Room.
- • Claude Sonnet 4.6 Is Now the Default — And It's Beating Opus
- • Can Your $150K Knowledge Job Survive a $20/Month AI?