10个主要问题Q&A

1. Q：怎么让 Claude Fable 5.2 主动重构、合并重复代码？ A：在提示词写明代码库归模型所有，该语句会显著提升主动重构概率。
2. Q：写了 “禁止随意重构”，归属声明还生效吗？ A：生效，归属声明优先级更高，测试中仍会出现代码合并行为。
3. Q：为什么模型长时间调用工具，界面看起来卡住没反馈？ A：默认 thinking.display=omitted，进度更新存于思考块，客户端未渲染。
4. Q：无法修改调度层，如何减少长任务静默？ A：在系统提示词增加指令，要求每几次工具调用输出一行进度。
5. Q：如何控制模型不要频繁创建子智能体？ A：修改子智能体工具描述，写明成本、适用与不适用场景。
6. Q：模型过度保守、频繁索要不必要审批是什么原因？ A：历史记忆、备注、约束规则不断叠加，限制指令累积。
7. Q：笼统写一句 “灵活执行” 能解除保守限制吗？ A：不行，需要明确列出哪些步骤无需审批。
8. Q：迁移到 Fable 5.2，哪些旧提示词要优先删掉？ A：委派指令、prompt 内 token 预算、限制思考、“把回答视为定稿” 等语句。
9. Q：模型拒绝请求，reasoning_extraction 类别代表什么？ A：禁止要求模型把内部推理写在输出文本，推理应放在 thinking 块。
10. Q：迁移上线的正确做法是什么？ A：多 effort 档位评测，逐条修复观测到的问题，同步评估 token 开销。

Claude Fable 5.2 会严格遵循提示词中关于代码归属的描述，以此调整它处理代码的方式。Anthropic 在小型编码任务测试中发现：如果提示词完全没有说明代码归属，或是将代码库描述为他人所有，模型倾向于在现有代码结构上做增补，哪怕这会造成代码重复；同时它往往只指出周边存在问题，而不会主动修复。 但如果提示词写明这份代码库归模型自己所有，模型经常会主动合并重复代码，并顺带完成相关修复，无需用户额外指令。

如果你希望模型在编码过程中主动优化代码结构，可以加上这句：

这份代码库归你所有：它的用途与架构由你来定，你将持续迭代开发它。

Anthropic 的小型编码测试显示：加入这句话后，约半数测试用例中模型会自动合并重复代码；不加这句话时，该行为的出现概率不足十分之一，具体概率随任务不同有所浮动。即使把这句话放在很长的系统提示词内部，该效果依然成立。无论是否添加这句话，模型几乎都能完成用户要求开发的功能。

同组测试还发现：加上这句话后，模型输出 token 量大约是原来的 1.5 倍，并且会自主做出不少用户没有要求的改动，其中很多是新增测试用例和文档。除 bug 修复外，每 6～10 次调用里就会有一次改动现有功能的原有行为；在更高算力档位（effort）下，这类改动会更频繁。模型末尾的总结会提及较大的变更，但经常遗漏小改动，因此一定要查看代码差异对比（diff），不能只看总结。

如果代码所有权属于用户，且你希望模型尽量少改动原有代码，就不要加入这段归属声明。提示词里其他限制范围的规则，并不能抵消归属声明的作用。Anthropic 测试显示：即便在提示词靠前位置写明「禁止无来由的重构、重命名或清理代码」，只要保留归属声明，大约三分之一的测试中模型依旧会合并重复代码。

长任务中持续向用户同步进度

Claude Fable 5.2 在连续调用工具执行长任务时，有时会输出面向用户的简短说明文本。模型也可能直接发起第一次工具调用，而不提前告知将要执行的操作。

首先要确认你的客户端能够接收模型的进度更新。在 Claude Fable 5.2 上，模型在多次工具调用间隙输出的进度更新，会通过思考块（thinking）的进度更新通道返回：https://platform.claude.com/docs/en/build-with-claude/thinking#progress-updates 默认配置 thinking.display = "omitted"时，这些更新文本为空。如果客户端只渲染普通文本块，模型执行长时间智能体任务时，界面看起来就像卡住无响应。 你可以设置 display: "updates"（测试版，请求头 thinking-display-updates-2026-08-18），获取每一条进度更新的简短摘要；或是设置为 "summarized"，同时拿到进度更新和精简后的推理过程，然后渲染工具调用之间非空的思考块。

