Anthropic 60 天弃用节奏：多供应商路由团队迁移手册

Anthropic 对公开发布的模型提供至少 60 天的弃用通知期。实际节奏比大多数团队预期的更紧——截至 2026 年 5 月的 12 个月内，已有 8 个 Claude 模型退役，后续还有更多排队。如果你的技术栈涉及 Anthropic 模型，你需要的是一套可重复的迁移流程，而不是每次都临时救火。

本文梳理生命周期规律，记录每一次重大弃用事件的日期和来源，并给出代码级操作手册：盘点硬编码的 model ID、配置 fallback、shadow 测试替代模型、质量回退时回滚。

我们把 OpenAI-compatible 请求路由到已配置的供应商，并在已实现的产品路径中支持 provider/model routing 和 fallback。我们不承诺零停机、支持所有模型，也不承诺一定最便宜。下文所有日期和价格均来自 Anthropic 官方文档，获取时间为 2026-06-16。

30 秒速览

• Anthropic 在模型退役前提供至少 60 天通知（Model deprecations，获取于 2026-06-16）。
• 生命周期阶段：Active → Legacy → Deprecated → Retired。Deprecated 后会分配确定的退役日期；Retired 后 API 请求会报错。
• 当前已弃用： claude-opus-4-1-20250805——2026 年 6 月 5 日弃用，2026 年 8 月 5 日退役（距今 50 天）。推荐替代：claude-opus-4-8。
• 刚刚退役（2026-06-15）： claude-opus-4-20250514 和 claude-sonnet-4-20250514。如果你还在用这些 model ID，调用已经在报错了。
• Anthropic 承诺永久保留所有公开发布模型的权重（Commitments on model deprecation and preservation，2025 年 11 月）。

Claude 模型生命周期时间线

下表汇总了 Anthropic 公开文档中所有重要的 Claude 弃用事件。所有日期来自 Anthropic 模型弃用页面 和 endoflife.date/claude，交叉验证，获取于 2026-06-16。

规律： 近期弃用周期趋于 60–62 天。早期 Claude 2/3 有更长的窗口（180 天以上），但从 Claude 3.5 代开始，Anthropic 已标准化到最低 60 天承诺。

Anthropic 弃用节奏的特殊之处

几个因素让 Anthropic 的弃用节奏在运维上特别紧迫：

1. 发布节奏快。 Anthropic 在 12 个月内发布了 Opus 4、4.1、4.5、4.6、4.7、4.8——大约每 2 个月一个 Opus 版本。每次新发布最终会触发 2–3 代之前模型的弃用。

2. Tokenizer 断代。 从 Claude Opus 4.7 开始，Anthropic 启用新 tokenizer（后续所有模型包括 Fable 5 均使用）。相同文本在新 tokenizer 下会多产生约 30% 的 token（Pricing，获取于 2026-06-16）。这意味着迁移不只是换个 model ID——你的成本基线会变。

3. 定价层级变动。 Opus 4/4.1 的价格是 $15/$75 per MTok（输入/输出），Opus 4.5–4.8 降到 $5/$25。从 4.1 迁到 4.8 成本下降——但 tokenizer 膨胀会部分抵消。净成本变化取决于你的 workload 形态。

4. 平台时间线分歧。 Anthropic 的弃用日期适用于 Claude API、Claude Platform on AWS 和 Microsoft Foundry。Amazon Bedrock 和 Vertex AI 有各自的退役时间表。同一个模型你可能需要跟踪两条时间线。

5. 无常青别名保证。 从 4.6 代开始，不带日期的 model ID（如 claude-opus-4-6）是固定快照，不是滚动指针。你不能依赖 ID 自动迁移。

Before/after 代码 diff：硬编码 model ID → 路由别名 + fallback

最危险的模式是在代码深处硬编码带日期的 model ID。模型退役后，所有调用都会失败。更安全的模式：用路由层把逻辑别名映射到具体 model ID，并配置 fallback 链。

脆弱：硬编码 model ID

from openai import OpenAI

client = OpenAI(
    base_url="https://api.anthropic.com/v1",
    api_key="<ANTHROPIC_API_KEY>",
)

# 2026 年 8 月 5 日之后会报错
response = client.chat.completions.create(
    model="claude-opus-4-1-20250805",
    messages=[{"role": "user", "content": "总结本季度的营收趋势。"}],
)

韧性：路由别名 + fallback

from openai import OpenAI

client = OpenAI(
    base_url="https://api.therouter.ai/v1",
    api_key="<THEROUTER_API_KEY>",
)

# 路由到已配置的 Anthropic provider；fallback 链处理弃用切换
response = client.chat.completions.create(
    model="anthropic/claude-opus-4.8",
    messages=[{"role": "user", "content": "总结本季度的营收趋势。"}],
)

使用路由层后，未来 Anthropic 弃用 Opus 4.8 时，你更新路由配置就行——不用改应用里的每一处调用。

TypeScript 等价写法

import OpenAI from 'openai';

// Before：硬编码，脆弱
const fragile = new OpenAI({
  baseURL: 'https://api.anthropic.com/v1',
  apiKey: '<ANTHROPIC_API_KEY>',
});

// After：路由，韧性
const resilient = new OpenAI({
  baseURL: 'https://api.therouter.ai/v1',
  apiKey: '<THEROUTER_API_KEY>',
});

const response = await resilient.chat.completions.create({
  model: 'anthropic/claude-opus-4.8',
  messages: [{ role: 'user', content: '总结本季度的营收趋势。' }],
});

跨供应商 fallback：Claude → DeepSeek / Qwen

有时迁移不是 Claude 到 Claude。如果 Anthropic 的定价或可用性不合适，跨供应商 fallback 是有效策略。

跨供应商 fallback 需要测试。模型在能力、上下文窗口和输出风格上各有不同。在把跨供应商 fallback 推到生产环境前，在每个候选模型上跑你的 eval 套件。

更多 fallback 链配置方法见 LLM API fallback 路由指南。

迁移清单

每次 Anthropic 宣布弃用时使用此清单：

• 盘点硬编码 model ID。 在代码、环境变量、配置文件中搜索被弃用的 model ID。用 Anthropic 的 usage 导出（CSV）找到仍在调用弃用模型的 API key。
• 确认平台日期。 确认你所用平台（Claude API / Bedrock / Vertex AI）的退役日期。它们可能不同。
• 测试替代模型。 在推荐的替代模型上跑你的 eval 套件。检查输出质量、延迟和 token 数量（特别是跨 tokenizer 边界如 Opus 4.1 → 4.8）。
• 重新基准成本。 Opus 4.7+ 的新 tokenizer 让相同文本 token 数膨胀 ~30%。即使单位 token 价格下降（$15→$5 输入），每次请求的实际成本取决于 workload 形态。
• 配置 fallback。 设置 fallback 链，当主模型返回 model_not_found（模型退役瞬间会发生）时，流量自动路由到替代模型。
• Shadow 流量。 如果你的量值得做，在切换前 1–2 周向替代模型发送 shadow 请求。逐条对比输出。
• 更新客户端代码。 替换应用中的 model ID。如果用了路由层，更新路由配置即可。
• 定义回滚路径。 如果替代模型在你的具体 workload 上质量回退，退到什么？Claude-to-Claude 用次新的 Opus；跨供应商用你已测试的替代方案。
• 监控迁移后表现。 在切换后 48 小时内关注错误率、延迟 p99 和输出质量指标。

处理 Opus 4.1 退役（2026-08-05）

这是当前活跃的弃用事件。关键信息：

