APIMODELSAPIMODELS

Claude Fable 5.2 提示词指南

TL;DR 按 Anthropic 给这个模型写的官方指南,Claude Fable 5.2 的提示词抓住六条就够:effort 从默认的 high 起步,再用自己的任务试 medium 和 xhigh;让 agent 把整件事做完,它有时会提前收工,low 和 medium 下更常见;讲清这份代码能不能由它来重构;长任务里要求它隔一会儿报一次进度;删掉为旧模型写的指令,比如「直接回答、不要思考」,这类话已经拦不住它思考;不要让它在回答里写出推理过程,这属于会被拒的类别。用代码做创作时,给它一个具体的交付物,并让它渲染出来、自己检查再改。

模型页:Claude Fable 5.2 API —— 价格、规格与在线体验

这一页用我们自己的话整理了 Anthropic 官方的「Prompting Claude Fable 5.2」,再补上发布后头几天创作者公开作品里常见的写法。文中的百分比、「约一半」这类数字都来自 Anthropic 自己的测试,不是我们跑的。通过 apimodels.app 调用 claude-fable-5-2 时,不管是在 Claude Code 里还是在你自己的程序里,这些写法都一样适用。

Claude 通用的提示词原则照样成立:把想要的结果说具体、给背景和例子、长文档放在问题前面。下面只讲 Fable 5.2 不一样的地方。

effort 选哪一档

从默认的 high 起步,只有自己的测试说明该换时再换。Anthropic 的说法是,大部分能力提升在 high 就已经拿到了:从 medium 升到 high,它跟踪的大多数编程和知识类评测分数都涨了;high 以上的提升不稳定,要看任务。给 Fable 5.2 重新试一遍,不要照搬在 Fable 5.1 或 Opus 5.5 上调好的档位,因为同一档位背后的思考量在不同模型上并不一样。

effort 几乎不影响可见回复的长短,回复长度和语气要靠提示词控制。同一件事可以混用档位,比如先用 medium 规划,把长时间无人值守的部分调高;要注意,在新请求里换顶层 effort 会让提示词缓存从头开始。在 apimodels.app 上,思考 token 按输出价每百万 $24 计费,所以 effort 也是最主要的成本开关。

effort适合要注意
low快速来回、要求明确的任务、大批量调用、要快的子 agent。Anthropic 说这一档的分数已接近 Fable 5.1 的高档位。长任务最容易提前收工。
medium交互式写代码、聊天、日常知识类工作。也比较容易提前收工,给 agent 加「把活干完」的说明。
high(默认)难的编程、研究、agent 任务、长时间无人值守。几乎每次回复前都会思考,连打招呼也是;明显比 medium 慢。
xhigh最难的长时间编程和 agent 任务,且你测到了提升。Anthropic 的编程评测里分数略高,token 多用很多。
max测上限;开放问题,比如数学、科学发现。很慢,token 比 xhigh 还多很多。

让它把活干完

在长的多步骤任务里,Fable 5.2 有时会提前结束这一轮:列一张还剩什么的清单、问你要不要继续,或者碰到超时这种普通障碍就停下。解决办法是在系统提示词里加一小段「把活干完」的说明:还欠着活的时候不要停;不依赖用户回答的部分先接着做;碰到报错、超时、文件被锁、结果为空、工具失败这类普通障碍,先诊断再想办法绕过去;而对刻意设下的限制,比如标明不许动的文件、故意没给的权限、安全规则,不要硬闯,如实报告。Anthropic 在 medium effort 下重放编程会话,加了这类说明后,留着能做的活就结束的会话减少了一半,输出 token 多了约 30%。

加了这段之后它请示得少了,所以有风险、不可撤销的操作,要保留你自己的确认步骤。你批准的时候,把批准的内容说清楚:「可以,在预发数据库上跑这次迁移」,而不是只回一句「继续」。系统提示词里的审批规则要写明具体管哪些操作,因为它会照字面执行;Anthropic 的一次测试里没有人能审批,一条「给对话以外的人发消息要先审批」的规则,让它压下了大约一半发给同事的日常请求。

讲清代码归谁

Fable 5.2 对提示词里「代码归谁」非常敏感。提示词没提,或者把代码库说成别人的,它倾向于在原有结构上往上加,哪怕会写出重复代码,看到旁边的问题也只报告不修。告诉它这份代码库归它自己设计、以后也由它接着做,行为就变了:在 Anthropic 的小型编程任务里,加了这句话后约一半的尝试会合并重复代码,不加时不到十分之一。

代价是改动范围变大。加了这句话,输出 token 约是原来的 1.5 倍,会做一些没人要求的改动(多半是补测试和文档);除了修 bug 之外,每六到十次里有一次改了已有功能的行为。它最后的总结会写大改动、常常漏掉小改动,所以要看 diff。代码归用户、希望改动越少越好的场景,就别加这句。

