2026年6月9日，Anthropic正式推出了Claude Fable 5。这款模型定位十分清晰，主要面向开发者使用Claude Code时最常见的任务——长周期自主编程会话，需要跨越整个代码库，并在庞大的上下文环境中维持逻辑连贯性。如果你已经在日常工程中顺利运用了Claude Code CLI，只需更改一个配置即可指向新模型，但其行为上的变化值得深入关注。本指南将带领你逐步完成：模型选择、生效确认、针对长时间自主运行调优以及成本控制。读完本文，你将清楚每种支持的模型如何配置、如何验证，以及在哪些场景下为它支付比Opus 4.8高出两倍的成本是值得的。
关于模型本身的技术细节，有专门文章介绍，本文仅聚焦于Claude Code的工作流程。
前提十分简单：安装并认证好Claude Code（v2.1.170或更高版本），然后使用/model fable或/model claude-fable-5切换即可。你也可以用claude --model fable启动，或者设置ANTHROPIC_MODEL=claude-fable-5环境变量，再或者在设置文件中固定写"model": "fable"。通过/status命令即可检查是否生效。价格方面，Fable 5每百万输入token收费10美元，每百万输出token收费50美元，正好是Opus 4.8的两倍。因此，长会话的规模需要谨慎权衡。
实际上，Anthropic打造Fable 5的目的就是长周期自主编程。官方宣称，该模型“在处理涉及数百万token的长期任务时能保持专注，还能自己记笔记来改进输出”。这与快速重构截然不同。一个很有说服力的案例：Stripe在测试期间用Fable 5完成了一次迁移——一天之内横跨5000万行Ruby代码的全库变更。Stripe表示，若由人工完成，需要整个团队两个多月。完整报告可在官方发布中找到。
当然，代价也很实在。Fable 5每百万输入token 10美元，输出50美元，是Opus 4.8（5和25美元）的两倍。因此，对“我是否应该一直开着Fable 5”这个问题，诚实的答案是：不。只有当你的任务确实属于长周期、且人工做同样事情的成本远高于token账单时，才开启它。日常编辑工作，Opus 4.8或Sonnet才是更靠谱的默认选择。如果你仍在权衡，可以参考那两篇模型对比文章来理清思路。
其实，如果你之前已经在Claude Code里换过模型，这套流程应该不陌生。与之前使用GLM-5.1的机制相同，只是模型ID换了名字。
前提条件
动手之前，请先检查这些条件：
- Claude Code需已安装并更新。Fable 5要求v2.1.170或更高版本。旧版本根本不会在模型选择器中显示Fable 5，选了也无法生效。运行
claude update升级，再用claude --version确认。 - Anthropic账户需拥有Fable 5的访问权限。在Anthropic API以及Max、Team Premium、Enterprise按需付费计划中，一旦你选中，就能使用Fable 5。它在任何账户类型中都不是默认模型，因此需要主动选择。
- API计费或符合条件的订阅。由于Fable 5是付费模型（每百万token 10/50美元），你的账户必须拥有活跃的API计费或包含它的计划。具体层级可查阅Anthropic的models overview。
- 要使用的代码仓库就绪。Claude Code在项目目录中运行。在想要让智能体操作的仓库中打开终端。
还有一点需要提前了解：Fable 5在零数据保留（ZDR）下无法使用。如果你的组织在运行Claude Code时开启了ZDR，模型选择器要么直接忽略Fable 5，要么显示其为禁用状态。这是政策限制，并非Bug。
设置 Claude Code 使用 Claude Fable 5
Claude Code提供了四种选择模型的方法，按优先级顺序生效。在会话开始时，最高优先级是会话内的/model选择，然后是--model启动标志，接着是ANTHROPIC_MODEL环境变量，最后才是设置文件中的model字段。每种方法对应Fable 5的具体值如下。
任何接受模型的地方，你都可以使用别名fable或完整模型名claude-fable-5。别名会解析成提供商推荐的Fable版本，并随时间更新；完整ID则固定到那个特定模型。完整参考可在Claude Code的模型配置文档中找到。
选项 1：使用 /model 在会话内切换
最快的办法还是直接在会话中切换。在运行中的Claude Code会话里输入：
/model fable
或者，如果想锁定精确的模型ID：
/model claude-fable-5
不传参数直接运行/model会打开选择器，你可以在列表中挑选Fable 5。在较新版本中，通过/model选择模型会把选择写入用户设置的model字段，从而成为新会话的默认模型。在选择器中，按回车键会切换并保存为默认值；按键则只针对当前会话切换。直接输入/model fable的行为类似回车，因此后续会话会一直使用Fable 5，直到你再次更改模型。
如果对话已有输出，选择器会在切换前要求确认，因为下一次响应会重新读取完整历史记录，无法使用缓存上下文。这很正常；在会话中途切换模型会带来一次性的重新读取成本。
选项 2：使用 --model 标志启动
如果只想启动单个Fable 5会话，又不想更改任何保存的默认设置，可以在启动时加上这个标志：
claude --model fable
或者使用完整ID：
claude --model claude-fable-5
这个--model标志只对用它启动的那次会话有效。这是在不同终端同时运行不同模型最干净的方法：每个窗口配置各自的--model标志，而不是使用/model切换（因为后者会写入共享默认设置）。
选项 3：设置 ANTHROPIC_MODEL 环境变量
如果你希望从shell启动的会话默认使用Fable 5，可以在启动前导出变量：
export ANTHROPIC_MODEL=claude-fable-5
然后运行claude。与标志类似，ANTHROPIC_MODEL只对它下面启动的会话有效。需要注意一个优先级细节：如果你同时在shell中导出，又在settings.json的env块中设置了ANTHROPIC_MODEL，shell导出会胜出，因为设置中的env对象在启动时应用，但不会覆盖预先存在的shell变量。
选项 4：在设置文件中固定
想让Fable 5成为跨会话的持久默认设置，就把model字段写进设置文件。用户设置位于~/.claude/settings.json；项目范围设置位于.claude/settings.json（或者.claude/settings.local.json，后者优先级更高但只对你个人有效）。一个最小化的设置文件大致如下：
{"model": "claude-fable-5"}
别名在这里同样可用：
{"model": "fable"}
项目设置和托管设置拥有优先权，并在下次启动时重新应用。因此，如果团队成员的/model选择和项目默认设置冲突了，重启时项目设置会生效。这是企业用来标准化团队模型的机制。
验证你是否正在使用 Fable 5
千万别想当然地认为切换成功了。在开启昂贵的长时间运行任务之前，请先确认活跃模型。两种方法很可靠：
- 运行
/status。在Claude Code会话中，/status会显示当前活跃模型和你的账户信息。这是最权威的检查方式。 - 查看状态栏。如果你配置了状态栏，活跃模型会一直显示在那里，无需打开菜单即可确认。
如果你选择了Fable 5之后，/status仍显示Opus 4.8而非Fable 5，最常见的原因是项目设置或托管设置在启动时覆盖了你的选择。当启动时的活跃模型来自项目或托管设置时，启动页眉会告诉你它是由哪个设置文件设定的。运行一次/model可以给当前会话覆盖；项目设置会在下次启动时重新应用。
另外需要注意：Fable 5会对网络安全和生物内容运行安全分类器。当分类器标记了某个请求时，Claude Code会自动在默认的Opus模型（Anthropic API上是Opus 4.8）上重新运行该请求，并在日志中显示通知。所以，即使你选择了Fable 5，个别请求也可能静默地在Opus 4.8上运行。Anthropic报告称，超过95%的Fable会话不涉及回退，因此普通应用程序代码很少遇到这种情况，但这解释了为什么偶尔会看到“已切换到Opus”的通知。想在回退后回到Fable 5，再运行一次/model fable即可。
将 Claude Code 与 Apifox 配合使用
当Claude Code写完或修改完API之后，接下来的问题就是这些端点是否真的能正常工作。一次长时间自主运行可能会触及几十个路由，阅读diff和确认API返回预期结果是两回事。这正是Apifox切入工作流的地方：Claude Code负责写代码，Apifox负责验证实时行为。
具体在Claude Code会话修改完API之后，工作流如下：
- 让Claude Code输出或更新OpenAPI规范。如果你的项目维护有OpenAPI文档，让智能体在修改实现时同时更新文档。如果没有，就让它为改过的路由生成一个。规范是代码和测试工具之间最干净的交接方式。
- 把规范导入Apifox。在Apifox中，创建或打开一个项目，导入OpenAPI文件。Apifox会读取路径、方法、参数和Schema，把每个端点转成可运行的请求，这样就不用手动输入URL了。
- 运行请求。针对本地或测试服务器调用修改后的端点。发送真实请求，检查状态码、响应头和响应体，确认响应与代码逻辑一致。
- 根据Schema验证响应。Apifox可以检查每个响应是否符合规范中的Schema。这能捕捉到代码返回内容与契约承诺之间的偏差——这是快速、自动化变更最容易出问题的地方。
- 把请求保存为测试用例。一旦端点通过验证，就把这些请求留下来做回归测试套件。下次Claude Code或任何人修改这些路由时，只需重新运行套件，就能立即发现功能是否损坏。
这种配合在使用长周期模型时尤为关键。自主变更的范围越大，需要验证的表面积就越多。通过Apifox里可运行的测试套件，就能把“智能体说它完成了”转化为“端点已确认正常工作”。
