Claude Code · 2026 年 11 月 16 日核实
在 Claude Code 里使用 Claude Fable 5.2
Fable 5.2 不是任何套餐的默认模型,必须手动选择。本文列出全部切换方式、费用规则,以及 Anthropic 建议的提示词写法。
一句话答案
在会话里输入 /model fable,或用 claude --model fable 启动,就能在 Claude Code v2.1.321 及以上选中 Claude Fable 5.2。Pro、Max、Ultra、Team、Enterprise 套餐都可以选择 Fable,但它永远不是账号默认模型;视套餐与席位等级,Fable 的用量可能不计入套餐额度,而是走 usage credits。
需要 Claude Code v2.1.321 及以上 · Anthropic 文档核实于 2026-11-16
三种切换方式,两个环境变量
Anthropic 文档列出五个可以设置模型的位置。日常你只会用到前三个,两个环境变量负责脚本和整机默认值。
/model fable —— 会话中途切换
输入 /model fable 立即生效,并把选择写入用户设置的 model 字段,之后的新会话就以 Fable 5.2 启动。直接输入 /model 会打开选择器:Enter 切换并保存为默认,按 s 只对当前会话生效。
claude --model fable —— 启动时决定
该参数只对这次启动的会话生效,不会被保存——这正是同时在一个终端跑 Fable、另一个终端跑 Opus 的正当做法。claude --model claude-fable-5-2 用完整 ID 指定同一个模型。
model 字段 —— 设为默认
在 ~/.claude/settings.json 或项目的 .claude/settings.json 里写 "model": "fable",新会话就会以 Fable 5.2 启动。写在项目设置或托管设置里的 model 每次启动都重新生效,优先级高于 /model 保存的值,启动头部会注明是哪个文件设置的。
ANTHROPIC_MODEL 与 ANTHROPIC_DEFAULT_MODEL
ANTHROPIC_MODEL 决定用该变量启动的那个会话用哪个模型。ANTHROPIC_DEFAULT_MODEL(v2.1.236 及以上)决定新会话的默认模型,但只有在启动参数、环境变量、设置文件和组织默认都没有指定模型时才生效。第三个变量 ANTHROPIC_DEFAULT_FABLE_MODEL 改变的是 fable 这个别名本身指向哪个模型。
谁的优先级最高
Anthropic 的顺序,从高到低:会话中的 /model、启动时的 --model、ANTHROPIC_MODEL、设置文件里的 model,最后是 ANTHROPIC_DEFAULT_MODEL。前两项与 ANTHROPIC_MODEL 只对本次会话有效;/model 和设置字段会持久保存。
就是这一行
"model": "fable"
别名跟随 Anthropic 的 Fable 默认值:除非设置了 ANTHROPIC_DEFAULT_FABLE_MODEL,fable 在除 Claude apps gateway 会话以外的地方都解析为 Fable 5.2,而在那种会话里解析为 Fable 5;未配置 claude-fable-5-2 的 gateway 会直接拒绝该模型 ID,所以在那里请用 /model claude-fable-5-2。想锁定版本,就在这个文件里写完整 ID。
各方式的生效范围
同样的五步,换一张表看:写在哪里,能不能跨会话保留。
| 设置位置 | 写法 | 生效范围 |
|---|---|---|
| /model 会话中 | /model fable | 本次会话,并保存为默认 |
| --model 启动参数 | claude --model fable | 仅本次会话 |
| ANTHROPIC_MODEL | ANTHROPIC_MODEL=fable | 仅本次会话 |
| settings.json 的 model 字段 | "model": "fable" | 所有新会话 |
| ANTHROPIC_DEFAULT_MODEL | ANTHROPIC_DEFAULT_MODEL | 未指定模型时的新会话 |
优先级自上而下:靠上的行覆盖靠下的行。组织统一设置的默认模型也可能覆盖你保存的选择,但 --model 与 ANTHROPIC_MODEL 仍然优先。
谁可以选中 Fable 5.2
付费套餐与 API 都能用,零数据保留(ZDR)组织不能;没有任何套餐或供应商把它设为默认。
Pro、Max、Ultra、Team、Enterprise
这五个套餐正是 Anthropic 在说明「保存的 claude-fable-5-1 会自动改为 fable 别名」时点名的那几个,Fable 也会出现在它们的 /model 选择器里。Anthropic 没有把 Fable 设成任何套餐的默认:「No Fable model is the account-type default on any plan or provider.」
Anthropic API 与 Console
在 Anthropic API 上,Fable 会出现在 /model 选择器里,行内还标着价格;除非 availableModels 或组织模型限制把它排除。在 Amazon Bedrock、Google Cloud 和 Microsoft Foundry 上用的是各家自己的模型 ID,需要按该 ID 选择,或用 ANTHROPIC_DEFAULT_FABLE_MODEL 固定。
零数据保留组织不可用
Fable 5.2、5.1 和 5 都属于默认要求数据保留的 Covered Models。组织若不能使用,选择器里这一行会缺失或置灰,服务器端也会拒绝请求,改客户端设置没有用。
LLM gateway 与 Claude apps gateway
未配置提供 claude-fable-5-2 的 gateway 会拒绝该模型的请求。要经由支持它的 gateway 使用 Fable 5.2,请按 ID 指定:/model claude-fable-5-2。走自己的 ANTHROPIC_BASE_URL 时,Claude Code 仍按它认识的 1M 上下文窗口处理该模型。
Claude Code v2.1.321 及以上
Fable 5.2 需要 Claude Code v2.1.321 及以上(Fable 5.1 需要 v2.1.257)。版本偏旧时请求会失败,因为它不认识这个模型 ID——先跑 claude update,再开新会话。
费用,以及什么时候会走出套餐额度
先看每百万 token 的标价,再看决定这笔用量算套餐额度还是 usage credits 的套餐规则。
| 费率(美元 / 百万 token) | Claude Fable 5.2 | Claude Opus 5.5 |
|---|---|---|
| 输入 | $8 | $4 |
| 输出 | $40 | $20 |
| 缓存命中 | $0.2 | $0.2 |
| fast mode 输入 | $16 | $8 |
| fast mode 输出 | $80 | $40 |
Fable 5.2 的标价读自模型注册表,2026 年 11 月 11 日与 Anthropic 定价文档核对过;Opus 5.5 是 Anthropic 建议起步的模型。fast mode 按基础费率的 2 倍计费,且不能与 Batch API 合用。缓存与批量的完整拆解见 /claude-fable-5-2-pricing。
选择器里的「Requires usage credits」
视套餐与席位等级,Fable 用量可能不计入套餐额度,而是计到 usage credits。此时 /model 里 Fable 那一行会标注「Requires usage credits」。usage credits 按标准 API 费率在订阅之外单独计费。
Max 与 Ultra 另有 Fable 周额度
Anthropic 帮助中心写明:Max 和 Ultra 套餐在共享的周额度与 5 小时会话额度之外,还有一个单独的 Fable 周额度。触及其中任一额度、且已开启 usage credits,Fable 的请求才会转到 usage credits。
会话额度与周额度是所有模型共享的
5 小时会话额度和周额度按席位计算、所有模型共用,所以用 /model 换成小模型并不能恢复额度,提示信息会给出重置时间。
fast mode 费率翻倍
fast mode 用同一个模型,只是把速度置于成本之上。Fable 5.2 上按 16 美元输入 / 80 美元输出(每百万 token)计费,需要 Claude Code v2.1.321 及以上;在 Fable 5.2 上,只有你在使用 Fable 5.2 时打开过,fast mode 才会跨会话保留。可用性还取决于组织的 usage tier。
/usage 与 /usage-credits
/usage 显示套餐用量条、各模型的 token 数;开启 usage credits 后还会多一行,显示本月已用金额与上限。/usage-credits 打开你所在套餐的计费设置;Team / Enterprise 成员则会向管理员发起申请。
脚本模式不询问
在 -p 非交互运行和不会弹出确认的 Agent SDK 应用里,Fable 请求若会走 usage credits,Claude Code 不问就直接计费。在意成本就用 --max-budget-usd 给单次运行设上限。
effort、思考与上下文
Fable 5.2 默认 medium effort、始终思考,并默认使用 100 万 token 上下文。
五档 effort,按模型分别保存
Fable 系列支持 low、medium、high、xhigh、max。/effort 可以设置并保存该档位:滑杆里按 Enter 保存,按 s 只对本次会话生效;max 默认只对本次会话生效,除非用 CLAUDE_CODE_EFFORT_LEVEL 指定。Claude Code 把档位存在 modelSettings 里。
默认 medium,查 bug 时往上调
Fable 5.2 默认 medium,Anthropic 把它描述为适合范围明确的日常工作。high 用于需要反复验证、边界情况多的工作;max 适合你想放手让它啃的难题,Anthropic 也提醒它容易过度思考。提示词里写 ultrathink 只提高那一轮。
思考无法关闭
Fable 系列始终使用自适应推理。思考开关与 /config 会显示无法关闭,保存的 alwaysThinkingEnabled: false 或 MAX_THINKING_TOKENS=0 在此无效。想少花思考的 token,只能调低 effort。
默认 100 万 token
Fable 5.2 默认就是 100 万 token 窗口,不需要 [1m] 后缀,Bedrock、Google Cloud、Foundry 和 gateway 会话同样如此。会话大约在 96.7 万 token 处自动压缩,除非用 /autocompact 设一个更小的窗口。
安全分类器会切换会话模型
Fable 系列跑在安全分类器下,最常命中网络安全与生物领域。被标记的请求会改在 Opus 5(生物)或 Opus 4.8(网络安全)上重跑,之后会话继续留在那个模型,直到你执行 /model。想每次切换前确认,可在 /config 里选 Ask each time。
effort 是按模型校准的:同一个档位名在不同模型上并不代表同样的思考量,你在 Opus 5.5 上喜欢的档位不能原样照搬。
Anthropic 建议怎么给它写提示词
Claude Code 文档里给 Fable 的四条建议,这里按要点转述。
说清结果,而不是步骤
把你要的结果交给它,让它自己规划路径。如果工作要跨多个会话,给它设一个 goal,好让它继续朝那个结果推进。
把模糊的问题交给它
根因排查、线上故障定位、架构决策,正是它多做的调查与验证能回本的地方;有明确复现步骤的工单,用更便宜的模型就够了。
不必反复提醒它验证
它自己验证得比小模型勤,所以「记得测试、记得检查」这类常驻指令通常只是在浪费上下文。保留检查本身(测试命令、lint 目标),去掉唠叨。
把任务放大
把平时你会拆成几块的工作整块给它:它能长时间不跑题。代价也在这里——token 账单一并变大,头几次留意 /usage。
三条可以直接改用的提示词(我们的示例,不是 Anthropic 原文)
1. checkout 的测试在 CI 上间歇性失败,本地却一路通过。找出根因、修掉,并告诉我它为什么会时好时坏——不要停在第一个能解释症状的假设上。 2. 这次迁移由你负责到底:读 schema、给出方案、把构建跑绿,最后总结改动内容和我需要复核的风险。 3. 目标:/docs 下每个页面在冷缓存下都要在 1 秒内加载完成。逐条排查原因,能验证的直接修,把需要我决策的部分列成清单。
上面四条才是 Anthropic 的建议;这几条提示词是我们按那种风格写的示例。
来源
本页所有 Claude Code 相关说法都出自以下页面,读取日期 2026 年 11 月 16 日。
- Claude Code — Model configuration
Fable 专节、五个设置模型的位置、别名解析、effort 档位与自动回退。
- Claude Code — Speed up responses with fast mode
Fable 5.2 的 fast mode 为 16 / 80 美元每百万 token,需要 v2.1.321,以及跨会话保留规则。
- Claude Code — Manage costs effectively
/usage、usage credits、消费上限,以及共享的会话额度与周额度。
- Claude 帮助中心 — 付费套餐的额外用量
Pro、Max、Ultra 的 usage credits 按标准 API 费率计费;Max 与 Ultra 另有单独的 Fable 周额度。
- Claude Code — 零数据保留
Fable 5.2、5.1、5 属于要求数据保留的 Covered Models,因此 ZDR 组织无法选择。
- Claude API — 模型总览
claude-fable-5-2 模型 ID、1M / 128K 上限,以及 8 / 40 美元的标价。
- fable5.top — Claude Fable 5.2 定价
同一模型的缓存、批量与 fast mode 倍率,由本页读取的注册表推导。
Claude Code 迭代很快,模型相关的机制也跟着变:2026 年里别名、默认值和套餐规则都改过多次。如果 /model 里没有 Fable 5.2,先跑 claude update,再回看上文的模型配置文档——本页以那份文档为准。
要给团队铺开 Fable?用托管设置里的 model 统一起始模型,而不是让人手敲 /model;用 availableModels 配合 enforceAvailableModels 控制选择器;并记住零数据保留组织不允许使用 Fable。