Model deprecations
See which Claude models are active, deprecated, or retired, and find retirement dates and recommended replacements for models and API parameters.
As safer and more capable models launch, Anthropic regularly retires older ones. Applications relying on Anthropic models may need occasional updates to keep working. Impacted customers will always be notified by email and in the documentation.
This page lists all API deprecations, along with recommended replacements.
Overview
Anthropic uses the following terms to describe the model lifecycle:
- Active: The model is fully supported and recommended for use.
- Legacy: The model will no longer receive updates and might be deprecated in the future.
- Deprecated: The model is still functional but no longer recommended. Anthropic provides a recommended replacement and assigns a retirement date.
- Retired: The model is no longer available for use. Requests to retired models fail.
The dates on this page apply to Anthropic-operated platforms: the Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), and Microsoft Foundry. Partner-operated platforms, Claude Models on Google Cloud (Google managed) and Amazon Bedrock, set their own retirement schedules, so a model’s lifecycle status and dates can differ. See the Amazon Bedrock (bedrock-mantle), Amazon Bedrock (bedrock-runtime), and Claude Models on Google Cloud (Google managed) model tables.
Claude Code uses the Claude API, including when you sign in with a Claude plan, so this page’s dates apply. If Claude Code is set up for another platform or for a gateway, the dates are those of the platform that serves its requests.
Migrating to replacements
Once a model is deprecated, migrate all usage to a suitable replacement before the retirement date. Once the model is retired, requests to it fail.
To help measure the performance of replacement models on your tasks, consider thorough testing of your applications with the new models well before the retirement date.
For specific instructions on migrating to the latest Claude models, see Migration guides.
If you use Claude Code, update it first, because a newer model can need a newer version of Claude Code. Then, check which model you’re using, even if you set no model or use a Claude Code alias such as sonnet. If that model is deprecated or retired, set its recommended replacement as your model. Also, change the old model everywhere you set a model, including subagent definitions, and ask your administrator to change any model they set.
Notifications
Anthropic notifies customers with active deployments for models with upcoming retirements, providing at least 60 days’ notice before model retirement for publicly released models.
Auditing model usage
To help identify usage of deprecated models, you can access an audit of your API usage. Follow these steps:
- Go to the Usage page in Claude Console.
- Click Export.
- Review the downloaded CSV to see usage broken down by API key and model.
This audit helps you locate any instances where your application is still using deprecated models, allowing you to prioritize updates to newer models before the retirement date.
Best practices
- Regularly check the documentation for updates on model deprecations.
- Test your applications with newer models well before the retirement date of your current model.
- Update your code to use the recommended replacement model as soon as possible.
- Contact the support team if you need help with migration or have any questions.
Deprecation downsides and mitigations
Anthropic currently deprecates and retires models to ensure capacity for new model releases. This comes with downsides:
- Users who value specific models must migrate to new versions.
- Researchers lose access to models for ongoing and comparative studies.
- Model retirement introduces safety- and model welfare-related risks.
At some point, Anthropic hopes to make past models publicly available again. In the meantime, Anthropic has committed to long-term preservation of model weights and other measures to help mitigate these impacts. For more details, see Commitments on Model Deprecation and Preservation.
Model status
Current and recently retired models are listed in the following table with their status:
| API model name | Current state | Deprecated | Tentative retirement date |
|---|---|---|---|
claude-fable-5-2 | Active | N/A | Not sooner than November 9, 2027 |
claude-mythos-5-2 | Active | N/A | Not sooner than November 9, 2027 |
claude-fable-5-1 | Active | N/A | Not sooner than September 1, 2027 |
claude-mythos-5-1 | Active | N/A | Not sooner than September 1, 2027 |
claude-fable-5 | Active | N/A | Not sooner than June 9, 2027 |
claude-mythos-5 | Active | N/A | Not sooner than June 9, 2027 |
claude-mythos-preview | Deprecated | June 9, 2026 | To be announced |
claude-opus-5-5 | Active | N/A | Not sooner than September 22, 2027 |
claude-opus-5 | Active | N/A | Not sooner than July 24, 2027 |
claude-opus-4-8 | Active | N/A | Not sooner than May 28, 2027 |
claude-opus-4-7 | Active | N/A | Not sooner than April 16, 2027 |
claude-opus-4-6 | Active | N/A | Not sooner than February 5, 2027 |
claude-opus-4-5-20251101 | Active | N/A | Not sooner than November 24, 2026 |
claude-opus-4-1-20250805 | Retired | June 5, 2026 | August 5, 2026 |
claude-opus-4-20250514 | Retired | April 14, 2026 | June 15, 2026 |
claude-sonnet-5-5 | Active | N/A | Not sooner than September 28, 2027 |
claude-sonnet-5 | Active | N/A | Not sooner than June 30, 2027 |
claude-sonnet-4-6 | Active | N/A | Not sooner than February 17, 2027 |
claude-sonnet-4-5-20250929 | Deprecated | September 30, 2026 | November 30, 2026 |
claude-sonnet-4-20250514 | Retired | April 14, 2026 | June 15, 2026 |
claude-3-7-sonnet-20250219 | Retired | October 28, 2025 | February 19, 2026 |
claude-haiku-5-5 | Active | N/A | Not sooner than October 7, 2027 |
claude-haiku-4-5-20251001 | Active | N/A | Not sooner than October 15, 2026 |
claude-3-5-haiku-20241022 | Retired | December 19, 2025 | February 19, 2026 |
claude-3-haiku-20240307 | Retired | February 19, 2026 | April 20, 2026 |
Deprecation history
All deprecations are listed in the following sections, with the most recent announcements first.
2026-09-30: Claude Sonnet 4.5 model
On September 30, 2026, Anthropic notified developers using Claude Sonnet 4.5 of its upcoming retirement on the Claude API.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| November 30, 2026 | claude-sonnet-4-5-20250929 | claude-sonnet-5-5 |
This retirement includes claude-sonnet-4-5, the same model’s ID without a date.
If you use Claude Code, see Overview for which dates apply and Migrating to replacements for what to change. Once this model is retired, Claude Code on the Claude API shows an error that begins There's an issue with the selected model. If you set a fallback model chain, Claude Code switches to the next model in the chain instead. It tries Claude Sonnet 4.5 again on your next message.
2026-06-05: Claude Opus 4.1 model
On June 5, 2026, Anthropic notified developers using Claude Opus 4.1 of its upcoming retirement on the Claude API.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| August 5, 2026 | claude-opus-4-1-20250805 | claude-opus-4-8 |
2026-04-14: Claude Sonnet 4 and Claude Opus 4 models
On April 14, 2026, Anthropic notified developers using Claude Sonnet 4 and Claude Opus 4 models of their upcoming retirement on the Claude API.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| June 15, 2026 | claude-sonnet-4-20250514 | claude-sonnet-5-5 |
| June 15, 2026 | claude-opus-4-20250514 | claude-opus-4-8 |
2026-02-19: Claude Haiku 3 model
On February 19, 2026, Anthropic notified developers using Claude Haiku 3 of its upcoming retirement on the Claude API.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| April 20, 2026 | claude-3-haiku-20240307 | claude-haiku-4-5-20251001 |
2025-12-19: Claude Haiku 3.5 model
On December 19, 2025, Anthropic notified developers using Claude Haiku 3.5 of its upcoming retirement on the Claude API.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| February 19, 2026 | claude-3-5-haiku-20241022 | claude-haiku-4-5-20251001 |
2025-10-28: Claude Sonnet 3.7 model
On October 28, 2025, Anthropic notified developers using Claude Sonnet 3.7 of its upcoming retirement on the Claude API.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| February 19, 2026 | claude-3-7-sonnet-20250219 | claude-sonnet-5-5 |
2025-08-13: Claude Sonnet 3.5 models
On August 13, 2025, Anthropic notified developers using Claude Sonnet 3.5 models of their upcoming retirement.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| October 28, 2025 | claude-3-5-sonnet-20240620 | claude-sonnet-5-5 |
| October 28, 2025 | claude-3-5-sonnet-20241022 | claude-sonnet-5-5 |
2025-06-30: Claude Opus 3 model
On June 30, 2025, Anthropic notified developers using Claude Opus 3 of its upcoming retirement.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| January 5, 2026 | claude-3-opus-20240229 | claude-opus-4-8 |
2025-01-21: Claude 2, Claude 2.1, and Claude Sonnet 3 models
On January 21, 2025, Anthropic notified developers using Claude 2, Claude 2.1, and Claude Sonnet 3 models of their upcoming retirements.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| July 21, 2025 | claude-2.0 | claude-opus-4-8 |
| July 21, 2025 | claude-2.1 | claude-opus-4-8 |
| July 21, 2025 | claude-3-sonnet-20240229 | claude-sonnet-5-5 |
2024-09-04: Claude 1 and Instant models
On September 4, 2024, Anthropic notified developers using Claude 1 and Instant models of their upcoming retirements.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| November 6, 2024 | claude-1.0 | claude-haiku-4-5-20251001 |
| November 6, 2024 | claude-1.1 | claude-haiku-4-5-20251001 |
| November 6, 2024 | claude-1.2 | claude-haiku-4-5-20251001 |
| November 6, 2024 | claude-1.3 | claude-haiku-4-5-20251001 |
| November 6, 2024 | claude-instant-1.0 | claude-haiku-4-5-20251001 |
| November 6, 2024 | claude-instant-1.1 | claude-haiku-4-5-20251001 |
| November 6, 2024 | claude-instant-1.2 | claude-haiku-4-5-20251001 |
API parameter deprecations
Anthropic occasionally deprecates request parameters that no longer apply to current models. A new model can reject a deprecated parameter, and a new API version can remove it for every model.
| Parameter | Status | Behavior | Recommended replacement |
|---|---|---|---|
temperature, top_p, top_k | Removed in API version 2026-10-21 | Returns a 400 error. Earlier API versions return it when set to a non-default value on Claude 4.7 and later models and Claude Mythos Preview. | Omit and use prompting to guide model behavior. |
For migration steps, see Migration guides.
Was this page helpful?