Claude Fable 5.1 和 Claude Mythos 5.1 迁移指南

Claude Fable 5.1 接替 Claude Fable 5，输入和输出价格保持不变，缓存读取费用降至原来的四分之一。它可在 Claude API、Amazon Bedrock、Claude Platform on AWS、Google Cloud 和 Microsoft Foundry 上使用。Claude Mythos 5.1 具有相同的能力，仅向通过 Anthropic 验证计划（例如 Cyber Verification Program）验证的组织提供。有关行为差异和提示模式，请参阅为 Claude Fable 5.1 编写提示。

claude-fable-5-1 和 claude-mythos-5-1 共享的基线设置：

• 思考： Adaptive thinking（自适应思考）始终开启，与 Claude Fable 5 相同。模型自行决定何时思考以及思考多少。无需任何 thinking 配置。thinking: {type: "disabled"} 和手动扩展思考（thinking: {type: "enabled", budget_tokens: N}）都会返回 400 错误。
• 预填充： 预填充 assistant 消息会返回 400 错误，与 Claude Fable 5 相同。请改用系统提示中的指令。
• 工具选择： 支持 {type: "auto"}（默认值）和 {type: "none"}。使用 {type: "any"} 或 {type: "tool", name: "..."} 强制工具调用会返回 400 错误。请参阅破坏性变更。
• 跨模型保留思考： Claude Fable 5.1 可以读取来自 Claude Opus 5、Claude Fable 5、Claude Mythos 5 及更早 Claude 模型的思考块。这些模型都无法读取 Claude Fable 5.1 的思考块。请参阅破坏性变更。
• 上下文窗口和输出： 默认提供 1M 令牌上下文窗口，每个请求最多 128k 输出令牌。
• 定价： 每百万输入令牌 10 美元，每百万输出令牌 50 美元，与 Claude Fable 5 相同。提示缓存读取为每百万令牌 0.25 美元，是 Claude Fable 5 费率的四分之一。请参阅 Claude 定价。
• 数据保留： 两个模型都要求 30 天数据保留，除非获得 Anthropic 明确授权，否则不适用于"zero data retention"（零数据保留），即 ZDR 安排，并且被指定为受管辖模型（Covered Models），与 Claude Fable 5 和 Claude Mythos 5 相同。在 Claude API 上，来自未启用 30 天保留的组织或工作区的请求会返回 400 invalid_request_error。有 ZDR 安排的组织应联系其 Anthropic 客户团队，或按工作区配置保留策略。有关各平台的详细信息，请参阅特定模型的数据保留要求。

两个模型的不同之处：

• 可用性： Claude Fable 5.1 无需访问审批。Claude Mythos 5.1 仅向通过 Anthropic 验证计划（例如 Cyber Verification Program）验证的组织提供。如需申请访问权限，请申请适用于您用例的计划，或联系您的 Anthropic 客户团队。
• Priority Tier： 两个模型都不支持 Priority Tier。Claude Fable 5 支持。

从 Claude Fable 5 迁移到 Claude Fable 5.1

迁移基本上可以直接替换。API 接口、限制、每令牌定价、分词器、始终开启的自适应思考、拒绝处理以及 stop_details 类别都与 Claude Fable 5 一致。变化之处：强制工具选择会返回 400 错误；只有 Claude Fable 5.1 和 Claude Mythos 5.1 能读取 Claude Fable 5.1 的思考块，且仅限于生成这些思考块的对话中；缓存读取费用更低；智能体循环行为在三个方面有所不同。相同的变更也适用于 Claude Mythos 5.1，但思考块的对话检查除外，Claude Mythos 5.1 不执行该检查。

更新模型名称

model = "claude-fable-5"  # Before
model = "claude-fable-5-1"  # After

# 或者，对于 Claude Mythos 5.1（为经过验证的组织提供相同功能）：
model = "claude-mythos-5-1"  # After

破坏性变更

