Claude Fable 5.1 的新功能

Claude Fable 5.1 以相同的每令牌价格扩展了 Claude Fable 5，在长时间运行的智能体编码、多步骤研究以及文档、电子表格和幻灯片工作方面表现更强。对于大多数工作负载，请从 Claude Opus 5 开始（请参阅选择模型）。将 Claude Fable 5.1 用于要求苛刻的推理和长周期智能体工作，或者当您在更高 effort 下对 Claude Opus 5 的评估仍然不达标时使用。Claude Mythos 5.1 仅向 Project Glasswing 参与者提供相同的能力。

如果您已经在调用 Claude Fable 5，有三项变更是破坏性变更：强制工具使用会返回错误、更早的模型无法读取其思考块，以及编辑较早的轮次会使思考块失效。有五项是附加功能：每条消息的 effort（beta）、轮次范围的系统消息（beta）、工具调用之间可读的进度更新（display: "updates"，beta）、更低的缓存读取价格，以及内容来源。

模型

Claude Fable 5.1 和 Claude Mythos 5.1 共享规格和定价：

• 上下文窗口和输出：1M 令牌上下文窗口（默认值和最大值），整个窗口均按标准每令牌定价，最大输出令牌为 128k。
• 思考：自适应思考始终开启。使用 effort 参数控制思考深度。
• 定价： 与 Claude Fable 5 相同，但缓存读取价格更低。
• 分词器： 与 Claude Fable 5 相同（随 Claude Opus 4.7 引入）。与早于 Claude Opus 4.7 的模型相比，相同文本产生的令牌大约多 30%。请参阅令牌计数。

有关所有当前模型，请参阅模型概述。

破坏性变更

不支持强制工具使用

Claude Fable 5.1 和 Claude Mythos 5.1 不支持强制 "tool use"（工具使用）。将 tool_choice 设置为 {"type": "any"} 或 {"type": "tool", "name": "..."} 会返回 400 invalid_request_error：

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

tool_choice: {"type": "auto"}（默认值）和 {"type": "none"} 保持不变。相同的验证也适用于令牌计数端点。

这些模型的思考始终开启，而强制工具调用会跳过思考。模型会转而将其推演过程写入工具参数中，从而降低参数质量。若需要符合 schema 的 JSON，请保留 tool_choice: {"type": "auto"} 并通过严格工具使用设置 strict: true，或将 schema 移至结构化输出。要让模型调用工具而不是以文本回复，请在提示中说明工具何时适用（例如，"使用 get_weather 工具来回答"）。Claude Fable 5.1 能可靠地遵循明确的工具指令。

更早的模型无法读取 Claude Fable 5.1 思考块

每个思考块都会记录是哪个模型生成了它，并且仅在一个方向上保留：Claude Fable 5.1 可以读取更早模型的思考块，而没有任何更早的模型可以读取 Claude Fable 5.1 的思考块。迁移到 Claude Fable 5.1 的对话（来自 Claude Opus 5、Claude Fable 5 或任何更早的 Claude 模型）会保留其推理。从 Claude Fable 5.1 迁移到上述任何模型的对话，在那些模型上运行的轮次中会丢失推理。

当请求携带目标模型无法读取的块时（例如，在对话中途切换模型的路由器或回退机制），API 会在模型看到该块之前将其丢弃。被丢弃的块不计入 input_tokens，也不会计费。使用 thinking-binding-controls-2026-08-01 beta 标头时，丢弃操作会在顶层 input_transformations 数组中报告。不使用该标头时，丢弃是静默的。请参阅保留的思考。

编辑较早的轮次会使思考块失效

修改 Claude Fable 5.1 思考块之前的任何内容（system 提示、tools 或较早的消息）会导致下一个请求出错，或者如果您选择了该选项，则会导致该块被丢弃。Claude Code、claude.ai、Claude Managed Agents 和 Claude Agent SDK 会为您保持该前缀完整。如果您的代码自己构建 messages 数组，请在迁移前进行检查：保留的思考详细介绍了检查和每个修复方法。对于 2026 年 8 月 31 日或之后创建的新账户，该检查是强制执行的。对于更早创建的账户，API 会记录不匹配，但仅在请求设置 thinking.block_binding.prefix_mismatch_behavior 时才会对其采取行动。

