Claude Opus 4.1 弃用：Anthropic 8月5日迁移指南

如果你的路由配置里仍把 claude-opus-4-1-20250805 放在 fallback 链中，那倒计时已经开始。Anthropic 于 2026 年 6 月 5 日正式弃用 Claude Opus 4.1 模型，硬下线日期是 2026 年 8 月 5 日——从弃用通知到 API 永久失效，恰好 60 天。

对运行多提供商路由层的工程团队而言，问题不只是"换模型名"这么简单。真正需要回答的是：你的 fallback 架构能否承受一个每 60 天就下线旧模型的提供商，而不出生产事故？

事件经过

Anthropic 于 2026 年 6 月 5 日通过模型弃用页面宣布弃用 claude-opus-4-1-20250805，推荐替代为 claude-opus-4-8。时间线如下：

• 2026 年 6 月 5 日： 弃用公告发布，模型仍可用但不再推荐。
• 2026 年 8 月 5 日： 硬下线，请求 claude-opus-4-1-20250805 将返回错误。

这延续了 Anthropic 的固定模式：Claude Opus 4（claude-opus-4-20250514）于 2026 年 4 月 14 日弃用，6 月 15 日下线；Claude Sonnet 4（claude-sonnet-4-20250514）遵循相同节奏。当前活跃模型状态：

注意代际跳跃：公共 API 里没有"Opus 4.2"或"Opus 4.3"。Anthropic 从 Opus 4.1 直接跳到 4.5/4.6/4.7/4.8 系列，每个都有独立的带时间戳模型 ID 后缀。

对工程团队的影响

三个运营信号值得关注。

弃用节奏正在加速。 Anthropic 过去给模型 4–6 个月的退役缓冲期。如今 Opus 4（2025 年 5 月发布）6 月退役，Opus 4.1（2025 年 8 月发布）8 月退役——从发布到退役都不超过 14 个月。在 CI/CD 管道、监控面板或 SDK 默认值里硬编码模型 ID 的团队，会比预期更快撞上这些墙。

多提供商成本计算已改变。 Opus 4.8 定价为 $5/$25（输入/输出每百万 token），比原版 Opus 4 的 $15/$75 便宜 67%。这改变了跨提供商成本对比：在 $5/$25 下，Claude Opus 4.8 在许多工作负载上已与 GPT-5 具有竞争力，而对代码密集型任务，与 DeepSeek V4 Pro 的价格差距已缩小到延迟和可靠性比原始 token 价格更重要的程度。

合作平台时间线各异。 Amazon Bedrock 和 Vertex AI 各自设定退役时间表。如果你通过 AWS Bedrock 路由，模型可能比 Anthropic API 的日期活得更久或更短——多提供商 fallback 逻辑不能假设单一的全局退役日期，需要按提供商维护弃用元数据。

路由/运营视角

对路由层运维来说，核心问题是模型别名衰减管理。当你配置了 opus-4-8 → opus-4-1 → opus-4 → sonnet-4-6 这样的 fallback 链，中间两层都已弃用，60 天内都会失效。你需要以下路由策略之一：

1. 自动清除已弃用层级 —— 定期查询 Anthropic 弃用端点，或维护本地弃用账本，让路由配置在部署时（而非请求时）读取最新状态。
2. 定期审计别名版本 —— 在每次 Anthropic 发布弃用公告时，扫描路由配置、环境变量、SDK 默认值、LangChain 封装参数和监控面板中的所有 claude-opus-4-* 和 claude-sonnet-4-* 模式。
3. 退役前测试 fallback 触发 —— 设置合成请求，强制路由层从主层级依次降到每个 fallback 层级，验证低层级在高层级退役前能正常返回 200。

对通过 OpenAI 兼容网关路由 Claude 的团队来说，模型别名字符串是唯一的真相来源。如果你的路由层接受 claude-opus-4-1 作为用户可见别名并在底层解析为 claude-opus-4-1-20250805，别名映射也需要更新——不只更新 fallback 链。

迁移检查清单：Claude Opus 4.1 → Opus 4.8

从 Opus 4.1 迁移到 Opus 4.8 基本是模型名替换，但 effort 参数行为有变化：

• 替换模型 ID：claude-opus-4-1-20250805 → claude-opus-4-8。检查源码、配置文件、.env、CI/CD 脚本、SDK 封装默认值、监控面板和 LangChain/LlamaIndex 参数。
• 单独审计 Bedrock/Vertex。 若通过 AWS Bedrock 或 Vertex AI 路由，查看对应平台的模型表——弃用日期可能不同。
• 重新校准 effort 层级。 Opus 4.8 默认 effort=high。对代码和高自主性任务，显式设置 xhigh。若之前针对 Opus 4.1 的 effort 校准调优过延迟，需重新测量。
• 检查上下文窗口假设。 Opus 4.8 默认提供 1M token 窗口（Microsoft Foundry 为 200k）。若你为旧模型传递了上下文窗口 beta header，可以移除。
• 验证采样参数。 Opus 4.8 对 temperature、top_p、top_k 返回 400 错误，与 Opus 4.7 一致。若你添加了在 400 时重新注入这些参数的重试路径，请移除。
• 更新路由别名映射。 若路由层将 claude-opus-4-1 等用户可见别名解析为带时间戳的底层 ID，更新解析目标。
• 运行合成 fallback 测试。 强制路由层逐级触发每个 fallback 层级，验证在 8 月 5 日前都能正常返回 200。
• 更新监控过滤器。 若面板按模型名字符串过滤，将 claude-opus-4-8 加入允许列表，并将 claude-opus-4-1-20250805 标记为已弃用。

Anthropic 还提供了 /claude-api migrate 命令（在 Claude Code 内运行），可自动完成跨代码库的模型 ID 替换，包括 Bedrock 和 Vertex 平台的调整。

TheRouter 用户需关注什么

如果你通过多提供商 AI 路由网关路由 Anthropic 流量，请确认路由配置中的 Claude fallback 层级只包含活跃模型 ID。快速自查：

grep -r "claude-opus-4-1\|claude-opus-4-2025" .

任何匹配都是 8 月 5 日的定时炸弹。替换为 claude-opus-4-8 并端到端重新测试 fallback 链。对于管理多个上游提供商（包括 SiliconFlow、DashScope 或其他 OpenAI 兼容端点）的团队，建议设置一个弃用提醒定时任务，每周检查 Anthropic 弃用页面，并标记配置中状态变为"已弃用"的模型 ID。

更深层的教训是：发布越快的提供商，退役也越快。你的路由层需要具备版本感知的别名管理能力，将模型 ID 视为临时路由键，而非永久配置。