• 被弃用模型： claude-opus-4-1-20250805
• 退役日期： 2026 年 8 月 5 日（距今 50 天）
• 推荐替代： claude-opus-4-8（来源）
• 价格变动： Opus 4.1 $15/$75 per MTok → Opus 4.8 $5/$25 per MTok。单位 token 成本下降 ~67%。
• Tokenizer 变化： Opus 4.8 使用新 tokenizer（Opus 4.7 引入）。相同文本 → ~30% 更多 token。每次请求的净成本通常下降，但请用你的 workload 数据验证。
• 上下文窗口： 两个模型均支持 1M token。Opus 4.8 最大输出 128K，Opus 4.1 为 64K。
• Extended thinking： Opus 4.1 支持 extended thinking。Opus 4.8 改为 adaptive thinking（始终开启，无 budget_tokens 参数）。如果你的代码设置了 thinking: {type: "enabled", budget_tokens: N}，必须移除。

最小迁移 diff

# Before
model = "claude-opus-4-1-20250805"

# After
model = "claude-opus-4-8"
# 同时移除任何 thinking={type: "enabled", budget_tokens: N} 配置
# Opus 4.8 使用 adaptive thinking——无需配置

模型退役时的 fallback 行为

Claude 模型退役后，针对该 model ID 的 API 请求会返回错误。Claude Code 等工具已实现 --fallback-model 标志，在 model_not_found 错误时自动切换——这个模式值得在你自己的应用层采用。

运维模式：

1. 主模型请求失败，返回 model_not_found 或等效错误。
2. 客户端或路由层逻辑捕获错误。
3. 用预配置的 fallback 模型重试。
4. 记录 fallback 事件以便可视化追踪。

这不能替代迁移——你仍然需要在退役前更新 model ID。但它为过渡期提供了安全网。

成本对比：Opus 4.1 → Opus 4.8

新 tokenizer 带来的 30% token 膨胀被 67% 的单位 token 价格下降更多地抵消了。大多数 workload 会看到净成本下降。但如果你的 workload 是重输入型且有大量缓存 prompt，cache-write 成本差异（5 分钟写入 $6.25 vs Opus 4.1 的 $18.75）可能有影响——请用你的实际用量算一下。

来源：Anthropic Pricing，获取于 2026-06-16。

跨供应商弃用背景

Anthropic 不是唯一有激进弃用时间线的供应商：

• 阿里云百炼 在 2026-07-08 下线了一批第三方模型快照（DeepSeek V3、GLM、MiniMax、Moonshot）——见我们的 百炼日落迁移指南。
• 阿里云 DashScope 将在 2026-07-13 下线 Qwen Turbo、VL、Coder Plus——见我们的 Qwen Turbo/VL/Coder Plus 日落指南。
• 小米 MiMo V2 于 2026 年 6 月 18 日下线，迁移至 V2.5。

跨供应商的规律：模型生命周期在缩短，运行多供应商技术栈的团队需要把弃用监控当作持续运维工作，而不是一次性事件。

回滚路径

如果 Opus 4.8 在你的 workload 上质量回退：

1. Claude-to-Claude： 回退到 claude-opus-4-7（Active，不早于 2027 年 4 月 16 日退役）或 claude-opus-4-6（Active，不早于 2027 年 2 月 5 日）。两者价格相同（$5/$25），使用相同 tokenizer。
2. 跨供应商： 回退到 deepseek/deepseek-v4-pro 或 dashscope/qwen3.7-max。不同定价、不同能力——需要 eval 测试。
3. 回滚路由配置： 如果用了路由层，回滚就是一次配置变更，不是代码部署。

延伸阅读

• Anthropic Model Deprecations——官方弃用时间表
• Anthropic Migration Guide——逐模型迁移指南
• Commitments on Model Deprecation and Preservation——Anthropic 权重保留政策
• Opus 3 Deprecation Update——首次完整退役流程案例
• LLM API Fallback 路由指南——跨供应商 fallback 链配置
• OpenAI 迁移到 TheRouter 指南——base URL 迁移模式
• DeepSeek API 完整指南——跨供应商 fallback 目标
• 阿里云百炼 API 指南——DashScope 作为替代供应商