当用户实时观察任务执行（比如交互式编码场景）时，高频进度同步尤为重要。如果用户依然收到太少更新，可以选用下面一种或多种方案：

如果你可以修改调度层（harness），一个很有效的方案：统计连续工具调用轮次，判断模型是否没有输出任何可读内容 —— 既没有文本块，也没有带文字的思考块。统计时 display需要设为 "updates"或 "summarized"；设为 "omitted"时所有思考块都是空的。 该方案依赖平台支持会话内临时系统消息：https://platform.claude.com/docs/en/build-with-claude/mid-conversation-system-messages 连续多次无输出之后，调度层在最新工具返回结果后追加一条轮级临时系统消息（clear_at: "next_user_message"，测试版，请求头 mid-conversation-system-clear-at-2026-08-21）：

用户已经很久没有收到你的反馈：用几句话说明你正在做什么，然后继续工作。

Anthropic 的多轮编码任务测试显示，这条提醒大致能把最长静默时长缩短一半，token 消耗和耗时没有明显上涨。

后续请求的消息列表里需要保留这条提醒。删除或者改写提醒，相当于修改历史对话里前面的轮次，会导致这条消息之后所有思考块失效。参考文档：https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#per-turn-reminders

想要在第一次调用工具前就输出开场白、过程中简短同步、最后给出总结，可以在系统提示词增加这段文字：

开始之前，先用一句话说明你接下来要做什么；工作过程中简短同步进度，方便用户跟进。结束时给出独立完整的小结：说明你发现了什么、做了哪些操作、下一步计划是什么，让只看到最后这条消息的人也能掌握全貌。

Anthropic 编码任务测试：加入这段文字后，模型每次都会在首次工具调用前先说话；代价是单任务输出 token 总量提升约 20%。适合有人实时跟进的场景；如果想要最高频的进度同步，可以和上面调度层自动追加的提醒搭配使用。

如果你无法修改调度层，或者平台不支持会话内临时系统消息，可以在系统提示词加入这句：

每调用几次工具，就给用户一行当前进度更新。

Anthropic 在工作流自动化任务测试中，这句话大幅减少长时间静默的情况。

即便同时配置提醒、开场和小结话术，依然会出现连续多次工具调用才同步一次信息的情况。Claude Fable 5.2 非常适合异步长任务：用户不用盯着每一步，等任务结束再查看结果。这类场景下，更新间隔长一些影响不大。

合理设定子智能体（subagent）调用预期

Claude Fable 5.2 多大程度上把工作委派给子智能体，取决于你的调度层设计和任务类型。 Anthropic 测试：在只提供极简子智能体启动工具的短任务里，模型很少拉起子智能体；但如果编码智能体产品的提示词本身鼓励委派，模型会很乐意拆分任务交给子智能体。

如果你的系统提示词、技能描述、智能体配置文件要求模型委派任务，优先审阅这部分内容。只有修改之后模型仍然频繁拉起多余子智能体，再去修改「启动子智能体」这个工具的描述文本。如果工具描述只是平实说明功能，提示词里也没有任何鼓励委派的内容，一般不需要调整。

新版工具描述需要写明三点：拉起子智能体会增加会话成本、什么场景适合委派 / 什么场景不适合、拉起子智能体时该如何给它下达任务。Anthropic 测试用的描述文本把成本放在最前面。这类描述最适合调度层原本就鼓励委派、且子智能体 token 开销占比很高的场景。

短任务测试显示：使用这套成本优先的描述文本后，模型委派频次相比只罗列委派好处的版本下降约三分之一，任务成功率保持不变。

测试文本里靠前的成本说明会抑制委派行为。如果模型委派太少，就减少关于成本的描述；如果还是委派过多，补充你调度层里子智能体的成本说明并做对照测试。

Anthropic 还观察到：在高算力档位（如 xhigh、max）的编码智能体产品中，Claude Fable 5.2 会调用子智能体复核自己的工作；Claude Fable 5.1 在同类任务中不会这么做。早期测试者反馈，把 Claude Fable 5.2 作为总规划与调度器、搭配其他模型协同工作效果很好。委派可以加速适合并行执行的任务。但子智能体可能占据会话绝大部分开销，务必确认调度层默认使用哪个模型运行子智能体。

避免约束指令层层叠加