1. 不支持强制工具选择： Claude Fable 5 接受 tool_choice 的 auto、none、any 和 tool。在 claude-fable-5-1 上，{type: "any"} 和 {type: "tool", name: "..."} 会返回 400 invalid_request_error：

   tool_choice: type "tool" and "any" are not supported for this model.

   

   该检查适用于 Messages API、Message Batches API 和令牌计数端点。

   之前（Claude Fable 5）：

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   client = anthropic.Anthropic()
   
   record_summary_tool = {
       "name": "record_summary",
       "description": "Record the structured summary of the document.",
       "input_schema": {
           "type": "object",
           "properties": {"summary": {"type": "string"}},
           "required": ["summary"],
       },
   }
   
   response = client.messages.create(
       model="claude-fable-5",
       max_tokens=16000,
       tools=[record_summary_tool],
       tool_choice={"type": "tool", "name": "record_summary"},
       messages=[{"role": "user", "content": "Summarize: The meeting moved to Thursday."}],
   )
   print(response.content)

   之后（Claude Fable 5.1）：将 tool_choice 保持为 auto，在指令中指明工具名称，并设置 strict: true，使调用符合您的 schema。（在 CMEK 组织中，Claude Fable 模型不支持结构化输出（包括 strict: true），此时只能依靠指令。）例如：

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   client = anthropic.Anthropic()
   
   record_summary_tool = {
       "name": "record_summary",
       "description": "Record the structured summary of the document.",
       "strict": True,
       "input_schema": {
           "type": "object",
           "properties": {"summary": {"type": "string"}},
           "required": ["summary"],
           "additionalProperties": False,
       },
   }
   
   response = client.messages.create(
       model="claude-fable-5-1",
       max_tokens=16000,
       tools=[record_summary_tool],
       tool_choice={"type": "auto"},
       messages=[
           {
               "role": "user",
               "content": "Summarize: The meeting moved to Thursday. Call the record_summary tool with your result.",
           }
       ],
   )
   print(response.content)

   请参阅严格工具使用和强制工具使用。如果您强制使用工具只是为了获得符合 schema 的 JSON，请改用 JSON 输出（output_config.format）。

   如果是您的应用程序（而非用户）要求在多轮对话的当前轮次中调用特定工具，请在最新的 user 轮次之后追加一条对话中途系统消息。在其中指明工具名称，说明本轮必须调用该工具，并告诉 Claude 以该调用开始其响应。由于该消息是追加的，而不是写入顶层 system 提示，较早的轮次保持字节完全一致，并保留其提示缓存命中：

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   client = anthropic.Anthropic()
   
   search_help_center_tool = {
       "name": "search_help_center",
       "description": "Search the help center for policy and troubleshooting articles.",
       "strict": True,
       "input_schema": {
           "type": "object",
           "properties": {"query": {"type": "string"}},
           "required": ["query"],
           "additionalProperties": False,
       },
   }
   
   response = client.messages.create(
       model="claude-fable-5-1",
       max_tokens=16000,
       system="You are a customer support assistant for an online electronics store.",
       tools=[search_help_center_tool],
       messages=[
           {
               "role": "user",
               "content": "My headphones from order A1234 arrived yesterday.",
           },
           {
               "role": "assistant",
               "content": "Thanks for confirming. How can I help with order A1234?",
           },
           {"role": "user", "content": "I opened the box. Can I still return them?"},
           # 应用要求在给出任何政策答复之前先查询帮助中心。
           # 将该要求作为系统消息追加，可使
           # 之前的轮次保持不变。
           {
               "role": "system",
               "content": "Tool-use requirement for the current turn: the application requires a call to the search_help_center tool in your response to the user's latest message. Begin your response with the search_help_center tool call. Do not reply with text only.",
           },
       ],
   )
   print(response.content)

   与其他任何轮次一样，在后续请求中将 role: "system" 消息保留在历史记录中。对话中途系统消息不需要 beta 标头。对于不得调用工具的轮次，tool_choice: {"type": "none"} 仍然有效。

2. 只有 Claude Fable 5.1 和 Claude Mythos 5.1 能读取 Claude Fable 5.1 的思考块： 每个 thinking 块都会记录生成它的模型。Claude Fable 5.1 可以读取自己的思考块，以及来自 Claude Mythos 5.1、Claude Opus 5、Claude Fable 5、Claude Mythos 5 和更早 Claude 模型的思考块。从这些模型中任何一个迁移到 claude-fable-5-1 的对话都会保留其先前的推理。该条件是单向的：除 Claude Mythos 5.1 外，这些模型都无法读取 Claude Fable 5.1 的思考块。

   在 Claude Fable 5.1 上运行的对话可能会通过路由切换、客户端重试或分类器拒绝回退（包括服务器端回退）转到另一个模型（无论更旧还是更新）。API 会在该模型看到之前移除它无法读取的思考块，请求会成功，并且您不会为被丢弃的输入令牌付费。目标模型会在没有该推理的情况下重新规划，这可能会增加切换后第一轮的成本和"latency"（延迟）。要查看丢弃了哪些内容，请发送 thinking-binding-controls-2026-08-01 beta 标头：响应随后会包含一个 input_transformations 数组，列出每个被丢弃的块，并带有 reason: "model_binding_mismatch"。请参阅在对话中途切换模型。

