โ† Back to blog

Claude 4 Deprecation FAQ: Everything You Need to Know

Claude 4 Opus and Claude Sonnet 4 retire on June 15, 2026. You have 13 days to migrate. This FAQ covers every question developers ask about the deprecation โ€” what happens, when, how to migrate, what it costs, and what to use instead.

--
Days Left
June 15
Deadline
2
Models Affected
67%
Max Savings

Quick answer: Update claude-4-opus โ†’ claude-opus-4-8 and claude-sonnet-4 โ†’ claude-sonnet-4-6 in your code. Same API key, same SDK, 67% cheaper for Opus. That's it.

Quick Navigation

Timeline & Dates

When is Claude 4 being deprecated?

Claude 4 Opus and Claude Sonnet 4 were deprecated in May 2026 and will be fully retired on June 15, 2026. After this date, API calls to these model IDs will return errors.

What is the Claude 4 shutdown date?

June 15, 2026. This is the hard cutoff โ€” after this date, claude-4-opus and claude-sonnet-4 will no longer respond to API calls.

Is there a grace period after June 15?

Anthropic has not announced a grace period. Plan to complete your migration before June 15 to avoid any service disruption.

Why is Anthropic retiring Claude 4?

Anthropic regularly retires older model versions as newer, more capable replacements become available. Claude Opus 4.8 and Claude Sonnet 4.6 offer better performance, larger context windows (1M vs 200K tokens), and in the case of Opus, significantly lower pricing.

What Changes & What Doesn't

ComponentStatusAction Required
API key No change None โ€” same key works with new models
SDK / libraries No change None โ€” same Anthropic SDK
API endpoint No change None โ€” same api.anthropic.com
Authentication No change None
Model name string Changes Update model ID in your code
Pricing Cheaper Opus 4.8 is 67% cheaper; Sonnet 4.6 same price
Context window Larger 200K โ†’ 1M tokens (5x increase)
Prompts / system prompts Compatible Test to verify output quality

Replacements & Pricing

What replaces Claude 4 Opus?

Claude Opus 4.8 is the direct replacement:

Claude 4 Opus (old)Claude Opus 4.8 (new)
Input price $15/M tokens $5/M tokens
Output price $75/M tokens $25/M tokens
Context window 200K tokens 1M tokens
Model ID claude-4-opus claude-opus-4-8

What replaces Claude Sonnet 4?

Claude Sonnet 4.6 is the direct replacement:

Claude Sonnet 4 (old)Claude Sonnet 4.6 (new)
Input price $3/M tokens $3/M tokens
Output price $15/M tokens $15/M tokens
Context window 200K tokens 1M tokens
Model ID claude-sonnet-4 claude-sonnet-4-6

How to Migrate

How do I migrate from Claude 4?

Migration is a one-line code change. Find where you set the model name and update it:

Python (Anthropic SDK)

# Before
client.messages.create(
    model="claude-4-opus",
    ...
)

# After
client.messages.create(
    model="claude-opus-4-8",
    ...
)

Node.js / TypeScript

// Before
const message = await anthropic.messages.create({
    model: 'claude-4-opus',
    ...
});

// After
const message = await anthropic.messages.create({
    model: 'claude-opus-4-8',
    ...
});

REST API (curl)

# Before
curl https://api.anthropic.com/v1/messages \
  -d '{"model": "claude-4-opus", ...}'

# After
curl https://api.anthropic.com/v1/messages \
  -d '{"model": "claude-opus-4-8", ...}'

How long does migration take?

Most teams complete the migration in under an hour. The code change itself takes seconds โ€” the bulk of the time is testing to verify output quality meets your requirements.

Do I need to update my SDK version?

No. The model name change works with all current versions of the Anthropic SDK. No library updates are required.

Need a step-by-step guide? See our Claude 4 Migration Guide with code examples in Python, Node.js, and REST API, plus a deployment checklist and rollback plan.

Cross-Provider Alternatives

Should I switch to a different provider instead of upgrading?

It depends on your priorities:

Cost comparison: Claude 4 Opus vs all alternatives

Monthly cost for a typical workload (10M input + 2M output tokens):

ModelProviderInput/MOutput/MMonthly CostSavings vs Claude 4 Opus
Claude 4 Opus Anthropic $15 $75 $300 โ€”
Claude Opus 4.8 Anthropic $5 $25 $100 67%
Claude Sonnet 4.6 Anthropic $3 $15 $60 80%
GPT-5 OpenAI $1.25 $10 $32.50 89%
Gemini 3.1 Pro Google $1 $5 $20 93%
DeepSeek V4 Pro DeepSeek $0.435 $0.87 $6.09 98%