只要上下文可以留存信息（记忆库、备注、指令文件、智能体之间传递的消息），各类谨慎约束指令就会不断累积。Claude Fable 5.2 会严格遵守这些指令，进而出现不必要地索要审批、不敢执行常规操作的情况。不少早期测试者遇到该现象，大多是多智能体协同场景。旧版模型也会遵守约束，但在部分测试方案里，只有 Claude Fable 5.2 会保守停手。

遇到这类问题，需要清理智能体携带的上下文信息：

1. 移除不再需要的备注
   Anthropic 模拟任务测试中，一条来自历史会话的备注写着「禁止重试」。当这条备注留在上下文，且提示词没有允许重试时，工具繁忙场景下模型重试概率从接近 100% 降到约 40%。
2. 明确列出无需审批的步骤
   模拟测试上下文里存在多条「禁止类」规则、备注和评审条件。在规则末尾写明「重试属于无需审批的操作」，重试概率从几乎为 0 提升到约 50%。同一套环境下，一句笼统的「放开限制、灵活执行」没有效果。只把重试标记为无需审批，前提是该调用重复执行本身是安全的。
3. 检查评审智能体附加的约束
   模拟测试中，提示词写明重试无需审批，但上下文里评审规则写着「遇到第一个错误就停止」，Claude Fable 5.2 依然有约三分之一的情况不会重试；而 Claude Fable 5.1、Claude Opus 5.5 会重试。
4. 把例外规则直接写进主规则内
   模拟测试场景，负责人已经批准某一步操作；在一条「禁止执行」的主规则下，模型执行该步骤概率仅约 10%。单独补充一句「已批准步骤可以执行」改善有限。但如果主规则本身写明「获得许可后可以执行」，执行概率提升至约 90%。参考文档：https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#approvals

高风险、不可逆操作，建议你自己保留一层人工确认流程。

复审为旧模型编写的指令

迁移到 Claude Fable 5.2 时，务必重新审阅提示词。Anthropic 测试发现：一部分为旧模型写的指令，会拉高成本、产生副作用，或是完全失效。重点重新评估下面几类指令：

• 常驻委派指令
  鼓励把任务交给子智能体的语句可能散落在系统提示词、技能文件、智能体配置里。迁移前通读这些文件。如果测试发现模型拉起过多不必要的子智能体，删掉冗余语句。参考：https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#set-expectations-for-subagents
• 调度层写入提示词的 token 预算
  部分调度层会在提示词告知模型本次任务可用 token 总额和剩余额度。预算数值会影响 Claude Fable 5.2 的开销。Anthropic 在 high、xhigh 档位编码任务测试中，移除大额预算描述后开销下降，任务效果不变。你可以在自己任务上做无预算版本对照测试。该结论只针对写在提示词里的文本预算，不包含 API 原生任务预算功能（测试未覆盖）：https://platform.claude.com/docs/en/build-with-claude/task-budgets
• 修改历史对话轮次的调度逻辑
  Claude Fable 5.2 依赖「持久化思考块」机制 https://platform.claude.com/docs/en/build-with-claude/preserved-thinking。如果调度层在两次请求之间修改系统提示词、工具定义或者历史消息，修改点之后所有思考块都会失效。默认情况下，Messages API 会拒绝该请求，批量消息接口会丢弃失效思考块。 想要精简历史而不触发报错，可以使用上下文编辑或者压缩摘要（压缩后不再保留更早轮次）：https://platform.claude.com/docs/en/build-with-claude/context-editing、https://platform.claude.com/docs/en/build-with-claude/compaction 也可以配置 thinking.block_binding.prefix_mismatch_behavior = "drop_block"（测试版，请求头 thinking-binding-controls-2026-08-01），让 Messages API 自动丢弃失效思考块。Anthropic 测试：每一轮都丢弃旧思考块时，模型会重新推理，输出 token 变多，属于最坏情况，涨幅取决于调度修改历史的频率。 除压缩、上下文编辑之外，尽量采用追加式写入消息列表，保证缓存命中率、思考块不丢失。在业务落地前，务必基于自身任务测算 token 消耗。参考：https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#mismatch-behavior、https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#replace-prefix-edits
• 「把上一轮回答视作最终结果」类语句
  这套话术原本用于 Claude Opus 5.5，作用是让模型不再复盘旧答案，专注处理新消息。Anthropic high 档位测试：加入之后 Claude Fable 5.2 对后续问题的推理变少，同时大幅降低它主动发现自己前文错误的概率。如果你希望模型持续校验历史输出，不要使用；如需使用，先验证它是否还能自查错误。