进度更新和最终汇报

连续调用工具的时候,Fable 5.2 可能半天不说话。在你自己的应用里,它在工具调用之间写的简短进度会放在 thinking 块里返回,默认文字是空的,所以只渲染 text 块的客户端看起来就是没动静;Anthropic 的指南里讲了怎么设置才能拿到这些进度。只改提示词的办法是加一句:每调用几次工具就用一行说明进展。如果有人在旁边看着,再要求它开工前先说一句要做什么、结束时写一段不看上下文也能读懂的总结;Anthropic 的测试里,这样会多用约 20% 的输出 token。

长任务结束后的汇报,要求它写给没看过工具调用和文件的人:结论放最前面、用大白话、不用干活过程中自己造的词,有关联的内容写成段落,列表只用来列并列的项。

为旧模型写的提示词要删什么

Fable 5.2 很听话,所以在 Fable 5.1 或 Opus 5.5 上无害的句子,换过来可能抬高成本或带来副作用。切换前把系统提示词、skills、agent 配置文件和记忆笔记都过一遍。还有一处对应用开发很关键:回传 thinking 块时,Fable 5.2 会检查对话开头有没有被改过,所以在存下来的对话里改系统提示词、工具定义或者更早的消息,可能直接返回 400。新的指令放进最新一轮,或者开一个新对话。

沿用过来的指令在 Fable 5.2 上会怎样怎么改
「直接回答,不要思考」medium 及以上档位拦不住它思考。删掉,改为给这些轮次调低 effort。
常驻的「交给子 agent 去做」可能开出超过任务需要的子 agent,而子 agent 可能占整个会话花费的一大块。删掉用不着的句子;看清子 agent 默认跑在哪个模型上。
写进提示词里的 token 预算预算大小会影响它花多少;在 high 和 xhigh 下去掉一个很大的预算,花费降了、效果不变。去掉预算,用自己的任务试一遍。
死板的文风规则,比如每句不超过多少字它会严格照做,文字变得一顿一顿的。只留还需要的规则。
记忆、笔记、规则文件里攒下的旧警告它会严格照做,可能多余地请示,或压着日常工作不做。删掉理由已经不成立的警告,给绝对化的规则写明范围和原因,并写明哪些步骤不用请示,比如重试一个安全的调用。
要它在回答里写出推理过程可能被当作「推理提取」拒掉。删掉;要看推理就读摘要版的 thinking。

被拒的时候

Fable 5.2 带有安全分类器,可能拒绝请求;返回的 stop_reason 是 refusal,并带一个类别:cyber(网络安全)、bio(生物)、frontier_llm(帮助开发与之竞争的 AI 模型)、reasoning_extraction(要它写出推理)、general_harms(其他违规)。正当的安全研究和生命科学工作也可能触发 cyber、bio 两类。做这类工作的机构可以申请 Anthropic 的验证计划;单个请求的话,实际做法是换模型。Anthropic 自己的兜底是 Opus 4.8,apimodels.app 上同一把 key 就能调,每百万 token $3 / $13。

用代码做创作的提示词

发布后传开的 Fable 5.2 作品,从 Blender 短片、Three.js 场景,到浏览器游戏、代码画的画和代码写的音乐,提示词都有几个共同点。交付物具体:格式、时长、分辨率都写明。质量要求说得很直白,并允许它花时间。所有东西都用代码生成,不下载模型、贴图,也不调用图像模型。最关键的是让它自己检查:先渲染几帧小图,看过、改过,再渲染完整版。网页动画则暴露一个确定性的 renderAt(t) 函数,这样每一帧都能截下来合成视频。

这些写法背后的几条原帖,用我们自己的话概括:@techfren 要一只尽量逼真的骑自行车的 3D 鹈鹕,Fable 5.2 在 Claude Code 里用命令行驱动 Blender 完成;@RezAIT00 要一个单文件 three.js 页面,渲染 1888 年巴黎的体素小岛,并暴露 renderAt(t);@felixrieseberg 要一个规模很小、画面像大制作的第一人称射击游戏;@aug5thmusic 要用 LilyPond 写一首巴赫风格的四声部众赞歌;Jake Eaton 让它先虚构一位画家,再写一个 Python 颜料引擎。原帖链接在下方的出处框里;「调用示例」里的模板是我们根据这些帖子归纳的,完整的故事、耗时和花费见我们的玩法文章。

出处

本页的写法建议整理自 Anthropic 的「Prompting Claude Fable 5.2」(2026 年 11 月 11 日阅读)。创作案例来自作者们在 X 上公开发布的帖子,上面的概括是我们写的。

调用示例

Template · system prompt for long agent runs (ours)