3. 编辑较早的轮次会使思考块失效： Claude Fable 5.1 的每个 thinking 块仅对其之前的 system 提示、tools 和对话历史有效。如果由 Claude Code、claude.ai、Claude Managed Agents 或 Claude Agent SDK 管理您的对话历史，它们已经会保持该前缀完整。如果您的代码自行构建 messages 数组，则本条适用于您，完整的集成指南请参阅保留思考。在强制执行该检查的情况下，如果上述任何内容发生变化后再将该块发回，请求会被拒绝并返回 400 错误：

   messages.5.content.0: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block". That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header.

   

   对于 2026 年 8 月 31 日或之后创建的新账户，API 会强制执行该检查。对于更早创建的账户，API 会记录不匹配情况，但不会据此采取行动，除非请求设置了 thinking.block_binding.prefix_mismatch_behavior，从而选择启用强制执行。在这些账户上，如果您发送 thinking-binding-controls-2026-08-01 beta 标头且未设置该字段，响应会在 input_transformations 中将每个未通过检查的块列为 thinking_mismatch_allowed 条目。无论您的账户创建时间如何，都请让您的应用程序兼容该检查：相同的模式也能保持提示缓存处于热状态，并且您可以通过发送 prefix_mismatch_behavior 从任何账户针对该检查进行测试。如果您发布的工具或框架由用户使用他们自己的 API 密钥运行，请在发布前以这种方式进行测试：您的密钥很可能属于较旧的账户，而使用新账户的用户会比您先遇到该检查。如需确认您自己的账户是否默认强制执行，请在不带 beta 标头的情况下发送一个编辑了历史记录的请求：如果返回提及该标头的 400 错误，则说明是默认强制执行的。

   对于该请求体，此错误是永久性的：自动重试循环无法消除它。如果希望在没有失效推理的情况下继续而不是失败，请从历史记录中移除 thinking 块并重试一次，或者发送 thinking-binding-controls-2026-08-01 beta 标头并将 prefix_mismatch_behavior 设置为 "drop_block"（默认值为 "error"）。使用 "drop_block" 时，API 会丢弃不匹配的块以及对话中其后的所有思考块，并在响应的 input_transformations 数组中以 reason: "prefix_binding_mismatch" 报告每个块：

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   client = anthropic.Anthropic()
   
   response = client.beta.messages.create(
       model="claude-fable-5-1",
       max_tokens=16000,
       thinking={
           "type": "adaptive",
           "block_binding": {"prefix_mismatch_behavior": "drop_block"},
       },
       messages=[
           {
               "role": "user",
               "content": "What is the greatest common divisor of 1071 and 462?",
           }
       ],
       betas=["thinking-binding-controls-2026-08-01"],
   )
   
   for block in response.content:
       if block.type == "text":
           print(block.text)
   
   print(f"Input transformations: {len(response.input_transformations or [])}")

   令牌计数端点也会执行相同的检查。有关响应结构和流式传输中的位置，请参阅未保留块的控制选项（beta）。

   会使后续思考块失效的模式，以及替代做法：

   • 编辑、重新排序或删除较早的轮次。这包括删除旧的工具结果、从对话记录中间剪掉轮次，以及在摘要之后逐字保留最近轮次及其思考块的客户端压缩（包括在几轮之后才换入摘要的后台压缩）。替代做法：使用服务器端压缩或上下文编辑（对旧工具结果使用工具结果清除），或使用在服务器上裁剪上下文中的某种客户端压缩结构。
   • 注入您不持久保存的内容，例如在 tool_result 块之后追加、并在下一个请求中移除的每轮提醒。替代做法：将提醒作为轮次范围的系统消息发送，并将其保留在历史记录中。
   • 在同一对话的请求之间重建顶层 system 提示或 tools 数组，例如为了更新当前日期或添加、移除工具。替代做法：追加一条对话中途系统消息，携带新指令（"当前日期是 2026-09-14。"）或 tool_addition 和 tool_removal 块。开始时未在 tools 中声明的工具可以在 tool_addition 块中定义（beta 标头 inline-tools-2026-09-15）。
   • 在后续请求中返回不同字节的图像或文档 URL。该检查针对的是字节，而不是 URL 字符串，因此同一文件的轮换签名 URL 没有问题。对于跨轮次引用的内容，请使用 Files API 上传一次并发送 file_id，或发送 base64。

   每种替代做法还能保持较早轮次字节完全一致，并保留编辑历史记录、system 提示或 tools 数组时会丢失的提示缓存命中。

   仍然有效的模式：

   • 仅追加的历史记录：添加轮次，并将较早的轮次完全按照发送和接收时的样子传回，包括追加的 role: "system" 消息。
   • 从较早的 assistant 轮次中移除思考块，从最旧的开始。
   • 更改 effort、max_tokens 或 system、tools 和 messages 之外的任何其他请求参数，以及添加或移动 cache_control 标记。
   • 服务器端压缩和上下文编辑，包括思考块清除。它们不算作编辑，因为该检查比较的是您发送时的对话。

   检查现有集成的方法：

   1. 捕获它在几个正常轮次中发送的确切请求体，如果您的产品有压缩或工具变更，也要包括在内。对于每对连续请求，比较 system 提示、tools 数组以及 messages 的共享前缀。在新追加的轮次之前，它们应该字节完全一致。一个预期的例外是换入来自按需压缩的已签名 compaction 块的请求：该块会在 messages 开头替换它所总结的消息，其后的所有内容仍应一致。
   2. 使用 thinking-binding-controls-2026-08-01 beta 标头和 prefix_mismatch_behavior: "drop_block"，针对 claude-fable-5-1 运行一个正常的多轮会话，并记录每个响应中的 input_transformations。如果每一轮都是空数组，则说明历史记录完整。带有 reason: "prefix_binding_mismatch" 的条目表示自上一个请求以来，path 处的块之前的某些内容发生了变化。带有 reason: "model_binding_mismatch" 的条目表示对话切换了模型，这不是您代码中的错误。这在任何账户上都有效，因为设置该字段会让请求选择启用强制执行。在 CI 中，请改为设置 "error"，以便编辑导致运行失败。
   3. 选择生产环境设置。如果前缀不匹配只可能意味着您代码中的错误，请保留默认值 "error"；或者设置 "drop_block" 以丢弃受影响的块而不是失败。无论哪种方式，都要监控 400 错误或 input_transformations 条目。

   偶尔丢弃一次思考块（例如在压缩边界处）影响很小。每个请求都使先前思考失效的集成每次都会重新开始提示缓存，这可能会增加每个任务的成本（请参阅保持对话历史仅追加）。

