博客

Claude Fable 5.1 配置 Claude Code 教程:fable 模型 ID 与常见报错

一句话结论

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 临时生效(当前会话):

bash
export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5-1
claude

写进 settings.json(长期生效):

json
{
  "env": {
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

放在 ~/.claude/settings.json 是全局生效,放在项目根的 .claude/settings.json 则只对该项目生效——建议全局设,个别项目需要回落时用项目级覆盖。

方式三:走中转(Base URL + Auth Token)

国内网络直连 Anthropic 不稳、付款要海外卡,最常见的做法是走 API 网关。Claude Code 原生支持两个环境变量:

bash
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 写法:

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_choiceany/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,面板切模型不用改配置。

准备好接入了吗?登录控制台 · 购买额度 · 创建 API Key,三步即可开始。
Claude Fable 5.1 配置 Claude Code 教程:fable 模型 ID 与常见报错 · TeamoRouter