• 要求减少思考的指令
  Claude Fable 5.1 通常会遵守类似「直接回答，不要反复推演」这类指令。测试发现，在 medium 及以上算力档位，这类语句无法限制 Claude Fable 5.2。建议删掉这类指令，改为调低 effort 档位：https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#calibrate-effort
• 文风硬性规则
  Claude Fable 5.2 严格遵守格式文风约束。像「一句话只放一条指令，不超过 20 个词」这类强限制，会让输出文本支离破碎。在添加可读性优化提示词之前，先清理不再需要的文风规则。
• 日积月累的规则、备注、记忆
  ：记忆文件、备注、指令文件会不断累积各类保守约束，其中一部分甚至是模型自己生成的。迁移前，删除理由已经失效的约束；把绝对化规则改写，写明适用范围和原因。如果系统已经陷入保守卡死状态，可以清空记忆和备注重启，原始版本做好备份。参考：https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#keep-caution-from-piling-up

优化报告可读性

智能体完成长时间工作后，阅读最终报告的人通常看不到中间工具调用、文件读取过程。报告本身必须能够独立读懂。

如果你让 Claude Fable 5.2 输出交付报告、交接文档，可以把下面这段加入系统提示词，并根据读者群体、产品场景调整：

清晰沟通规范

面向知情但缺少上下文的读者写作。阅读者看不到你的工具调用、推理过程和打开过的文件，可能是中途切换过来查看结果。消息尽量自包含：读者不需要翻查其他上下文就能看懂。 重点信息放在开头几句话。信息按顺序逐层展开，不要在第一句就使用要读到后面才能理解的未定义术语与概念。 使用平实词汇、通顺完整的句子。不要使用你在任务过程中自创的术语或缩写；描述事物时采用所有人都能看懂的表达。 行文风格尽量遵循 ASD-STE100 简化技术英文规范：短句、一句一个核心意思、主动语态、同一概念固定用词。关联紧密的内容用连贯段落；分立条目使用项目符号。 除非用户主动要求，否则省略无关细节，保持精简；但必须包含关键上下文。面向用户的文本，做到易读、清晰。

Anthropic 智能体任务测试：加入这段提示词后，最终报告密度下降、分号使用变少；工作流自动化任务中，句子平均长度变短。你还可以补充篇幅要求，或是指定需要包含的信息项。

安全拦截（拒绝输出）相关说明

Claude Fable 5.2 内置安全分类器，可能拒绝执行请求。被拒绝时返回 stop_reason: "refusal"，stop_details.category标记拒绝类型：

• cyber
  请求可能带来网络安全危害，例如编写恶意程序、漏洞利用代码
• bio
  请求可能带来生物安全危害，例如危险实验操作方案
• frontier_llm
  请求有助于开发竞品大模型
• reasoning_extraction
  要求模型把内部推理过程放到返回文本里
• general_harms
  属于其他政策禁止场景

合规的网络安全、生命科学研究工作，也有可能触发 cyber、bio分类器拦截。如果你的组织有合法业务被误拦，可以查阅 Anthropic 支持文档以及生命科学核验计划：https://support.claude.com/en/articles/14604842、https://www.anthropic.com/news/life-sciences-verification-program 通过该核验计划的机构，可以使用 Mythos 5.2，能力和 Claude Fable 5.2 一致。

如果你的提示词、技能、工具描述要求模型把推理写在输出正文里，请删掉这条要求。想要查看推理，设置 display: "summarized"，读取思考块内容：https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#keep-reasoning-in-thinking-blocks

被拦截的请求如果需要重试，可以切换其他模型，参考：https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2#refusals-fallback-and-billing

迁移落地步骤

迁移时按顺序执行：

1. 显式设置 effort = high，同时在 medium、xhigh 档位跑评估用例
2. 通读所有继承过来的系统提示词、技能、智能体配置、记忆文件、备注、调度文本；删除或单独测试「复审旧模型指令」一节列出的风险语句
3. 运行最长链路的智能体任务，记录异常点：提前终止、索要不必要审批、长时间静默、委派过多子智能体、只增补代码而不重构
4. 针对观察到的每一类问题，逐条套用对应优化方案，并且在你的业务任务上评估效果与 token 开销。