# Claude Code 看不到 Fable 5.1？按提示找原因 > Claude Code 里找不到或选不了 Fable 5.1，多半是版本低于 2.1.257、列表没显示、套餐走用量额度或组织限制。先输入 /model claude-fable-5-1，再按报错对照原因。 - Source: https://www.aifreeapi.com/zh/posts/claude-code-fable-5-1-not-available - Language: zh - Published: 2026-09-24 - Updated: 2026-09-24 - Publisher: AI Free API (https://www.aifreeapi.com) **截至 2026 年 9 月 24 日**，Claude Fable 5.1 已经正式开放（9 月 1 日发布，不需要申请），Pro、Max、Team、Enterprise 这些付费套餐都能用，Free 套餐不能用（见 Anthropic 帮助中心的 [Fable 模型套餐说明](https://support.claude.com/en/articles/15424964-claude-fable-models-on-your-plan)）。所以 Claude Code 里"看不到"通常不等于"没有权限"，先做两步： 1. 在终端运行 `claude --version`，确认版本是 **2.1.257 或更新**。低于这个版本就先升级，然后开一个新会话。 2. 在会话里直接输入 `/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 使用限额：周额度、额外付费与模型切换](/zh/posts/claude-fable-pro-max-weekly-limits) | 表中的报错和界面文字是 Claude Code 实际显示的英文原文，可以直接拿来比对或搜索；下面各节按原因展开。 ## 版本：以 2.1.257 为准，而不是 2.1.255 官方几处给出的最低版本并不一致： - 帮助中心的 [Fable 套餐说明](https://support.claude.com/en/articles/15424964-claude-fable-models-on-your-plan)写的是 2.1.255； - Claude Code 文档的 [Work with Fable](https://code.claude.com/docs/en/model-config#work-with-fable) 和 [第 36 周更新说明](https://code.claude.com/docs/en/whats-new/2026-w36)写的是 2.1.257； - 9 月 1 日有用户在 [GitHub issue #91345](https://github.com/anthropics/claude-code/issues/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。 ![Fable 5.1 版本门槛对照图：服务端报错要求 2.1.251、帮助中心写 2.1.255、Claude Code 文档写 2.1.257；npm 上 2.1.253 到 2.1.256 从未发布，2.1.257 是同时满足三种说法的第一个版本](https://www.aifreeapi.com/posts/zh/claude-code-fable-5-1-not-available/img/fable-version-threshold.webp) 服务端真正卡的是哪个版本，以你收到的 400 报错里写的数字为准；报错原文和处理方式见 Claude Code 的[错误说明](https://code.claude.com/docs/en/errors#claude-code-does-not-support-this-model)。 ### 按安装方式升级 | 安装方式 | 升级命令 | 需要注意 | | --- | --- | --- | | 原生安装 | `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 的[安装与更新文档](https://code.claude.com/docs/en/setup#update-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` 会去服务端当场确认。所以最省事的检查就是开头那一步： ```text /model claude-fable-5-1 ``` 如果你的套餐按用量额度计费，交互会话里 Claude Code 会在 Fable 请求计费前先弹出确认，你可以继续，也可以换回默认模型。 ![输入 /model claude-fable-5-1 后的判断流程：切换成功说明只是列表没显示；失败时按四类报错原文分别对应升级版本、改正 ID、找管理员和确认账号或线路](https://www.aifreeapi.com/posts/zh/claude-code-fable-5-1-not-available/img/model-check-flow.webp) 想确认真正回答你的是哪个模型，可以在终端跑一次非交互调用： ```bash 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](https://github.com/anthropics/claude-code/issues/91852) 与 [#94638](https://github.com/anthropics/claude-code/issues/94638)：Max 账户（包括个人 Max 5x，版本从 2.1.259 到 2.1.276 都有人复现），`/model` 列表只有 "Fable"（即 Fable 5），没有 5.1；但 `/model claude-fable-5-1` 和上面的非交互调用都成功。 - [#91885](https://github.com/anthropics/claude-code/issues/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](https://code.claude.com/docs/en/model-config#a-new-session-starts-on-a-different-model-than-you-picked)）： - 项目或托管设置里写了 `model`，或者 shell 里设置了 `ANTHROPIC_MODEL`。特别是项目设置里残留的 `claude-fable-5`，不会被自动改成新别名，会一直把你留在 Fable 5。 - 管理员设置的组织默认模型。 - 用 `--resume` 或 `--continue` 恢复的会话，会沿用当时保存的模型。 `/status` 能同时看到当前模型和登录账号，是判断"到底用的是谁"最快的地方。 ## 套餐：显示 "Requires usage credits" 不代表不能用 Fable 5 和 Fable 5.1 在各套餐里的规则相同（[帮助中心](https://support.claude.com/en/articles/15424964-claude-fable-models-on-your-plan)）： | 套餐 / 席位 | 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](https://code.claude.com/docs/en/model-config#fable-and-usage-credits)。 刚在 claude.ai 升级套餐，Claude Code 里却还是旧状态？登录凭证记录的是登录那一刻的套餐，需要执行 `/logout` 再 `/login` 才会更新（[错误说明](https://code.claude.com/docs/en/errors#claude-opus-is-not-available-with-the-claude-pro-plan)）。额度怎么用、Pro 和 Max 差在哪，分别见 [Claude Fable 5.1 使用限额：周额度、额外付费与模型切换](/zh/posts/claude-fable-pro-max-weekly-limits) 和 [Claude Max 和 Pro 限额差在哪？5x、20x 升级后仍有周上限](/zh/posts/claude-code-pricing-pro-vs-max)。 ## 企业与团队：管理员那一侧的限制 这一类只能由管理员或 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 下的模型可用性](https://code.claude.com/docs/en/zero-data-retention#model-availability-under-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](https://code.claude.com/docs/en/model-config#pin-models-for-third-party-deployments)）： ```bash # 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](https://github.com/anthropics/claude-code/issues/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)`。在本地会话里手动输入完整 ID `claude-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 的[支持地区列表](https://www.anthropic.com/supported-countries)中没有中国大陆和香港，这属于账户资格问题，不是 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 四档模型的价格与能力边界](/zh/posts/claude-sonnet-vs-opus-vs-haiku-vs-fable)；Fable 5.1 的 API 价格和模型 ID 变化见 [Claude Fable 5.1：价格、API 变化与迁移指南](/zh/posts/claude-fable-5-1)；各版本改了什么、要不要回退，见 [Claude Code 更新日志：新版改了什么，该用哪个版本](/zh/posts/claude-code-changelog)。 如果 Fable 5.1 选中了、也跑起来了，但中途被换成 Opus，或者突然提示改用额度，那是另一类问题：安全分类器标记请求后会自动切换模型；GitHub 上也有 Fable 请求被错误计费提示拦下的未确认报告。这部分见 [Claude Fable 5.1 使用限额：周额度、额外付费与模型切换](/zh/posts/claude-fable-pro-max-weekly-limits)。 ## 常见疑问 ### 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 了，列表显不显示不影响使用。缓存字段属于客户端内部数据，官方没有说明，修改后果不可控。