以下模式会使之后的每个思考块失效：

• 编辑、重新排序或删除较早的轮次，同时保留之后的轮次。
• 向较早的轮次注入按请求变化的文本（提醒或状态行），并在下一个请求中将其删除。
• 在同一对话的请求之间重建顶层 system 提示或 tools 数组。
• 在之后的请求中提供不同字节内容的图像或文档 URL（检查涵盖的是字节而非 URL，因此同一文件的轮换签名 URL 没有问题）。

以下操作会保持之后的块有效：删除开头连续的一段思考块（从最旧的开始）、让服务器端压缩或上下文编辑修剪历史记录、移动 cache_control 标记，以及在请求之间更改 effort。从连续段开头以外的任何位置删除思考块，会使其后的每个思考块失效。

在强制执行检查的情况下，重放已失效块的请求会被拒绝并返回 400，其消息为 The block is bound to a different conversation。若要改为丢弃该块并继续，请发送 thinking-binding-controls-2026-08-01 beta 标头并设置 thinking.block_binding.prefix_mismatch_behavior: "drop_block"。丢弃操作会在 input_transformations 中以 reason: "prefix_binding_mismatch" 报告。

要在长会话中保持思考有效，请将对话视为仅追加的。使用对话中途系统消息添加指令（如果只应适用于一个轮次，则使用轮次范围的），并使用对话中途工具变更来更改工具，而不是编辑 system 或 tools。使用服务器端上下文编辑或压缩来修剪上下文，这些不算作编辑。这些模式还能保持 提示缓存处于热状态。要了解您的集成是否编辑了历史记录，请使用 prefix_mismatch_behavior: "drop_block" 运行一个会话并记录 input_transformations：迁移指南提供了三步检查法。有关完整规则，请参阅保留的思考。

新功能

在对话中途更改 effort（beta）

在 Claude Fable 5.1 上，您可以在对话中途更改 effort 级别，而不会使提示缓存失效。为困难的步骤提高它，为常规步骤降低它。每条消息的 effort 处于 beta 阶段：包含 mid-conversation-output-config-2026-07-01 beta 标头。Claude Fable 5.1、Claude Mythos 5.1 和 Claude Opus 5 在 Claude API 上支持它。

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)

详情请参阅按消息设置 effort。

轮次范围的系统消息（beta）

对话中途系统消息可以限定在一个轮次内。在 role: "system" 消息上设置 clear_at: "next_user_message"，其文本在当前轮次具有 "system prompt"（系统提示）的权威性，一旦存在之后的 user 消息便停止渲染。该消息保留在 messages 中，您继续原样发送回去，因此对话中较早的内容不会发生任何变化。提示缓存继续匹配，之后的思考块保持有效，并且已清除的消息不消耗输入令牌。将其用于工具循环中的每轮提醒（"在运行更多代码之前检查您的收件箱"、"用户看不到该工具输出"），而不是将文本注入历史记录并在下一个请求中删除。轮次范围的系统消息处于 beta 阶段：请包含 mid-conversation-system-clear-at-2026-08-21 beta 标头。请参阅轮次范围的系统消息。

{
  "role": "system",
  "clear_at": "next_user_message",
  "content": "Results have landed in your inbox. Check it before running more code."
}

工具调用之间的进度更新（beta）

与 Claude Fable 5 一样，Claude Fable 5.1 会在工具调用之间写下简短的进度更新，说明它发现了什么以及接下来要做什么，不过数量更少（请参阅相对于 Claude Fable 5 的变化）。每条更新都作为独立的 thinking 块紧接在工具调用之前到达。在默认的 thinking.display 为 "omitted" 的情况下，这些块与推理一样返回为空，因此一个较长的智能体轮次在您的用户看来可能是静默的。新增的是 display: "updates" 选项：配合 thinking-display-updates-2026-08-18 beta 标头设置它，即可以文本形式接收进度更新，同时推理保持隐藏。此时任何带有非空文本的 thinking 块都是您可以向用户展示的状态行。"summarized" 也会返回它们，但与摘要化的推理混合在一起。请参阅工具调用之间的进度更新。

