Claude Fable 5.2 和 Claude Mythos 5.2 迁移指南
借助本迁移指南,从 Claude Fable 5.1、Claude Mythos 5.1、Claude Opus 5.5 或更早的 Claude Fable、Claude Mythos 或 Claude Opus 模型切换到 Claude Fable 5.2 和 Claude Mythos 5.2。启用 Claude Fable 5.2 和 Claude Mythos 5.2 的指南包括模型 ID、破坏性变更和迁移清单。
让 Claude Code 为您迁移代码
/claude-api migrate 将此项目迁移到 claude-fable-5-2
如果您的 Claude Managed Agents 智能体配有顾问,那么顾问的 model 是另一个需要更新的模型名称:在更改智能体的模型时,将其设置为 claude-fable-5-2 或 claude-mythos-5-2。请参阅 Claude Fable 5.2 执行器需要 Claude Fable 5.2 或 Claude Mythos 5.2 顾问。如果智能体的 model 对象设置了 speed: "fast",也请将该设置移除。
以下各节介绍如何从 Claude Fable 5.1、Claude Mythos 5.1、Claude Opus 5.5 或更早的 Claude Fable、Claude Mythos 或 Claude Opus 模型迁移到 Claude Fable 5.2 或 Claude Mythos 5.2。有关变更本身,请参阅 Claude Fable 5.2 的新功能。有关行为差异和特定于模型的提示模式,请参阅为 Claude Fable 5.2 编写提示。
Claude Fable 5.2 可在 Claude API、Amazon Bedrock(bedrock-runtime)、Claude Platform on AWS、Claude Models on Google Cloud (Anthropic managed)、Claude Models on Google Cloud (Google managed) 和 Microsoft Foundry 上使用。Claude Mythos 5.2 具有相同的能力,仅供通过 Anthropic 验证计划(例如 Cyber Verification Program)验证的组织使用。
claude-fable-5-2 和 claude-mythos-5-2 共有的基线设置:
- 思考:Adaptive thinking(自适应思考)始终开启,与 Claude Fable 5.1 相同。模型会决定何时思考以及思考多少,而 effort 参数控制思考的深度。
thinking: {type: "disabled"}和手动扩展思考(thinking: {type: "enabled", budget_tokens: N})都会返回 400 错误。 - Effort:支持全部五个 effort 级别,默认值为
high,与 Claude Fable 5.1 相同。请参阅 Claude Fable 5.2 的推荐 effort 级别。 - Prefill(预填充):预填充 assistant 消息会返回 400 错误,与 Claude Fable 5.1 相同。请改用系统提示中的指令。
- 采样参数:省略
temperature、top_p和top_k,与 Claude Fable 5.1 相同。有关会返回 400 错误的取值,请参阅采样参数。 - 工具选择:支持
{type: "auto"}(默认值)和{type: "none"}。使用{type: "any"}或{type: "tool", name: "..."}强制工具调用会返回 400 错误,与 Claude Fable 5.1 相同。 - 结构化输出:在使用客户管理的加密密钥(CMEK)的组织中,结构化输出对这两个模型均不可用,与 Claude Fable 5.1 相同。这包括严格工具使用和 JSON 输出。如果您的请求在此类组织中设置了
strict: true或output_config.format,请将其移除,并在您的代码中验证输出。 - 跨模型保留思考:在 Claude API 和 Claude Models on Google Cloud (Google managed) 上,Claude Fable 5.2 和 Claude Mythos 5.2 可以读取彼此的思考块,以及其他模型(包括 Claude Opus 5.5、Claude Sonnet 5.5 和 Claude Haiku 5.5)的思考块。没有任何其他模型能读取它们的思考块。完整列表请参阅在 Claude API 上哪些模型切换会保留推理。
- 绑定账户的思考:Claude Fable 5.2 和 Claude Mythos 5.2 的思考块仅在生成它们的账户或与之关联的账户中有效。当其他账户发送这些思考块之一时,API 会在模型接收之前丢弃该块,请求仍会成功。在 Claude API 和 Claude Models on Google Cloud (Google managed) 上,如果使用
thinking-binding-controls-2026-08-01beta 标头,响应会在input_transformations中列出每个被丢弃的块,并附带reason: "organization_binding_mismatch"。请参阅账户和云平台。 - 上下文窗口和输出:默认提供 1M 令牌上下文窗口,每个请求最多可输出 128k 令牌。
- 定价:每百万输入令牌 8 美元,每百万输出令牌 40 美元,而 Claude Fable 5.1 和 Claude Mythos 5.1 分别为 10 美元和 50 美元。提示缓存读取为每百万令牌 0.20 美元,而这些模型为 0.25 美元。请参阅定价。
- 数据保留:这两个模型都要求 30 天数据保留,除非获得 Anthropic 明确授权,否则在 “zero data retention”(零数据保留),即 ZDR 安排下不可用,并且被指定为 Covered Models,与 Claude Fable 5.1 和 Claude Mythos 5.1 相同。在 Claude API 上,来自未启用 30 天保留的组织或工作区的请求会返回 400
invalid_request_error。有 ZDR 安排的组织应联系其 Anthropic 客户团队,或为单个工作区配置保留。有关各平台的详细信息,请参阅特定模型的数据保留要求。 - Priority Tier:两个模型均不支持 Priority Tier。
- 快速模式:两个模型均在 Messages API 请求中支持快速模式。有关每个模型支持的平台,请参阅快速模式的可用性。
两个模型的不同之处:
- 可用性:在 Claude API 上,Claude Fable 5.2 无需访问审批。Claude Mythos 5.2 仅供通过 Anthropic 验证计划(例如 Cyber Verification Program)验证的组织使用。如需申请访问权限,请申请适用于您用例的计划,或联系您的 Anthropic 客户团队。
- 速率限制:Claude Fable 5.2 有自己的速率限制,独立于 Claude Fable 5.1 和 Claude Fable 5 共享的合并限制。Claude Mythos 5.2 与 Claude Mythos 5.1 和 Claude Mythos 5 共享一个合并限制。请参阅速率限制。
从 Claude Fable 5.1 迁移到 Claude Fable 5.2
迁移基本上可以直接替换。API 接口、始终开启的自适应思考、强制工具选择限制、拒绝处理、stop_details 类别以及数据保留要求都与 Claude Fable 5.1 一致。Claude Fable 5.2 成本更低:每百万输入令牌 8 美元,每百万输出令牌 40 美元,而 Claude Fable 5.1 分别为 10 美元和 50 美元。有四项变更可能会破坏您的代码。未通过用于捕获对早期轮次编辑的 “prefix check”(前缀检查)会返回 400 错误(请参阅绑定到其他对话的思考块)。Claude Fable 5.1 无法读取 Claude Fable 5.2 的思考块。早期的 computer use 工具 computer_20251124 在除 Amazon Bedrock 之外的所有平台上都会返回 400 错误。使用 Advisor 工具时,Claude Fable 5.2 “executor”(执行器)只接受 Claude Fable 5.2 或 Claude Mythos 5.2 作为其顾问。
更新您的模型名称
model = "claude-fable-5-1" # Before
model = "claude-fable-5-2" # After
模型 ID 在所有平台上均为 claude-fable-5-2,但 Amazon Bedrock 除外。在 Amazon Bedrock 上,模型 ID 为 global.anthropic.claude-fable-5-2 或 us.anthropic.claude-fable-5-2,并且只有 bedrock-runtime 端点提供该模型。
破坏性变更
-
未通过前缀检查会返回 400 错误:在 Claude Fable 5.2 上,每个请求都会进行前缀检查。如果您在对话中途更改
system、tools或早期消息,然后将思考块发回,就会未通过前缀检查。如果未通过前缀检查,请求会收到 400 错误。如果由 Claude Code、claude.ai、Claude Managed Agents 或 Claude Agent SDK 管理您的对话历史,则您无需做任何更改。如果您的代码自行构建
messages数组,请将其在请求之间所做的操作与如果您的代码更改了系统提示、工具或历史进行比较。如果您的代码在请求之间进行了其中某项更改,则已位于该更改之后的思考将失效。之后将其发回的请求会返回 400 错误:messages.5.content.0: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block". That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header.使用相同的请求体重试并不能消除该错误。要在切换生产流量之前找出这些编辑,请针对您当前使用的模型(Claude Fable 5.1 或 Claude Opus 5.5)运行测试您的代码是否存在未通过前缀检查的情况中的测试。如果您使用 MCP 连接器但没有固定服务器的工具列表,还请针对
claude-fable-5-2运行该测试。对于 Claude Fable 5.2 的思考块,在请求之间发生变化的工具列表属于编辑。对于 Claude Fable 5.1 或 Claude Opus 5.5 的块,则不是。有关每种模式的修复方法,请参阅更改工具或指令而不会导致前缀检查失败。在生产环境中,如果不匹配只可能意味着您代码中的错误,请将
prefix_mismatch_behavior保持为默认值"error"。如果要在修复编辑期间丢弃受影响的块并在没有该推理的情况下继续,请将其设置为"drop_block"。请将此视为权宜之计,而非长期设置:丢弃块可能会增加输出令牌。您可以在 Claude Fable 5.2 上继续 Claude Fable 5.1 或 Claude Opus 5.5 的对话。如果您在其中更改过
system、tools或早期消息,它可能会收到 400 错误:请参阅绑定到其他对话的思考块。 -
Claude Fable 5.1 无法读取 Claude Fable 5.2 的思考块:在 Claude API 和 Claude Models on Google Cloud (Google managed) 上,Claude Fable 5.2 可以读取 Claude Fable 5.1 的思考块,因此从
claude-fable-5-1切换到claude-fable-5-2的对话会保留其早期推理。反方向则不行,Claude Fable 5.1 无法读取 Claude Fable 5.2 的思考块。如果路由器切换、客户端重试或分类器拒绝回退将对话从 Claude Fable 5.2 转移到其他模型(包括 Claude Fable 5.1),API 会丢弃该模型无法读取的块。请求会成功,并且您不会为被丢弃的输入令牌付费。随后模型会在没有该推理的情况下工作,这可能会增加切换后第一个轮次的成本和延迟。
如果使用
thinking-binding-controls-2026-08-01beta 标头,input_transformations会列出每个被丢弃的块,并附带reason: "model_binding_mismatch"。请参阅切换模型再切换回来。 -
使用 computer use 工具集代替
computer_20251124:类型为computer_20251124的tools条目在除 Amazon Bedrock 之外的所有平台上都会返回 400 错误。请改为声明computer_toolset_20260801工具集:移除 beta 标头,并发送不含name或显示尺寸的条目。然后为该工具集更新您的智能体循环(请参阅从computer_20251124迁移)。在 Amazon Bedrock 上,Claude Fable 5.2 和 Claude Mythos 5.2 接受早期工具:使用 InvokeModel API 时,请在请求体的anthropic_beta数组中发送computer-use-2025-11-24。 -
Claude Fable 5.2 执行器需要 Claude Fable 5.2 或 Claude Mythos 5.2 顾问:使用处于 beta 阶段的 Advisor 工具时,顾问的能力必须至少与执行器相当。Claude Fable 5.2 或 Claude Mythos 5.2 执行器只接受 Claude Fable 5.2 或 Claude Mythos 5.2 作为其顾问。对于这些执行器,任何其他顾问(包括 Claude Fable 5.1 和 Claude Mythos 5.1)都会返回 400
invalid_request_error。请参阅模型兼容性。更改执行器的模型 ID 时,请将 Advisor 工具定义中的
model设置为claude-fable-5-2或claude-mythos-5-2。更改顾问的model属于对tools的编辑,因此请在新对话中进行此更改。在更改后回传早期思考块的请求将无法通过前缀检查。该请求会返回 400 错误,除非您将prefix_mismatch_behavior设置为"drop_block"。如果要保留当前执行器而只更改顾问,请将顾问的
model设置为claude-fable-5-2:每个执行器模型都接受它。Claude Fable 5.2 顾问以加密形式返回其建议。如果您的代码读取建议文本,请参阅结果变体。
如果 Claude Managed Agents 智能体配有顾问,则相同的模型要求也适用于该顾问。在更改智能体的模型时,请将该顾问的
model设置为claude-fable-5-2或claude-mythos-5-2。请参阅为会话配置顾问。
行为变更
- 要求减少思考的提示语句无法阻止模型在
medium及以上 effort 级别进行思考:Claude Fable 5.1 通常会遵循诸如"直接回答,无需深思"之类的语句。在 Anthropic 的测试中,此类语句并未阻止 Claude Fable 5.2 在medium及以上级别进行思考。请移除这些语句并降低 effort 级别。请参阅校准 effort。 - 在较高 effort 级别下,模型可能会启动子智能体来审查自己的工作:在较高 effort 级别(例如
xhigh和max)的智能体编码产品中,Anthropic 观察到 Claude Fable 5.2 使用子智能体来审查自己的工作。Claude Fable 5.1 在相同任务上不会这样做。子智能体可能占会话成本的很大一部分。请参阅为子代理设定预期。 - 较小的
max_tokens可能不会为文本留出空间:思考令牌计入max_tokens,因此max_tokens较小的请求可能会在thinking块之后、任何文本之前以stop_reason: "max_tokens"停止。通常能让 Claude Fable 5.1 不进行思考的提示语句,并不能阻止 Claude Fable 5.2 在medium及以上 effort 级别进行思考。因此,在 Claude Fable 5.1 上依赖此类语句来适应较小max_tokens的请求,在 Claude Fable 5.2 上可能会在输出任何文本之前就耗尽令牌。请提高max_tokens以为思考留出空间,或选择较低的 effort 级别。
有关迁移提示时需要检查的其他行为,请参阅行为差异。
迁移清单
- 将模型名称从
claude-fable-5-1更新为claude-fable-5-2。 - 在迁移生产流量之前检查您的速率限制。Claude Fable 5.2 有自己的速率限制,独立于 Claude Fable 5.1 和 Claude Fable 5 共享的限制。
- 如果您在 Amazon Bedrock 以外的任何平台上通过
computer_20251124使用 computer use,Claude Fable 5.2 会针对该工具返回 400 错误。请改为声明computer_toolset_20260801,并为该工具集更新您的智能体循环。 - 如果您在以 Claude Fable 5.2 作为执行器时使用 Advisor 工具,请将顾问的
model设置为claude-fable-5-2或claude-mythos-5-2。 - 如果您的代码自行构建
messages数组,请使用thinking-binding-controls-2026-08-01beta 标头和prefix_mismatch_behavior: "drop_block"运行一个会话,记录input_transformations,并修复每个prefix_binding_mismatch条目。 - 选择生产环境的
prefix_mismatch_behavior:"error"(默认值),或在修复编辑期间作为权宜之计使用"drop_block",因为丢弃块可能会增加输出令牌。监控 400 错误或input_transformations条目。 - 在每个轮次中继续原样回传
thinking块,包括空块。如果路由器或回退可能将对话从 Claude Fable 5.2 转移到 Claude Fable 5.1,请预期 Claude Fable 5.1 将在没有 Claude Fable 5.2 思考块的情况下运行。 - 如果您通过不同的账户重放已存储的对话,请通过生成该对话的账户或与之关联的账户来重放每个对话。API 会丢弃由其他账户生成的 Claude Fable 5.2 思考块。请参阅账户和云平台。
- 在您自己的评估上重新运行 effort 扫描,并重新建立成本和延迟基线。
- 对照审查为早期模型设计的提示和 harness,检查您沿用的系统提示、技能和其他指令。
从 Claude Mythos 5.1 迁移到 Claude Mythos 5.2
Claude Mythos 5.2 是面向通过 Anthropic 验证计划(例如 Cyber Verification Program)验证的组织的 Claude Fable 5.2 对应版本。在切换模型 ID 之前,请确认您的组织有权访问 Claude Mythos 5.2。
在 Claude Mythos 5.2 上,未通过前缀检查的请求会收到 400 错误。在 Amazon Bedrock 上,此错误是相对于 Claude Mythos 5.1 的破坏性变更。如果您的代码在请求之间更改 system、tools 或早期消息,请参阅编辑较早的轮次会使思考块失效了解需要更改的内容和测试方法,并针对 claude-mythos-5-2 运行测试。
在 Claude API 和 Claude Models on Google Cloud (Google managed) 上,Claude Mythos 5.2 可以读取 Claude Mythos 5.1 的思考块,因此从 claude-mythos-5-1 切换到 claude-mythos-5-2 的对话会保留其早期推理。反方向则不行,Claude Mythos 5.1 无法读取 Claude Mythos 5.2 的思考块:API 会丢弃这些块,请求仍会成功。请参阅切换模型再切换回来。
使用处于 beta 阶段的 Advisor 工具时,Claude Mythos 5.2 执行器只接受 Claude Mythos 5.2 或 Claude Fable 5.2 作为其顾问。Claude Mythos 5.1 或 Claude Fable 5.1 顾问会返回 400 错误。请参阅 Claude Fable 5.2 执行器需要 Claude Fable 5.2 或 Claude Mythos 5.2 顾问。
Claude Mythos 5.2 通过 computer_toolset_20260801 工具集支持 computer use。类型为 computer_20251124 的 tools 条目在除 Amazon Bedrock(早期工具在该平台上可以使用)之外的所有平台上都会返回 400 错误。请参阅使用 computer use 工具集代替 computer_20251124。
Claude Mythos 5.2 的价格为每百万输入令牌 8 美元、每百万输出令牌 40 美元,而 Claude Mythos 5.1 分别为 10 美元和 50 美元。提示缓存读取为每百万令牌 0.20 美元,而此前为 0.25 美元。
更新您的模型名称
model = "claude-mythos-5-1" # Before
model = "claude-mythos-5-2" # After
迁移清单
- 将模型名称从
claude-mythos-5-1更新为claude-mythos-5-2。 - 如果您在 Amazon Bedrock 以外的任何平台上通过
computer_20251124使用 computer use,Claude Mythos 5.2 会针对该工具返回 400 错误。请改为声明computer_toolset_20260801,并为该工具集更新您的智能体循环。 - 如果您在以 Claude Mythos 5.2 作为执行器时使用 Advisor 工具,请将顾问的
model设置为claude-mythos-5-2或claude-fable-5-2。 - 在每个轮次中继续原样回传
thinking块,包括空块。 - 如果您通过不同的账户重放已存储的对话,请通过生成该对话的账户或与之关联的账户来重放每个对话。API 会丢弃由其他账户生成的 Claude Mythos 5.2 思考块。请参阅账户和云平台。
- 如果您的代码自行构建
messages数组,请针对claude-mythos-5-2运行编辑较早的轮次会使思考块失效中的测试,修复每个prefix_binding_mismatch条目,并保持对话历史仅追加(请参阅什么算作更改)。仅追加的历史还能保持提示缓存处于预热状态。 - 处理
stop_reason: "refusal",并在读取响应内容之前读取stop_details.category。请参阅拒绝和回退。 - 重新运行您的 effort 扫描,并重新建立成本和延迟基线。
- 对照审查为早期模型设计的提示和 harness,检查您沿用的系统提示、技能和其他指令。
从 Claude Opus 5.5 迁移到 Claude Fable 5.2
Claude Fable 5.2 使用与 Claude Opus 5.5 相同的 Messages API 和工具使用模式。两个模型都始终进行自适应思考,并对强制工具选择返回 400 错误,因此您请求中的这些部分可以直接沿用。当您将流量或回退路径迁移到 Claude Fable 5.2 时,以下差异适用。
更新您的模型名称
model = "claude-opus-5-5" # Before
model = "claude-fable-5-2" # After
变更内容
-
需要数据保留:Claude Fable 5.2 要求 30 天数据保留,除非获得 Anthropic 明确授权,否则在零数据保留(ZDR)安排下不可用。如果您的组织或工作区在 ZDR 下运行 Claude Opus 5.5,请在切换之前为某个工作区启用 30 天保留,或联系您的 Anthropic 客户团队。否则,在 Claude API 上,对 Claude Fable 5.2 的每个请求都会返回 400
invalid_request_error。请参阅特定模型的数据保留要求。 -
未通过前缀检查会返回 400 错误:在 Claude Fable 5.2 上,每个请求都会进行前缀检查。如果您在对话中途更改
system、tools或早期消息,然后将思考块发回,就会未通过前缀检查。如果未通过前缀检查,请求会收到 400 错误。要在切换之前测试您的代码,请参阅如何找出未通过前缀检查的请求。 -
Claude Opus 5.5 无法读取 Claude Fable 5.2 的思考块:从 Claude Fable 5.2 切换到 Claude Opus 5.5 的对话会保留其文本和工具调用,但切换后的轮次将在没有 Claude Fable 5.2 推理的情况下运行。API 会在模型接收之前丢弃这些块,请求会成功,被丢弃的块不会计费。预计切换后第一个轮次的成本和延迟会更高。反方向上,在 Claude API 和 Claude Models on Google Cloud (Google managed) 上,Claude Fable 5.2 可以读取 Claude Opus 5.5 的思考块,因此从
claude-opus-5-5切换到claude-fable-5-2的对话会保留其早期推理。 -
安全分类器和回退:Claude Fable 5.2 运行的安全分类器涵盖与 Claude Fable 5.1 相同的
stop_details类别。请处理拒绝类别表中的每个类别,而不仅仅是您在 Claude Opus 5.5 上见过的类别。要在另一个模型上重新运行被拒绝的请求,请设置fallbacks: "default",它会在 Anthropic 针对该类别推荐的模型上重试,或者构建您自己的重试逻辑。该参数在 Claude API 和 Claude Models on Google Cloud (Anthropic managed) 上处于 beta 阶段,并且需要server-side-fallback-2026-07-01beta 标头。Claude Fable 5.2 允许的回退目标是 Claude Opus 4.8(claude-opus-4-8)和 Claude Opus 5(claude-opus-5)。服务器端回退不会重试因"reasoning_extraction"而被拒绝的请求。该拒绝会直接返回给您。回退模型不会收到 Claude Fable 5.2 的思考块。请参阅拒绝和回退。 -
定价:Claude Fable 5.2 的价格为每百万输入令牌 8 美元、每百万输出令牌 40 美元,而 Claude Opus 5.5 分别为 4 美元和 20 美元。两个模型的提示缓存读取均为每百万令牌 0.20 美元。请参阅定价。
-
快速模式:与 Claude Opus 5.5 一样,Claude Fable 5.2 在 Claude API 上的 Messages API 请求中支持快速模式(
speed: "fast")。Claude Fable 5.2 的快速模式价格为每百万输入令牌 16 美元、每百万输出令牌 80 美元,而 Claude Opus 5.5 的快速模式分别为 8 美元和 40 美元。请参阅快速模式定价。Claude Fable 5.2 还在 Claude Models on Google Cloud (Anthropic managed) 上支持快速模式,使用相同的
speed: "fast"设置。Claude Fable 5.2 还在 Claude Models on Google Cloud (Google managed) 上支持快速模式,使用相同的
speed: "fast"设置。该平台的价格由 Google Cloud 设定。请参阅云平台定价。Claude Fable 5.2 还在 Microsoft Foundry 中的 Claude 上针对托管在 Anthropic 上的部署支持快速模式。在该平台上,快速模式有自己的模型 ID:请将请求发送到
claude-fable-5-2-fast部署,并省略speed。Claude Mythos 5.2 还在 Claude API 上的 Messages API 请求中支持快速模式,价格与 Claude Fable 5.2 的快速模式价格相同。快速模式的可用性列出了 Claude Mythos 5.2 支持快速模式的所有平台。
请在 Claude Managed Agents 中移除
speed: "fast"。此外,在快速模式的可用性未列出您要迁移到的模型的任何平台或托管选项上,也请将其移除。 -
CMEK 组织中的结构化输出:在使用客户管理的加密密钥的组织中,Claude Opus 5.5 支持结构化输出,而 Claude Fable 5.2 不支持。请从迁移的请求中移除
strict: true和output_config.format,并在您的代码中验证输出。 -
默认 effort 为
high:Claude Opus 5.5 默认为medium,因此省略effort的请求在 Claude Fable 5.2 上会高一个级别运行。请求会成功,这一变化仅体现为成本、延迟和结果的不同。请显式设置effort,然后在您自己的评估上重新运行 effort 扫描。 -
Claude Fable 5.2 执行器需要 Claude Fable 5.2 或 Claude Mythos 5.2 顾问:使用处于 beta 阶段的 Advisor 工具时,Claude Opus 5.5 执行器接受多个顾问,其中包括 Claude Opus 5.5 和 Claude Fable 5.1。Claude Fable 5.2 执行器只接受 Claude Fable 5.2 或 Claude Mythos 5.2,任何其他顾问都会返回 400 错误。更改执行器的模型时,请将顾问的
model设置为claude-fable-5-2或claude-mythos-5-2。请参阅 Claude Fable 5.2 执行器需要 Claude Fable 5.2 或 Claude Mythos 5.2 顾问。
迁移清单
- 如果您的组织有 ZDR 安排,请首先为工作区启用 30 天保留,或与您的 Anthropic 客户团队确认资格。
- 将模型 ID 从
claude-opus-5-5更新为claude-fable-5-2。 - 在迁移生产流量之前检查您的速率限制。Claude Fable 5.2 的速率限制独立于 Claude Opus 5.5,且每个层级的令牌限制更低。
- 如果您的代码自行构建
messages数组,请运行未通过前缀检查会返回 400 错误中的测试。 - 处理每个
stop_details.category。如果您设置了显式的fallbacks列表,请仅指定 Claude Fable 5.2 允许的目标。 - 如果路由器或回退将对话从 Claude Fable 5.2 转移到 Claude Opus 5.5,请预期切换后的轮次将在没有 Claude Fable 5.2 思考块的情况下运行。
- 如果您通过不同的账户重放已存储的对话,请通过生成该对话的账户或与之关联的账户来重放每个对话。API 会丢弃由其他账户生成的 Claude Fable 5.2 思考块。请参阅账户和云平台。
- 如果您在 Messages API 请求中使用快速模式,请仅在快速模式的可用性列出您要迁移到的模型的平台或托管选项上保留
speed: "fast"。在这些平台和托管选项上,请根据快速模式价格重新建立成本基线。在所有其他平台或托管选项上以及在 Claude Managed Agents 中,请移除speed: "fast"。您不需要fast-mode-2026-02-01beta 标头。在 Claude API 上,发送该标头的请求仍可正常工作。Microsoft Foundry 中的 Claude 是例外:在该平台上,请移除speed: "fast",并将请求发送到claude-fable-5-2-fast部署。 - 如果您在以 Claude Fable 5.2 作为执行器时使用 Advisor 工具,请将顾问的
model设置为claude-fable-5-2或claude-mythos-5-2。 - 在使用客户管理的加密密钥的组织中,移除
strict: true和output_config.format,并在您的代码中验证输出。 - 显式设置
effort:Claude Fable 5.2 的默认值为high,而 Claude Opus 5.5 的默认值为medium,因此省略它的请求会高一个级别运行。然后在您自己的评估上重新运行 effort 扫描,并重新建立成本和延迟基线。 - 对照审查为早期模型设计的提示和 harness,检查您沿用的系统提示、技能和其他指令。
从 Claude Fable 5 迁移到 Claude Fable 5.2
API 接口、上下文窗口和输出限制、分词器、始终开启的自适应思考以及拒绝处理都与 Claude Fable 5 一致。以下部分变更也适用于从 Claude Mythos 5 迁移到 Claude Mythos 5.2 的情况。有关具体是哪些变更,请参阅从 Claude Mythos 5 迁移到 Claude Mythos 5.2。
更新您的模型名称
model = "claude-fable-5" # Before
model = "claude-fable-5-2" # After
破坏性变更
-
强制工具选择会返回 400 错误: Claude Fable 5 接受
tool_choice的auto、none、any和tool。在claude-fable-5-2上,{type: "any"}和{type: "tool", name: "..."}会返回 400invalid_request_error,令牌计数端点也是如此。有关错误消息,请参阅不支持强制工具使用。若要在不强制的情况下获得工具调用,请将
tool_choice保持为auto,并在您的指令中指明该工具。在工具上设置strict: true,使调用符合您的 schema。请参阅严格工具使用。如果您强制使用工具只是为了获得符合 schema 的 JSON,请改用 JSON 输出。在使用客户管理的加密密钥的组织中,"structured outputs"(结构化输出)不适用于 Claude Fable 5.2 或 Claude Mythos 5.2。这包括严格工具使用和 JSON 输出。在这种情况下,请保持auto和指令,省略strict,并在您的代码中验证工具输入。如果您的应用程序要求在当前轮次进行特定的工具调用,请在最新的
user轮次之后追加一条对话中途系统消息。指明该工具,说明本轮次必须进行该调用,并告诉 Claude 以该调用开始其响应。较早的轮次保持不变,因此它们的提示缓存命中和思考块仍然有效。有关支持该功能的平台,请参阅对话中途系统消息和工具更改。对于不得调用工具的轮次,tool_choice: {"type": "none"}仍然有效。请参阅强制工具使用。 -
编辑较早的轮次会使思考块失效: 在 Claude Fable 5.2 上,每个
thinking块仅相对于其之前的system提示、tools和消息有效。如果其中任何一项发生了变化,将该块发回的请求将无法通过前缀检查并收到 400 错误。使用相同请求体重试也无法消除该错误。如果由 Claude Code、claude.ai、Claude Managed Agents 或 Claude Agent SDK 管理您的对话历史,则您无需做任何更改。如果您的代码自行构建
messages数组,请保持历史记录仅追加。在会话期间冻结system和tools。通过对话中途系统消息进行指令和工具的更改,并使用服务器端压缩或上下文编辑来裁剪上下文。有关支持对话中途系统消息的平台,请参阅对话中途系统消息和工具更改。有关应发送什么来代替每项更改,请参阅更改工具或指令而不会导致前缀检查失败。若要在切换生产流量之前找出这些编辑,请针对
claude-fable-5-2运行测试您的代码是否存在未通过前缀检查的情况中的测试。在生产环境中,如果不匹配只可能意味着您的代码存在错误,请将prefix_mismatch_behavior保持为默认值"error"。若要在修复编辑期间丢弃受影响的块并在没有该推理的情况下继续,请配合thinking-binding-controls-2026-08-01beta 标头将其设置为"drop_block"。请将其视为权宜之计,而非长期设置:丢弃块可能会增加输出令牌。 -
Claude Fable 5 无法读取 Claude Fable 5.2 的思考块: 在 Claude API 和 Claude Models on Google Cloud (Google managed) 上,Claude Fable 5.2 可以读取 Claude Fable 5 的块,因此从
claude-fable-5迁移到claude-fable-5-2的对话会保留其先前的推理。反过来,Claude Fable 5 无法读取 Claude Fable 5.2 的块。如果路由切换、客户端重试或分类器拒绝回退将对话从 Claude Fable 5.2 转移到其他模型(包括 Claude Fable 5),API 会丢弃该模型无法读取的块。请求会成功,并且不会对被丢弃的输入令牌向您计费。使用
thinking-binding-controls-2026-08-01beta 标头时,input_transformations会列出每个被丢弃的块,并附带reason: "model_binding_mismatch"。请参阅切换模型再切换回来。 -
使用 computer use 工具集代替
computer_20251124: 在 Claude Fable 5.2 上,类型为computer_20251124的tools条目在除 Amazon Bedrock 以外的所有平台上都会返回 400 错误。Claude Fable 5 在配合其 beta 标头时接受该工具。请改为声明computer_toolset_20260801工具集(请参阅使用 computer use 工具集代替computer_20251124)。 -
Claude Fable 5.2 执行器需要 Claude Fable 5.2 或 Claude Mythos 5.2 顾问: 使用处于 beta 阶段的 Advisor 工具时,Claude Fable 5.2 执行器仅接受 Claude Fable 5.2 或 Claude Mythos 5.2 作为其顾问。Claude Fable 5 执行器接受的其他顾问(例如 Claude Fable 5 和 Claude Opus 5.5)会返回 400 错误。在更改执行器的
model时,请将顾问的model设置为claude-fable-5-2或claude-mythos-5-2。请参阅 Claude Fable 5.2 执行器需要 Claude Fable 5.2 或 Claude Mythos 5.2 顾问。
其他变更
- 定价: 每百万输入令牌 8 美元,每百万输出令牌 40 美元,而 Claude Fable 5 分别为 10 美元和 50 美元。提示缓存读取为每百万令牌 0.20 美元,而此前为 1 美元。请参阅定价。
- Priority Tier: Claude Fable 5.2 不支持 Priority Tier。Claude Fable 5 支持。如果您的组织有 Priority Tier 承诺,请单独规划容量。
- 按消息设置 effort(beta): 若要在对话中途更改 effort 而不丢失提示缓存命中,请发送一条按消息设置 effort 的
role: "system"消息,而不是在请求之间更改output_config.effort。按消息设置 effort 页面列出了支持该功能的平台。
迁移清单
- 将模型名称从
claude-fable-5更新为claude-fable-5-2。 - 在转移生产流量之前,请检查您的"rate limits"(速率限制)。Claude Fable 5.2 有自己的速率限制,与 Claude Fable 5.1 和 Claude Fable 5 共享的速率限制相互独立。
- 将强制
tool_choice({type: "any"}或{type: "tool", ...})替换为{type: "auto"}加上明确的指令和strict: true工具,或替换为 JSON 输出。将指令放在user轮次中。当您的应用程序要求进行该调用时,请改为将其放在对话中途的role: "system"消息中(适用于对话中途系统消息列出的平台)。在使用客户管理的加密密钥的组织中,严格工具使用和 JSON 输出不适用于 Claude Fable 5.2。在这种情况下,请保持{type: "auto"}和指令,并在您的代码中验证工具输入。 - 如果您的代码自行构建
messages数组,请针对claude-fable-5-2使用thinking-binding-controls-2026-08-01beta 标头和prefix_mismatch_behavior: "drop_block"运行一个会话,记录input_transformations,并修复每个prefix_binding_mismatch条目。 - 保持历史记录仅追加:在会话开始时冻结
system和tools,通过role: "system"消息进行会话中途的更改,并在服务器上裁剪上下文。有关支持对话中途系统消息的平台,请参阅对话中途系统消息和工具更改。 - 选择生产环境的
prefix_mismatch_behavior:"error"(默认值),或者在修复编辑期间将"drop_block"作为权宜之计,因为丢弃块可能会增加输出令牌。监控 400 错误或input_transformations条目。 - 在每个轮次中继续原样传回
thinking块,包括空块。如果路由或回退可能将对话从 Claude Fable 5.2 转移到 Claude Fable 5,请预期 Claude Fable 5 将在没有 Claude Fable 5.2 的块的情况下运行。 - 如果您通过不同的账户重放存储的对话,请通过生成该对话的账户或与其关联的账户重放每个对话。API 会丢弃由其他账户生成的 Claude Fable 5.2 思考块。请参阅账户和云平台。
- 如果您在 Amazon Bedrock 以外的任何平台上通过
computer_20251124使用 computer use,Claude Fable 5.2 会对该工具返回 400 错误。请改为声明computer_toolset_20260801,并针对该工具集更新您的代理循环。 - 如果您在将 Claude Fable 5.2 作为执行器的情况下使用 Advisor 工具,请将顾问的
model设置为claude-fable-5-2或claude-mythos-5-2。 - 如果您在请求之间更改 effort,请在您的平台支持的情况下,将该更改移至处于 beta 阶段的按消息设置 effort 的
role: "system"消息。 - 如果您的组织有 Priority Tier 承诺,请单独规划容量。
- 处理
stop_reason: "refusal"并读取stop_details.category。考虑使用fallbacks: "default"(在 Claude API 和 Claude Models on Google Cloud (Anthropic managed) 上处于 beta 阶段)。 - 在您自己的评估上重新运行 effort 扫描,并重新建立成本和延迟的基线。
- 对照审查为早期模型设计的提示和 harness,检查您沿用的系统提示、skills 和其他指令。
从 Claude Mythos 5 迁移到 Claude Mythos 5.2
Claude Mythos 5.2 是 Claude Fable 5.2 的对应模型,面向通过 Anthropic 验证计划(例如 Cyber Verification Program)验证的组织。在切换模型 ID 之前,请确认您的组织有权访问 Claude Mythos 5.2。
从 Claude Fable 5 迁移到 Claude Fable 5.2 中的四项变更按原文适用:
- 强制工具选择会返回 400 错误。
- 编辑较早的轮次会使思考块失效。
- 使用 computer use 工具集代替
computer_20251124。 - Claude Fable 5.2 或 Claude Mythos 5.2 执行器需要这两个模型之一作为其顾问。
在 Claude API 和 Claude Models on Google Cloud (Google managed) 上,Claude Mythos 5.2 可以读取 Claude Mythos 5 的思考块,因此从 claude-mythos-5 迁移到 claude-mythos-5-2 的对话会保留其先前的推理。反过来,Claude Mythos 5 无法读取 Claude Mythos 5.2 的块:API 会丢弃这些块,并且请求会成功。请参阅切换模型再切换回来。
Claude Mythos 5.2 的价格为每百万输入令牌 8 美元、每百万输出令牌 40 美元,而 Claude Mythos 5 分别为 10 美元和 50 美元。提示缓存读取为每百万令牌 0.20 美元,而此前为 1 美元。
更新您的模型名称
model = "claude-mythos-5" # Before
model = "claude-mythos-5-2" # After
迁移清单
- 将模型名称从
claude-mythos-5更新为claude-mythos-5-2。 - 将强制
tool_choice(any或tool)替换为auto加上明确的指令和strict: true工具,或替换为 JSON 输出。在使用客户管理的加密密钥的组织中,严格工具使用和 JSON 输出不适用于 Claude Mythos 5.2。在这种情况下,请保持auto和指令,并在您的代码中验证工具输入。 - 如果您在 Amazon Bedrock 以外的任何平台上通过
computer_20251124使用 computer use,Claude Mythos 5.2 会对该工具返回 400 错误。请改为声明computer_toolset_20260801,并针对该工具集更新您的代理循环。 - 如果您在将 Claude Mythos 5.2 作为执行器的情况下使用 Advisor 工具,请将顾问的
model设置为claude-mythos-5-2或claude-fable-5-2。 - 在每个轮次中继续原样传回
thinking块,包括空块。 - 如果您通过不同的账户重放存储的对话,请通过生成该对话的账户或与其关联的账户重放每个对话。API 会丢弃由其他账户生成的 Claude Mythos 5.2 思考块。请参阅账户和云平台。
- 如果您的代码自行构建
messages数组,请针对claude-mythos-5-2运行编辑较早的轮次会使思考块失效中的测试,修复每个prefix_binding_mismatch条目,并保持对话历史仅追加(请参阅什么算作更改)。仅追加的历史记录还能保持提示缓存处于预热状态。 - 处理
stop_reason: "refusal",并在读取响应内容之前读取stop_details.category。请参阅拒绝与回退。 - 重新运行您的 effort 扫描,并重新建立成本和延迟的基线。
- 对照审查为早期模型设计的提示和 harness,检查您沿用的系统提示、skills 和其他指令。
从 Claude Opus 5 迁移到 Claude Fable 5.2
Claude Fable 5.2 使用与 Claude Opus 5 相同的 Messages API 和"tool use"(工具使用)模式。1M 令牌的"context window"(上下文窗口)、128k 最大输出令牌、512 令牌的"prompt caching"(提示缓存)最小值以及对话中途系统消息均保持不变。对预填充和采样参数的限制也同样保持不变。当您将流量或回退路径转移到 Claude Fable 5.2 时,以下差异适用。
更新您的模型名称
model = "claude-opus-5" # Before
model = "claude-fable-5-2" # After
变更内容
-
思考无法禁用: Claude Opus 5 在 effort 级别为
high或更低时接受thinking: {type: "disabled"}。在 Claude Fable 5.2 上,自适应思考始终开启,thinking: {type: "disabled"}在任何 effort 级别都会返回 400 错误。请删除该字段,并通过较低的 effort 级别来控制令牌开销。对于曾在禁用思考的情况下运行的工作负载,请重新审视max_tokens,它涵盖思考和响应文本。如果该代码按位置读取内容(例如content[0].text),请改为按type选择内容块,因为thinking块会排在最前面。 -
强制工具选择会返回 400 错误: Claude Opus 5 接受
tool_choice的any和tool。Claude Fable 5.2 会拒绝这两者。有关应改为发送的内容,请参阅强制工具选择会返回 400 错误。 -
编辑较早的轮次会使思考块失效: 如果您的代码在请求之间编辑较早的消息、重建
system或tools,或在客户端进行压缩,位于已更改内容之后的思考块将失效。之后将其中某个块发回 Claude Fable 5.2 的请求会收到 400 错误;如果将prefix_mismatch_behavior设置为"drop_block",API 则会丢弃该块。有关需要更改的内容以及测试方法,请参阅编辑较早的轮次会使思考块失效。 -
Claude Opus 5 无法读取 Claude Fable 5.2 的思考块: 在 Claude API 和 Claude Models on Google Cloud (Google managed) 上,Claude Fable 5.2 可以读取 Claude Opus 5 的块,因此从
claude-opus-5迁移到claude-fable-5-2的对话会保留其先前的推理。反过来,Claude Opus 5 无法读取 Claude Fable 5.2 的块。从 Claude Fable 5.2 转移到 Claude Opus 5 的对话,在切换后的轮次中将在没有 Claude Fable 5.2 推理的情况下运行。API 会在模型接收这些块之前将其丢弃,请求会成功,并且被丢弃的块不会计费。请参阅切换模型再切换回来。
-
工具调用之间的文本以思考块形式返回: 在 Claude Opus 5 上,模型在工具调用之间编写的文本以
text块形式返回。在 Claude Fable 5.2 上,这些叙述以进度更新thinking块的形式返回,每次工具调用之前最多一个。如果您的界面会渲染这些叙述,请将thinking.display设置为"updates"(该值处于 beta 阶段),以便以文本形式接收进度更新,同时推理保持隐藏;或设置为"summarized"以同时接收两者。然后渲染tool_use块之间的非空thinking块。请参阅工具调用之间的进度更新。 -
使用 computer use 工具集代替
computer_20251124: Claude Opus 5 在配合其 beta 标头时接受较早的computer_20251124工具。Claude Fable 5.2 在除 Amazon Bedrock 以外的所有平台上都会对其返回 400 错误。请参阅使用 computer use 工具集代替computer_20251124。 -
安全分类器与回退: Claude Fable 5.2 的安全分类器涵盖的
stop_details类别比 Claude Opus 5 的分类器更广泛。请预期会出现额外的stop_details.category值,例如"bio"。请处理拒绝类别表中的每个类别。若要在其他模型上重新运行被拒绝的请求,请设置fallbacks: "default",或构建您自己的重试机制。该参数在 Claude API 和 Claude Models on Google Cloud (Anthropic managed) 上处于 beta 阶段,并且需要server-side-fallback-2026-07-01beta 标头。有关允许的回退目标,请参阅拒绝、回退与计费。 -
定价: Claude Fable 5.2 的费用为每百万输入令牌 $8 USD、每百万输出令牌 $40 USD,而 Claude Opus 5 为 $5 USD 和 $25 USD。提示缓存读取为每百万令牌 $0.20 USD,相比之下为 $0.50 USD。请参阅定价。
-
需要数据保留: Claude Fable 5.2 需要 30 天的数据保留,除非获得 Anthropic 的明确授权,否则不适用于"zero data retention"(零数据保留),即 ZDR 安排。Claude Opus 5 可在 ZDR 下使用。在 Claude API 上,来自没有 30 天保留的组织或工作区的请求会返回 400
invalid_request_error。请参阅特定模型的数据保留要求。 -
快速模式: Claude Opus 5 在研究预览阶段支持快速模式(
speed: "fast"),需要使用fast-mode-2026-02-01beta 标头。Claude Fable 5.2 在 Claude API 上的 Messages API 请求中支持快速模式,无需该标头。发送该标头的请求可继续正常工作。Claude Fable 5.2 的快速模式费用为每百万输入令牌 $16 USD、每百万输出令牌 $80 USD,而 Claude Opus 5 的快速模式为 $10 USD 和 $50 USD。请参阅快速模式定价。Claude Fable 5.2 还在 Claude Models on Google Cloud (Anthropic managed) 上支持快速模式,使用相同的
speed: "fast"设置。Claude Fable 5.2 还在 Claude Models on Google Cloud (Google managed) 上支持快速模式,使用相同的
speed: "fast"设置。该平台的价格由 Google Cloud 设定。请参阅云平台定价。Claude Fable 5.2 还在 Microsoft Foundry 中的 Claude 上针对托管在 Anthropic 上的部署支持快速模式。在该平台上,快速模式有自己的模型 ID:请将请求发送到
claude-fable-5-2-fast部署,并省略speed。Claude Mythos 5.2 还在 Claude API 上的 Messages API 请求中支持快速模式,无需该标头,价格与 Claude Fable 5.2 的快速模式价格相同。快速模式的可用性列出了 Claude Mythos 5.2 支持快速模式的所有平台。
请在 Claude Managed Agents 中删除
speed: "fast"。如果快速模式的可用性未列出您要转移到的模型,也请将其删除。 -
CMEK 组织中的结构化输出: 在使用客户管理的加密密钥的组织中,Claude Opus 5 支持结构化输出,而 Claude Fable 5.2 不支持。请从您转移的请求中删除
strict: true和output_config.format,并在您的代码中验证输出。 -
Claude Fable 5.2 执行器需要 Claude Fable 5.2 或 Claude Mythos 5.2 顾问: 使用处于 beta 阶段的 Advisor 工具时,Claude Opus 5 执行器接受多种顾问,其中包括 Claude Opus 5 和 Claude Fable 5.1。Claude Fable 5.2 执行器仅接受 Claude Fable 5.2 或 Claude Mythos 5.2,任何其他顾问都会返回 400 错误。在更改执行器的
model时,请将顾问的model设置为claude-fable-5-2或claude-mythos-5-2。请参阅 Claude Fable 5.2 执行器需要 Claude Fable 5.2 或 Claude Mythos 5.2 顾问。
迁移清单
- 如果您的组织有 ZDR 安排,请首先为工作区启用 30 天保留,或向您的 Anthropic 客户团队确认资格。
- 将模型 ID 从
claude-opus-5更新为claude-fable-5-2。 - 在转移生产流量之前,请检查您的速率限制。Claude Fable 5.2 的速率限制与 Claude Opus 5 的相互独立,且在每个层级的令牌限制都更低。
- 删除任何
thinking: {type: "disabled"}配置。通过较低的 effort 级别控制令牌开销,重新审视max_tokens,并按type选择内容块。 - 在每个轮次中原样传回
thinking块,包括空块。在工具使用循环中,将它们与工具结果一起发回。请参阅保留思考块。 - 将强制
tool_choice(any或tool)替换为auto加上明确的指令和strict: true工具,或替换为 JSON 输出。在使用客户管理的加密密钥的组织中,严格工具使用和 JSON 输出不适用于 Claude Fable 5.2。在这种情况下,请保持auto和指令,并在您的代码中验证工具输入。 - 如果您的代码自行构建
messages数组,请针对claude-fable-5-2运行编辑较早的轮次会使思考块失效中的测试,修复每个prefix_binding_mismatch条目,并保持历史记录仅追加。 - 如果您在 Amazon Bedrock 以外的任何平台上通过
computer_20251124使用 computer use,Claude Fable 5.2 会对该工具返回 400 错误。请改为声明computer_toolset_20260801,并针对该工具集更新您的代理循环。 - 如果您在将 Claude Fable 5.2 作为执行器的情况下使用 Advisor 工具,请将顾问的
model设置为claude-fable-5-2或claude-mythos-5-2。 - 如果路由或回退将对话从 Claude Fable 5.2 转移到 Claude Opus 5,请预期切换后的轮次将在没有 Claude Fable 5.2 思考块的情况下运行。
- 如果您通过不同的账户重放存储的对话,请通过生成该对话的账户或与其关联的账户重放每个对话。API 会丢弃由其他账户生成的 Claude Fable 5.2 思考块。请参阅账户和云平台。
- 如果您的界面会渲染工具调用之间的文本,请将
thinking.display设置为"updates"(该值处于 beta 阶段)或"summarized",并渲染非空的thinking块。 - 处理每个
stop_details.category。如果您设置了显式的fallbacks列表,请仅指定 Claude Fable 5.2 允许的目标。 - 如果您在 Claude API 上的 Messages API 请求中使用快速模式,请仅在快速模式的可用性列出您要转移到的模型时保留
speed: "fast"。如果保留,请根据快速模式价格重新建立成本基线。在 Claude Managed Agents 中,请删除speed: "fast"。您不需要fast-mode-2026-02-01beta 标头,发送该标头的请求仍可正常工作。 - 在使用客户管理的加密密钥的组织中,请删除
strict: true和output_config.format,并在您的代码中验证输出。 - 在您自己的评估上重新运行 effort 扫描,并重新建立成本和延迟的基线。
- 对照审查为早期模型设计的提示和 harness,检查您沿用的系统提示、skills 和其他指令。
从 Claude Opus 4.8 或更早版本迁移到 Claude Fable 5.2
首先完成从 Claude Opus 5 迁移到 Claude Fable 5.2 中的步骤,将 claude-opus-4-8 作为您要替换的模型 ID。该部分按原文适用于 Claude Opus 4.8 上的代码,因为 Claude Opus 4.8 与 Claude Opus 5 一样:
- 接受
thinking: {type: "disabled"}、强制工具选择、computer_20251124工具和快速模式(该模式已在 Claude Opus 4.8 上弃用)。 - 将工具调用之间的文本以
text块形式返回。 - 可在零数据保留(ZDR)安排下使用。
- 价格为每百万输入令牌 5 美元、每百万输出令牌 25 美元,提示缓存读取为 0.50 美元。
本部分补充 Claude Opus 5 部分未涵盖的差异。
变更内容
-
省略思考的请求也会运行思考: 在 Claude Opus 4.8 上,除非您请求,否则思考处于关闭状态。在 Claude Fable 5.2 上,没有
thinking字段的请求会以自适应思考运行。响应可能会在text块之前携带thinking块,因此请按type选择内容块,而不是读取content[0].text。在工具使用循环中,将thinking块(包括空块)与工具结果一起原样发回。思考令牌按输出令牌计费,并且max_tokens涵盖思考和响应文本。请重新审视max_tokens,并在您希望减少思考的地方降低effort。在 Claude API 和 Claude Models on Google Cloud (Google managed) 上,Claude Fable 5.2 可以读取先前 Claude Opus 4.8 轮次中的思考块,因此迁移到claude-fable-5-2的对话会保留该推理。 -
更低的提示缓存最小值: Claude Fable 5.2 上的最小可缓存提示长度为 512 个令牌,低于 Claude Opus 4.8 上的 1,024 个令牌。以前因过短而无法缓存的提示现在可以创建缓存条目,无需更改代码。请参阅提示缓存。
-
不支持 Priority Tier: Claude Opus 4.8 支持 Priority Tier。Claude Fable 5.2 不支持。如果您的组织有 Priority Tier 承诺,请单独规划容量。
-
Advisor 工具的建议以加密形式返回: 使用处于 beta 阶段的 Advisor 工具时,Claude Opus 4.8 执行器可以与以明文形式返回建议的顾问(例如 Claude Opus 4.8)配对。Claude Fable 5.2 执行器仅接受的顾问 Claude Fable 5.2 和 Claude Mythos 5.2 会以加密形式返回建议,即
advisor_redacted_result块,因此您的客户端无法读取其文本。如果您的代码会读取建议文本,请移除该依赖。请参阅结果变体。
如果您的代码使用的是 Claude Opus 4.7 或更早版本,还需应用 Claude Opus 5.5 指南迁移清单中的部分内容。从 Claude Opus 4.7 或更早版本这一组开始,依次应用其后的每一组,直到并包括提及您的模型的那一组为止。这些组涵盖了 Claude Opus 4.8 之前所做的请求变更,例如已移除的采样参数和 beta 标头。仅当快速模式的可用性列出您要迁移到的模型时,才应用该清单中的快速模式一项。在使用客户管理的加密密钥的组织中,结构化输出不适用于 Claude Fable 5.2,因此请勿在其中应用 output_config.format 一项。请改为从您的请求中删除 output_format,并在您的代码中验证 JSON。
迁移清单
- 完成 Claude Opus 5 清单中的步骤,将
claude-opus-4-8作为您要替换的模型 ID。 - 审查在没有
thinking字段的情况下运行的工作负载。在 Claude Fable 5.2 上,它们会以思考方式运行,因此请重新审视max_tokens,在您希望减少思考的地方降低effort,并按type选择内容块。 - 检查任何解析
thinking字段的代码是否仅将其视为显示文本。将thinking.display设置为"summarized"以接收可读的摘要。 - 审查接近缓存最小值的提示:512 个令牌或更多的提示可以创建缓存条目。
- 如果您的组织有 Priority Tier 承诺,请单独规划容量。
- 如果您使用 Advisor 工具且您的代码会读取建议文本,请移除该依赖:建议会以加密的
advisor_redacted_result块形式到达。 - 在您自己的评估上运行全新的 effort 扫描,而不是沿用为 Claude Opus 4.8 调优的设置。
- 对于 Claude Opus 4.7 或更早版本,还需应用 Claude Opus 5.5 指南中适用于您的模型的清单组。除非快速模式的可用性列出您要迁移到的模型,否则请省略快速模式一项。在使用客户管理的加密密钥的组织中,还需省略
output_config.format一项,并从您的请求中删除output_format。