Claude Fable 5.1 的新特性

Claude Fable 5.1 在 Claude Fable 5 的基础上进行了扩展，输入和输出价格保持不变，缓存读取成本降至四分之一，并带来了更强的长时间运行的智能体编码、多步骤研究，以及文档、电子表格和幻灯片处理能力。对于大多数工作负载，请从 Claude Opus 5 开始（请参阅选择模型）。当您需要高要求的推理和长周期智能体工作，或者在 Claude Opus 5 上以更高 effort 运行的评估仍然达不到要求时，请使用 Claude Fable 5.1。Claude Mythos 5.1 仅向 Project Glasswing 参与者提供相同的能力。

如果您已经在调用 Claude Fable 5，有三项变更是破坏性的：强制工具使用会返回错误、早期模型无法读取其思考块，以及编辑早期轮次会使思考块失效。有五项是新增的：按消息设置 effort（测试版）、轮次作用域的系统消息（测试版）、工具调用之间可读的进度更新（display: "updates"，测试版）、更低的缓存读取价格，以及内容溯源。

模型

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

• 上下文窗口和输出： 1M 令牌的 "context window"（上下文窗口）（默认值和最大值），整个窗口范围内均按标准的每令牌价格计费，最大输出令牌数为 128k。
• 思考： "adaptive thinking"（自适应思考）始终开启，详见思考。使用 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 测试版请求头时，丢弃操作会在顶层 input_transformations 数组中报告。不使用该请求头时，丢弃是静默的。请参阅保留的思考。

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

修改 Claude Fable 5.1 思考块之前的任何内容（system 提示、tools 或更早的消息）会导致下一次请求出错，或者如果您选择启用该行为，则该块会被丢弃。Claude Mythos 5.1 不执行此检查。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 测试版请求头并设置 thinking.block_binding.prefix_mismatch_behavior: "drop_block"。丢弃操作会在 input_transformations 中以 reason: "prefix_binding_mismatch" 报告。

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

新功能

在对话中途更改 effort（测试版）

在 Claude Fable 5.1 上，您可以在对话中途更改 effort 级别，而不会使提示缓存失效。在困难步骤时提高它，在常规步骤时降低它。按消息设置 effort 处于测试阶段：请包含 mid-conversation-output-config-2026-07-01 测试版请求头。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。

轮次作用域的系统消息（测试版）

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

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

工具调用之间的进度更新（测试版）

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

内容溯源

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

水印不会改变输出的含义、质量或可读性。它不添加任何令牌或隐藏字符，不携带有关您或您组织的任何信息，也不需要对您的请求或响应进行任何更改。有关背景信息，请参阅 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 加编辑器的运行框架、计算机使用。额外的轮次会消耗令牌、往返次数和实际耗时，但不会降低答案质量。明确指出要获取多项内容的请求仍会并行运行。请添加在智能体循环中批量处理独立工具调用中的单行批处理指令。
• 长时间工具运行期间的进度更新更少。 模型在工具调用之间写的面向用户的文本更少，尤其是在较高 effort 下。将 thinking.display 设置为 "updates"（测试版）以接收它确实写下的进度更新，并删除任何告诉它将发现保留到最终响应的提示行。如果您的 UI 依赖于叙述，请明确要求提供开场语、定期更新和结尾回顾。请参阅要求提供面向用户的进度更新。
• 在 low effort 下更常凭记忆回答。 在最低 effort 级别下，模型调用搜索或检索工具的频率更低。对于需要最新信息的轮次，请提高 effort（包括在对话中途），或添加低 effort 下的搜索触发中的验证提示。
• 部分场景下行文更密集。 在某些情况下，其行文比 Claude Fable 5 更密集，句子更长，段落分隔更少。请参阅写作密度。
• 聊天中的格式更少。 该模型使用粗体、标题和列表的频率低于早期 Claude 模型，因此为那些模型编写的反格式化规则可能会抑制内容所需的结构。请参阅聊天中的格式。
• 摘要中未标注的引用。 在总结文档时，模型更有可能复述来源中的段落而不将其标注为引用。请参阅引用检索到的来源。
• 为小改动重写整个文件。 在编辑文本文件时，模型更有可能重写整个文件而不是进行有针对性的编辑。结果通常相同，但重写会消耗更多输出令牌和时间。请参阅优先使用有针对性的编辑而非整文件重写。

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

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

• 自适应思考始终开启。带 budget_tokens 的 thinking: {"type": "enabled"} 和 thinking: {"type": "disabled"} 都会返回 400 错误。请省略 thinking 或发送 {"type": "adaptive"}。
• thinking.display 默认为 "omitted"。"summarized" 可用，原始思维链永远不会返回。
• 工具调用之间的推理出现在思考块中而非文本中，并且交错思考是自动的，无需测试版请求头。
• 预填充助手响应会返回 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 类别，并且拒绝和回退中的所有内容均适用。它可能返回 stop_reason: "refusal"，因此请处理拒绝并配置回退。

• 拒绝： 被拒绝的请求返回 HTTP 200，带有 stop_reason: "refusal" 和一个指明所触发策略领域的 stop_details 对象。
• 回退： 使用服务器端回退、SDK 中间件或您自己的重试机制，在另一个模型上重试被拒绝的请求。fallbacks: "default"（测试版）会在 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；以及 AWS 上的 Claude Platform，模型 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 明确授权，否则不提供零数据保留。两者均为受保护模型（Covered Models），与 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 及更早模型迁移），请参阅迁移指南。

后续步骤