行为变更

1. 长智能体循环中的并行工具调用更少：在长时间运行的循环中，如果下一批独立读取仅由任务隐含（自定义编码智能体、bash 加编辑器框架、计算机使用），Claude Fable 5.1 可能每轮只发出一个工具调用。每个额外的轮次都会消耗令牌、一次往返和实际时间。在每条用户消息之后追加一句批处理指令，作为轮次范围的系统消息（clear_at: "next_user_message"，beta），或者在没有 beta 的情况下，放在 tool_result 块之后的文本块中，并在后续请求中将较早的副本保留在历史记录中。请参阅在智能体循环中批量处理独立工具调用。

2. 工具调用之间的进度消息更少：与 Claude Fable 5 相比，Claude Fable 5.1 在长工具序列期间写的状态更新更少，其智能体编码摘要也更短。如果您的界面渲染这些更新，请将 thinking.display 设置为 "updates"（beta）或 "summarized"，并明确提示要求它们。请参阅工具调用之间的进度更新和请求面向用户的进度更新。

3. 低努力级别下的搜索和检索调用更少：在 low 努力级别下，Claude Fable 5.1 比 Claude Fable 5 更常凭记忆回答，而不是调用搜索或检索工具。如果您的产品依赖低努力级别下的检索，请为这些请求提高努力级别，或告诉模型何时搜索。请参阅低努力级别下的搜索触发。

有关散文密度、聊天格式、摘要中的引用和文件编辑方面的差异（这些不影响 API 集成），请参阅相对于 Claude Fable 5 的变化。

建议的变更

这些变更不是必需的，但每一项都能降低成本或延迟，或消除一种故障模式：

