弃用与迁移观察
模型会被退役，参数会被重命名，行为会发生变化。本页追踪 破坏性变更，让升级不会让你措手不及。如果你基于 API 进行构建，请定期浏览本页。
为什么这很重要
一个被固定的模型 ID 终将被 弃用，进而被 移除。硬编码该 ID 的代码会出问题。一点点保养就能避免凌晨两点的意外。
生存法则
- 从配置中读取模型 ID，绝不要在整个代码库中散布字面量——这样迁移就只是改动一行。
- 关注公告，留意弃用日期和推荐的替代方案。
- 切换模型时，重新运行你的 评估——即使是在“更新、更好”的模型上，行为也可能发生变化。
- 在截止日期之前测试，而不是在移除之后。
常见的变更类型
| 变更 | 示例 | 应对方式 |
|---|---|---|
| 模型退役 | 某个较旧的模型 ID 停止工作 | 迁移到推荐的后继模型；重新评估 |
| 参数被取代 | 某个推理/预算旋钮被 effort 取代 | 更新调用；参阅 思考与 Effort |
| 默认值变更 | 新的默认模型/行为 | 有意识地固定版本；验证你的提示词是否仍然有效 |
| 端点/SDK 更新 | 新的 SDK 主版本 | 阅读迁移指南；谨慎升级 |
当前观察
权威的时间表位于官方模型弃用页面——在迁移之前，请在那里确认日期。Anthropic 会在退役某个公开发布的模型之前提供至少 60 天的提前通知。
已弃用的模型
| 模型 ID | 弃用 | 退役 | 迁移到 |
|---|---|---|---|
claude-opus-4-1-20250805（Opus 4.1） | 2026年6月5日 | 2026年8月5日 | claude-opus-4-8 |
向已过退役日期的模型发送的请求会失败——如果你固定使用 Opus 4.1，请在截止日期之前迁移。
近期已退役
claude-opus-4-20250514（Opus 4）和 claude-sonnet-4-20250514（Sonnet 4）已于 2026年6月15日退役。对这些 ID 的调用现在会报错——请分别迁移到 claude-opus-4-8 和 claude-sonnet-5。
参数弃用
在 Claude Opus 4.7 及更高版本（包括 Opus 4.8）上，采样旋钮 temperature、top_p 和 top_k 已被弃用：将它们中的任何一个设置为非默认值都会返回 400 错误。请省略它们，改用提示词和思考与 Effort 来引导行为。
请始终对照 当前模型与定价 表格确认你的模型 ID；如果你仍在使用较旧的 ID，请规划一次迁移。