Keep going until the task is done. When you hit an ordinary obstacle
(an error, a timeout, an empty result, a failing tool), diagnose it and
work through it: retry, fix the request or use another tool.
Leave deliberate blockers alone (files marked do-not-touch, access you
were not given, safety rules) and tell me what you found.
Ask before anything risky or irreversible.
Every few tool calls, give me a one-line update.
End with a short recap a newcomer can follow: what you found,
what you changed, and what is left.

Template · 3D animation in Blender, run in Claude Code (ours)

Make a [length]-second, [resolution] video of [subject], as realistic as
you can: [what must look right: anatomy, materials, physics, lighting].
Drive Blender from the command line with Python. Generate every model,
material and animation in code; no downloaded assets.
Render a few low-resolution test frames first, look at them, fix what
looks wrong, then render the full shot. Take the time it needs.
Deliver the video file and the script.

Template · three.js scene exported to video (ours)

Build one self-contained three.js HTML page that renders a [length]-second
animation at [1280x720, 30fps]: [scene].
Make it deterministic and expose window.renderAt(t) so any frame can be
captured. Capture the frames, look at screenshots of the key moments,
fix anything that looks off, and encode the result to MP4.

Template · small browser game (ours)

Build a small but polished [genre] game that runs in the browser:
one [level / arena], with [core mechanics].
Generate all models, textures and sound effects in code.
Keep the scope tiny and the visual quality high.
Play-test it with automated input, fix what breaks, then give me the
file and the controls.

Template · painting in code (ours)

Invent a painter: name, era, background and a consistent style.
Then write one Python program that paints [subject] in that style:
a simulated paint engine with bristle brushes and paint mixing that
places every stroke. No image models, no tracing.
Render it, critique it against the painter's style, and revise the
engine until the picture holds up.

Template · music in code (ours)

Compose a [length]-second original piece in [style], entirely in code
([Python synthesis / Tone.js / LilyPond]).
Render it to WAV, listen to it by analysing the audio, and revise
anything harsh, muddy or repetitive before you hand it over.

cURL

curl https://api.apimodels.app/v1/messages \
  -H "x-api-key: $APIMODELS_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 32000,
    "output_config": { "effort": "medium" },
    "system": "Keep going until the task is done. Every few tool calls, give a one-line update.",
    "messages": [{"role": "user", "content": "Refactor utils.py into smaller modules and keep the tests passing."}]
  }'

常见问题

Claude Fable 5.2 的 effort 该选哪档?

从默认的 high 起步,再用自己的任务试 medium 和 xhigh。Anthropic 的建议是:快速、要求明确或大批量的工作用 low,交互式写代码和聊天用 medium,难的编程和 agent 任务用 high,xhigh 只在你测到提升时用,max 留给开放式的研究问题。effort 越低越省钱,因为思考 token 按输出计费。

Fable 5.2 为什么活没干完就停了?

Fable 5.2 在长任务里有时会提前结束这一轮,low 和 medium 下更常见:列出还剩什么,或者问你要不要继续。在系统提示词里加一小段:还欠着活就别停,普通障碍想办法绕过,刻意设下的限制不要硬闯。Anthropic 的测试里,留着能做的活就结束的会话减少了一半,输出 token 多了约 30%。

Fable 5.2 能关掉思考、回答快一点吗?

不能。思考一直开着,在 medium 及以上,「直接回答、不要思考」这类话也拦不住。想更快、更省,就把这些请求的 effort 设成 low 或 medium;回复的长短和语气要靠提示词控制,effort 对它们几乎没影响。

给 Fable 5.1 或 Opus 5.5 写的提示词能直接用在 Fable 5.2 上吗?

大多能用,但要先过一遍。Fable 5.2 很听话,常驻的「交给子 agent」、写进提示词的 token 预算、「少想一点」、死板的文风规则、记忆文件里攒下的旧警告,都可能抬高成本或让它束手束脚。effort 也要重新试,因为同一档位在不同模型上对应的思考量不一样。

Fable 5.2 为什么返回 stop_reason: refusal?

安全分类器拒了这个请求,类别会说明原因:cyber、bio、frontier_llm、reasoning_extraction 或 general_harms。如果提示词里要它写出推理过程,把那句删掉。正当的安全或生命科学工作,就换个模型跑:在 apimodels.app 上同一把 key 就能调 Opus 4.8,这也是 Anthropic 自己的兜底模型。

通过 apimodels.app 调 Fable 5.2,effort 怎么设?

原生接口 POST /v1/messages 里传 output_config,effort 取 low、medium、high、xhigh、max 之一。OpenAI 兼容的 /v1/chat/completions 里传 reasoning_effort,会映射成 Anthropic 的 effort。Claude Code 自己会带 effort,按 Anthropic 发布公告的说法,它默认用 medium 跑 Fable 5.2,在那里只需要换模型。

相关阅读

收录于
APIMODELS on Product HuntAPIMODELS featured on ToolifyAPIMODELS featured on There's An AI For That