工具大全
踩坑实录作者:Coocon2026年8月14日643 次阅读约 3 分钟阅读

Fable 5 明明是 1M 上下文,状态栏却显示 200k:别急着换工具,先抓一份现场数据

现象

Claude Code 里用 Claude Fable 5 干活,官方文档明确它是 1M token 上下文窗口(默认开启,不需要 beta header)。但底部自定义状态栏显示的是:

magictools | Fable 5 | Ctx 38% (76k/200k)

分母 200k。照这个算法,用到 16 万 token 就开始飘红报警——实际上离真正的窗口上限还差 84 万。

第一反应很自然:是不是我这个 statusline 脚本太差了,换个社区流行的?

这个念头是本文要复盘的第一个坑。

先想清楚:换 statusline 能解决吗

Claude Code 的 statusline 机制是:每次刷新时把一份 JSON 通过 stdin 喂给你配置的命令,里面带模型信息、工作目录、上下文用量等字段。所有 statusline——不管是自己写的 bash 脚本还是社区项目——拿到的都是同一份 stdin。

窗口大小只有两个来源:

  1. 读 stdin 里的 context_window.context_window_size 字段
  2. 按模型名查自己内置的「模型 → 窗口大小」表

如果问题出在字段本身报错了,换任何一个读这个字段的 statusline 都是换汤不换药;如果指望内置表,Fable 5 这种刚发布的模型大概率还没进第三方项目的表里。

结论:先确认数据源,再谈换工具。 否则换完发现还是 200k,白折腾一轮。

抓现场:一行 tee 拿到 stdin 实锤

statusline 脚本的 stdin 是瞬时的,平时看不到。排障最直接的办法是临时加一行,把每次的输入落盘:

input=$(cat)
printf "%s" "$input" > /tmp/statusline-debug.json   # 临时调试行,用完删

等状态栏刷新一次(随便让会话产生一条消息就行),文件里就是货真价实的现场:

jq '.model, .context_window' /tmp/statusline-debug.json
{
  "id": "claude-fable-5",
  "display_name": "Fable 5"
}
{
  "total_input_tokens": 76334,
  "context_window_size": 200000,
  "used_percentage": 38
}

实锤了:模型 id 明明是 claude-fable-5,Claude Code 报的 context_window_size 却是 200000。 这不是脚本算错,是上游数据源就错了——Claude Code 不认识新模型的窗口大小时,会回落到 200k 默认值(对应已知 issue #76751,1M 会话误报 200k)。

到这一步,「换 statusline」的方案可以正式毙掉:谁来读这个字段都是 200000。

根因

三层叠加:

  1. 官方字段误报:Claude Code 对 1M 窗口模型(实测 claude-fable-5)的 context_window_size 报 200000
  2. 脚本兜底写死:脚本里字段缺失时 ctx_size=200000,进一步固化了这个值
  3. 原有修正条件太苛刻:脚本此前只在「已用量超过报告值」时才修正为 1M——意味着必须先用掉 20 万 token,分母才会变对。在那之前,百分比一直按 200k 算,红色告警全是虚惊

修复:一张模型表 + 保留兜底

既然上游字段靠不住,就在脚本里维护一张已知 1M 窗口模型表,按 model.id 强制修正:

model_id=$(printf '%s' "$input" | jq -r '.model.id // empty')

# 官方字段对 1M 窗口模型误报 200k(#76751,实测 claude-fable-5 报 200000)
# 已知 1M 窗口模型按表强制修正;[1m] 后缀显式声明 1M,优先于模型表
case "$model_id" in
  *"[1m]"*)
    ctx_size=1000000
    ;;
  *fable-5*|*mythos-5*|*opus-5*|*sonnet-5*|*opus-4-8*|*opus-4-7*|*opus-4-6*|*sonnet-4-6*)
    if [ -z "$ctx_size" ] || [ "$ctx_size" -le 200000 ] 2>/dev/null; then
      ctx_size=1000000
    fi
    ;;
esac
[ -z "$ctx_size" ] && ctx_size=200000
# 兜底:未知模型用量超过报告窗口时,也按 1M 修正
if [ -n "$ctx_used" ] && [ "$ctx_used" -gt "$ctx_size" ] 2>/dev/null; then
  ctx_size=1000000
fi

表里的型号(Fable/Mythos 5、Opus 5/4.8/4.7/4.6、Sonnet 5/4.6)都是官方文档确认 1M 窗口的。原来那条「用量超过报告值就修正」的逻辑保留,作为表外未知模型的兜底。

验证不用等真实会话——刚才抓的 debug JSON 就是现成测试用例:

bash ~/.claude/statusline-command.sh < /tmp/statusline-debug.json
# magictools | Fable 5 | Ctx 7% (79k/1M)

同一份输入,38% 变 7%,分母 200k 变 1M。改完记得删掉调试行、清掉 /tmp 的落盘文件。

一个容易忽略的尾巴:1M ≠ 可用 1M

Claude Code 会为 auto-compact 预留缓冲,1M 窗口的实际可用预算约 830k 左右。所以状态栏按 1M 算百分比时,心里要留一档:80% 飘红时就该收尾了,别等 100%。

