Skip to content

fix(code-review): drop model:sonnet override — 1M-context billing footgun (v2.37.1) - #169

Merged
wongk merged 1 commit into
mainfrom
fix/code-review-orchestrator-model-1m-billing
Jun 26, 2026
Merged

wongk merged 1 commit into
mainfrom
fix/code-review-orchestrator-model-1m-billing

Conversation

@wongk

@wongk wongk commented Jun 26, 2026

Copy link
Copy Markdown
Collaborator

The bug

PR #167 added model: sonnet to the /start, /deep, /shallow command frontmatter to run the orchestrator on Sonnet. But a per-command model override inherits the session's context-window tier — so on a 1M-context session (e.g. a default of "Opus 4.8 (1M context)") the override resolves to claude-sonnet-4-6[1m], which bills as extra pay-as-you-go API usage outside a Pro/Max subscription.

Verified against current Claude Code behavior + docs:

So for anyone whose default session is a 1M model, #167 silently moved the orchestrator out of the subscription into billable API usage — and Opus-1M (included) is actually cheaper for them than Sonnet-1M (extra). The "optimization" inverted.

The fix

Remove the model: sonnet override from all three commands. The orchestrator runs on the session model again.

  • The model-independent wins from feat(code-review): hybrid-model orchestrator (Sonnet spine) + turn/context discipline #167 — never carrying the diff/large artifacts in orchestrator context, batching deterministic stages, narrating sparingly — are retained.
  • start.md and README.md now document the supported path to the cheaper orchestrator: run /code-review from a standard-context Sonnet session (/model sonnet), where Sonnet bills normally and is genuinely cheaper than Opus. The docs also explain why the frontmatter override is deliberately avoided, so it isn't re-added.

Scope / sequencing

6-file change (frontmatter + docs + version + CHANGELOG), no code. 2.37.0 → 2.37.1 (PATCH).

Branched from main (which has #167). Independent of the open #168 (premise category excision, v3.0.0) — they touch different sections of start.md. This hotfix should merge first (it's an active billing regression); #168 then rebases and re-bumps from 2.37.1.

🤖 Generated with Claude Code

…tgun

PR #167 added `model: sonnet` to the /start, /deep, /shallow command
frontmatter to run the orchestrator on Sonnet. But a per-command model
override inherits the session's context-window tier: on a 1M-context
session (e.g. a default of "Opus 4.8 (1M context)") it resolves to
Sonnet-with-1M, which bills as extra pay-as-you-go API usage OUTSIDE a
Pro/Max subscription (Sonnet 4.6 has no long-context rate premium, but
its 1M tier is not subscription-included the way Opus's is). There is no
per-command way to opt out of the session's 1M tier (known Claude Code
limitation: anthropics/claude-code#45847, #45169), so the override
inverted the intended saving for anyone on a 1M-default session.

Remove the override; the orchestrator runs on the session model again.
The model-independent turn-and-context discipline rules from v2.37.0 are
retained. start.md and README.md now document running /code-review from
a standard-context Sonnet session (`/model sonnet`) as the supported way
to get the cheaper orchestrator, and explain why the frontmatter override
is deliberately avoided so it is not re-added.

Version 2.37.1 (PATCH).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@wongk
wongk merged commit be9637c into main Jun 26, 2026
5 checks passed
@wongk
wongk deleted the fix/code-review-orchestrator-model-1m-billing branch June 26, 2026 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant