Claude Fable 5.2 最新提示词指南

Anthropic 在这份指南中介绍了 Claude Fable 5.2 的提示词用法，从推理强度、长任务和审批，到子 Agent、历史指令与最终报告，也给出了可以直接使用的提示词。以下是全文翻译。

本指南介绍 Claude Fable 5.2 和 Claude Mythos 5.2 特有的提示词用法，涉及推理强度、提前停止、审批、代码所有权、进度更新、子 Agent、不断累积的谨慎指令、为旧模型编写的指令、最终报告以及拒绝响应。

本指南介绍 Claude Fable 5.2 特有的提示词用法。模型能力与 API 变化，请参阅《Claude Fable 5.2 的新变化》。适用于当前所有 Claude 模型的技巧，请参阅《提示词最佳实践》。

Claude Fable 5.2 在一些方面与旧模型表现不同。你可以从与实际观察相符的章节开始：

• 不确定该用哪档推理强度，或者简单请求也耗时很长：校准推理强度。
• 工作还没做完，一轮交互就结束了：完成整个任务。
• 你会在 Agent 工作过程中审批操作，或系统提示词包含审批规则：审批。
• 编程 Agent 重复添加已有代码而不合并，或只报告附近的问题却不修复：说明代码由谁负责。
• 长时间的 Agent 执行过程显得很安静：长任务中及时告知用户进展。
• 一次 Agent 会话启动了超出任务需要的子 Agent：明确对子 Agent 的预期。
• Agent 请求不必要的审批，或不敢执行常规工作：避免谨慎指令越积越多。
• 你沿用了为 Claude Fable 5.1 或 Claude Opus 5.5 编写的系统提示词、Skills 或 harness：检查为旧模型编写的指令。
• 用户会在长任务结束后阅读最终报告或交接说明：让报告容易读懂。
• 请求返回 stop_reason: "refusal"：安全机制触发的拒绝。

从旧模型迁移时涉及的 API 变化，请参阅《Claude Fable 5.2 和 Claude Mythos 5.2 迁移指南》。迁移时应用本指南的顺序，请参阅“从哪里开始”。

本页有些章节建议向系统提示词添加文字，从系统提示词或 Agent 携带的笔记、规则中删除某些内容，或调整工具描述。只在新对话中进行这些修改。Claude Fable 5.2 的 API 会对所有账号执行前缀校验。如果你修改了 system、tools 或较早的消息，再把后面的 thinking 块随请求传回，可能收到 400 错误；因此，保存下来的对话在使用新指令恢复时可能失败。如果要在对话中途改变指令，应将它们放在最新一轮中。支持对话中途系统消息的平台，也可以向对话追加一条系统消息。

校准推理强度

从 Claude API 默认的 high 开始。如果用例需要，再向上或向下调整 effort，并用自己的评估集检验每次变化。effort 决定 Claude Fable 5.2 思考多少、一轮交互耗时多久，以及使用多少 token。应将 effort 与提示词一起调优，因为它还会改变模型的思考方式和工具调用次数。

一般来说，Claude 各模型的 effort 档位顺序一致，但每档背后的实际思考量可能不同。因此，应重新扫描不同档位，而不是直接沿用在 Claude Fable 5.1 或 Claude Opus 5.5 上调好的设置。

根据工作类型选择档位：

• low
   适合快速交互、要求明确的任务和高吞吐量工作，例如快速而智能的子 Agent。在 Anthropic 的测试中，模型在 low 下的分数接近 Claude Fable 5.1 在较高推理强度下的分数。
• medium
   适合交互式编程、聊天和日常知识工作。
• high
   适合困难的编程、研究、Agent 任务，以及长时间无人值守的运行。一轮交互的完成时间会明显长于 medium。
• xhigh
   适合最困难、持续时间较长的编程和 Agent 任务，前提是你已经测得它能带来收益。在 Anthropic 内部编程评估中，这一档略微提高了分数，但消耗了更多 token。
• max
   适合测量模型的能力上限，或少数不在意时间和 token 消耗的任务。它更适合科学发现、数学等开放性问题。运行很慢，token 消耗也远高于 xhigh。

大部分能力增益在 high 就已经体现。Anthropic 跟踪的大多数编程和知识工作评估中，从 medium 升到 high 都能提高分数，但也会消耗更多 token 和时间。如果你的评估表明质量能够保持，就降到 medium。高于 high 后，收益并不均匀，取决于具体任务。

选择档位时，注意三个行为特点：

• 推理强度较低时，模型更容易提前停止。如果在 low 或 medium 下执行 Agent 任务，可以加入“完成整个任务”一节中的提示词。
• 在 high 及以上档位，模型几乎每次回复前都会思考，包括回复一句问候。如果简单请求太慢或成本太高，应在这些轮次使用更低的 effort。Anthropic 的测试表明，在 medium 及以上，仅用指令要求直接回答、不作推敲，并不能让模型停止思考。
• effort 几乎不会改变回复长度。要调整回复的长短和语气，应使用提示词。

你也可以在一个工作流里混合使用不同档位。例如，用 medium 做规划和迭代，再为长时间无人值守的阶段提高 effort。如果要在同一对话中切换档位并保留提示词缓存，可以使用逐消息调整 effort 的功能（beta，需要 mid-conversation-output-config-2026-07-01 header）；对应文档列出了支持的平台。设置会一直生效，直到被下一次设置替换。在不支持逐消息调整的平台上，可在下一次请求中设置新的顶层 effort 值，但这样会重新建立缓存。

完成整个任务

在耗时较长、包含多个步骤的任务中，Claude Fable 5.2 有时会在工作尚未完成时结束一轮交互。它可能列出剩余事项，表示愿意继续，或遇到超时等普通障碍就停下。这种情况在 low 和 medium 下更常见。

如果你的 Agent 出现这种提前停止的情况，可以在系统提示词中加入类似文字：

完成工作

只要用户要求的工作还没有完成，就尽量不要停止。保持推进，除非确有必要，否则不要停下。

欢迎说明进展，也可以就尚未确定的选择向用户澄清；与此同时，不依赖用户回答的工作应继续进行，不要无谓地停下。

如果你发现自己正在邀请用户重新指示方向，或表示愿意等待，就转而继续任务的下一部分。你可能遇到错误、超时、文件被锁定、结果为空、工具失败等普通障碍。先诊断；如果它们不是真正的阻断，就利用已有权限处理，例如等待并重试、修正请求、换用其他工具或来源，而不是无必要地停止。

如果有人已经明确将某件事规定为不可越过的阻断，例如文件被标记为不能修改、访问权限被有意保留，或存在安全护栏，就不要碰它。清楚说明发现了什么，并寻找其他安全方式完成任务。在任务完成前停下应当非常少见，例如确实无法在没有用户输入的情况下继续，或障碍是有意设置、不能绕过的。这并不取消对高风险或破坏性操作进行确认的要求。

这段文字区分了两类障碍。对于错误、超时、工具失败等普通问题，要求模型先诊断，再设法解决；对于有意设置的限制，例如文件明确标记为不能修改，则要求模型尊重并报告。可以把它作为起点，根据你的应用调整，但应保留这一区分。

Anthropic 在 medium 下重放了某个 Agent 编程产品记录的会话。使用这段文字的一个版本后，结束时仍留有可完成工作的会话数量约减半。它消除了大部分以请求许可或表示愿意继续收尾的情况，但没有消除“列出剩余事项然后停下”的情况。输出 token 增加约30%。

因为这段提示词会减少模型询问的次数，高风险或不可逆操作仍应保留你自己的确认步骤。

审批

让模型继续时，应明确说出要它做什么，而不是只发一个“继续”。例如，原本可能回复“开始吧”或一个点赞表情时，改成“是的，在预发布数据库上执行这次迁移”。

如果系统提示词中有审批规则，应明确列出它们覆盖哪些操作，因为模型会按文字执行。在 Anthropic 一项无人提供审批的模拟任务测试中，有条规则把“向本次对话以外的人发送消息”列为需要审批的步骤。加入该规则后，模型约有一半向同事和其他团队发起的常规请求没有执行。

说明代码由谁负责

Claude Fable 5.2 会紧密遵循提示词对代码所有权的描述。Anthropic 的小型编程任务测试发现，如果没有说明所有权，或把代码库描述为别人的，模型倾向于在已有结构上继续添加内容，即便会重复已有代码；它也倾向于报告附近的问题，而不是修复。如果提示词说明代码库由模型自己负责，它往往会主动合并重复代码，并完成相关修复。

如果希望模型在工作时改善结构，可以告诉它这份代码由它负责：

这个代码库由你负责：它用来做什么、怎样构建，由你决定，而且你会继续在它的基础上开发。

在 Anthropic 的小型编程任务测试中，加入这句话后，模型大约一半的尝试会合并重复代码；没有它时，比例不足十分之一，具体比例因任务而异。即便把这句话放进很长的系统提示词中，结果仍然成立。无论是否添加，要求实现的功能几乎每次都能正常工作。

在同一组测试中，加入这句话还让输出 token 增至约1.5倍，并产生若干无人要求的改动，其中很多是新增测试和文档。除修复 bug 外，大约每6到10次尝试就有1次改变了现有功能的行为，推理强度越高，这种情况越多。最终总结会提到较大的改动，却经常漏掉小改动，因此应检查 diff，而不只是总结。

如果代码属于用户，而且用户希望尽量少改，就不要加入这句所有权说明。提示词其他位置的范围限制，并不能抵消它。Anthropic 的测试中，即便同一提示词前面已经写了“不要顺手重构、重命名或清理”，模型仍会在大约三分之一的尝试中合并重复代码。

长任务中及时告知用户进展

Claude Fable 5.2 连续调用工具、运行较长时间时，有时很少输出面向用户的文字。它也可能在没有说明即将做什么的情况下，直接发起第一次工具调用。

首先检查客户端是否收到了模型的进度更新。在 Claude Fable 5.2 中，工具调用之间的更新通过用于报告进度的 thinking 块返回，内容说明模型发现了什么、接下来准备做什么。默认 thinking.display 为 "omitted"，这些块的文本为空，因此只渲染 text 块的客户端可能在长任务中看起来一直没有动静。设置 display: "updates"（beta，需要 thinking-display-updates-2026-08-18 header），可接收每次更新的简短摘要；设置为 "summarized"，则会同时接收进度更新与推理摘要。然后在工具调用之间渲染非空的 thinking 块。

用户实时看着工作推进时，例如交互式编程，频繁更新最重要。如果用户正在旁观，仍然收到太少进展，可以采用以下一种或多种做法。

如果能够修改 harness，一个有效办法是统计连续多少个工具调用步骤没有给用户任何可读信息：既没有 text 块，也没有带文本的 thinking 块。统计时，应将 display 设为 "updates" 或 "summarized"，因为在 "omitted" 下所有 thinking 块都是空的。平台支持对话中途系统消息时，可以采用这一做法。连续出现若干这样的步骤后，让 harness 在最新工具结果后追加下面这条单轮有效的系统消息（clear_at: "next_user_message"，beta，需要 mid-conversation-system-clear-at-2026-08-21 header）：

用户已经有一阵子没听到你的消息了：用几句话说明你正在做什么，然后继续。

在 Anthropic 的多轮编程任务测试中，这条提醒使最长的无声阶段约缩短了一半，token 或耗时没有明显增加。

后续请求中，应把每条提醒继续保留在 messages 里。删除或改写其中一条，就相当于编辑较早的轮次，会使它之后的 thinking 块失效。请参阅《将每轮提醒作为单轮有效的系统消息发送》。

如果还希望模型在第一次工具调用前说一句开场、过程中简短更新，并在结束时回顾，可以向系统提示词加入：

开始前，用一句话说明你准备做什么；工作中简短更新进展，帮助用户跟上。结束时给出一段可以独立理解的简短回顾，说明发现了什么、做了什么，以及接下来如何，让只看到最后一条消息的读者也能了解全貌。

在 Anthropic 的编程任务测试中，使用这段文字后，模型每次都会在第一次工具调用前说明情况。每个任务的输出 token 也增加了约20%。适合在人直接参与交互的场景使用。如果希望获得最多的更新，可将它与 harness 追加的提醒结合。

如果无法修改 harness，或者平台不支持对话中途系统消息，可以在系统提示词中加入：

每调用几次工具，就用一句话向用户更新当前进展。

在 Anthropic 的工作流自动化任务测试中，这句话缩短了大部分长时间没有更新的阶段。

即使同时使用提醒、开场和收尾提示，仍应预期模型会连续调用几次工具才更新。Claude Fable 5.2 很适合长时间异步运行的任务，用户回来查看结果，而不是盯着每一步；这种场景下，更新之间的空档没有那么重要。

明确对子 Agent 的预期

Claude Fable 5.2 会把多少工作交给子 Agent，取决于 harness 和任务。在 Anthropic 的短任务测试中，如果仅提供一个最简的子 Agent 启动工具，它很少启动子 Agent；在提示词鼓励委派的 Agent 编程产品中，它就很容易委派工作。

如果系统提示词、Skills 或 Agent 文件已经要求委派，先检查这些内容。只有在 Claude Fable 5.2 启动的子 Agent 仍多于任务所需时，再修改子 Agent 启动工具的描述。如果工具描述本来就很普通，其他提示词也没有要求委派，通常不需要重新写一份描述。

新的描述应交代子 Agent 会增加多少会话成本、什么时候值得委派、什么时候不值得，以及该怎样向启动的子 Agent 交代任务。Anthropic 测试的描述包含这三点，并把成本放在最前面。对本就鼓励委派、且子 Agent 占用大量 token 的 harness，这类描述最有用。

在 Anthropic 的短任务测试中，相比主要罗列委派好处的描述，使用测试描述后，委派频率降低约三分之一，任务成功情况相同。

在被测试的描述中，开头关于成本的句子会抑制委派。如果模型委派得太少，就少强调成本；如果仍然太多，就进一步说明子 Agent 在你的 harness 中会产生的代价，并测试变化。

Anthropic 还观察到，在一个 Agent 编程产品中，Claude Fable 5.2 会在 xhigh、max 等较高 effort 下使用子 Agent 检查自己的工作。Claude Fable 5.1 在相同任务中没有这样做。早期测试者让 Claude Fable 5.2 为其他模型做规划和编排，得到了不错的结果。委派可以加快适合并行的工作，但子 Agent 可能占据会话成本的很大一部分，因此应检查 harness 默认让子 Agent 使用哪个模型。

避免谨慎指令越积越多

只要上下文会被带到后续任务中，谨慎指令就会在记忆、笔记、指令文件和 Agent 间的消息里积累。Claude Fable 5.2 会紧密遵循这些指令，因此可能请求不必要的审批，或不敢执行常规工作。少数早期测试者观察到了这种行为，主要发生在多 Agent 协作场景。旧模型同样会遵循这类指令，但在这里介绍的一种设置中，只有 Claude Fable 5.2 停住了。

如果出现这种情况，应清理 Agent 携带的内容：

• 删除不再需要的笔记。在 Anthropic 的模拟任务测试中，来自早期会话的十二条笔记里，有一条写着绝不重试。当这些笔记留在上下文中，提示词又没有允许重试时，工具繁忙后模型只在约四成尝试中重试；没有这些笔记时，几乎每次都会重试。
• 明确哪些步骤不需要审批。在 Anthropic 的模拟任务测试中，上下文包含“绝不”类规则、笔记和审阅者的条件。在规则末尾增加一句，把重试列为无需审批的步骤，重试比例便从几乎没有升到约一半。在相同设置中，笼统要求更自主地行动，没有产生变化。只应把可安全重复的调用列入重试范围。
• 检查审阅 Agent 附加了什么内容。Anthropic 的模拟任务测试中，有一种设置在提示词里明确写了重试无需审批，但上下文里又有审阅者的“遇到第一个错误就停止”。Claude Fable 5.2 约有三分之一的尝试没有重试，而 Claude Fable 5.1 和 Claude Opus 5.5 会重试。
• 把例外写进规则本身。在 Anthropic 的模拟任务测试中，负责人已经批准了某一步，但在“绝不”规则之下，模型只有约一成尝试会执行。另加一句“获批的步骤已经得到许可”，也没有明显改变这一比例。当规则本身改为先取得许可再执行时，模型大约九成尝试会执行这一步。请参阅“审批”。

高风险或不可逆操作，仍要保留你自己的确认步骤。

检查为旧模型编写的指令

迁移到 Claude Fable 5.2 时，应检查提示词。Anthropic 的测试发现，有些为旧模型写的指令会增加成本、产生副作用，或已经不再有效。重新考虑以下指令：

• 长期要求委派的指令。这些把工作推给子 Agent 的句子，可能存在于系统提示词、Skills 和 Agent 文件中。迁移前应阅读这些文件。如果测试中启动的子 Agent 多于任务需要，就删除不再需要的句子。请参阅“明确对子 Agent 的预期”。
• harness 写进提示词的 token 预算。有些 harness 会在提示词中告诉模型任务可以使用多少 token，以及还剩多少。这个预算的大小会改变 Claude Fable 5.2 的消耗。Anthropic 在 high 和 xhigh 下的编程任务测试发现，移除较大的预算后，成本下降，表现相当。可以测试你的任务在不写预算时会怎样。这一发现针对提示词中的文字，而不是 API 的任务预算；后者是一项 beta 功能，并未包含在这次测试中。
• 编辑较早轮次的 harness 代码。Claude Fable 5.2 使用保留思考（preserved thinking）。如果 harness 在两次请求间修改系统提示词、工具或较早的消息，历史中修改位置之后的 thinking 块就会失效。默认情况下，Messages API 会拒绝该请求，而 Message Batches API 会丢弃这些块。若要缩短历史而不触发错误，可以使用上下文编辑，或采用在摘要之后不保留任何较早轮次的压缩方式。如果希望 Messages API 也直接丢弃这些块，可设置 thinking.block_binding.prefix_mismatch_behavior 为 "drop_block"（beta，需要 thinking-binding-controls-2026-08-01 header）。Anthropic 的测试发现，如果每轮都丢弃先前的 thinking，模型会重新思考，消耗更多输出 token。这是最差情况；增幅取决于 harness 编辑早期轮次的频率。除压缩和上下文编辑外，保持历史只追加、不改写，可以维持较高的缓存命中率，也不丢弃任何 thinking。在依赖 "drop_block" 前，先测量你自己的任务消耗多少输出 token。请参阅《API 如何处理失效块》和《不修改前缀的变更方式》。
• “把那个回答视为已完成”的句子。《Claude Opus 5.5 提示词指南》为聊天系统提示词提供过两句话，要求模型把较早的回答视为已完成，将思考集中在新消息上。Anthropic 在 high 下的测试中，这些句子减少了 Claude Fable 5.2 对追问的思考，但模型也远没有那么愿意指出早先回答中的错误。如果希望模型继续检查自己先前的回答，就不要加入这些句子。其他场景中，也应先确认模型仍能指出自己的错误，再采用它们。
• 要求少思考的指令。Claude Fable 5.1 通常会遵循“直接回答，不要推敲”之类的句子。但 Anthropic 的测试中，这样的句子并不能阻止 Claude Fable 5.2 在 medium 及以上档位思考。删除这些句子，按照“校准推理强度”一节降低 effort。
• 写作风格规则。Claude Fable 5.2 会紧密遵循风格要求，因此“每句只写一条指令，且不超过20个词”这样的硬限制，可能让行文变得支离破碎。在加入“让报告容易读懂”中的提示词前，先删除不再需要的规则。
• 不断积累的规则、笔记和记忆。记忆文件、笔记和指令文件会逐渐积累各种谨慎要求，其中有些可能是模型自己写的。迁移前，应删除理由已经不再成立的提醒，并重写绝对化规则，说明其范围和原因。如果系统已经卡住，可以考虑精简记忆与笔记后重新启动，同时保留原始副本。请参阅“避免谨慎指令越积越多”。

让报告容易读懂

长时间的 Agent 工作结束后，阅读 Claude Fable 5.2 最终报告的人，通常没看过背后的工具调用或文件。报告需要能够独立读懂。

如果让 Claude Fable 5.2 撰写最终报告或交接说明，可以将下面的文字加入系统提示词，并根据读者和产品调整：

清楚沟通

面向聪明、但不了解当前上下文的读者写作。读者没有看过你的工具调用、推理过程或打开的文件，也可能刚从其他工作切换过来。消息通常应能独立理解：读者无需翻找其他上下文，就应明白你的意思。把关键点放在开头几句话里。通过句子顺序逐步展开信息，不要在第一行就使用要到第十二行才能看懂、且尚未定义的指代或概念。

用平实词语，写清楚、好懂的完整句子。不要使用工作过程中自己造出的术语或缩写，以任何读者都能理解的方式说明它是什么。写作总体上参考 ASD-STE100 简化技术英语的风格：使用短句，每句表达一个意思，采用主动语态，对同一件事始终使用同一个词。观点彼此相连时，用连贯自然的段落；只有列举独立项目时才使用项目符号。除非读者要求，否则省去不必要的细节，尽量简洁，但要确保保留关键背景。努力让面向用户的文字尽可能清晰易读。

在 Anthropic 的 Agent 任务测试中，这段文字让最终报告不再那么密集，分号更少。在工作流自动化任务中，它还缩短了句子。你也可以增加有关长度的要求，或让模型包含某些具体细节。

安全机制触发的拒绝

Claude Fable 5.2 会运行可能拒绝请求的安全分类器。被拒绝的请求返回 stop_reason: "refusal"，stop_details.category 会标明类别：

• cyber
  ：请求可能促成网络危害，例如恶意软件或漏洞利用开发。
• bio
  ：请求可能促成生物危害，例如危险的实验室操作方法。
• frontier_llm
  ：请求可能帮助开发与其竞争的 AI 模型。
• reasoning_extraction
  ：请求要求模型在回答文本中重现其内部推理。
• general_harms
  ：请求属于其他使用政策范围。

良性的网络安全和生命科学工作，也可能触发 cyber 和 bio 分类器。如果它们阻碍了你所在组织的合法工作，可以参阅 Anthropic 的网络安全验证计划与生命科学验证计划。Claude Mythos 5.2 仅向通过这些计划验证的组织提供与 Claude Fable 5.2 相同的能力。

如果提示词、Skills 或工具描述要求模型把推理写进回答，应删除这些指令。要了解模型如何推理，可以设置 display: "summarized"，阅读 thinking 块。请参阅《将推理保留在 thinking 块中》。

如果想在另一个模型上重试被拒绝的请求，请参阅《拒绝、回退与计费》。

从哪里开始

迁移时，按以下顺序进行：

1. 明确将 effort 设为 high，同时在 medium 和 xhigh 下运行你的评估。
2. 阅读沿用的系统提示词、Skills、Agent 文件、记忆文件、笔记和 harness 文本。删除或测试“检查为旧模型编写的指令”中列出的内容。
3. 运行耗时最长的 Agent 任务，记录模型在哪里提前停止、索要不必要的审批、长时间不更新、委派超过任务所需的工作，或在你希望调整结构时只是继续添加代码。
4. 针对观察到的行为，一次应用一项对应建议，并在你自己的任务上测量效果和 token 成本。

参考链接

• 原文：https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5-2
• Claude Mythos 5.2：https://platform.claude.com/docs/en/models/mythos-5-2/overview
• effort 与逐消息设置：https://platform.claude.com/docs/en/build-with-claude/effort
• Claude Fable 5.2 的新变化与回退计费：https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2
• 提示词最佳实践：https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices
• Claude Fable 5.2 与 Mythos 5.2 迁移指南：https://platform.claude.com/docs/en/models/fable-5-2/migration-guide
• 对话中途系统消息：https://platform.claude.com/docs/en/build-with-claude/mid-conversation-system-messages
• 保留思考与前缀校验：https://platform.claude.com/docs/en/build-with-claude/preserved-thinking
• thinking 与进度更新：https://platform.claude.com/docs/en/build-with-claude/thinking
• 任务预算：https://platform.claude.com/docs/en/build-with-claude/task-budgets
• 上下文编辑：https://platform.claude.com/docs/en/build-with-claude/context-editing
• 上下文压缩：https://platform.claude.com/docs/en/build-with-claude/compaction
• Claude Opus 5.5 提示词指南：https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5
• 拒绝处理与回退：https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback
• 网络安全验证计划：https://support.claude.com/en/articles/14604842
• 生命科学验证计划：https://www.anthropic.com/news/life-sciences-verification-program