截至 2026 年 9 月 24 日，Claude Fable 5.1 已经正式开放（9 月 1 日发布，不需要申请），Pro、Max、Team、Enterprise 这些付费套餐都能用，Free 套餐不能用（见 Anthropic 帮助中心的 Fable 模型套餐说明）。所以 Claude Code 里"看不到"通常不等于"没有权限"，先做两步：
- 在终端运行
claude --version，确认版本是 2.1.257 或更新。低于这个版本就先升级，然后开一个新会话。 - 在会话里直接输入
/model claude-fable-5-1（中间是短横线，不是5.1）。
第二步如果提示已切换到 Fable 5.1，说明账号能用，只是 /model 列表没把它列出来，接着用就行。如果弹出报错，把报错原文和下面的对照表比一下，基本能定位到是版本、计费、组织设置还是 API 线路的问题。
先按你看到的现象对照
同样是"找不到 Fable 5.1"，屏幕上的表现不一样，原因和处理也完全不同。
| 你看到的 | 最可能的原因 | 先做什么 |
|---|---|---|
/model 列表里只有一行 "Fable"，描述写的是 Fable 5 | 客户端低于 2.1.257；或版本够新但列表没更新（有用户报告的已知问题） | 查版本；版本够新就直接输入 /model claude-fable-5-1 |
| 列表里一行 Fable 都没有 | Free 套餐、组织禁用了 Fable、管理员的 availableModels 没放行，或走的是第三方平台 | 用 /status 看登录账号和当前模型，再按下文"企业"或"第三方"两节处理 |
| Fable 行是灰色的，旁边有说明 | 组织整体不能用 Fable，例如开启了零数据保留（ZDR） | 本地改不了，找管理员 |
| Fable 行写着 "Requires usage credits" | 能用，但你的套餐按用量额度计费 | 开通用量额度，或换模型 |
API Error: 400 Claude Code 2.1.xxx does not support this model; version ... or newer is required | 客户端版本太旧 | 升级后开新会话 |
输入 /model claude-fable-5.1 后报 not found 类错误；或把它写在 --model、ANTHROPIC_MODEL、model 设置里，第一次请求时报 There's an issue with the selected model | ID 写错（用了点号）。以 claude- 开头的名称能通过本地校验，要等请求时才会失败 | 改成 claude-fable-5-1 |
通过桌面版、Remote Control 或 Agent SDK 切换时报 Model "..." is not a recognized model id | 传入的是 Fable 5.1 这类显示名，或 fable-5-1 这类短 ID | 改用 fable 别名或完整 ID claude-fable-5-1 |
Model 'claude-fable-5-1' is restricted by your organization's settings | 组织管理员限制了这个模型 | 找管理员开通 |
There's an issue with the selected model (...) 或 Model '...' not found | ID 拼错，或当前账号、平台、网关没有提供这个模型 | 核对 ID，再确认线路是否提供 |
| Remote Control 里选模型时显示 "Update to use this model" | 远程服务还在跑旧版本，或该入口在服务端未开放（用户报告） | 重启远程服务；仍不行就改用本地会话 |
| 选中了 Fable 5.1，用着用着变成 Opus，或被额度提示拦住 | 这是计费或安全切换的问题，不是"看不到" | 见 Claude Fable 5.1 使用限额：周额度、额外付费与模型切换 |
表中的报错和界面文字是 Claude Code 实际显示的英文原文，可以直接拿来比对或搜索；下面各节按原因展开。
版本：以 2.1.257 为准，而不是 2.1.255
官方几处给出的最低版本并不一致：
- 帮助中心的 Fable 套餐说明写的是 2.1.255；
- Claude Code 文档的 Work with Fable 和 第 36 周更新说明写的是 2.1.257；
- 9 月 1 日有用户在 GitHub issue #91345 贴出的服务端报错，要求的是 2.1.251。
npm 上 @anthropic-ai/claude-code 的发布记录可以解开这个矛盾：2.1.252 在 8 月 31 日发布，下一个版本直接是 9 月 1 日的 2.1.257，2.1.253 到 2.1.256 从来没有发布过。三个门槛里最高的是 2.1.257，而它本身就是可安装的版本，所以装到 2.1.257 或更新，无论按哪一种说法都满足。另外，fable 这个别名也是从 2.1.257 起才指向 Fable 5.1，更早的版本里 /model fable 选到的是 Fable 5。
服务端真正卡的是哪个版本，以你收到的 400 报错里写的数字为准；报错原文和处理方式见 Claude Code 的错误说明。
按安装方式升级
| 安装方式 | 升级命令 | 需要注意 |
|---|---|---|
| 原生安装 | claude update | 会在后台自动更新，但要下次启动才生效，旧会话还是旧版本 |
| npm 全局安装 | npm install -g @anthropic-ai/claude-code@latest | 不要用 npm update -g，它可能停在旧的版本范围里 |
| Homebrew | brew upgrade claude-code 或 brew upgrade claude-code@latest | 不会自动更新；claude-code 跟的是稳定版通道 |
| WinGet | winget upgrade Anthropic.ClaudeCode | 不会自动更新 |
| apt / dnf / apk | 用对应包管理器升级 | 不会自动更新，需要手动升级 |
| Claude 桌面版 | 更新桌面应用本身 | 桌面端自带 Claude Code，终端里升级不影响它 |
以上命令来自 Claude Code 的安装与更新文档。升级后用三件事确认真的生效：claude --version 显示新版本；claude doctor 能看到最近一次自动更新的结果；关掉旧会话，重新开一个。
Claude Code 有两个更新通道，由 autoUpdatesChannel 设置控制：最新版通道（latest，默认）和稳定版通道（stable，通常比最新版晚一周左右）。9 月 1 日 Fable 5.1 发布时，稳定版通道还停在 2.1.236，所以当时稳定版用户会被版本报错挡住。截至 9 月 24 日，稳定版是 2.1.273，最新版是 2.1.281，两个通道都已经高于 2.1.257。现在仍然低于 2.1.257，多半是用了不会自动更新的包管理器、公司设置了 DISABLE_UPDATES 禁止更新，或者一个长时间运行的进程还在用旧版本。
一次检查分清"列表没显示"和"没有权限"
/model 列表和实际能不能调用，走的不是同一条路。Claude Code 文档写得很明确：在 Anthropic API 上，列表只有在服务端报告你的组织可以使用 Fable 之后才会列出它，而直接输入 /model fable 会去服务端当场确认。所以最省事的检查就是开头那一步：
/model claude-fable-5-1如果你的套餐按用量额度计费，交互会话里 Claude Code 会在 Fable 请求计费前先弹出确认，你可以继续，也可以换回默认模型。
想确认真正回答你的是哪个模型，可以在终端跑一次非交互调用：
claude --model claude-fable-5-1 -p "Reply with exactly: OK" --output-format json返回结果里的 modelUsage 字段会列出实际用到的模型。看到 claude-fable-5-1，说明账号和当前线路都能调用 Fable 5.1，问题只在列表显示；如果报错，就回到上面的对照表。先知道一个代价：在 Pro、Team 标准席位这类按用量额度计费的套餐上，-p 模式不会弹出确认，会直接从用量额度扣费（只有一句话，消耗很小，但不是零）。
能调用但列表里没有：已知的显示问题
GitHub 上有几份仍未关闭的用户报告，描述的正是这种情况：
- #91852 与 #94638：Max 账户（包括个人 Max 5x，版本从 2.1.259 到 2.1.276 都有人复现），
/model列表只有 "Fable"（即 Fable 5），没有 5.1；但/model claude-fable-5-1和上面的非交互调用都成功。 - #91885 是反过来的情况：企业组织开放了 Fable 5、限制了 Fable 5.1，结果列表里一行 Fable 都没有；输入
/model fable时会提示改用 Fable 5，/model claude-fable-5可以直接用。
截至 9 月 24 日，Anthropic 没有公开说明原因，也没有给出修复时间。实际处理很简单：直接输入 /model claude-fable-5-1，它会同时保存为新会话的默认模型，以后不用每次重选。报告里提到 ~/.claude.json 里的缓存字段，那是客户端内部数据，官方没有提供任何手动修改的说明，改了也可能被覆盖，不建议动。
切换了但没生效：看是谁盖过了你的选择
/model 会把选择写进 ~/.claude/settings.json，但下面几种情况会让新会话用上别的模型（见文档 A new session starts on a different model）：
- 项目或托管设置里写了
model，或者 shell 里设置了ANTHROPIC_MODEL。特别是项目设置里残留的claude-fable-5，不会被自动改成新别名，会一直把你留在 Fable 5。 - 管理员设置的组织默认模型。
- 用
--resume或--continue恢复的会话，会沿用当时保存的模型。
/status 能同时看到当前模型和登录账号，是判断"到底用的是谁"最快的地方。
套餐：显示 "Requires usage credits" 不代表不能用
Fable 5 和 Fable 5.1 在各套餐里的规则相同（帮助中心）：
| 套餐 / 席位 | Fable 5.1 怎么算 |
|---|---|
| Free | 不能用 |
| Pro、Team 标准席位 | 从第一条请求起就走用量额度（usage credits），不占套餐内额度 |
| 按席位计费的 Enterprise 标准席位 | 组织开通了用量额度才能用 |
| Max、Team 高级席位、按席位计费的 Enterprise 高级席位 | 包含在套餐内，最多用掉每周额度的 50% |
| 按用量计费的 Enterprise、API | 按 API 标准价计费 |
走用量额度的账号，/model 列表里 Fable 行会写 "Requires usage credits"，交互会话在第一次计费前会弹出确认（使用组织统一付费的 Enterprise 成员不会看到）。在列表里关掉这个确认，模型保持不变；会话中途关掉，这一轮会改用你的默认模型继续。Remote Control、后台会话或团队成员会话里没人应答时，确认会等 5 分钟（dialogExpiry 的默认值），到时仍没人回答，这一轮不会发出请求。细节见 Claude Code 文档的 Fable and usage credits。
刚在 claude.ai 升级套餐，Claude Code 里却还是旧状态？登录凭证记录的是登录那一刻的套餐，需要执行 /logout 再 /login 才会更新（错误说明）。额度怎么用、Pro 和 Max 差在哪，分别见 Claude Fable 5.1 使用限额：周额度、额外付费与模型切换 和 Claude Max 和 Pro 限额差在哪？5x、20x 升级后仍有周上限。
企业与团队：管理员那一侧的限制
这一类只能由管理员或 Anthropic 客户团队处理，本地换版本、改设置都没用。
- 管理后台禁用了模型：Enterprise 管理员可以在 claude.ai 管理后台按整个组织或按自定义角色禁用模型。被禁用的模型不会出现在
/model列表里；输入/model claude-fable-5-1会被拒绝，提示Model 'claude-fable-5-1' is restricted by your organization's settings. Run /model to choose a different model.；通过--model或环境变量指定时，会提示改用其他模型并继续。管理员放开后，新请求大约一分钟内生效，列表要到下一次启动会话才更新。 - 托管设置里的
availableModels：写claude-fable-5会同时放行 Fable 5 和 5.1，写claude-fable-5-1只放行 5.1；只写了别的模型，Fable 就被隐藏。托管列表存在时，用户和项目设置没法往里加。 - 零数据保留（ZDR）：Fable 5.1 和 Fable 5 默认需要保留数据，开了 ZDR 的组织能不能用由 Covered Models 政策决定。不能用时，Fable 要么不出现，要么显示为灰色，而且无论客户端怎么配置，服务端都会拒绝请求（ZDR 下的模型可用性）。
找管理员时，把报错原文、claude --version 的结果和 /status 里的账号信息一起发过去，比一句"Fable 用不了"好处理得多。
Bedrock、Vertex 与第三方网关
在 Amazon Bedrock、Google Cloud 的 Agent Platform（Vertex AI）、Microsoft Foundry 或 Claude Platform on AWS 上，fable 别名指向的是 Claude Code 内置的平台默认值，可能落后于 Anthropic 的最新版本。办法是用 ANTHROPIC_DEFAULT_FABLE_MODEL 把它固定成对应平台的模型 ID（Pin models for third-party deployments）：
# Amazon Bedrock
export ANTHROPIC_DEFAULT_FABLE_MODEL='anthropic.claude-fable-5-1'
# Google Cloud / Microsoft Foundry / Claude Platform on AWS
export ANTHROPIC_DEFAULT_FABLE_MODEL='claude-fable-5-1'前提是这个模型已经在你的云账号和所在区域开通。新模型可能先上 Anthropic API，晚一些才出现在某个平台或区域；遇到 Model '...' not found 时，先去平台的模型目录确认。Foundry 发送的是部署名称，要填你自己部署时起的名字。管理后台的组织限制不会下发到这些平台，企业需要用托管设置文件管控。
通过 LLM 网关或第三方 API 代理服务使用时，要分清两件事：ANTHROPIC_BASE_URL 只决定请求发到哪里，不决定哪个模型回答；网关本身必须提供 claude-fable-5-1，否则请求会被拒绝。在网关场景下 Claude Code 不再校验模型名，写错的 ID 会原样发给网关，报错也由网关返回。确认网关提供 Fable 5.1 后：
- 用
/model claude-fable-5-1选择； - 想让它出现在列表里，可以设置
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1，让 Claude Code 从网关的/v1/models读取模型；或用ANTHROPIC_CUSTOM_MODEL_OPTION手动加一行。
第三方网关是否提供 Fable 5.1、价格多少，各家不同，只能看对方自己的模型列表。环境变量只在设置它的终端及其子进程里有效，关掉窗口或重启电脑就没了；需要长期生效，写进 shell 配置或 Claude Code 设置文件的 env 字段。
Remote Control、桌面版与 IDE 插件
这几个入口和终端里的 CLI 不一定是同一个版本，排查时要单独看。
- Remote Control：GitHub issue #95263 的报告者发现，长时间运行的
claude remote-control服务会一直用它启动时的版本（例子里是 2.1.235）创建新会话，CLI 升级了也不跟着变，Fable 5.1 因此显示不可用；重启这个服务后恢复。报告者还发现，即使版本最新，从桌面版、网页版或手机端给 Remote Control 会话选 Fable 5.1 时仍显示 "Update to use this model"，后台错误是model is not selectable for this organization，而同一台机器上的本地会话用/model claude-fable-5-1正常。这一层是服务端的限制，本地无法修，目前只能改用本地会话。另外，Claude Code 要到 2.1.260 才会校验从 Remote Control 发来的模型选择。 - 桌面版：同一份报告提到，Linux 桌面测试版 2.110.1 会发送
fable-5-1这样的短名称，CLI 不认，报There's an issue with the selected model (fable-5-1)。在本地会话里手动输入完整 IDclaude-fable-5-1可以绕开。Cowork 需要最新版 Claude 桌面应用。 - VS Code 插件：点输入框底部的模型名称可以打开模型选择器。插件运行的 Claude Code 程序不一定是你终端里那一个，终端
claude --version显示新版不代表插件也是新版，把插件更新到最新再看。
什么时候停下，先换个模型干活
下面几种情况，本地怎么折腾都改变不了结果：
- 组织禁用、
availableModels未放行或 ZDR：等管理员决定； - 网关或云平台没有提供
claude-fable-5-1：等对方上线； - Remote Control 显示 "Update to use this model" 且版本已最新：服务端限制；
- 账户本身不符合条件：Free 套餐不含 Fable；Anthropic 的支持地区列表中没有中国大陆和香港，这属于账户资格问题，不是 Claude Code 里能改的设置。
这时先用别的模型把工作推进下去：
- Fable 5：Anthropic API 上用
/model claude-fable-5选择，它仍然可用。 - Opus 5.5：
/model opus在 Anthropic API 上指向 Opus 5.5，但它要求 Claude Code 2.1.280 或更新。
两者怎么选，见 Opus 5.5 和 Fable 5.1 怎么选？Claude 四档模型的价格与能力边界；Fable 5.1 的 API 价格和模型 ID 变化见 Claude Fable 5.1：价格、API 变化与迁移指南；各版本改了什么、要不要回退，见 Claude Code 更新日志：新版改了什么，该用哪个版本。
如果 Fable 5.1 选中了、也跑起来了，但中途被换成 Opus，或者突然提示改用额度，那是另一类问题：安全分类器标记请求后会自动切换模型；GitHub 上也有 Fable 请求被错误计费提示拦下的未确认报告。这部分见 Claude Fable 5.1 使用限额：周额度、额外付费与模型切换。
常见疑问
Fable 5.1 需要单独申请吗？
不需要。Fable 5.1 是正式开放的模型，付费套餐直接可用；需要审批的是 Mythos 5.1，只对获批的 Project Glasswing 客户开放。
/model fable 和 /model claude-fable-5-1 有什么区别？
在 Anthropic API 上、Claude Code 2.1.257 及以后，两者都选 Fable 5.1，fable 别名会跟随官方推荐版本变化。例外是 Claude apps gateway 会话：那里 fable 仍然指向 Fable 5，要用 5.1 必须输入完整 ID。想固定版本、或者排查问题时，用完整 ID 更可靠。
用第三方 API 地址接 Claude Code，能选 Fable 5.1 吗？
取决于那个服务有没有提供 claude-fable-5-1。改 ANTHROPIC_BASE_URL 只换了请求去向，模型能不能用由对方决定；先看它的模型列表，再用 /model claude-fable-5-1 选择。
列表里就是不出现，要不要改 ~/.claude.json？
不要。只要 /model claude-fable-5-1 能切换成功，就已经在用 Fable 5.1 了，列表显不显示不影响使用。缓存字段属于客户端内部数据，官方没有说明，修改后果不可控。
