发布日期2026-09-02 | 话题Claude Fable 5.1 / API 迁移 / Agentic 编码Claude Fable 5.1model IDclaude-fable-5-1于 2026 年 9 月 1 日正式发布是 Fable 5 的直接继任者定位长时 Agentic 编码与知识工作与 Fable 5 保持相同基础定价输入 10 美元/MTok、输出 50 美元/MTok但 Cache 读取成本降至 0.025 倍基础价旧版为 0.1 倍降幅 75%并新增三项 breaking changes 和五项新功能能力提升集中在多文件 Agentic 编码、多步研究、视觉理解和计算机控制六个方向Claude Mythos 5.1 提供相同能力仅向 Project Glasswing 邀请用户开放模型知识截止时间升至 2026 年 6 月比 Fable 5 更新。一句话定位Fable 5.1 是什么与 Fable 5 有什么不同Fable 5.1 是在 Fable 5 基础上做后训练优化的升级版不改变基础架构但在 Agentic 编码、多步研究和文档处理上有显著提升。对已有代码库来说大多数情况下只需要改一行 model 字符串——但三个 breaking changes 如果不处理会在生产环境静默损坏或直接报 400。模型 ID 对比模型Claude API ID知识截止Cache 读取价格Claude Fable 5旧claude-fable-5早于 Jun 2026$1.00/MTokClaude Fable 5.1新claude-fable-5-1Jun 2026$0.25/MTok价格方面两者基础输入/输出价格完全相同Cache 读取是最大变化。Breaking Change 1强制工具调用不再支持Fable 5.1 不支持tool_choice设置为{type: any}或{type: tool, name: ...}的请求。发送此类请求会直接返回 400 错误tool_choice: type tool and any are not supported for this model.为什么Fable 5.1 的思考thinking始终开启强制工具调用会绕过思考过程导致模型把推理过程写入工具参数而非 thinking block显著降低参数质量。如何修复# 旧写法会报 400tool_choice{type:tool,name:search_web}# 新写法 1改用自动模式 严格工具约束tool_choice{type:auto}# 在工具定义中加 strictTrue 保证 JSON 格式tools[{name:search_web,...,strict:True}]# 新写法 2用结构化输出代替强制工具调用# 移到 output_config.format 中# 新写法 3在 system prompt 中明确说明何时调用工具# 当用户询问最新信息时使用 search_web 工具# Fable 5.1 对明确的工具调用指令响应非常可靠Breaking Change 2Thinking Blocks 单向兼容Fable 5.1 产生的 thinking blocks 只能被 Fable 5.1 读取早期模型包括 Fable 5、Opus 5 等无法读取它们。反过来Fable 5.1 可以读取早期模型的 thinking blocks。影响场景路由器或 fallback 逻辑在 Fable 5.1 和其他模型之间切换Agent 框架在多个模型间传递对话历史使用server-side-fallback时fallback 目标模型会收到被丢弃的 thinking blocks当 API 收到目标模型无法读取的 thinking block 时会静默丢弃该 block不计费、不报错。如果想获得明确通知在请求中加入 beta header# 开启 thinking binding 控制丢弃时会在 input_transformations 中报告client.beta.messages.create(modelclaude-fable-5-1,betas[thinking-binding-controls-2026-08-01],thinking{type:adaptive,block_binding:{prefix_mismatch_behavior:drop_block}},...)# 检查 response.input_transformations 获取丢弃详情Breaking Change 3编辑历史消息使 Thinking Blocks 失效如果你修改了已有 thinking block 之前的任何内容——系统提示、工具列表、或更早的对话消息——Fable 5.1 会认为 thinking block 已经失效请求会被拒绝或静默丢弃该 block。常见触发场景这些在 Fable 5 时代都没问题# 危险每轮插入时间戳或状态信息后下轮删除messages.append({role:system,content:f当前时间{datetime.now()}})# 下一轮删除这条 → thinking blocks 失效# 危险对话途中更新工具列表toolsget_current_tools()# 动态工具列表变化# 危险对话途中修改 system promptsystemf当前用户{user.name}# 每次不同正确做法把对话历史视为 append-only用这些方式处理动态内容# 安全用 mid-conversation system message 传递运行时信息# 不修改历史不影响 thinking blocksmessages.append({role:system,content:用户上传了新文件请优先处理。})# 安全用 turn-scoped system message新功能见下文# 自动在下一个 user message 到来时清除无需手动管理# 安全用服务端 compaction 或 context editing 压缩历史# 不触发 thinking block 失效检查新功能 1对话中途改 effort 等级BetaFable 5.1 支持在同一对话中改变 effort 等级且不会使 prompt cache 失效。这对 Agentic 长会话特别有用困难步骤用high/xhigh简单步骤用low节省成本。responseclient.beta.messages.create(modelclaude-fable-5-1,max_tokens4096,output_config{effort:high},messages[{role:user,content:制定从 SQLite 迁移到 PostgreSQL 的详细方案},{role:assistant,content:...详细方案...},# 插入 effort-only 系统消息下一轮生效{role:system,content:[],output_config:{effort:low}},{role:user,content:用一句话总结要点},],betas[mid-conversation-output-config-2026-07-01],)新功能 2Turn-Scoped 系统消息Beta之前为 Agent 循环注入这一轮的提示开发者通常的做法是插入一条消息 → 下一轮删除它 → 但删除操作会使 thinking blocks 失效。Fable 5.1 引入clear_at字段消息自动在下一个 user 消息到来时失效无需手动删除历史不变thinking blocks 和 cache 都不受影响{role:system,clear_at:next_user_message,content:新邮件已送达收件箱运行更多代码前先检查一下。}Beta headermid-conversation-system-clear-at-2026-08-21新功能 3工具调用间进度更新BetaFable 5.1 在工具调用之间会写短暂的进度更新每次 tool call 前的 thinking block。此前thinking.display默认是omitted导致长 Agent 会话对用户来说看起来完全静默。新增display: updates选项reasoning 保持隐藏但进度更新文本以 thinking block 形式返回可以展示给用户responseclient.beta.messages.create(modelclaude-fable-5-1,thinking{type:adaptive,display:updates},betas[thinking-display-updates-2026-08-18],...)forblockinresponse.content:ifblock.typethinkingandblock.thinking:# 这是进度更新可以展示给用户print(f[进度]{block.thinking})elifblock.typetext:print(block.text)新功能 4Cache 读取降价 75%Fable 5.1 的 Cache 读取价格为基础输入价格的0.025 倍约 0.25 美元/MTok而其他 Claude 模型是 0.1 倍约 1 美元/MTok。对于长时 Agentic 会话——每轮都会重发整个对话历史其中大部分命中 prompt cache——这是最直接的成本节省。会话越长、cache 命中率越高节省越明显。价格对比类型Fable 5Fable 5.1基础输入$10/MTok$10/MTok基础输出$50/MTok$50/MTok5m Cache 写入$12.50/MTok$12.50/MTok1h Cache 写入$20/MTok$20/MTokCache 读取$1.00/MTok$0.25/MTok新功能 5内容溯源Content ProvenanceFable 5.1 生成的所有文本都携带 Anthropic 的统计文本水印不添加任何额外 token 或隐藏字符不包含用户或组织信息对输出质量无影响。通过代码执行工具生成的图片和视频文件可通过 Files API 取回时携带 C2PA 格式的 Content Credentials。能力提升6 个重点方向与 Fable 5 相比提升最显著、在高 effort 下差距最大的六个方向方向说明长会话 Agentic 编码多文件功能开发、大型重构与迁移、跨会话代码审查会话可持续数小时文档/表格/幻灯片处理从第一个问题到完整文档、含公式表格、从空白页生成幻灯片全流程多步研究多步骤网络研究能跟进搜索结果进一步深挖视觉理解读取 PDF 中的密集图表、财报和嵌套表格结合放大工具效果更好长上下文推理在完整 1M token 上下文窗口内连接和关联跨文档细节计算机控制操控浏览器和桌面应用更可靠从失败步骤中恢复能力提升多语言性能与 Fable 5 持平。行为变化7 处需要调整 Prompt从 Fable 5 迁移时以下行为变化可能影响现有 Agent 效果1. 并行工具调用更不稳定Fable 5.1 可能每轮只发一个工具调用而 Fable 5 会批量发多个。解决方式在 prompt 中明确说明同时取多个数据时请并行发出工具调用。2. 进度更新变少在高 effort 下工具调用之间的用户可见文本减少。开启display: updates并在 prompt 里要求提供开场说明和周期性进度汇报。3. Low effort 下更多从记忆回答loweffort 时模型更少触发检索工具。对需要最新信息的步骤改用 mid-conversation effort 提升或在 prompt 加验证提示。4. 文字更紧凑某些场景散文更密集、句子更长。需要宽松段落的场景在 prompt 中明确要求格式。5. 聊天场景减少格式标记加粗、标题、列表的使用比 Fable 5 少。如果需要格式化输出明确在 prompt 中指定。6. 摘要中引用未标注总结文档时更可能直接复现原文而不加引号标注。需要区分的场景在 prompt 中说明直接引用时请加引号标注。7. 小改动触发全文重写编辑文本文件时更倾向于重写整个文件而非做局部修改。用于代码编辑的场景明确说明只修改需要改动的部分可缓解。迁移清单从 Fable 5 迁移到 Fable 5.1 的五步检查# 第 1 步更新 model IDmodelclaude-fable-5-1# 原来是 claude-fable-5# 第 2 步移除所有强制工具调用# tool_choice{type: tool} 或 {type: any} → 改为 {type: auto}# 第 3 步检查对话历史是否 append-only# 运行一次带 thinking-binding-controls-2026-08-01 的测试请求# 检查 response.input_transformations 有无 prefix_binding_mismatch# 第 4 步考虑用 turn-scoped 系统消息替代插入删除模式# 第 5 步重跑 evals重点关注工具调用并行行为和 effort 配置企业 Agent 的基础设施建议Fable 5.1 的长会话 Agentic 能力提升使得企业 Agent 架构的模型编排层变得更重要。一个典型模式是用旗舰模型处理需要深度推理的核心步骤用更轻量、高性价比的模型处理分类、摘要、路由等辅助任务。在多模型并行调用的场景下维护多套 SDK 和鉴权体系的成本相当高。七牛云 MCP 服务developer.qiniu.com/aitokenapi/12984/mcp-user-manual提供标准化的多模型能力编排接口支持无需本地部署直接接入 Agent 工作流适合需要在不同任务步骤中灵活切换模型的企业团队。常见问题直接把 model 改成 claude-fable-5-1 会怎样大多数情况能正常运行。如果你没有用tool_choice: any/tool也没有在对话中修改历史消息升级是无感的。最大的变化是 Cache 读取费用降了 75%以及 thinking blocks 的兼容性行为。Mythos 5.1 和 Fable 5.1 有什么区别能力和定价完全相同区别只是可用性Fable 5.1 对所有用户开放Mythos 5.1 仅向 Project Glasswing 邀请用户开放model ID 为claude-mythos-5-1。Fable 5.1 什么时候退役Anthropic 承诺不早于 2027 年 9 月 1 日退役。thinking.display 的三个选项分别适合什么场景omitted默认thinking 在后台进行用户看不到适合不需要展示推理过程的场景summarized返回可读的推理摘要适合需要向用户展示Claude 为什么这么做的场景updates新功能beta只返回工具调用间的进度更新推理本身仍隐藏适合长 Agent 任务的进度显示延伸阅读Fable 5.1 官方发布页https://platform.claude.com/docs/en/models/fable-5-1/overview七牛云 MCP 服务Agent 多模型编排https://developer.qiniu.com/aitokenapi/12984/mcp-user-manual