1. 在对话中途更改 effort（beta）： 在 Claude Fable 5 上，output_config.effort 是请求级别的，在请求之间更改它会丢失较早轮次的缓存前缀。在 claude-fable-5-1 上，仅携带 output_config 的 role: "system" 消息可以为困难步骤提高 effort，或为常规步骤降低 effort，而不会使提示缓存失效：

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   client = anthropic.Anthropic()
   
   response = client.beta.messages.create(
       model="claude-fable-5-1",
       max_tokens=4096,
       output_config={"effort": "high"},
       messages=[
           {
               "role": "user",
               "content": "Plan a migration from SQLite to PostgreSQL in three short steps.",
           },
           {
               "role": "assistant",
               "content": "1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts.",
           },
           # 仅含 effort 的系统消息：新级别从下一个用户轮次起生效。
           {"role": "system", "content": [], "output_config": {"effort": "low"}},
           {"role": "user", "content": "Summarize the plan in one sentence."},
       ],
       betas=["mid-conversation-output-config-2026-07-01"],
   )
   
   for block in response.content:
       if block.type == "text":
           print(block.text)

   如此处所示，当该消息放在 assistant 轮次和下一个 user 轮次之间时，它从该 user 轮次开始生效。当它直接放在带有新输入的 user 轮次之后时，它会设置 Claude 对该轮次回复的级别。仅包含工具结果的 user 轮次不算作新输入：更改会等到下一个带有新输入的 user 轮次才生效。之后该级别会一直保持，直到另一条 role: "system" 消息更改它。仅接受命名级别（low、medium、high、xhigh、max），并且需要 mid-conversation-output-config-2026-07-01 beta 标头。请参阅按消息设置 effort。

2. 使用对话中途系统消息更改指令和工具： 如需在会话中途更改指令或工具，请追加一条 role: "system" 消息，工具变更使用 tool_addition 和 tool_removal 块（在 Claude API 上使用 beta 标头 inline-tools-2026-09-15）。tool_addition 块可以指明会话开始时在 tools 中声明的工具，也可以携带工具的完整定义，因此会话开始时未知的工具无需放在 tools 中。这样可以保留较早轮次的提示缓存命中，并保持对话历史仅追加。较旧的 mid-conversation-tool-changes-2026-07-01 标头仍适用于通过引用指明工具的变更，可在 Claude API、Amazon Bedrock 和 Google Cloud 上使用。当当前轮次必须运行特定工具时，同样的消息可以替代强制 tool_choice（请参阅破坏性变更）。对于仅适用于一个轮次的提醒，请将其作为单独的纯文本 role: "system" 消息发送，并设置 clear_at: "next_user_message"（轮次范围的系统消息，beta 标头 mid-conversation-system-clear-at-2026-08-21），并将其保留在历史记录中：它会在下一条用户消息之后停止渲染，清除后不再消耗令牌。携带 tool_addition 或 tool_removal 块的消息不能设为轮次范围。

3. 对拒绝使用 fallbacks: "default"： 继续处理 stop_reason: "refusal"，并在读取响应内容之前读取 stop_details.category。如需自动在另一个模型上重新运行被拒绝的请求，请设置 fallbacks: "default"（beta，server-side-fallback-2026-07-01 标头）。"default" 会在 Anthropic 针对该类别推荐的模型上重试被拒绝的请求。Claude Fable 5.1 允许的回退目标是 Claude Opus 4.8（claude-opus-4-8）和 Claude Opus 5（claude-opus-5）。显式的 fallbacks 列表可以指定其中任意一个。回退模型不会收到 Claude Fable 5.1 的思考块。fallbacks 参数在 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 上不可用。在这些平台上，请改用客户端回退。如果您自行构建重试，回退抵扣按与 Claude Fable 5 相同的条款适用。请参阅拒绝与回退。

4. 从 high effort 开始并进行扫描测试： effort 参数的默认值为 high，支持全部五个级别。沿用 Claude Fable 5 的指导：大多数工作使用 high，medium 作为值得测试的成本控制手段。Claude Fable 5.1 相对于 Claude Fable 5 的提升在 xhigh 和 max 下最大，但这些级别也会增加思考时间和首次响应时间，因此请在对能力最敏感的任务中、以及您的评估显示有提升的情况下再提升到这些级别。请在您自己的评估上重新进行扫描测试，而不是沿用为 Claude Fable 5 调优的设置。请参阅 Claude Fable 5.1 的推荐 effort 级别。

5. 在服务器上裁剪上下文，或以不携带过时思考的结构进行压缩： 如果您的代码在客户端截断或总结较早的轮次，最简单的解决方法是将这项工作移至服务器端压缩或上下文编辑。两者都不算作编辑，因为历史检查比较的是您发送时的对话，所以它们移除的任何内容都不会使后续思考块失效，并且压缩的 instructions 参数接受您自己的总结提示。如果您在摘要之后逐字保留最近的轮次，或在对话继续进行时在后台进行总结，请使用按需压缩（beta 标头 compact-2026-09-04），而不是客户端编写的摘要。API 会写入一个已签名的摘要块，您将其放在它所总结的消息的位置。在压缩与保留思考中所述的条件下，您保留的轮次中的思考块可以保持有效。如果您在客户端进行压缩，请从以下三种结构中选择一种：

   • 简单压缩（推荐）： 用一条摘要消息加上新的用户轮次替换整个历史记录，不重放其他任何内容。不会携带任何思考块，因此不会出现失败。Claude 模型在长周期任务上使用这种方案进行训练，对于大多数工作负载，其表现与更复杂的方案相当。
   • 保留尾部压缩： 如果您在摘要之后逐字保留最近的轮次，请从这些轮次中移除 thinking 和 redacted_thinking 块（文本和工具调用可以保留），或设置 prefix_mismatch_behavior: "drop_block"。它们的思考是基于完整历史生成的，否则放在摘要之后会失败。
   • 后台压缩： 如果您在关键路径之外构建摘要并在稍后换入，那么在此期间生成的每一轮都携带早于换入的思考。对于每个仍携带换入前生成的思考块的请求，请发送 "drop_block"（或自行移除这些块；换入后第一个响应中的 input_transformations 会准确列出是哪些块），或者改为同步压缩。

   不要从对话记录中间剪掉单个轮次：这会使之后的每个思考块失效，任何客户端结构都无法避免。对于您原本要进行的指令变更，请使用对话中途系统消息；对于选择性移除，请使用服务器端上下文编辑。请参阅回传压缩块。

迁移清单

• 将模型名称从 claude-fable-5 更新为 claude-fable-5-1（或从 claude-mythos-5 更新为 claude-mythos-5-1）。
• 替换强制 tool_choice（{type: "any"} 或 {type: "tool", ...}），它会返回 400 错误。请使用 {type: "auto"} 加上明确的指令和 strict: true 工具，或使用 JSON 输出。将指令放在 user 轮次中；当您的应用程序要求调用时，则放在对话中的 role: "system" 消息中。
• 在每一轮中继续原样传回 thinking 块，包括空块。Claude Fable 5.1 可以读取来自 Claude Opus 5、Claude Fable 5、Claude Mythos 5 和更早模型的思考块。将对话从 Claude Fable 5.1 迁移到 Claude Mythos 5.1 以外的任何模型都会丢弃其思考块。
• 如果您的代码自行构建 messages 数组，请检查它是否会编辑之前的轮次：使用 thinking-binding-controls-2026-08-01 beta 标头和 prefix_mismatch_behavior: "drop_block" 运行一个会话，记录 input_transformations，并修复每个 prefix_binding_mismatch。模型切换后出现 model_binding_mismatch 条目属于预期情况。
• 保持对话历史仅追加：在会话开始时固定 system 和 tools，将会话中途的变更移至 role: "system" 消息以及 tool_addition / tool_removal 块；将每轮提醒作为永不移除的轮次范围系统消息发送；在服务器端裁剪上下文，或从跨越客户端摘要保留的任何轮次中移除思考块；并通过 file_id 引用跨轮次文件。
• 选择生产环境的 prefix_mismatch_behavior（默认为 "error"，或 "drop_block"）并进行监控。如果您维护的工具供他人使用自己的 API 密钥运行，请在设置该字段的情况下进行测试：即使您的账户未默认强制执行，新账户也会默认强制执行。
• 检查智能体循环是否存在每轮只调用一个工具的行为，并添加批处理指令。
• 如果您的界面会渲染工具调用之间的进度文本，请将 thinking.display 设置为 "updates"（beta）或 "summarized"，并提示模型提供更新。
• 如果您在请求之间更改努力程度，请将该更改移至按消息设置努力程度的 role: "system" 消息（beta），以保持缓存命中。
• 处理 stop_reason: "refusal" 并读取 stop_details.category。考虑使用 fallbacks: "default"（beta）。
• 通过新的扫描测试重新评估 effort，从 high 开始，并在您自己的工作负载上重新确定成本和延迟基线。分词器保持不变。提示缓存读取费用为 Claude Fable 5 费率的四分之一。

从 Claude Opus 5 迁移到 Claude Fable 5.1

Claude Fable 5.1 使用与 Claude Opus 5 相同的 Messages API 和工具使用模式。它默认保留 1M 令牌上下文窗口、128k 最大输出令牌、512 令牌的提示缓存最小值，以及对话中途系统消息支持。预填充限制、采样参数限制以及 thinking.display 的 "omitted" 默认值也同样延续。请应用从 Claude Fable 5 迁移到 Claude Fable 5.1 中的所有内容，以及以下内容。

更新模型名称

model = "claude-opus-5"  # Before
model = "claude-fable-5-1"  # After

# 或者，对于 Claude Mythos 5.1（为经过验证的组织提供相同功能）：
model = "claude-mythos-5-1"  # After

变化内容

1. 无法再禁用思考： Claude Opus 5 在 effort 级别为 high 或更低时接受 thinking: {type: "disabled"}。在 claude-fable-5-1 和 claude-mythos-5-1 上，自适应思考始终开启，thinking: {type: "disabled"} 在任何 effort 级别下都会返回 400 错误。请移除该字段，使用较低的 effort 级别控制令牌消耗，并为原先在禁用思考情况下运行的工作负载重新评估 max_tokens。

2. 不支持强制工具选择： Claude Opus 5 接受 tool_choice 的 any 和 tool。claude-fable-5-1 会返回 400 错误。请参阅破坏性变更。

3. 跨模型保留思考： Claude Fable 5.1 可以读取 Claude Opus 5 的思考块：从 claude-opus-5 迁移到 claude-fable-5-1 的对话会保留其推理。Claude Opus 5 无法读取 Claude Fable 5.1 的思考块。Claude Fable 5.1 的思考块还会在较早轮次发生变化时失效：如果您的代码在请求之间编辑较早的消息、重建 system 或 tools，或在客户端进行压缩，Claude Opus 5 不会报错，但 claude-fable-5-1 会拒绝或丢弃之后的每个思考块。在切换流量之前，请运行该部分中的三步检查。请参阅破坏性变更。

4. 工具调用之间的文本以思考块形式返回： 在 Claude Opus 5 上，模型在工具调用之间编写的文本以 text 块形式返回。在 claude-fable-5-1 上，与 Claude Fable 5 一样，这些叙述以进度更新 thinking 块的形式返回，每个工具调用之前一个。在默认的 thinking.display 值 "omitted" 下，它们不包含可读文本。如果您的界面会渲染这些叙述，请设置 display: "updates"（beta）以文本形式接收进度更新，同时保持推理隐藏；或设置 "summarized" 以同时接收两者。然后渲染 tool_use 块之间的非空 thinking 块。请参阅工具调用之间的进度更新。

5. 安全分类器和回退路由： Claude Fable 5.1 运行的安全分类器覆盖与 Claude Fable 5 相同的 stop_details 类别，范围比 Claude Opus 5 的分类器更广。预计会出现额外的 stop_details.category 值，例如 "bio"；完整列表请参阅拒绝类别表。有关 fallbacks 配置和允许的目标，请参阅对拒绝使用 fallbacks: "default"。

6. 定价： 每百万输入令牌 10 美元，每百万输出令牌 50 美元，而 Claude Opus 5 分别为 5 美元和 25 美元。提示缓存读取为每百万令牌 0.25 美元，是 Claude Opus 5 费率的一半。请参阅 Claude 定价。

7. 数据保留： Claude Fable 5.1 和 Claude Mythos 5.1 要求 30 天数据保留，除非获得 Anthropic 明确授权，否则不适用于零数据保留（ZDR）安排，并且被指定为受管辖模型（Covered Models）。Claude Opus 5 可在 ZDR 下使用。请参阅特定模型的数据保留要求。

迁移清单

• 如果您的组织签订了"zero data retention"（零数据保留），即 ZDR 协议，请先确认资格：除非获得 Anthropic 的明确授权，否则这些模型不在 ZDR 下提供。请参阅特定模型的数据保留要求。
• 将模型名称从 claude-opus-5 更新为 claude-fable-5-1（或 claude-mythos-5-1）。
• 删除所有 thinking: {type: "disabled"} 配置：它在 claude-fable-5-1 上会返回 400 错误。请使用较低的 effort 级别来控制令牌消耗，并重新审视 max_tokens。
• 将强制 tool_choice（any 或 tool）替换为 auto，并配合明确的指令（user 轮次或对话中途的系统消息）和 strict: true 工具，或改用 JSON 输出。
• 如果您的界面会渲染工具调用之间的文本，请设置 display: "updates"（beta）或 "summarized"，并渲染非空的 thinking 块。
• 应用 Claude Fable 5 清单中关于保留思考、历史编辑、行为、effort 和回退的各项内容。
• 在您自己的工作负载上重新建立成本基线。"tokenizer"（分词器）保持不变，但每令牌定价有所不同。

从 Claude Opus 4.8 或更早版本迁移到 Claude Fable 5.1

