# 模型弃用

---

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

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

## 概述

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

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

本页上的日期适用于 Anthropic 运营的平台：Claude API、[AWS 上的 Claude Platform](/docs/en/build-with-claude/claude-platform-on-aws) 和 [Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry)。合作伙伴运营的平台（Amazon Bedrock 和 Vertex AI）设定自己的退役时间表，因此模型的生命周期状态和日期可能有所不同。参见 [Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock#supported-models)、[Amazon Bedrock（遗留）](/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy#api-model-ids) 和 [Vertex AI](/docs/en/build-with-claude/claude-on-vertex-ai#api-model-ids) 模型表。

## 迁移到替代方案

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

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

有关迁移到最新 Claude 模型的具体说明，请参见[迁移指南](/docs/en/about-claude/models/migration-guide)。

## 通知

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

## 审计模型使用情况

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

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

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

## 最佳实践

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

## 弃用的缺点和缓解措施

Anthropic 目前弃用和退役模型以确保新模型发布的容量。这带来了以下缺点：
- 重视特定模型的用户必须迁移到新版本
- 研究人员失去对正在进行和比较研究的模型访问权限
- 模型退役引入了安全和模型福利相关的风险

Anthropic 希望在未来某个时候再次公开提供过去的模型。与此同时，Anthropic 已承诺长期保存模型权重和其他措施来帮助减轻这些影响。更多详情，请参见[模型弃用和保存承诺](https://www.anthropic.com/research/deprecation-commitments)。

## 模型状态

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

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

### 2026-02-19：Claude Haiku 3 模型

<Note>
此模型已于 2026 年 4 月 20 日退役。
</Note>

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

<Note>
此模型已于 2026 年 2 月 19 日退役。
</Note>

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

<Note>
此模型已于 2026 年 2 月 19 日退役。
</Note>

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

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

### 2025-08-13：Claude Sonnet 3.5 模型

<Note>
这些模型已于 2025 年 10 月 28 日退役。
</Note>

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

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

### 2025-06-30：Claude Opus 3 模型

<Note>
此模型已于 2026 年 1 月 5 日退役。
</Note>

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

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

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

<Note>
这些模型已于 2025 年 7 月 21 日退役。
</Note>

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

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

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

<Note>
这些模型已于 2024 年 11 月 6 日退役。
</Note>

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`|
