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.
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
- What Changes & What Doesn't
- Replacements & Pricing
- How to Migrate
- Cross-Provider Alternatives
- Compatibility & Testing
- Cost Impact
- Full FAQ
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
| Component | Status | Action 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:
- Easiest migration: Stay with Anthropic โ Claude Opus 4.8 or Sonnet 4.6 (same SDK, same key)
- Cheapest option: DeepSeek V4 Pro at $0.435/$0.87 per M tokens (97% cheaper than Claude 4 Opus)
- Best balance: GPT-5 at $1.25/$10 per M tokens (strong performance, competitive price)
- Largest context: Gemini 3.1 Pro at $1/$5 per M tokens (2M token context window)
Cost comparison: Claude 4 Opus vs all alternatives
Monthly cost for a typical workload (10M input + 2M output tokens):
| Model | Provider | Input/M | Output/M | Monthly Cost | Savings 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 | $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 Level | Claude 4 Opus Cost | Claude Opus 4.8 Cost | Monthly 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
- Claude 4 Stopped Working? โ Quick fix guide if your API calls are already failing
- Claude Deprecation Calculator โ Calculate your exact migration cost and savings
- Claude 4 Migration Tool โ Compare all 34 alternatives with your exact usage
- Claude 4 Migration Guide โ Step-by-step code examples in Python, Node.js, and REST API
- Best Claude 4 Alternatives โ Detailed comparison of all replacement options
- Claude 4 Deprecation Countdown โ Live countdown and timeline
- AI Model Deprecation Guide โ How to handle model retirements in general
- LLM Pricing Comparison โ Compare all 34 models across 10 providers
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 โ