Claude Sonnet 4 与 Opus 4 将于 6 月 15 日关停:两周内必须完成的 Routing 迁移

Anthropic 将于 2026 年 6 月 15 日正式停用 claude-sonnet-4-20250514 和 claude-opus-4-20250514。任何仍指向这两个 model ID 的 routing 配置将在两周后开始报错。

发布于 来源 Anthropic

归档条目:由 AI 根据所引信源辅助生成,发布时未经逐篇审阅。责任编辑:Joe Werner。

一张 routing 示意图,展示已弃用的 Claude model ID 在 6 月 15 日截止前被重定向到现役继任版本

从今天起两周后,所有仍使用 claude-sonnet-4-20250514 或 claude-opus-4-20250514 的 API 调用将直接报错。Anthropic 于 2026 年 4 月 14 日宣布弃用这两个 model ID,硬性关停时间为 2026 年 6 月 15 日 09:00 PT。如果你的 routing 层、fallback 链或 SDK 默认配置仍然引用这两个字符串,一个生产事故正在倒计时。

这不是软弃用(模型会静默重定向)。这是完全退役:model ID 停止响应。

发生了什么

Anthropic 于 2026 年 4 月 14 日宣布,Claude 4 初代版本——claude-sonnet-4-20250514 和 claude-opus-4-20250514(均于 2025 年 5 月 22 日发布)——将于 2026 年 6 月 15 日退役。官方推荐的迁移目标为:

  • claude-sonnet-4-20250514 → claude-sonnet-4-6(现役,支持至少到 2027 年 2 月 17 日)
  • claude-opus-4-20250514 → claude-opus-4-8(现役,支持至少到 2027 年 4 月 16 日)

带 -20250514 后缀的 model ID 是 Claude 4 的初始发布版本,此后已经历多个小版本迭代。4.6 和 4.8 版本不只是改名的别名——它们带来了能力提升、更好的 tool use 支持以及更新的安全调优。

为什么 AI 工程团队需要重视

这类故障的特点是:平时无声无息,到截止日期突然爆发。在集成时硬编码了 model ID 的团队——无论是写在环境变量、routing 配置、SDK 初始化代码还是 prompt 管理系统里——往往不会主动回头检查这些字符串,直到出了问题。6 月 15 日就是那个"出问题"的时间点。

以下三个地方最容易藏着过期的 model ID:

Routing 和 gateway 配置。 如果你运行了一个代理或 gateway,将入站请求映射到特定 model ID,那么任何引用 claude-sonnet-4-20250514 或 claude-opus-4-20250514 的规则,在关停后都会开始返回 404 或 400 错误。这不是优雅的 fallback,而是硬性 API 拒绝。

Fallback 链。 有些团队设置了"先试 Opus 4,失败后 fallback 到 Sonnet 4"这样的逻辑,但两个 model ID 都用的是初代版本。关停后,fallback 链的两条腿同时断掉。如果你的 fallback 设计只考虑了 provider 故障,没有考虑 model 退役,这就是盲区。

SDK 和库的默认配置。 部分集成在初始化时设置一次 model ID 就再也不动。Claude Code、LangChain 等工具如果当初配置的是初代 Claude 4 ID,现在需要更新。检查你的 .env 文件、settings.json 以及任何引用这些字符串的基础设施代码。

Router/Operator 视角

Model 弃用是一个周期性的运营模式,不是一次性事件。Anthropic 在过去十二个月里已经退役了八个 Claude 模型。节奏大致是:新一代发布,上一代进入 60-90 天弃用窗口,然后硬性关停。OpenAI 遵循类似的模式。这是运行生产 AI 工作负载的团队必须接受的新常态。

Routing 层面的启示是:将 routing 目标固定在带日期后缀的 model ID 上是一种运营负债。更安全的做法是固定到某一代内的最新稳定别名——比如用 claude-sonnet-4-6 而不是 claude-sonnet-4-20250514。别名会随着该系列的安全更新而滚动指向最新版本;带日期的 ID 则不会。

对于运行多 provider routing 的团队,这也是一个提醒:审计你的 fallback model 列表。指向已退役 model 的 fallback 比没有 fallback 更糟糕——它会在真正报错之前额外增加延迟。

6 月 15 日前的迁移 checklist:

  • 在代码库和配置中搜索 claude-sonnet-4-20250514 和 claude-opus-4-20250514
  • 分别替换为 claude-sonnet-4-6 和 claude-opus-4-8
  • 更新所有 routing 规则、gateway 配置或代理 model 映射
  • 确认 fallback 链中没有引用已弃用的 ID
  • 检查 Claude Code 的 settings.json 以及含有 ANTHROPIC_MODEL 等变量的 .env 文件
  • 在 6 月 15 日前于 staging 环境验证更新后的 model ID

TheRouter 用户需要关注的事项

如果你通过 TheRouter 路由 Anthropic 流量,请确认你的 model routing 规则引用的是当前有效的 model ID。6 月 15 日的截止日期适用于所有直接调用 Anthropic API 的系统——包括通过 gateway 透传 model ID 的流量。

更广泛地说,这次弃用周期是一个好时机,用来审查你对所有 provider 的 routing 策略:你是否在任何地方固定了带日期的 model ID?采用"最新稳定别名"而非"特定日期版本"的模式,可以减少未来弃用事件带来的运营摩擦。

Anthropic 的完整弃用历史和当前 model 状态表见 platform.claude.com/docs/en/about-claude/model-deprecations。

本文涉及的模型

帮助与联系