English ← MyDocs

模型弃用

随着更安全、更强大的模型发布，Anthropic 会定期淘汰旧模型。依赖 Anthropic 模型的应用程序可能需要偶尔更新才能继续工作。受影响的客户将始终通过电子邮件和文档收到通知。

本页列出所有 API 弃用情况以及建议的替代方案。

概述

Anthropic 使用以下术语来描述模型生命周期：

  • 活跃： 模型完全受支持并推荐使用。
  • 遗留： 模型将不再接收更新，未来可能会被弃用。
  • 已弃用： 模型仍然可用但不再推荐使用。Anthropic 提供建议的替代方案并指定退役日期。
  • 已退役： 模型不再可用。对已退役模型的请求将失败。
Warning

已弃用的模型可能不如活跃模型可靠。将工作负载迁移到活跃模型以保持最高级别的支持和可靠性。

本页上的日期适用于 Anthropic 运营的平台：Claude API、AWS 上的 Claude Platform 和 Microsoft Foundry。合作伙伴运营的平台（Amazon Bedrock 和 Vertex AI）设定自己的退役时间表，因此模型的生命周期状态和日期可能有所不同。参见 Amazon Bedrock、Amazon Bedrock（遗留） 和 Vertex AI 模型表。

迁移到替代方案

模型被弃用后，请在退役日期之前将所有使用迁移到合适的替代方案。对超过退役日期的模型的请求将失败。

为了帮助衡量替代模型在您任务上的性能，请考虑在退役日期之前使用新模型对您的应用程序进行彻底测试。

有关迁移到最新 Claude 模型的具体说明，请参见迁移指南。

通知

Anthropic 会通知有活跃部署的客户即将退役的模型，在公开发布模型退役前至少提供 60 天通知。

审计模型使用情况

为了帮助识别已弃用模型的使用情况，客户可以访问其 API 使用情况的审计。请按照以下步骤操作：

  1. 前往 Claude Console 中的使用情况页面
  2. 点击"导出"按钮
  3. 查看下载的 CSV 以查看按 API 密钥和模型细分的使用情况

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

最佳实践

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

弃用的缺点和缓解措施

Anthropic 目前弃用和退役模型以确保新模型发布的容量。这带来了以下缺点：

  • 重视特定模型的用户必须迁移到新版本
  • 研究人员失去对正在进行和比较研究的模型访问权限
  • 模型退役引入了安全和模型福利相关的风险

Anthropic 希望在未来某个时候再次公开提供过去的模型。与此同时，Anthropic 已承诺长期保存模型权重和其他措施来帮助减轻这些影响。更多详情，请参见模型弃用和保存承诺。

模型状态

当前和最近退役的模型在下表中列出其状态：

API 模型名称当前状态弃用日期暂定退役日期
claude-opus-4-7活跃不适用不早于 2027 年 4 月 16 日
claude-opus-4-6活跃不适用不早于 2027 年 2 月 5 日
claude-opus-4-5-20251101活跃不适用不早于 2026 年 11 月 24 日
claude-opus-4-1-20250805活跃不适用不早于 2026 年 8 月 5 日
claude-opus-4-20250514已弃用2026 年 4 月 14 日2026 年 6 月 15 日
claude-sonnet-4-6活跃不适用不早于 2027 年 2 月 17 日
claude-sonnet-4-5-20250929活跃不适用不早于 2026 年 9 月 29 日
claude-sonnet-4-20250514已弃用2026 年 4 月 14 日2026 年 6 月 15 日
claude-3-7-sonnet-20250219已退役2025 年 10 月 28 日2026 年 2 月 19 日
claude-haiku-4-5-20251001活跃不适用不早于 2026 年 10 月 15 日
claude-3-5-haiku-20241022已退役2025 年 12 月 19 日2026 年 2 月 19 日
claude-3-haiku-20240307已退役2026 年 2 月 19 日2026 年 4 月 20 日

弃用历史

所有弃用情况如下所列，最新的公告在最前面。

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-4-6
2026 年 6 月 15 日claude-opus-4-20250514claude-opus-4-7

2026-02-19：Claude Haiku 3 模型

Note

此模型已于 2026 年 4 月 20 日退役。

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 模型

Note

此模型已于 2026 年 2 月 19 日退役。

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 模型

Note

此模型已于 2026 年 2 月 19 日退役。

2025 年 10 月 28 日，Anthropic 通知使用 Claude Sonnet 3.7 模型的开发者它即将在 Claude API 上退役。

退役日期已弃用模型建议替代方案
2026 年 2 月 19 日claude-3-7-sonnet-20250219claude-sonnet-4-6

2025-08-13：Claude Sonnet 3.5 模型

Note

这些模型已于 2025 年 10 月 28 日退役。

2025 年 8 月 13 日，Anthropic 通知使用 Claude Sonnet 3.5 模型的开发者它们即将退役。

退役日期已弃用模型建议替代方案
2025 年 10 月 28 日claude-3-5-sonnet-20240620claude-sonnet-4-6
2025 年 10 月 28 日claude-3-5-sonnet-20241022claude-sonnet-4-6

2025-06-30：Claude Opus 3 模型

Note

此模型已于 2026 年 1 月 5 日退役。

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

退役日期已弃用模型建议替代方案
2026 年 1 月 5 日claude-3-opus-20240229claude-opus-4-7

2025-01-21：Claude 2、Claude 2.1 和 Claude Sonnet 3 模型

Note

这些模型已于 2025 年 7 月 21 日退役。

2025 年 1 月 21 日，Anthropic 通知使用 Claude 2、Claude 2.1 和 Claude Sonnet 3 模型的开发者它们即将退役。

退役日期已弃用模型建议替代方案
2025 年 7 月 21 日claude-2.0claude-opus-4-7
2025 年 7 月 21 日claude-2.1claude-opus-4-7
2025 年 7 月 21 日claude-3-sonnet-20240229claude-sonnet-4-6

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

Note

这些模型已于 2024 年 11 月 6 日退役。

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