带走的教训

  1. 换工具之前,先确认坏的是不是数据源。 所有下游消费同一份上游数据时,换下游是无效动作。这次如果直接换了社区 statusline,结果还是 200k,还多引入一个依赖。
  2. 瞬时数据要落盘再排障。 stdin、管道、hook 输入这类「看不到的现场」,加一行 tee/重定向落盘,比盯着结果猜快得多。抓下来的现场还能直接当回归测试的输入。
  3. 写死的兜底值要有失效预案。 ctx_size=200000 在写下的那天是对的,模型迭代后就成了暗雷。兜底值旁边最好留一张按标识符查的修正表,并给表外情况保留动态修正逻辑。
  4. 新模型上线后,把「工具链对它的认知」也当成待验证项。 模型能力升级了,编辑器、CLI、监控脚本里关于它的硬编码假设(窗口大小、价格、tokenizer)不会自动跟上。

这类实测,每周六汇总一封

订阅码农早餐:每天 8:00 一封 AI 编程早报,每周六另附本周 Claude Code / Codex / 本地模型的实测和踩坑汇总。

相关文章

Claude Code 禁止 rm -rf 怎么配:deny 规则两周拦下 14 次,实测还有 7 种写法照样能删,一个 hook 补齐

为了防 Claude Code 误删文件,我在全局 settings 里加了一条 deny 规则 Bash(rm -rf *)。翻本机 10 月 7 日到 21 日的会话记录:这条规则拦下 14 次删除,模型被拒后 8 次换新目录名、6 次直接放弃删除,一次都没换写法绕过。但在 Claude Code 2.1.285 上用 stub 逐字回放 22 种删除写法后发现:rm -fr、rm -r -f、rm -Rf、rm -r 在手动、auto、bypass 三种模式下都照删不误,/bin/rm、find -delete、bash -c 在手动和 bypass 模式下也能删。auto 模式下,工作目录内的 rm -fr 会被当成「acceptEdits 也会放行」的操作,连分类器都不过。另一道闸是内置的 dangerous-rm 检查,目标是 $D/* 这类变量展开时触发,bypass 模式也拦;多行命令里前面有 heredoc,它就跟不上同一条命令里的变量赋值。文末给出一个 PreToolUse hook,三种模式下补齐全部递归删除写法,并告诉模型被拒后该怎么做。

claude-codehooks+5
pitfalls2026年10月21日7 min
920

Claude Code 接 DeepSeek / GLM / Kimi 开 auto 模式:temporarily unavailable 括号里的原因怎么看,哪些重试没用(故障注入实测)

用第三方模型跑 Claude Code auto 模式,每个有副作用的动作都会用你的会话模型向同一个后端多发一次判定请求:系统提示词 132,470 字符,单次约 2.97 万输入 token,比主循环那一步还多。判定请求一失败,就出现「xxx is temporarily unavailable, so auto mode cannot determine the safety of Bash」。本文用故障注入代理把每种失败对应的报错原文测了一遍:500 → (server error)、429 → (rate-limited)、529 → (overloaded)、断连 → (connection failed),这几种会自动重试 5 次;超过 60 秒没回 → (timed out);**没有括号 = 后端拒收(4xx),只试 1 次,重试多少遍都一样**;后端回了但模型没给判定 → could not evaluate,连续 3 次就退回人工确认。另外实测 CLAUDE_CODE_AUTO_MODE_MODEL 不生效,判定器只能跟着会话模型换。Claude Code 2.1.285,真实后端 DeepSeek v4-pro 与小米 MiMo v2.5。

claude-codedeepseek+7
pitfalls2026年10月11日11 min
1865

Claude Code 上下文太长怎么办:Prompt is too long 会自动压缩,中转站 / DeepSeek 的 maximum context length 却不会(实测)

Claude Code 靠报错文案判断「上下文太长」:后端说 prompt is too long 或 input is too long for requested model,它会自动压缩对话后重发,用户无感;DeepSeek 和 OpenAI 风格中转返回的 This model's maximum context length is …,它不认识,直接报 API Error: 400,每轮都失败。手动 /compact 有效;更好的办法是用 CLAUDE_CODE_MAX_CONTEXT_TOKENS(非 claude- 模型 ID)或 CLAUDE_CODE_AUTO_COMPACT_WINDOW(claude- 模型 ID)告诉它真实上限,让它提前压缩。Claude Code 2.1.285 + 本地 stub 实测。

claude-codedeepseek+6
pitfalls2026年10月5日8 min
1464

Claude Code 一直卡住、转圈没反应怎么办:后端不回时它要等 6 分钟,重试满 10 次可能卡一个多小时(实测)

Claude Code 转圈不动、或者停在 Retrying in 0s,多半是后端没有回数据。实测 2.1.285(API key + ANTHROPIC_BASE_URL):后端不回响应头时每次等 6 分钟(360 秒)才判超时,把 API_TIMEOUT_MS 调到 60 万、90 万也不变,只能调小;默认重试 10 次,总共可能卡一个多小时。中转站如果把回复缓冲到生成完才返回,超过 6 分钟的回复永远拿不到。按 Esc 可以随时中断。全部在本地 stub 上实测。

claude-code中转站+6
pitfalls2026年10月5日10 min
1275