要在 Claude Code 中使用 Claude Fable 5.1，先升级到 Claude Code 2.1.255 或更新版本，然后在会话中运行 /model fable，或者用 claude --model fable 开启新会话。Fable 5.1 支持 low、medium、high、xhigh、max 五档 Effort，模型默认值是 high。你可以用 /effort 在速度、Token 消耗和推理深度之间做调整。
选择模型后，运行 /status 核对真正生效的账号和模型路由。如果 Fable 没显示或请求失败，请依次检查 Claude Code 版本、当前凭证、组织限制、Provider 配置和 Usage Credits。不要因为付费方案、picker 里的一行模型或一把可用 API Key，就推断其他访问条件也一定满足。
事实核验于 2026 年 9 月 9 日。 模型 alias、最低版本、Effort 控制、可用范围和计费规则都可能变化。请把 Anthropic 当前模型配置文档、实时
/modelpicker、/status，以及账号或组织后台作为最终依据。
60 秒完成设置
先检查 Claude Code 版本，必要时更新：
然后用默认的 high Effort 开启一个新的 Fable 5.1 会话：
也可以在已有交互式会话中切换：
Anthropic 当前的 Claude Code 模型配置文档写明：除非管理员或 Provider 配置覆盖了这个 alias，否则 fable 当前会解析到 Fable 5.1。该文档也把 2.1.255 列为 Fable 5.1 所需的最低 Claude Code 版本。
本文只解决 Claude Code CLI 中的使用问题。如果你想看 API 价格、Prompt Caching 和它在 Coding Agent 中的整体定位，请阅读单独的 Claude Fable 5.1 模型指南。
显式选择 Fable 5.1
Fable 不是任何 Claude 方案或 Provider 的账号默认模型，因此你需要主动选择它。
在当前会话中切换
运行：
这会让 Claude Code 选择 fable alias 当前对应的模型。只运行不带参数的 /model，则会打开 picker。如果当前对话已经有输出，Claude Code 可能会要求确认切换，因为下一条回复要让新模型重新读取已有历史。
用 Fable 开启一个干净会话
运行：
如果任务应该从干净上下文开始，并且你想明确指定模型家族，这种方式更清楚。你也可以加上 --effort high 或其他支持的档位，让该会话的 Effort 选择保持显式。
Alias 的优点是简单，但它会跟随 Anthropic 推荐的 Fable 版本变化。本文核验时，它对应 Fable 5.1。如果受审计的工作流必须固定到精确版本，请先确认当前完整 Model ID 和对应 Provider 的映射，再写入设置。Anthropic API ID、Amazon Bedrock 标识和 Gateway alias 不能直接假设为互相通用。
在五档 Effort 之间选择
Fable 5.1 支持当前全部五档 Effort。如果没有已保存设置、命令行参数、环境变量或组织策略覆盖，high 就是模型默认值。
要交互式选择，可以运行 /effort 打开滑块，也可以直接设置：
你还可以在 /model 中选择支持 Effort 的模型时调整滑块，或者在启动时只为本次会话指定：
运行 /effort auto 可以清除当前模型已保存的 Effort，让它回到默认行为。Claude Code 通常会按模型保存 low、medium、high、xhigh，供后续本地会话继续使用。除非通过相应环境变量强制设置，max 只作用于当前会话。组织管理员也可以限制成员可用的最高档位。
Anthropic 当前的 Effort 指南建议 Fable 5.1 从默认的 high 开始：只有对能力敏感的任务才升档；只有在评测证明质量仍能维持时才降档。Effort 是行为控制，不是固定 Token 预算；同一个档位名称在不同模型上也会单独校准。
Fable 5.1 的 Adaptive Thinking 不能关闭
Fable 5.1 始终使用 Adaptive Thinking（自适应思考）。模型会依据每一步的复杂度和当前 Effort，自己决定是否需要思考以及思考多深。这不代表每个简单请求都一定生成很长、可见的推理内容。
Claude Code 常见的 thinking 开关、alwaysThinkingEnabled 和 MAX_THINKING_TOKENS=0 都无法关闭 Fable 5.1 的 thinking。常规任务如果不需要默认深度，应降低 /effort；只有任务和验收标准确实值得时才升档。
还要区分两个名字相近、但界面不同的控制：
- Claude Code 的
/effort和--effort，控制本文讨论的交互式或启动时 CLI 会话。 - Claude API 的 per-message effort，是 API 应用通过单条请求的
output_config改变 Effort；它不是 Slash Command，也不能直接粘贴进 Claude Code 当命令使用。
排错时，这个区别很重要。为直接 API 调用编写的代码示例，不能证明当前 Claude Code 会话实际保存了什么设置。
Fable 5.1 不显示或无法运行怎么办
请按下面顺序排查，并在同时修改多个设置之前先保留完整错误信息。
1. 检查 Claude Code 版本
运行 claude --version。Fable 5.1 至少需要 2.1.255。如果版本更旧，先运行 claude update，重新开启会话，再试一次 /model fable。
如果电脑里有不止一份 Claude Code，请从真正要运行任务的终端、IDE、Desktop 界面或远程环境检查版本。更新其中一份，不会自动更新其他位置的副本。
2. 不要只看 picker，试一下直接输入 alias
当 Claude Code 直连 Anthropic API 时，只有服务器向当前组织报告 Fable 可用，picker 才会显示它。Anthropic 文档说明，直接输入 /model fable 会向服务器检查可用性，因此即使 picker 暂时没有这一行，命令仍可能成功。
如果直接命令也被拒绝，请保留原始提示。它能帮助区分账号尚无资格、组织限制、客户端版本过旧，以及 Provider 映射无法识别等问题。
3. 确认账号和凭证
运行 /status，检查当前使用的 Claude 账号、组织和认证路径。订阅账号、Claude Console API Key、Cloud Provider 凭证和 Gateway 属于不同的计费与策略边界。
环境变量或受管理配置可能覆盖你以为正在使用的账号。求助时不要公开 API Key、Token 或未打码的凭证文件。
4. 检查组织限制和 Provider 映射
Enterprise 管理员可以按组织或自定义角色限制模型访问。受管理的 availableModels 设置也可能隐藏或拒绝某个模型。如果整个 Fable 家族都被禁止，family alias 就无法选中任何 Fable 版本。
第三方 Provider 和 LLM Gateway 可能使用自己的模型标识，也可能通过 ANTHROPIC_DEFAULT_FABLE_MODEL 覆盖 alias。请向管理员确认启用的是哪个 Fable 部署，以及 alias 是否指向该部署。没有确认映射前，不要把 Anthropic API ID 直接复制到另一家 Provider 的配置中。
5. 检查 Usage Credits 和当前方案路径
根据方案和席位档位，Fable 请求可能消耗 Usage Credits，而不是套餐内额度。Claude Code 可以在 picker 中把该模型标成 “Requires usage credits”，并在交互式会话真正计费前请求确认；由组织统一付费的 Enterprise 成员可能看到不同的确认流程。
能够选择模型，不等于当前账号一定有可用余额或获批的消费额度。请检查实时账号设置和账单归属。Claude Code 价格指南区分了订阅额度、Usage Credits 与 Console API 账单。如果遇到的是额度或余额错误，而不是模型选择问题，请转到 Claude Code 用量限制排错指南。
如果仍然无法解决，请收集客户端版本、使用的命令、Provider、账号和组织名称、不含秘密的 /status 输出，以及完整错误文本。与反复重装 CLI 或切换凭证相比，这些证据更能帮助定位问题。
用真实任务决定 Effort
Anthropic 把 Fable 5.1 定位在困难、长时程工作上。这是厂商定位，不是它在你的仓库里一定最好或最便宜的独立证据。
先选择一个范围明确、结果可 Review 的任务，例如跨模块缺陷调查、困难的架构审查，或带明确测试的迁移。在比较不同 Effort 时，尽量保持起始代码、指令、工具、权限和验收标准一致。
不要用回答长度判断效果，而应记录：
- 通过了哪些检查、遗漏了哪些缺陷；
- 返工轮数与 Review 时间；
- 总耗时和中断情况；
- 能看到时，记录输入、输出和缓存 Token；
- 最终改动是否保持在要求的范围内。
把 high 当作基线。常规工作可以尝试 medium 并比较质量；只有困难任务确实有明显改进空间时，再尝试 xhigh 或 max。一个只有一行的修改，不会因为用了最贵的推理设置就自然变得更好。
Agent.Space 在这套流程中的位置
Claude Code 是 Agent harness，Fable 5.1 是模型，Agent.Space 则提供独立的 Agent 和持久化 Workspace 产品层。这些部分可以服务同一项目，但不是可以互相替代的订阅，也不能互相保证模型权限。
Agent.Space 独立于 Anthropic。本文不声称 Agent.Space 上的 Claude Code 当前已经提供 Fable 5.1。可用的 Agent 与模型组合应以 Agent.Space 实时选择器为准；Agent.Space 上的 Claude Code 指南会进一步说明外层 Workspace 工作流和产品边界。
如果持久化 Workspace 适合你的项目，可以从 Agent.Space 开始：先确认当前账号显示的 Agent、模型和价格，再用一个拥有明确验收标准的小任务开启首个会话。
常见问题
Claude Code 用什么命令选择 Fable 5.1？
在会话中运行 /model fable，或用 claude --model fable 开启新会话。截至 2026 年 9 月 9 日，除非管理员或 Provider 配置覆盖，fable alias 会解析到 Fable 5.1。
Fable 5.1 对 Claude Code 版本有什么要求？
至少需要 Claude Code 2.1.255。先运行 claude --version，必要时再运行 claude update。
Fable 5.1 的默认 Effort 是什么？
模型默认值是 high。按模型保存的偏好、--effort、/effort、环境变量或组织策略都可能改变最终生效的档位。
Fable 5.1 可以关闭 thinking 吗？
不可以。Fable 5.1 始终使用 Adaptive Thinking。请通过合适的 Effort 控制深度；Claude Code 常见的 thinking-off 控制对该模型无效。
为什么 /model 里没有 Fable？
服务器可能没有向当前组织报告可用权限，客户端可能早于 2.1.255，管理员可能限制了该模型，或者 Provider 映射缺失。先试 /model fable，再依次检查版本、/status、组织策略、Provider 和 Usage Credits。
Claude Code 的 /effort 等于 API per-message effort 吗？
不等于。两者都影响能力与成本的取舍，但属于不同界面。本文使用 Claude Code 的 /effort 和 --effort；直接调用 API 的应用则需要在请求参数中配置 per-message effort。