内容来源

Claude Fable 5.1 和 Claude Mythos 5.1 生成的文本在模型可用的每个平台上都带有 Anthropic 的统计文本水印。当您通过 Claude API 上的 Files API 检索 Claude 生成的受支持的图像和视频文件（例如通过代码执行工具生成）时，这些文件带有签名的 C2PA 内容凭证。

水印不会改变输出的含义、质量或可读性。它不添加令牌或隐藏字符，不携带有关您或您组织的任何信息，也不需要对您的请求或响应进行任何更改。有关背景信息，请参阅 Claude 如何标记 AI 生成的内容和 Claude 的文本水印如何工作。

行为差异

相对于 Claude Fable 5 的变化

Claude Fable 5.1 与 Claude Fable 5 在三个方面有所不同，这些差异无需任何代码更改即会显现。每一项在 Claude Fable 5.1 提示指南中都有对应的提示修复方法：

• 并行工具调用更加多变。 在 Claude Fable 5 会批量发出多个工具调用的地方，Claude Fable 5.1 可能每轮只发出一个工具调用。这出现在下一批独立读取仅为隐含的长智能体循环中：自定义编码智能体、bash 加编辑器框架、计算机使用。额外的轮次会消耗往返次数和实际耗时，但不会降低答案质量。明确指出要获取多项内容的请求仍会并行运行。请添加在智能体循环中批量处理独立工具调用中的单行批处理指令。
• 长时间工具运行期间的进度更新更少。 模型在工具调用之间撰写的面向用户的文本更少。如果您的 UI 依赖于叙述，请明确要求提供开场语、定期更新和结束总结。将 thinking.display 设置为 "updates"（beta）以接收它确实撰写的进度更新。请参阅要求提供面向用户的进度更新。
• 在 low effort 下更常凭记忆回答。 在最低 effort 级别下，模型调用搜索或检索工具的频率更低。对于需要最新信息的轮次，请提高 effort，包括在对话中途提高。

相对于 Claude Fable 5 未变化的部分

以下 Messages API 行为从 Claude Fable 5 原样延续：

• 自适应思考始终开启。带 budget_tokens 的 thinking: {"type": "enabled"} 和 thinking: {"type": "disabled"} 都会返回 400 错误。请省略 thinking 或发送 {"type": "adaptive"}。
• thinking.display 默认为 "omitted"。"summarized" 可用，且原始思维链永远不会返回。
• 工具调用之间的推理出现在思考块中而非文本中，并且交错思考是自动的，无需 beta 标头。
• 预填充助手响应会返回 400 错误。
• 非默认的 temperature、top_p 或 top_k 值会返回 400 错误。
• 最小可缓存提示长度为 512 个令牌。
• 支持对话中途系统消息和工具变更。

能力改进

Claude Fable 5.1 在 Claude Fable 5 的基础上有所改进，且在更高的 effort 级别下差距最大。提升集中在六个领域：

• 长会话中的智能体编码，包括多文件功能、大型重构和迁移、调试，以及跨越持续数小时会话的代码审查。
• 涉及文档、电子表格和幻灯片的知识工作，将一项分析从最初的问题推进到完成的文档、带实时公式的电子表格，或从空白页构建的幻灯片。
• 研究和搜索，在多步骤网络研究和会跟进所发现内容的深度研究任务上准确性更高。
• 视觉，读取密集的图表、申报文件和嵌套在 PDF 中的表格，在拥有裁剪和缩放工具时表现最强。
• 长上下文检索，在 1M 令牌上下文窗口深处查找细节并进行推理。
• 计算机使用，更可靠地操作浏览器和桌面应用程序，并从失败的步骤中恢复。

