Claude Platform Docs
模型与定价生命周期与参考

模型弃用

查看哪些 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 使用情况的审计。请按照以下步骤操作:

  1. 前往 Claude Console 中的用量页面。
  2. 点击导出。
  3. 查看下载的 CSV 文件,了解按 API 密钥和模型细分的使用情况。

此审计可帮助您找到应用程序仍在使用已弃用模型的所有实例,使您能够在退役日期之前优先将其更新为较新的模型。

最佳实践

  1. 定期查看文档以获取有关模型弃用的更新。
  2. 在当前模型的退役日期之前尽早使用较新的模型测试您的应用程序。
  3. 尽快更新您的代码以使用推荐的替代模型。
  4. 如果您在迁移方面需要帮助或有任何疑问,请联系支持团队。

弃用的弊端与缓解措施

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-20250929claude-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-20250805claude-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-20250514claude-sonnet-5-5
2026 年 6 月 15 日claude-opus-4-20250514claude-opus-4-8

2026-02-19:Claude Haiku 3 模型

2026 年 2 月 19 日,Anthropic 通知了使用 Claude Haiku 3 的开发者,该模型即将在 Claude API 上退役。

退役日期已弃用模型推荐替代方案
2026 年 4 月 20 日claude-3-haiku-20240307claude-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-20241022claude-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-20250219claude-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-20240620claude-sonnet-5-5
2025 年 10 月 28 日claude-3-5-sonnet-20241022claude-sonnet-5-5

2025-06-30:Claude Opus 3 模型

2025 年 6 月 30 日,Anthropic 通知了使用 Claude Opus 3 的开发者,该模型即将退役。

退役日期已弃用模型推荐替代方案
2026 年 1 月 5 日claude-3-opus-20240229claude-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.0claude-opus-4-8
2025 年 7 月 21 日claude-2.1claude-opus-4-8
2025 年 7 月 21 日claude-3-sonnet-20240229claude-sonnet-5-5

2024-09-04:Claude 1 和 Instant 模型

2024 年 9 月 4 日,Anthropic 通知了使用 Claude 1 和 Instant 模型的开发者,这些模型即将退役。

退役日期已弃用模型推荐替代方案
2024 年 11 月 6 日claude-1.0claude-haiku-4-5-20251001
2024 年 11 月 6 日claude-1.1claude-haiku-4-5-20251001
2024 年 11 月 6 日claude-1.2claude-haiku-4-5-20251001
2024 年 11 月 6 日claude-1.3claude-haiku-4-5-20251001
2024 年 11 月 6 日claude-instant-1.0claude-haiku-4-5-20251001
2024 年 11 月 6 日claude-instant-1.1claude-haiku-4-5-20251001
2024 年 11 月 6 日claude-instant-1.2claude-haiku-4-5-20251001

API 参数弃用

Anthropic 偶尔会弃用不再适用于当前模型的请求参数。新模型可能会拒绝已弃用的参数,而新的 API 版本可能会针对所有模型移除该参数。

参数状态行为推荐替代方案
temperature、top_p、top_k已在 API 版本 2026-10-21 中移除返回 400 错误。在较早的 API 版本中,当在 Claude 4.7 及更高版本模型和 Claude Mythos Preview 上将其设置为非默认值时,会返回该错误。省略这些参数,并使用提示来引导模型行为。

有关迁移步骤,请参阅迁移指南。

此页面对您有帮助吗?