模型弃用
查看哪些 Claude 模型处于活跃、已弃用或已退役状态,并查找模型和 API 参数的退役日期及推荐替代方案。
随着更安全、更强大的模型发布,Anthropic 会定期退役旧模型。依赖 Anthropic 模型的应用程序可能需要偶尔更新才能继续正常运行。受影响的客户始终会通过电子邮件和文档收到通知。
本页列出了所有 API 弃用项以及推荐的替代方案。
概述
Anthropic 使用以下术语来描述模型生命周期:
- 活跃(Active): 该模型受到完全支持,并推荐使用。
- Legacy(旧版): 该模型将不再接收更新,未来可能会被弃用。
- 已弃用(Deprecated): 该模型仍可正常使用,但不再推荐。Anthropic 会提供推荐的替代方案并指定退役日期。
- Retired(已退役): 该模型已无法使用。对已退役模型的请求将会失败。
本页上的日期适用于 Anthropic 运营的平台:Claude API、Claude Platform on AWS、Claude Models on Google Cloud (Anthropic managed) 和 Microsoft Foundry。合作伙伴运营的平台(Claude Models on Google Cloud (Google managed) 和 Amazon Bedrock)自行设定退役时间表,因此模型的生命周期状态和日期可能有所不同。请参阅 Amazon Bedrock、Amazon Bedrock(Opus 4.6 及更早版本) 和 Claude Models on Google Cloud (Google managed) 模型表。
迁移到替代方案
一旦模型被弃用,请在退役日期之前将所有使用迁移到合适的替代方案。在退役日期之后对模型的请求将会失败。
为了帮助衡量替代模型在您的任务上的性能,请考虑在退役日期之前尽早使用新模型对您的应用程序进行全面测试。
有关迁移到最新 Claude 模型的具体说明,请参阅迁移指南。
通知
Anthropic 会通知对即将退役的模型有活跃部署的客户,对于公开发布的模型,会在模型退役前至少提前 60 天发出通知。
审核模型使用情况
为了帮助识别已弃用模型的使用情况,您可以访问 API 使用情况的审计。请按照以下步骤操作:
- 前往 Claude Console 中的用量页面。
- 点击导出。
- 查看下载的 CSV 文件,了解按 API 密钥和模型细分的使用情况。
此审计可帮助您找到应用程序仍在使用已弃用模型的所有实例,使您能够在退役日期之前优先将其更新为较新的模型。
最佳实践
- 定期查看文档以获取有关模型弃用的更新。
- 在当前模型的退役日期之前尽早使用较新的模型测试您的应用程序。
- 尽快更新您的代码以使用推荐的替代模型。
- 如果您在迁移方面需要帮助或有任何疑问,请联系支持团队。
弃用的弊端与缓解措施
Anthropic 目前弃用和退役模型是为了确保新模型发布所需的容量。这会带来一些弊端:
- 重视特定模型的用户必须迁移到新版本。
- 研究人员将无法再使用这些模型进行正在进行的研究和比较研究。
- 模型退役会带来与安全和模型福祉相关的风险。
Anthropic 希望在未来某个时候能够再次公开提供过去的模型。在此期间,Anthropic 已承诺长期保存模型权重并采取其他措施来帮助缓解这些影响。有关更多详细信息,请参阅关于模型弃用和保存的承诺。
模型状态
下表列出了当前模型和最近退役的模型及其状态:
| API 模型名称 | 当前状态 | 弃用日期 | 暂定停用日期 |
|---|---|---|---|
| 活跃 | 不适用 | 不早于 2027年11月9日 | |
| 活跃 | 不适用 | 不早于 2027年11月9日 | |
| 活跃 | 不适用 | 不早于 2027年9月1日 | |
| 活跃 | 不适用 | 不早于 2027年9月1日 | |
| 活跃 | 不适用 | 不早于 2027年6月9日 | |
| 活跃 | 不适用 | 不早于 2027年6月9日 | |
| 已弃用 | 2026年6月9日 | 待公布 | |
| 活跃 | 不适用 | 不早于 2027年9月22日 | |
| 活跃 | 不适用 | 不早于 2027年7月24日 | |
| 活跃 | 不适用 | 不早于 2027年5月28日 | |
| 活跃 | 不适用 | 不早于 2027年4月16日 | |
| 活跃 | 不适用 | 不早于 2027年2月5日 | |
| 活跃 | 不适用 | 不早于 2026年11月24日 | |
| 已停用 | 2026年6月5日 | 2026年8月5日 | |
| 已停用 | 2026年4月14日 | 2026年6月15日 | |
| 活跃 | 不适用 | 不早于 2027年9月28日 | |
| 活跃 | 不适用 | 不早于 2027年6月30日 | |
| 活跃 | 不适用 | 不早于 2027年2月17日 | |
| 已弃用 | 2026年9月30日 | 2026年11月30日 | |
| 已停用 | 2026年4月14日 | 2026年6月15日 | |
| 已停用 | 2025年10月28日 | 2026年2月19日 | |
| 活跃 | 不适用 | 不早于 2027年10月7日 | |
| 活跃 | 不适用 | 不早于 2026年10月15日 | |
| 已停用 | 2025年12月19日 | 2026年2月19日 | |
| 已停用 | 2026年2月19日 | 2026年4月20日 |
弃用历史
以下各节列出了所有弃用项,最新的公告排在最前面。
2026-09-30:Claude Sonnet 4.5 模型
2026 年 9 月 30 日,Anthropic 通知使用 Claude Sonnet 4.5 的开发者,该模型即将在 Claude API 上退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2026 年 11 月 30 日 | claude-sonnet-4-5-20250929 | claude-sonnet-5-5 |
2026-06-05:Claude Opus 4.1 模型
2026 年 6 月 5 日,Anthropic 通知了使用 Claude Opus 4.1 的开发者,该模型即将在 Claude API 上退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2026 年 8 月 5 日 | claude-opus-4-1-20250805 | claude-opus-4-8 |
2026-04-14:Claude Sonnet 4 和 Claude Opus 4 模型
2026 年 4 月 14 日,Anthropic 通知了使用 Claude Sonnet 4 和 Claude Opus 4 模型的开发者,这些模型即将在 Claude API 上退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2026 年 6 月 15 日 | claude-sonnet-4-20250514 | claude-sonnet-5-5 |
| 2026 年 6 月 15 日 | claude-opus-4-20250514 | claude-opus-4-8 |
2026-02-19:Claude Haiku 3 模型
2026 年 2 月 19 日,Anthropic 通知了使用 Claude Haiku 3 的开发者,该模型即将在 Claude API 上退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2026 年 4 月 20 日 | claude-3-haiku-20240307 | claude-haiku-4-5-20251001 |
2025-12-19:Claude Haiku 3.5 模型
2025 年 12 月 19 日,Anthropic 通知了使用 Claude Haiku 3.5 的开发者,该模型即将在 Claude API 上退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2026 年 2 月 19 日 | claude-3-5-haiku-20241022 | claude-haiku-4-5-20251001 |
2025-10-28:Claude Sonnet 3.7 模型
2025 年 10 月 28 日,Anthropic 通知了使用 Claude Sonnet 3.7 的开发者,该模型即将在 Claude API 上退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2026 年 2 月 19 日 | claude-3-7-sonnet-20250219 | claude-sonnet-5-5 |
2025-08-13:Claude Sonnet 3.5 模型
2025 年 8 月 13 日,Anthropic 通知了使用 Claude Sonnet 3.5 模型的开发者,这些模型即将退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2025 年 10 月 28 日 | claude-3-5-sonnet-20240620 | claude-sonnet-5-5 |
| 2025 年 10 月 28 日 | claude-3-5-sonnet-20241022 | claude-sonnet-5-5 |
2025-06-30:Claude Opus 3 模型
2025 年 6 月 30 日,Anthropic 通知了使用 Claude Opus 3 的开发者,该模型即将退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2026 年 1 月 5 日 | claude-3-opus-20240229 | claude-opus-4-8 |
2025-01-21:Claude 2、Claude 2.1 和 Claude Sonnet 3 模型
2025 年 1 月 21 日,Anthropic 通知了使用 Claude 2、Claude 2.1 和 Claude Sonnet 3 模型的开发者,这些模型即将退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2025 年 7 月 21 日 | claude-2.0 | claude-opus-4-8 |
| 2025 年 7 月 21 日 | claude-2.1 | claude-opus-4-8 |
| 2025 年 7 月 21 日 | claude-3-sonnet-20240229 | claude-sonnet-5-5 |
2024-09-04:Claude 1 和 Instant 模型
2024 年 9 月 4 日,Anthropic 通知了使用 Claude 1 和 Instant 模型的开发者,这些模型即将退役。
| 退役日期 | 已弃用模型 | 推荐替代方案 |
|---|---|---|
| 2024 年 11 月 6 日 | claude-1.0 | claude-haiku-4-5-20251001 |
| 2024 年 11 月 6 日 | claude-1.1 | claude-haiku-4-5-20251001 |
| 2024 年 11 月 6 日 | claude-1.2 | claude-haiku-4-5-20251001 |
| 2024 年 11 月 6 日 | claude-1.3 | claude-haiku-4-5-20251001 |
| 2024 年 11 月 6 日 | claude-instant-1.0 | claude-haiku-4-5-20251001 |
| 2024 年 11 月 6 日 | claude-instant-1.1 | claude-haiku-4-5-20251001 |
| 2024 年 11 月 6 日 | claude-instant-1.2 | claude-haiku-4-5-20251001 |
API 参数弃用
Anthropic 偶尔会弃用不再适用于当前模型的请求参数。新模型可能会拒绝已弃用的参数,而新的 API 版本可能会针对所有模型移除该参数。
| 参数 | 状态 | 行为 | 推荐替代方案 |
|---|---|---|---|
temperature、top_p、top_k | 已在 API 版本 2026-10-21 中移除 | 返回 400 错误。在较早的 API 版本中,当在 Claude 4.7 及更高版本模型和 Claude Mythos Preview 上将其设置为非默认值时,会返回该错误。 | 省略这些参数,并使用提示来引导模型行为。 |
有关迁移步骤,请参阅迁移指南。
此页面对您有帮助吗?