一句话结论
Claude Code 用 Fable 5.1 只需要做一件事:让模型 ID 解析到 claude-fable-5-1——要么 /model 里直接选 fable 项,要么设环境变量 ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5-1;走中转就再加 ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN 两个变量。剩下的问题集中在三类 5.1 破坏性变更引发的报错,本文一张排查表给全。
前置:Fable 5.1 在 Claude Code 里是什么状态
- Anthropic 旗舰,2026-09-01 发布并已 GA,API 模型 ID 为
claude-fable-5-1; - 1M token 上下文,官方价 $10/$50 每百万 token,缓存读降到 $0.25/M(降 75%);
- effort 档位为 low / medium / high / xhigh / max 五档,Claude Code 默认 High;
- Max 订阅和 Team/Enterprise 高级席位都包含它(每周额度的一半可分配给 Fable 5.1)。
价格与渠道的完整分析见 Claude Fable 5.1 价格与中转渠道;从 Fable 5 迁移的注意事项见 Fable 5 迁移指南。
方式一:/model 里直接选 fable
在 Claude Code 会话里输入 /model,模型列表会出现 fable 选择项,回车即切。适合临时切换、快速试用。
局限:这个选项只切当前会话/项目的默认,且你无法控制它解析到哪个具体版本。要对版本有确定性,用方式二。
方式二:环境变量 ANTHROPIC_DEFAULT_FABLE_MODEL
ANTHROPIC_DEFAULT_FABLE_MODEL 的作用是覆盖 Claude Code 默认使用的 fable 模型 ID:
- 未设置:回退到 Fable 5,同时
/model里仍会出现 "fable" 选择项; - 设置为
claude-fable-5-1:所有 "fable" 选择落到 5.1。
Shell 临时生效(当前会话):
export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5-1
claude
写进 settings.json(长期生效):
{
"env": {
"ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
}
}
放在 ~/.claude/settings.json 是全局生效,放在项目根的 .claude/settings.json 则只对该项目生效——建议全局设,个别项目需要回落时用项目级覆盖。
方式三:走中转(Base URL + Auth Token)
国内网络直连 Anthropic 不稳、付款要海外卡,最常见的做法是走 API 网关。Claude Code 原生支持两个环境变量:
export ANTHROPIC_BASE_URL="https://api.teamorouter.cn"
export ANTHROPIC_AUTH_TOKEN="sk-teamo-xxxxxx"
export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5-1
对应 settings.json 写法:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.teamorouter.cn",
"ANTHROPIC_AUTH_TOKEN": "sk-teamo-xxxxxx",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
}
}
用 TeamoRouter 这类网关还有个便利:切模型在面板上点一下就行,不用回来改配置文件——Fable 5.1、GPT-6 Astra、DeepSeek 在同一个 key 下,/model 或面板切换即可,尤其适合多模型混用的团队。网关选型见 Claude Code 中转站推荐。
为什么值得切:$0.25 缓存读 + 默认 High effort
Claude Code 的长会话是 Fable 5.1 降价的最大受益场景:CC 每一步都重读 system prompt + 工具定义 + 代码上下文,这段前缀从 $1.00 降到 $0.25/M,对 $10 的 fresh 输入是 40 倍价差。官方估算典型场景总成本降约 25%、重度 agent 场景最多降约 45%——CC 会话基本落在后一档。
同时 CC 默认 High effort,不需要你手动调档:复杂任务自动吃满推理预算,简单问题也不会浪费。想了解 5.1 国内的其他用法(订阅/API/中转三条路),见 Claude Fable 5.1 国内怎么用。
常见报错排查表
Fable 5.1 有三个破坏性变更,报错基本都从这里来:
| 报错现象 | 原因 | 解决 |
|---|---|---|
| 400 错误,涉及强制工具调用 | 5.1 禁用了 tool_choice 的 any/tool 强制模式 |
改回 auto,用提示词引导模型调用工具("你必须先调用 X 工具再回答") |
| conversation history rewrite 报错 | 5.1 限制改写会话历史(回删/篡改已发生的轮次) | 不改历史,用追加纠正轮次:补一条 assistant/user 消息说明"前面有误,以本条为准" |
| thinking 块相关报错(跨模型续会话) | 5.1 的 thinking 块不能跨代际复用,拿旧模型的 thinking 续 5.1 会话会被拒 | 新会话或换模型时不要携带旧代际的 thinking 块;恢复会话用 5.1 自身的记录 |
另外两个高频非报错问题:
Q:设了 ANTHROPIC_DEFAULT_FABLE_MODEL 但 /model 里还是旧的?
环境变量只影响默认值,不刷新已开着的会话。改完重启 claude 进程;确认 claude 启动的 shell 里 echo $ANTHROPIC_DEFAULT_FABLE_MODEL 输出正确。
Q:走中转后 401 / 连接失败?
依次查:ANTHROPIC_AUTH_TOKEN 是否是网关 key(不是 Anthropic 官方 key);ANTHROPIC_BASE_URL 结尾多了没有 /v1(按网关文档来,别自己猜);公司代理是否拦了自定义域名。账号安全相关的解法另见 Claude Code 封号后中转解法。
什么时候别切
Fable 5.1 不是无脑默认项。日常简单任务(改文案、跑脚本、问答)走 $0.20 级别的便宜模型就够了,$10/$50 的旗舰只配给难推理和复杂编码。合理的做法是分层:CC 里把简单会话指到便宜模型,Fable 5.1 留给硬任务——路由策略详见 GPT-6 Astra token 集采降本,思路完全通用。
总结
配置就三步:/model 选 fable 或设 ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5-1;走中转加 ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN;报错先对照三破坏性变更(tool_choice 400、改写历史受限、thinking 不跨代际)。长会话场景 $0.25 缓存读几乎白送 25–45% 的降本。注册 TeamoRouter,一个 key 直连 claude-fable-5-1,面板切模型不用改配置。