· By the ToolNav Team · 6 min read Anthropic Claude Model Deprecation Claude Agent SDK AI Pricing

Claude Sonnet 4 + Opus 4 Retire June 15 — Migrate Before Requests Fail

TL;DR

Two Anthropic deadlines land on June 15, 2026 — four days from now. First, the model IDs claude-sonnet-4-20250514 and claude-opus-4-20250514 are retired: any API request still calling those IDs will fail, with no grace period and no automatic redirect. Second, usage from the Claude Agent SDK and the headless claude -p command moves to a separate credit pool for subscription users, ending the implicit assumption that automation usage is covered by the same limits as interactive chat.

June 15, 2026

Hard retirement date for claude-sonnet-4-20250514 and claude-opus-4-20250514 — requests fail after this date

2 model IDs

Retiring: claude-sonnet-4-20250514 → replace with claude-sonnet-4-6; claude-opus-4-20250514 → replace with claude-opus-4-8

$20 / $100 / $200

Monthly Agent SDK credit pool by subscription tier: Pro / Max 5x / Max 20x — per-user, no rollover

No grace period

API requests to retired model IDs fail immediately — no auto-redirect, no fallback to a newer model

Two breaking changes land on the same day — June 15, 2026 — and both are silent failures if you do nothing. Operators running anything built on Claude have four days to act. This article covers exactly what changes, what breaks, and what to do before the deadline.

The model retirement: two IDs go dark on June 15. Anthropic is retiring claude-sonnet-4-20250514 and claude-opus-4-20250514 on June 15, 2026. These model IDs were deprecated on April 14, 2026; June 15 is the hard retirement date. The official replacements are claude-sonnet-4-6 (replacing claude-sonnet-4-20250514) and claude-opus-4-8 (replacing claude-opus-4-20250514). Anthropic's documentation states directly: "Requests to models past the retirement date will fail." There is no grace period, no automatic redirect, and no fallback to a newer model. An API call to a retired ID does not silently route to the replacement — it fails.

What doing nothing looks like in production. Any application, pipeline, or config file that still references either of the two retired IDs will begin returning errors on June 15. This includes hardcoded model strings in application code, model IDs stored in environment variables or config files, defaults set in framework or library wrappers, and any third-party integration that passes a model ID on your behalf. The failure is silent until it happens — there is no deprecation warning at request time — so teams that haven't audited their codebase since April may not know they're exposed.

The Agent SDK billing change: a new credit pool, same day. Separately, effective June 15, 2026, usage from the Claude Agent SDK and the headless claude -p command — and CI jobs and automation built on the Agent SDK — will draw from a new monthly "Agent SDK credit" pool for subscription users. This pool is separate from interactive subscription usage limits. Monthly credit amounts by tier: Pro $20, Max 5x $100, Max 20x $200 (Team Standard seats $20, Team Premium $100; some Enterprise Standard seats are excluded). Credits are per-user — they cannot be shared or pooled across a team. They do not roll over: the balance resets each billing cycle. Once the monthly credit is depleted, additional Agent SDK usage flows to usage credits at standard API list rates, or stops if usage credits are not enabled.

What is NOT affected. Interactive AI coding tools use in the terminal or IDE — Claude Code running interactively (see our Cursor vs Claude Code comparison) — is not subject to the new credit pool. Neither is claude.ai web, desktop, or mobile chat, nor Claude Cowork. API-key users (direct API billing, not subscription plans) are also unaffected and continue under existing API billing. The credit pool applies specifically to subscription-plan users whose headless/automated usage runs through the Agent SDK or claude -p.

The operator impact. Before June 15, the retirement and billing change together represent two distinct exposure categories for most teams. A team with the old model IDs hardcoded in production will see broken API calls starting June 15 regardless of their billing setup. A team running heavy claude -p or Agent SDK automation on a Pro or Max subscription will hit their credit ceiling faster than they expect — particularly if they've been treating headless usage as covered by the same pool as interactive use. Both risks are fixable now with a targeted audit; both become production incidents if left unaddressed.

Why It Matters

A silent production break is the default outcome for teams that don't act. Any service still calling claude-sonnet-4-20250514 or claude-opus-4-20250514 after June 15 will start returning errors with no warning — the failure only surfaces when a request is made. The billing change ends the subscription 'free ride' for heavy automation. Teams running significant claude -p or Agent SDK usage on Pro or Max plans have been drawing from general subscription limits; the new separate credit pool is smaller and per-user, which means automation-heavy users will hit the ceiling faster than their interactive usage patterns suggest. Both changes land on the same day, so an audit that addresses only the model IDs misses half the exposure. The combined deadline rewards teams that have maintained clean dependency hygiene and punishes anyone who hardcoded a deprecated model ID and walked away.

Who's Affected

  • Teams with old model IDs hardcoded in production — any code, config, or env var referencing claude-sonnet-4-20250514 or claude-opus-4-20250514 will produce failed API calls starting June 15. No warning at request time.
  • Teams running claude -p or Agent SDK automation on a subscription plan — the new per-user credit pool ($20 / $100 / $200 by tier) is separate from interactive limits and does not roll over. Automation-heavy users may exhaust it quickly.
  • CI jobs and automation built on the Agent SDK — these fall under the 'third-party apps built on the Agent SDK' category and draw from the new credit pool, not general subscription limits.
  • Subscription users who assumed headless usage was covered by their plan — the June 15 billing change explicitly separates Agent SDK and claude -p usage into its own pool, making that assumption incorrect going forward.

What To Do Now

  1. 1. Export usage from the Claude Console now. Pull your model usage report to see which model IDs your integrations are actually calling and how much volume each one carries. This tells you whether you have an exposure and how large it is before you touch any code.
  2. 2. Search your codebase, configs, and env vars for the two retired IDs. Look for both claude-sonnet-4-20250514 and claude-opus-4-20250514 everywhere: application source, infrastructure-as-code, CI configs, deployment manifests, .env files, and any third-party integrations that accept a model ID parameter.
  3. 3. Replace them with the official successor IDs. Swap claude-sonnet-4-20250514 for claude-sonnet-4-6, and claude-opus-4-20250514 for claude-opus-4-8. These are the Anthropic-recommended replacements — not inferred equivalents.
  4. 4. Test against the new model IDs before June 15. Don't just update the string — run your integration tests or a targeted smoke test against the replacement IDs while you still have time to catch any response-format or capability differences.
  5. 5. Audit your Agent SDK and claude -p usage against the new credit pools. Estimate your monthly headless usage volume, compare it to your tier's credit limit ($20 for Pro, $100 for Max 5x, $200 for Max 20x), and decide whether to enable usage credits as overflow or restructure automation to stay within the pool.

More on this topic — Best AI Coding Tools

Independent Review

Claude

Pricing, pros and cons, real-world verdict — no affiliate spin.

Read the Claude review

The AI Hustle Playbook Newsletter

Get one practical AI playbook each week.

Tools, workflows, and side-income ideas — curated for people who want to build, not browse forever.

No spam. Unsubscribe anytime. We respect your privacy.