请按照下面的清单逐项操作。如果您使用的是 Claude Opus 4.7 或更早版本，请先参阅 Claude Opus 5.5 迁移指南中的相应部分。

更新您的模型名称

model = "claude-opus-4-8"  # Before
model = "claude-fable-5-1"  # After

# 或者，对于 Claude Mythos 5.1（为经过验证的组织提供相同功能）：
model = "claude-mythos-5-1"  # After

迁移清单

• 如果您的组织有零数据保留（ZDR）安排，请首先确认资格：除非获得 Anthropic 明确授权，否则这些模型不适用于 ZDR。Claude Opus 4.8 可在 ZDR 下使用。
• 将模型名称从 claude-opus-4-8 更新为 claude-fable-5-1（或 claude-mythos-5-1）。
• 移除任何 thinking: {type: "disabled"} 配置并重新审视 max_tokens。不带 thinking 字段的请求将以自适应思考运行。
• 更新按位置读取内容的响应解析逻辑，例如 content[0].text：响应现在可能以 thinking 块开头，因此请改为按 type 选择内容块。
• 将强制 tool_choice（any 或 tool）替换为 auto 加上明确的指令（user 轮次或对话中途系统消息）和 strict: true 工具，或替换为 JSON 输出。
• 原样传回 thinking 块，并将其文本视为仅供显示。Claude Fable 5.1 可以读取 Claude Opus 4.8 的 thinking 块：迁移到 claude-fable-5-1 的对话会保留其较早的推理。Claude Opus 4.8 无法读取 Claude Fable 5.1 的块。
• 如果您的代码自行构建 messages 数组，请检查它是否编辑了较早的轮次。为 Claude Opus 4.8 及更早版本编写的集成通常会截断旧轮次、剥离或重建较早的消息，或在每次请求时刷新 system 提示，而 Claude Opus 4.8 从未提出异议。在 claude-fable-5-1 上，上述每一种做法都会使之后的 thinking 块失效。
• 处理 stop_reason: "refusal"，读取 stop_details.category，并考虑使用 fallbacks: "default"（beta）。
• 应用 Claude Fable 5 清单中的保留思考、历史编辑、行为、按消息设置 effort 和进度更新相关条目。
• 重新评估 effort（从 high 开始），检查接近 512 令牌缓存最小值（Claude Opus 4.8 上为 1,024 令牌）的提示，并重新建立成本和延迟基线。每令牌定价有所不同，且思考令牌按输出令牌计费，因此在 Claude Opus 4.8 上不使用思考运行的工作负载，每次请求可能会产生更多输出令牌。

从 Claude Mythos 5 迁移到 Claude Mythos 5.1

Claude Mythos 5.1 是 Claude Fable 5.1 的对应版本，面向通过 Anthropic 验证计划（例如 Cyber Verification Program）验证的组织。在切换模型 ID 之前，请确认您的组织有权访问 Claude Mythos 5.1。

API 级别的差异与从 Claude Fable 5 迁移到 Claude Fable 5.1 相同：强制工具选择会返回 400 错误，并且只有 Claude Mythos 5.1 和 Claude Fable 5.1 能读取 Claude Mythos 5.1 的思考块（Claude Mythos 5.1 可以读取 Claude Mythos 5 的思考块，反之则不行）。与 Claude Fable 5.1 不同，Claude Mythos 5.1 不运行对话检查，因此编辑先前的轮次不会使思考块失效，但仍会重新开始提示缓存。

更新您的模型名称

model = "claude-mythos-5"  # Before
model = "claude-mythos-5-1"  # After

迁移清单

• 将模型名称从 claude-mythos-5 更新为 claude-mythos-5-1。
• 将强制 tool_choice（any 或 tool）替换为 auto 加上明确的指令（user 轮次或对话中途系统消息）和 strict: true 工具，或替换为 JSON 输出。
• 在处理响应内容之前，处理 stop_reason: "refusal" 并读取 stop_details.category。请参阅拒绝与回退。
• 在每一轮中继续原样传回 thinking 块，包括空块。
• 如果您的代码自行构建 messages 数组，请保持对话历史仅追加，以保持提示缓存处于热状态。Claude Mythos 5.1 不运行对话检查，因此编辑不会使其 thinking 块失效。
• 应用 Claude Fable 5 部分中的行为和建议变更，但历史编辑相关条目除外，这些条目不适用于 Claude Mythos 5.1。
• 通过一次全新的扫描重新评估 effort，并重新建立成本和延迟基线。提示缓存读取的费用是 Claude Mythos 5 费率的四分之一。