如何一起使用 Claude Fable 5与Claude Code

Anthropic 于 2026 年 6 月 9 日发布了 Claude Fable 5，其核心用例正是开发者最常使用 Claude Code 处理的任务：跨越整个代码库、能够保持逻辑连贯的长时自主编程会话（long, autonomous coding sessions）。如果你已经在日常工程中使用 Claude Code CLI，那么将其指向新模型只需一个简单的配置更改，但会带来显著的行为差异。本指南将全程引导你在 Claude Code 中运行 Claude Fable 5，从模型选择、确认生效，到长时自主运行的调优以及成本控制。读完本文，你将掌握每种受支持的模型设置方式、验证方法，以及在何种场景下值得支付比 Opus 4.8 高出 2 倍的成本。

如果你在配置之前想深入了解模型本身，请参阅 what is Claude Fable 5。本文将专注于 Claude Code 的工作流。

安装并认证 Claude Code（v2.1.170 或更高版本），然后通过会话内命令 /model fable 或 /model claude-fable-5 将模型设置为 Fable 5。你也可以使用 claude --model fable 启动，导出环境变量 ANTHROPIC_MODEL=claude-fable-5，或者在设置文件中固定 "model": "fable"。使用 /status 进行确认。Fable 5 的价格为 $10/M input 和 $50/M output，是 Opus 4.8 的 2 倍，因此请谨慎评估长会话的范围。

为什么在 Fable 5 上运行 Claude Code

Claude Code 是 Anthropic 官方的命令行编程智能体（agent）。它运行在 Anthropic 模型之上，可以编辑仓库中的文件、执行命令，并在你的终端驱动多步任务。其背后的模型决定了它在“断片”之前能走多远，而这正是 Fable 5 改变游戏规则的地方。

Anthropic 为长周期自主编程构建了 Fable 5。用官方的话说，该模型“在处理涉及数百万个 token 的长期任务时能保持专注，并利用自身的笔记改进输出”。这与快速的重构工作完全不同。Anthropic 发布的一个证明点是 Stripe 在测试期间进行的一次迁移：Fable 5 在一天内完成了跨越 5000 万行 Ruby 代码的全库变更，该公司表示，如果由人工完成，这需要一个团队花费两个多月的时间。你可以在 Claude Fable 5 announcement 中阅读完整报告。

权衡之处在于价格。Fable 5 的定价为每百万输入 token 10 美元，每百万输出 token 50 美元，是 Opus 4.8（分别为 5 美元和 25 美元）的两倍。因此，对于“我是否应该一直运行 Fable 5”的诚实回答是：不。只有当任务确实属于长周期任务，且人工完成相同工作的成本远超 token 账单时才运行它。对于常规编辑，Opus 4.8 或 Sonnet 是更好的默认选择。如果你正在权衡这两者，Claude Fable 5 vs Opus 4.8 详细分析了各自的优势。

如果你以前在 Claude Code 中更换过模型，这也会是一个熟悉的过程。这里的机制与 running GLM-5.1 with Claude Code 中涵盖的机制相同，只是 model id 发生了变化。

前提条件

在设置模型之前，请确保满足以下条件：

已安装并更新 Claude Code。 Fable 5 需要 Claude Code v2.1.170 或更高版本。旧版本不会在模型选择器中显示 Fable 5，也无法选择它。运行 claude update 进行升级，然后通过 claude --version 确认。
拥有 Fable 5 访问权限的 Anthropic 账户。 在 Anthropic API 以及 Max、Team Premium、Enterprise 按需付费等计划中，一旦选择即可使用 Fable 5。它在任何账户类型中都不是默认模型，因此你始终需要主动选择。
API 计费或符合条件的订阅。 由于 Fable 5 是付费模型（$10/$50 每百万 token），你的账户需要有活跃的 API 计费或包含该模型的计划。请在 Anthropic models overview 中查看当前的层级。
要工作的代码仓库。 Claude Code 在项目目录内运行。请在你想让智能体操作的仓库中打开终端。

有一个值得提前了解的限制：Fable 5 在零数据保留（zero data retention, ZDR）下不可用。如果你的组织在启用 ZDR 的情况下运行 Claude Code，模型选择器要么会忽略 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 参考位于 Claude Code model configuration docs。

选项 1：使用 /model 在会话内切换

这是最快的方法，也是大多数人使用的方法。在运行中的 Claude Code 会话内，输入：

/model fable

或者，固定精确的模型 id 而非别名：

/model claude-fable-5

运行不带参数的 /model 会打开选择器，你可以从列表中选择 Fable 5。在最近的版本中，通过 /model 选择模型会将其写入用户设置的 model 字段，从而保存为新会话的默认模型。在选择器中，按回车键（Enter）会切换并将其保存为默认值，而按 s 键则仅针对当前会话切换。直接输入 /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 会显示当前活跃模型以及你的账户信息。这是最权威的检查方式。
查看状态栏。 如果你配置了 status line，活跃模型会持续显示在那里，因此你无需打开菜单即可一目了然地确认。

如果在你选择 Fable 后，/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 中可运行的测试套件，你可以将“智能体说它完成了”转化为“端点已确认正常工作”。你可以在几分钟内下载 Apifox 并导入现有规范。