Claude Fable 5.2：Claude Code 配置、API 价格与 Opus 对比

当 Opus 5.5 提高推理强度（effort）后仍无法通过代码验收时，再试 Claude Fable 5.2；否则，日常开发继续用 Opus。按照 Anthropic 的建议，Claude Code 从 medium 起步，API 从 high 起步。比较通过验收的改动所花的成本：token 单价更高，也可能以更低的总费用完成任务。

Fable 5.2 于 2026 年 11 月 9 日发布，API 模型 ID 为 claude-fable-5-2。截至 2026-11-12，模型规格列出的上下文窗口为 1M token，最大输出为 128K token。

在 Claude Code 中选择 Fable 5.2，并验证实际修改

使用 Claude Code 2.1.321 或更高版本，然后指定完整的模型 ID。官方更新日志确认，Fable 5.2 支持是在 2.1.321 中加入的。

你需要已安装并完成身份验证的 Claude Code 客户端，以及允许使用该模型的账号或服务商。发送私有代码前，确认组织已批准按照 Fable 的 Covered Models 数据处理政策使用该模型。

如果使用原生安装方式，在 Bash 中运行：

claude update
claude --version

如果通过包管理器安装，请按对应的更新说明操作。检查输出的版本至少为 2.1.321。不要仅凭执行过更新，就认定旧安装已成功升级。

在已有会话中运行：

/model claude-fable-5-2

“默认 Fable 模型”并不意味着 Fable 会成为所有用户的默认选择。模型配置文档明确说明，Fable 不是任何账号类型的默认模型。

为了单独验证，使用 Bash 和 Python 3 创建一个临时目录：

workdir="$(mktemp -d)"
cd "$workdir"

cat > clamp.py <<'PY'
def clamp(value, low, high):
    return min(low, max(value, high))
PY

cat > test_clamp.py <<'PY'
from clamp import clamp

assert clamp(-2, 0, 10) == 0
assert clamp(5, 0, 10) == 5
assert clamp(12, 0, 10) == 10
print("3 checks passed")
PY

claude --model claude-fable-5-2 --effort medium

这些 CLI 参数为本次会话指定模型和 effort。开始前通过 /model 确认。若 effort 不符，检查环境变量 CLAUDE_CODE_EFFORT_LEVEL；它的优先级高于启动参数。

把下面的任务交给 Claude Code。它要求修正函数、保持测试文件不变，并且不使用子代理：

Read clamp.py and test_clamp.py.
Fix clamp.py so all existing assertions pass.
Do not edit test_clamp.py.
Run python3 test_clamp.py and report the exact result.
Do not use subagents.

保持权限检查开启。只批准适合在该目录执行的文件操作和命令。

代理结束后，退出 Claude Code，再自行运行：

python3 test_clamp.py

预期结果是 3 checks passed，同时测试文件保持不变。只给出补丁建议，却没有实际应用修改并通过测试，不算验证成功。这一步验证的是工具调用路径，而不是 Fable 相对其他模型的能力优势。

向 claude-fable-5-2 发送首个 API 请求

先使用 Anthropic 直连 Messages API，区分模型行为与网关配置问题。此示例需要 Bash、支持 --fail-with-body 的 curl、jq，以及 Anthropic 签发的 API 密钥。

按照 Console 创建 API 密钥的说明，选择一个具体工作区，并创建自己的密钥。该示例使用限定在此工作区的密钥，因此可以省略 anthropic-workspace-id。具体条件见 API 身份验证文档。

在 read 等待输入时粘贴密钥，然后按 Enter：

read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY

发送同步请求：

curl --silent --show-error --fail-with-body \
  https://api.anthropic.com/v1/messages \
  --header "Authorization: Bearer ${ANTHROPIC_API_KEY}" \
  --header "anthropic-version: 2026-10-21" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-fable-5-2",
    "max_tokens": 4096,
    "output_config": {
      "effort": "high"
    },
    "messages": [
      {
        "role": "user",
        "content": "Fix this Python function and return the corrected function plus three assertions: def clamp(value, low, high): return min(low, max(value, high))"
      }
    ]
  }' \
  --output fable-response.json &&
jq '{
  model,
  stop_reason,
  usage,
  text: [.content[] | select(.type == "text") | .text]
}' fable-response.json

请求使用当前的 API 版本头和文档中的 output_config.effort 字段。示例未传入 thinking，因为 Fable 5.2 已使用自适应思考。