Don't miss the June 15 deadline

Calculate your exact migration savings with your real token usage.

Deprecation Calculator โ†’ Migration Tool โ†’ Cheapest LLM APIs

๐Ÿšจ June 15 deadline: See all 34 alternatives, calculate your savings, and get migration code on our Claude 4 Deprecation Hub.

Compatibility & Testing

Will my prompts still work with the new models?

Yes. Claude Opus 4.8 and Claude Sonnet 4.6 are backward-compatible with Claude 4 prompts and system prompts. The API interface is identical. However, you should test your specific use cases to verify output quality meets your requirements.

Are there any API behavior differences?

The API interface (endpoints, parameters, response format) is identical. The new models may produce slightly different outputs for the same prompt due to model improvements. Test critical workflows before deploying.

Will streaming still work?

Yes. Streaming works exactly the same way with the new models. No code changes needed beyond the model name.

Do function calls / tool use still work?

Yes. Function calling and tool use are fully supported in Claude Opus 4.8 and Claude Sonnet 4.6 with the same API interface.

What about fine-tuned models?

If you have fine-tuned Claude 4 models, contact Anthropic support about migrating your fine-tuned weights to the new model versions.

Cost Impact

Will my costs go up or down after migration?

Your costs will go down if you migrate to Claude Opus 4.8 (67% savings) or stay the same if you migrate to Claude Sonnet 4.6. If you switch to a cross-provider alternative like DeepSeek or GPT-5, you could save 89-98%.

How much will I save per month?

Depends on your usage. Here are some common scenarios:

Usage LevelClaude 4 Opus CostClaude Opus 4.8 CostMonthly Savings
Light (1M in + 200K out) $30 $10 $20/mo
Medium (10M in + 2M out) $300 $100 $200/mo
Heavy (100M in + 20M out) $3,000 $1,000 $2,000/mo

Calculate your exact savings: Use our Claude Deprecation Calculator to see your specific cost impact based on your actual token usage.

Full FAQ

Yes. Claude 4 Opus and Claude Sonnet 4 are officially deprecated and will be fully retired on June 15, 2026. After this date, API calls to these model IDs will return errors.

Claude 4 Opus and Claude Sonnet 4 will stop working on June 15, 2026. After this date, API calls will return errors.

No. Your existing Anthropic API key works with all current models including Claude Opus 4.8 and Claude Sonnet 4.6. No key rotation or regeneration is needed.

DeepSeek V4 Pro at $0.435/$0.87 per million tokens is the cheapest option โ€” 98% less than Claude 4 Opus. However, it requires switching providers and using a different SDK. The cheapest Anthropic option is Claude Haiku 4.5 at $0.80/$4 per million tokens.

No. After June 15, 2026, API calls to Claude 4 Opus and Claude Sonnet 4 will return errors. You must migrate before that date. There is no announced grace period.

Yes. Claude Opus 4.8 and Claude Sonnet 4.6 are backward-compatible with Claude 4 prompts. The API interface is identical โ€” only the model name string changes. We recommend testing your prompts to verify output quality.

The code change itself takes seconds โ€” it's a one-line model name update. Most teams complete the full migration (including testing) in under an hour. Larger applications with extensive prompt chains may need a day of testing.

For the easiest migration, upgrade within Anthropic to Claude Opus 4.8 or Sonnet 4.6 โ€” same SDK, same API key, no provider switch needed. For maximum cost savings, consider DeepSeek V4 Pro (98% cheaper) or GPT-5 (89% cheaper), but factor in the migration effort of switching SDKs.

The deprecation only affects model availability โ€” not your data. Your API key, account, billing, and any stored conversations remain unchanged. The new models (Opus 4.8, Sonnet 4.6) use the same infrastructure.

No. Only Claude 4 Opus and Claude Sonnet 4 are being deprecated. Claude Haiku 4.5, Claude Opus 4.8, Claude Sonnet 4.6, and Claude Opus 4.7 all remain available.

Related Resources

Calculate your migration savings

See exactly how much you'll save by switching from Claude 4 to any alternative.

Deprecation Calculator โ†’ Migration Tool โ†’ Step-by-Step Guide โ†’