Claude Code CLIContext length exceeded / Auto-compact triggered

Claude Code 上下文窗口满载(Context Full)与 Token 消耗暴增优化

一句话结论

上下文越长,每轮重发的历史 Token 越庞大(单轮可达 15 万+ Token),既拖慢推理又极快耗尽 5 小时与周限额;通过主动 /compact 与按任务拆会话可立省 60% 以上用量。

测算上下文膨胀对月度成本的影响 →

直观对比:同一工作量下 85% 缓存 vs 0% 缓存的月账单差距

以主力编程每天 2,500 万 Token、每月 22 天、Claude Sonnet 单价(输入 $3 / 缓存读 $0.30 / 输出 $15)为例:

健康状态(85% 缓存命中)$520 / 月

绝大部分上下文走 $0.30/M 的低价缓存读取通道。

缓存全失效(0% 缓存命中)$1,782 / 月(暴涨 3.4 倍)

前缀失效导致每轮全按 $3/M 全价新输入计费。

常见触发原因

  • 在同一个终端会话里连续做 5 个以上不相关的功能或排障,导致海量旧日志和 diff 残留;
  • 读取了未经筛选的大型编译产物、lockfile 或完整测试日志进入对话历史。

实操排查与解决步骤

  1. 1. 善用 /compact [保留重点] 与 /clear

    完成当前模块修改并跑通测试后,执行 /clear 开启新任务;若需保留关键架构约定,使用 /compact keep API contract。

  2. 2. 在 .claudeignore 中屏蔽构建与依赖目录

    排除 dist/、node_modules/ 和巨型日志目录,避免 Agent 误读无用文件瞬间撑爆上下文。

常见延伸问题

触发 Auto-compact 会导致 Prompt Cache 失效吗?

会的。上下文被重新摘要压缩后,前缀发生变化,紧接着的第一轮请求需要重新写入缓存,因此主动按任务边界 /clear 往往更省额度。

其他常见限流与成本报错