检查返回的模型、非空文本、usage 和 stop_reason。自然结束的回复通常返回 end_turn；max_tokens 表示输出已达到设定上限。先按停止原因指南提高输出上限，再判断被截断的回复是否存在质量问题。

如果 HTTP 请求失败，查看保存的错误：

jq '.error' fable-response.json

该请求只以文本形式返回代码，不会读取本地文件，也不会执行断言。先检查返回代码，再运行。

截至 2026-11-12，BetterToken 的目录也列有 claude-fable-5-2。其 Claude Code 接入说明使用 Base URL https://bettertoken.ai。身份验证需单独按该接入路径的说明配置。目录中列有模型，并不能证明所有 effort 和 fast mode 参数均受支持。

区分 token 单价与完成任务的总成本

按标准 API 价格计算，Fable 5.2 的 token 单价低于 Fable 5.1，但为 Opus 5.5 的两倍。下表是截至 2026-11-12 Anthropic 的公开价格，以 USD 计价，单位为每百万 token。

模型，标准速度	未缓存输入	输出
Claude Fable 5.1	$10	$50
Claude Fable 5.2	$8	$40
Claude Opus 5.5	$4	$20
Claude Sonnet 5.5	$2	$10

从 Fable 5.1 到 5.2，输入和输出单价都降低了 20%。这是单位价格下降，并不保证每次会话的账单也减少 20%。

Fable 5.2 在标准速度下，五分钟缓存写入为 $10，一小时缓存写入为 $16，缓存读取为 $0.20，均按每百万 token 计费。异步 Batch 批处理的输入/输出价格为 $4/$20；这不是 Claude Code 交互式会话的价格。

假设用量为 100,000 个未缓存输入 token 和 20,000 个计费输出 token，估算如下：

Fable 5.2: 0.1 × $8 + 0.02 × $40 = $1.60
Opus 5.5: 0.1 × $4 + 0.02 × $20 = $0.80

该计算假设使用标准速度和全球价格，不涉及缓存操作、付费工具或 Batch 折扣，也未计入适用税费。这里让两者消耗相同数量的 token，而实际代理会话中的用量往往不同。

Anthropic 的 FrontierCode 2.0 公告比较的是另一项指标。Fable 5.2 在 High effort 下得分为 45.3%，接近 Opus 5.5 的最佳成绩 45.5%，公布的单次任务成本约为后者的一半。这里比较的是 Fable High 与 Opus Max，既没有保持 token 用量相同，也没有保持 effort 相同。

Cursor 的当前 CursorBench 4.0 结果说明，结论取决于工作负载。Fable 5.2 High 得分为 56.9%，公布的成本为 $9.70；Opus 5.5 High 为 56.0%，成本为 $3.97。Fable 5.2 Max 达到 60.0%，成本为 $32.79。

这些是评测发布方给出的结果，不是订阅价格，也不是在你的代码仓库上测得的数据。Cursor 将 56.9% 这一行标为 High，不是 Claude Code 默认的 Medium。

参考按任务成本评估指南，把重试、失败尝试以及代理执行设置一并纳入比较。

只在输出速度重要时启用 fast mode

标准请求成功后，再为延迟敏感的工作开启 fast mode。Anthropic 宣称 token 生成速度最高可达标准速度的 2.5 倍；这不是整个编程任务都能加速 2.5 倍的保证。

直连 Messages API 时，保留模型 claude-fable-5-2，在请求体顶层添加以下字段：

"speed": "fast"

不需要 fast mode 专用的 beta 请求头。请求成功后，按 fast mode API 指南确认 usage.speed 为 "fast"。

截至 2026-11-12，Fable 5.2 fast mode 的输入/输出价格为每百万 token $16/$80。文档列出的 fast mode 默认限额适用于 Start、Build 和 Scale 用量等级。如果超过 fast mode 速率限制，API 会返回 429 和 retry-after 响应头。等待该响应头指定的时长，或者主动移除 speed，以标准速度重试。

在 Claude Code 中选择 Fable 5.2，然后运行 /fast。使用订阅套餐时，即使套餐内用量仍有剩余，fast mode 也会直接从 usage credits 余额扣费。启用前先检查 Claude Code 的使用条件。

通过 Google Cloud 的 Vertex/Agent Platform 使用 fast mode，需要 Claude Code 2.1.322 或更高版本。支持的区域是 global、us 和 eu；请按该服务商的专用说明配置。

