Claude Code 切到 Fable 5.2：/model fable
截至 2026-11-12，在 Claude Code 里用上 Claude Fable 5.2 的最快写法是会话内输入 /model fable，或直接写完整 ID /model claude-fable-5-2；官方 model-config 文档写明 Fable 5.2 需要 Claude Code v2.1.321 或更新版本，v2.1.321 起 fable 别名就指向 5.2。下面把三种设法、settings.json 的 model 字段、ANTHROPIC_MODEL 环境变量、用自己的 API key 时的 ANTHROPIC_BASE_URL，以及 CC Switch 里的 model 填法逐项给出可照抄的写法。
更新于 2026-11-13
把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
四条官方要点
需要的最低版本
官方 model-config 文档写 Fable 5.2 需要 v2.1.321 或更新版本，changelog 的版本历史写 v2.1.321 起 fable 别名解析为 Fable 5.2；旧版会收到版本过低的 400 报错，官方让运行 claude update 升级后新开会话。
会话内切换命令
官方 model-config 写：要用 Fable 5.2 就运行 /model fable，或用 claude --model fable 启动；不带参数的 /model 会打开选择器。Claude apps gateway 会话里改用 /model claude-fable-5-2。
环境变量设法
官方按优先级列出的设法里，环境变量写法是 ANTHROPIC_MODEL 后接别名或型号名；settings 文件里用 model 字段永久配置，/model 的选择也会写进用户 settings 的 model 字段。ANTHROPIC_MODEL 只对用它启动的那个会话生效。
完整 ID 与 QCode 地址
QCode 的 /models 列出 claude-fable-5-2；用自己的 API key 时按端点文档把 ANTHROPIC_BASE_URL 填为 https://api.qcode.cc/api，model 填完整 ID claude-fable-5-2。Claude 型号只走 Anthropic 端点。按 token 计费，各模型单价见 /models。
切换 Fable 5.2 到底要改哪几处
截至 2026-11-12，在 Claude Code 里用上 Fable 5.2 要改的只有「选哪个型号」这一处：官方版本历史写 v2.1.321 起 fable 别名指向 5.2，所以 /model fable 就是 5.2；要锁死版本就写完整 ID /model claude-fable-5-2。型号之外，ANTHROPIC_BASE_URL 只决定请求发往哪个端点，不决定回答的型号，两者分开填才不会切错。ultracode 开关与订阅套餐的区别见 /claude-code-ultracode-guide，国内接入与付款见 /claude-code-china-guide。
选了 5.2 却还是旧型号？先看版本、别名与 base URL
按官方文档，依次检查三处。① 版本：低于 v2.1.321 时 API 会回 400，报错形如「Claude Code … does not support this model; version … or newer is required」（错误码 claude_code_version_too_old），运行 claude update 后新开会话。② 残留设置：旧型号反复出现，说明某处还留着旧 ID；按官方优先级顺序检查设型号的位置（/model、--model、ANTHROPIC_MODEL、settings 文件的 model 字段），清掉残留值。③ base URL：ANTHROPIC_BASE_URL 指向网关时，官方写未配置服务 claude-fable-5-2 的网关会拒绝该型号；完整 ID 要对照该端点的型号目录，因为新型号可能先在 Anthropic API 上线，其它服务商稍后才提供。网关后每个型号都失败时，检查网关是否接受 tool search 字段。
时间线
Claude Code 2.1.257（2026-09-01）加入 Fable 5.1（claude-fable-5-1）作为默认 Fable 型号，官方版本历史写 v2.1.257 起 fable 解析为 Fable 5.1。
Claude Code 2.1.321（2026-11-09）加入 Claude Fable 5.2（claude-fable-5-2）作为默认 Fable 型号；官方模型页把 2026-11-09 列为发布日，版本历史写 v2.1.321 起 fable 指向 Fable 5.2。
QCode 的 /models 同时列出 claude-fable-5-2 与 1M 写法 claude-fable-5-2[1m]，显示 1M / 128K；本页官方原文与 QCode 线上页均核对于 2026-11-12。
已确认 vs 官方未公布
已确认（官方原文）
Claude Code 官方 changelog：2.1.321（2026-11-09）新增 Claude Fable 5.2（claude-fable-5-2）并设为默认 Fable 型号；2.1.322 的日期是 2026-11-10；2.1.257（2026-09-01）加入的是 Fable 5.1。官方版本历史：v2.1.321 起 fable 解析为 Fable 5.2，v2.1.257 起解析为 Fable 5.1；Fable 5.2 需要 v2.1.321 或更新版本。官方按优先级列出的设法：会话内 /model fable、启动时 claude --model fable、环境变量 ANTHROPIC_MODEL、settings 文件的 model 字段；/model 会把选择写进用户 settings 的 model 字段。未设 ANTHROPIC_DEFAULT_FABLE_MODEL 时 fable 在 Claude apps gateway 会话解析为 Fable 5，其余解析为 Fable 5.2；要留在 5.1 用 /model claude-fable-5-1。Anthropic 官方：模型 ID 是 claude-fable-5-2，2026-11-09 发布，上下文 1M tokens、最大输出 128K tokens，1M 是默认、不需要 beta 头。QCode 线上：/models 列出 claude-fable-5-2 与 claude-fable-5-2[1m]，端点文档给 Claude Code 的 ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api，Claude 型号只走 Anthropic 接口，按 token 计费、各模型单价见 /models。CC Switch 官方：切换只替换端点、Key、型号名与协议等字段，Claude Code 的配置编辑器是 ~/.claude/settings.json，服务商 JSON 编辑器里可覆盖 ANTHROPIC_MODEL 等环境变量（手册举的例子是 Codex OAuth 预设）。
官方未公布的部分
截至 2026-11-12，Claude Code 官方 changelog 与 model-config 文档只写到 v2.1.321 把 fable 指向 Fable 5.2；下一代 Fable 的型号 ID、发布日期，以及 fable 别名下一次改指哪一代、在哪一天切换，官方页面都没有预先公布。官方文档写明别名会随服务商推荐版本更新，但没有给出未来切换的版本号或日期；这些以官方后续页面为准。
别名还是完整 ID
跟着最新 Fable 走：用 fable 别名
官方 model-config 写 /model fable 就是 Fable 5.2，别名会随服务商推荐版本更新；以后新版本上线，同一个别名会自动跟过去。未设 ANTHROPIC_DEFAULT_FABLE_MODEL 时，fable 在 Claude apps gateway 会话解析为 Fable 5，其余解析为 Fable 5.2。
锁死版本、或退回 5.1：用完整 ID
要把型号固定成某一代，就用完整型号名 /model claude-fable-5-2。想退回 Fable 5.1，运行 /model claude-fable-5-1（changelog 原文给的回退命令）；Fable 5 是 /model claude-fable-5。第三方部署还能用 ANTHROPIC_DEFAULT_FABLE_MODEL 固定别名指向的型号。
可照抄的写法
① 会话内：按官方文档输入 /model fable 立即切到 Fable 5.2；/model 不带参数会打开选择器。② 想让新会话默认用它：在 ~/.claude/settings.json 里把 model 字段设为 claude-fable-5-2，即 {"model": "claude-fable-5-2"}（官方设置文档的 model 字段写法），/model 的选择也会写进这个字段。③ 只对一次启动生效：设环境变量 ANTHROPIC_MODEL=claude-fable-5-2，或用 claude --model claude-fable-5-2 启动。④ 用自己的 API key：把 ANTHROPIC_BASE_URL 填为 https://api.qcode.cc/api（QCode 端点文档），ANTHROPIC_AUTH_TOKEN 填自己的 Key（QCode 的 CC Switch 文档），model 仍填完整 ID claude-fable-5-2；Claude 型号只走 Anthropic 端点。⑤ 在 CC Switch 里：新增自定义服务商，按官方手册填 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，型号名写在服务商配置的 ANTHROPIC_MODEL 里；官方手册说明在工具里用 /model 临时选的型号不会写回服务商，要永久改就在服务商里编辑。CC Switch 的填写与排错见 docs.qcode.cc/docs/ide/cc-switch。
在 QCode 上怎么用
QCode 已支持 claude-fable-5-2：Claude Code 等 Anthropic 协议工具把 model 设为 claude-fable-5-2 即可，Base URL 用 https://api.qcode.cc/api；同一把 Key 还能调 claude-fable-5-1、claude-fable-5、claude-opus-5-5 等。按 token 计费，各模型单价见 /models。不想包月？按量包 ¥26 起买一笔额度，7 天内用完为止；已有个人套餐的用户额度不够时买加油包。
常见问题
claude code 怎么用 fable 5.2？
在会话里输入 /model fable 立即切到 Fable 5.2（官方 model-config 原文），或写完整 ID /model claude-fable-5-2；需要 Claude Code v2.1.321 或更新版本，旧版先运行 claude update。/model 不带参数会打开选择器；在 Claude apps gateway 会话里按官方文档改用 /model claude-fable-5-2。
要升级到哪个版本？
Fable 5.2 需要 Claude Code v2.1.321 或更新版本（官方 model-config 原文）；changelog 里 2.1.321 的日期是 2026-11-09；2.1.322 的日期是 2026-11-10。用 claude --version 看当前版本，运行 claude update 升级后新开会话；低于最低版本时 API 会回 400 版本过低的报错。
cc switch 里 model 怎么填？
按 CC Switch 官方用户手册，服务商配置里 Claude Code 的关键字段是端点、Key、型号名与协议，Claude Code 的配置编辑器是 ~/.claude/settings.json。手册写明服务商的 JSON 编辑器里可以覆盖 ANTHROPIC_MODEL 等环境变量（手册举的例子是 Codex OAuth 预设），所以自定义 QCode 服务商时，把完整 ID claude-fable-5-2 写进该服务商的 ANTHROPIC_MODEL。官方手册还提醒：在工具里用 /model 临时选的型号不会写回服务商，切走再切回会回到服务商里保存的值，要永久改就在服务商里编辑。QCode 的 CC Switch 页补充：v3.20.3 起 Claude 服务商编辑器带按角色（Sonnet / Opus / Fable / Haiku / 子代理）的模型映射面板。QCode 侧的 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 填法见 docs.qcode.cc/docs/ide/cc-switch。
fable 和 claude-fable-5-2 有什么区别？
fable 是别名，claude-fable-5-2 是完整型号 ID。官方 model-config 写：别名会随服务商推荐版本更新，未设 ANTHROPIC_DEFAULT_FABLE_MODEL 时 fable 在 Claude apps gateway 会话解析为 Fable 5、其余解析为 Fable 5.2；要锁死版本就用完整型号名 /model claude-fable-5-2。网关若没配置服务 claude-fable-5-2，官方写它会拒绝该型号的请求，这时按官方文档显式选完整 ID。
怎么退回 5.1？
运行 /model claude-fable-5-1：这是 Claude Code changelog 给的回退命令，官方 model-config 也写 Fable 5.1 要按型号 ID 选（Fable 5 是 /model claude-fable-5）。v2.1.321 起，保存在用户 settings 里的 claude-fable-5-1 选择在 Pro、Max、Ultra 套餐上会迁到 fable 别名一次（Team、Enterprise 要等组织允许），迁移之后再运行一次 /model claude-fable-5-1 即可回到 5.1。Console 账号、第三方服务商，以及项目、本地、托管 settings 里的 claude-fable-5-1 保持不变。
1M 上下文怎么开？
Fable 5.2 默认就是 1M 上下文，不需要额外开关：Claude Code 官方 model-config 写 Fable 系列默认跑 1M 窗口、不需要 [1m] 后缀，Anthropic 官方上下文文档也写 1M 是默认、不需要 beta 头；官方规格是上下文 1M tokens、最大输出 128K tokens。要按名字显式选 1M 变体，官方写法是在别名或完整型号名后加 [1m]；QCode 的 /models 把 1M 写法列为 claude-fable-5-2[1m]。自定义 ANTHROPIC_BASE_URL 指向代理时，官方文档写可识别的型号仍按 Anthropic API 的窗口处理。
来源
Claude Code 官方：changelog、model-config、settings、环境变量与错误文档；Anthropic 官方：Fable 5.2 模型页、模型总览、迁移指南与上下文窗口文档；CC Switch 官方仓库：README 与用户手册；QCode：qcode.cc/models、docs.qcode.cc 的接入端点页与 CC Switch 配置页、线上状态页。以上均于 2026-11-12 抓取核对。
相关
按量包：不包月，7 天有效
不包月，一次买一笔额度，7 天有效，各模型单价见 /models。
claude-fable-5-2 400 报错：原文、原因与改法（2026-11）
依据 Anthropic 官方迁移指南与 API 错误文档：claude-fable-5-2 上前缀检查、computer_20251124、advisor 模型、tool_choice 与 thinking 参数的 400 报错原文、原因和改前 / 改后写法；另含没变的部分、Claude Code v2.1.321 与 QCode 上同样的改法。
magpie 与 CC Switch 对比
两款工具各自的定位与切换方式的对比。
加密货币充值指南
9 种币、56 条网络，0 平台手续费购买 AI 编程 API 额度。
官方说法核对于 2026-11-12，以 Anthropic、Claude Code 与 CC Switch 官方页面为准；型号可用性与单价以 qcode.cc/models 为准。