多语言性能与 Claude Fable 5 相当。

拒绝、回退和计费

Claude Fable 5.1 包含安全分类器，涵盖与 Claude Fable 5 相同的 stop_details 类别，并且拒绝和回退中的所有内容均适用。

• 拒绝： 被拒绝的请求返回 HTTP 200，带有 stop_reason: "refusal" 和一个 stop_details 对象，指明触发的策略领域。
• 回退： 使用服务器端回退、SDK 中间件或您自己的重试机制，在另一个模型上重试被拒绝的请求。fallbacks: "default"（beta）会在 Anthropic 为该类别推荐的模型上重试被拒绝的请求。Claude Fable 5.1 允许的回退目标是 Claude Opus 4.8 和 Claude Opus 5。
• 计费： 对于在任何输出之前到达的拒绝，您不会被计费，并且对于 Claude Fable 5.1，回退抵扣会退还切换模型的提示缓存成本。

定价

Claude Fable 5.1 和 Claude Mythos 5.1 的定价与 Claude Fable 5 相同，除了缓存读取（价格以美元计）：

在这些模型上，缓存读取（命中和刷新）的费用为基础输入价格的 0.025 倍，而其他 Claude 模型为 0.1 倍。重复读取已缓存前缀的长智能体会话只需支付 Claude Fable 5 费率的四分之一。缓存写入和 512 令牌的最小可缓存提示长度保持不变。

批处理为每百万输入令牌 $5 美元，每百万输出令牌 $25 美元。有关数据驻留和工具定价，请参阅定价。

可用性

Claude Fable 5.1 可在以下平台使用：

• Claude API： 所有客户，模型 ID 为 claude-fable-5-1。
• AWS：Amazon Bedrock 中的 Claude，模型 ID 为 anthropic.claude-fable-5-1，以及 Claude Platform on AWS，模型 ID 为 claude-fable-5-1。
• Google Cloud：Google Cloud 上的 Claude，模型 ID 为 claude-fable-5-1。
• Microsoft Foundry：Microsoft Foundry 中的 Claude，运行在 Anthropic 基础设施上。

Claude Mythos 5.1 仅向 Project Glasswing 中获得批准的客户提供。如需访问权限，请联系您的 Anthropic、AWS 或 Google Cloud 客户团队。

Claude Fable 5.1 和 Claude Mythos 5.1 采用 30 天数据保留期，除非获得 Anthropic 明确授权，否则不提供零数据保留。两者都是涵盖模型，与 Claude Fable 5 和 Claude Mythos 5 一样。请参阅特定模型的数据保留要求。

从 Claude Fable 5 迁移

要从 Claude Fable 5 迁移，请更新您的模型 ID：

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

然后检查以下事项：

1. 删除任何类型为 any 或 tool 的 tool_choice。将 schema 强制执行移至使用 tool_choice: {"type": "auto"} 的严格工具使用，或移至结构化输出。
2. 原样传回思考块，并保持历史记录仅追加。如果您的代码自行构建 messages 数组，请运行历史编辑检查：将您当前注入并删除的每轮提醒移至轮次范围的系统消息，将 system 和 tools 的更改移至对话中途系统消息，在服务器端修剪上下文或从您跨客户端摘要携带的轮次中剥离思考块，然后选择一个生产环境的 prefix_mismatch_behavior 并监控 input_transformations。
3. 从默认值（high）重新调整 effort，并考虑在对话中途更改它，而不是在整个会话中保持一个级别。
4. 在智能体循环中，留意在 Claude Fable 5 会批量发出多个工具调用的地方是否出现每轮一个工具调用的情况，并添加 Claude Fable 5.1 提示指南中的每轮说明。
5. 重新运行您的评估。拒绝处理、回退、回退抵扣和令牌计数原样延续。缓存读取费用更低（请参阅定价），并且默认行为在相对于 Claude Fable 5 的变化下列出的三个方面有所不同。

有关分步说明（包括从 Claude Opus 5 和更早模型迁移），请参阅迁移指南。

后续步骤