上面的 cURL 配置用于 Anthropic 直连 API。不要原样复制到其他云服务商的端点。

迁移时如何避开相关的 400 错误

切换生产流量前，先审查请求参数和对话历史。自适应思考始终开启、不支持强制工具调用，这些限制在 Fable 5.1 和 Opus 5.5 中已存在，并不是 Fable 5.2 新增的。

Fable 5.2 兼容性说明记录了以下错误：

请求设置	结果	修复方式
`thinking: {"type": "enabled"}` 搭配 `budget_tokens`	`400`	省略 `thinking`，或使用 `{"type": "adaptive"}`。通过 effort 控制思考深度。
`thinking: {"type": "disabled"}`	`400`	移除此设置。自适应思考无法关闭。
`tool_choice: {"type": "any"}`	`400 invalid_request_error`	使用 `{"type": "auto"}`，并处理模型可能返回文本回复的情况。
`tool_choice: {"type": "tool", "name": "..."}`	`400 invalid_request_error`	移除强制选择，在应用中处理工具选择。

需要工具参数符合 schema 时，可在支持的环境中同时使用自动工具选择和 strict: true。严格模式约束的是参数，并不会强制模型调用工具。JSON outputs（结构化 JSON 输出）也是一种选择。

如果组织使用客户管理的加密密钥，则 Fable 5.2 的严格工具调用和 JSON outputs 均不可用。此时，在应用代码中验证输出。

迁移时的一项重要变化，是对话前缀检查更严格。Fable 5.2 对所有账号执行这项检查，也包括此前同类 Fable 5.1 请求能够通过的旧账号。

错误信息中会出现这句：

The block is bound to a different conversation.

如果修改 system 提示词、tools 或更早的对话内容后，再重发思考块，就可能触发此错误。重试同一个请求无法修复这种不匹配。

按照思考内容保留规则，保持已有前缀不变，在末尾追加新消息，并原样回传助手响应的内容数组。对于简单集成，替换原始系统提示词或工具定义时，建议开启新对话。

使用 computer use 或 advisor 工具的应用，还应在部署前阅读完整迁移指南。

长任务要调整 effort，并自行确认是否完成

用 effort 设置控制思考，不要只靠提示词措辞。Anthropic 表示，在 medium 及以上级别，要求模型不加思考地回答，并不能抑制 Fable 5.2 的思考。

该模型的提示词指南还提到，多步骤任务可能提前结束，尤其是在 low 和 medium 下。end_turn 只代表本轮回复结束；整个任务是否完成，仍要由你的验收检查决定。

对于范围明确的代码仓库任务，应写清完成条件。下面的提示要求完成修改和测试，但遇到缺失凭据、破坏性操作或需要改变任务范围的决定时，停止并报告：

Complete the requested change and run the relevant tests.
Do not stop after a plan or a list of remaining steps.
Continue through ordinary implementation failures within the approved scope.
Stop and report the blocker if you need unavailable credentials,
destructive actions, or a decision that changes the requested scope.
Do not start subagents for this trial.

长时间编程任务可以用 medium 作为基线，再与 high 比较。只有实测收益足以抵消额外开销时，才尝试 xhigh。把 max 留给能力上限测试，或失败代价特别高的少数任务。

任务委派也会改变成本。Anthropic 表示，代理运行系统鼓励委派时，Fable 很容易把工作交给子代理。子代理可能消耗会话预算中的很大一部分。将整笔账单归因于主模型前，先记录子代理所用的模型和用量。

日常开发应该保留哪个模型？

如果 Sonnet 5.5 的输出已经满足要求，就继续用它处理范围明确、测试清晰的改动。它的 token 单价较低，适合作为重复性修改的首个试用选项。当代码审查发现遗漏的依赖关系，或需要反复修复时，再换用更强的模型。

一般的代码仓库工作继续用 Opus 5.5，除非 Fable 带来可衡量的改善。Opus 选择指南介绍了如何切回并保持这一选择。

对于提高 effort 后的 Opus 仍然处理不好的复杂诊断、跨文件改动和长时间迁移，再测试 Fable 5.2。当它能让更多改动通过验收，或降低完成任务的总成本，且收益足以抵消较高的 token 单价时，再选择它。

接入验证完成后，用同一个起始提交和相同的验收测试比较模型。记录 effort、耗时、缓存用量、子代理用量和所有失败尝试。保留能通过实际检查且成本更低的配置；不要用单一基准分数替代这个决定。