model-deprecations changedabout-claude/model-deprecations
Nearest release: v2.1.307, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+14added
Lines−14removed
From line
13
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits14to this page, all time
The whole hunk
from line 13, old and new numbered
/
from line 13
1313Anthropic uses the following terms to describe the model lifecycle:
1414
1515* **Active:** The model is fully supported and recommended for use.
16* **Legacy:** The model will no longer receive updates and may be deprecated in the future.
16* **Legacy:** The model will no longer receive updates and might be deprecated in the future.
1717* **Deprecated:** The model is still functional but no longer recommended. Anthropic provides a recommended replacement and assigns a retirement date.
18* **Retired:** The model is no longer available for use. Requests to retired models will fail.
18* **Retired:** The model is no longer available for use. Requests to retired models fail.
1919
2020<Warning>
2121 Deprecated models are likely to be less reliable than active models. Move workloads to active models to maintain the highest level of support and reliability.
from line 29
2929
3030To 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.
3131
32For specific instructions on migrating to the latest Claude models, see the [Migration guide](https://platform.claude.com/docs/en/about-claude/models/migration-guide).
32For specific instructions on migrating to the latest Claude models, see [Migration guides](https://platform.claude.com/docs/en/about-claude/models/migration-guide).
3333
3434## Notifications
3535
from line 37
3737
3838## Auditing model usage
3939
40To help identify usage of deprecated models, customers can access an audit of their API usage. Follow these steps:
40To help identify usage of deprecated models, you can access an audit of your API usage. Follow these steps:
4141
42421. Go to the [Usage](https://platform.claude.com/usage) page in Claude Console.
43432. Click **Export**.
44443. Review the downloaded CSV to see usage broken down by API key and model.
4545
46This audit will help you locate any instances where your application is still using deprecated models, allowing you to prioritize updates to newer models before the retirement date.
46This 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.
4747
4848## Best practices
4949
from line 50
50501. Regularly check the documentation for updates on model deprecations.
51512. Test your applications with newer models well before the retirement date of your current model.
52523. Update your code to use the recommended replacement model as soon as possible.
534. Contact the support team if you need assistance with migration or have any questions.
534. Contact the support team if you need help with migration or have any questions.
5454
5555## Deprecation downsides and mitigations
5656
5757Anthropic currently deprecates and retires models to ensure capacity for new model releases. This comes with downsides:
5858
59* Users who value specific models must migrate to new versions
60* Researchers lose access to models for ongoing and comparative studies
61* Model retirement introduces safety- and model welfare-related risks
59* Users who value specific models must migrate to new versions.
60* Researchers lose access to models for ongoing and comparative studies.
61* Model retirement introduces safety- and model welfare-related risks.
6262
6363At 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](https://www.anthropic.com/research/deprecation-commitments).
6464
from line 135
135135 This model was retired April 20, 2026.
136136</Note>
137137
138On February 19, 2026, Anthropic notified developers using Claude Haiku 3 model of its upcoming retirement on the Claude API.
138On February 19, 2026, Anthropic notified developers using Claude Haiku 3 of its upcoming retirement on the Claude API.
139139
140140| Retirement date | Deprecated model | Recommended replacement |
141141| --------------- | ------------------------- | --------------------------- |
from line 147
147147 This model was retired February 19, 2026.
148148</Note>
149149
150On December 19, 2025, Anthropic notified developers using Claude Haiku 3.5 model of its upcoming retirement on the Claude API.
150On December 19, 2025, Anthropic notified developers using Claude Haiku 3.5 of its upcoming retirement on the Claude API.
151151
152152| Retirement date | Deprecated model | Recommended replacement |
153153| ----------------- | --------------------------- | --------------------------- |
from line 159
159159 This model was retired February 19, 2026.
160160</Note>
161161
162On October 28, 2025, Anthropic notified developers using Claude Sonnet 3.7 model of its upcoming retirement on the Claude API.
162On October 28, 2025, Anthropic notified developers using Claude Sonnet 3.7 of its upcoming retirement on the Claude API.
163163
164164| Retirement date | Deprecated model | Recommended replacement |
165165| ----------------- | ---------------------------- | ----------------------- |
from line 184
184184 This model was retired January 5, 2026.
185185</Note>
186186
187On June 30, 2025, Anthropic notified developers using Claude Opus 3 model of its upcoming retirement.
187On June 30, 2025, Anthropic notified developers using Claude Opus 3 of its upcoming retirement.
188188
189189| Retirement date | Deprecated model | Recommended replacement |
190190| --------------- | ------------------------ | ----------------------- |
from line 230
230230| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
231231| `temperature`, `top_p`, `top_k` | Removed in [API version `2026-10-21`](https://platform.claude.com/docs/en/api/migration-2026-10-21#sampling-parameters) | 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](https://anthropic.com/glasswing). | Omit and use [prompting](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) to guide model behavior. |
232232
233For migration steps, see the [migration guide](https://platform.claude.com/docs/en/about-claude/models/migration-guide).
233For migration steps, see [Migration guides](https://platform.claude.com/docs/en/about-claude/models/migration-guide).
234234
No line in this hunk matches that.