返回 AI Bar

Claude Code 官方讲清了哪些操作会让缓存失效:切模型、切推理档位最亏

盯豆 · 2026-11-16T07:48:10

Claude Code 的提示缓存一直自动开着,但官方这次把规则写全了:哪些操作会让下一轮变慢变贵,哪些完全没事。 先把机制说清楚。每次发消息,Claude Code 都把系统提示、项目上下文(CLAUDE.md、自动记忆)、整段对话重新发一遍。缓存按「前缀逐字匹配」工作,前面任何一处变了,后面的全部重算,没有按文件或按段的缓存。 会打断缓存的操作: 切换模型。每个模型有独立缓存,用 /model 换模型后,下一轮要把整段历史重新读一遍,即使内容没变。 切换推理档位。多数模型上改档位也会全量重算。API Key 或订阅下,Fable 5.1 及以后、Opus 5.5、Sonnet 5.5、Haiku 5.5 默认不失效。 开快速模式。快速和标准速度各自一份缓存,中途打开等于重新读一遍,而且要按快速模式的价格算。官方建议在会话开头就打开。 中途连接或移除 MCP 服务器。工具定义在系统提示层,改了就会失效。不过工具搜索默认开启时,工具定义是延后加载的,中途连服务器通常不影响已有缓存。 用裸工具名整条禁用一个工具,比如在权限里 deny 掉 Bash。带参数的 deny 规则(Bash(rm *))和所有 allow、ask 规则都不影响缓存。 压缩对话、图片累积超过请求上限、升级 Claude Code,也都会重建缓存。 不打断缓存的操作:改仓库文件、中途改 CLAUDE.md、切权限模式、切输出风格、调用技能和命令、/recap、/rewind、派子代理。注意中途改 CLAUDE.md 虽然不掉缓存,但改动要到 /clear、/compact 或重启才生效。 缓存多久过期,取决于你怎么付费。订阅在套餐额度内,主对话默认 1 小时;一旦超出额度改用额度积分,或者用 API Key、云厂商,主对话默认降到 5 分钟。子代理、工作流、压缩这些请求默认都是 5 分钟。想自己定,可以用 promptCacheTtl 和 subagentPromptCacheTtl 设置,或者 CLAUDE_CODE_PROMPT_CACHE_TTL、CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL 环境变量,填 5m 或 1h,需要 v2.1.242 以上。 还有一个容易踩的坑:缓存实际是按机器和目录隔离的。不同目录的两个会话前缀不一样,互相命中不了;同目录下并行的会话可以共享;顺序会话只有在启动时的 git 状态快照一致时才共享。走网关或自定义 ANTHROPIC_BASE_URL 的话,网关原样转发 cache_control 标记才和官方端点一致;如果网关悄悄把标记删了,每一轮都会按未缓存计费。 想确认自己有没有吃到缓存,可以看 /usage 里的「Prompt cache (main)」这一行,会显示命中率、未命中次数和缓存是否还热着。v2.1.260 以上还会给出最近一次未命中的可能原因。 官方给的建议很朴素:在会话开头就把模型和推理档位定好,把 /compact 放在任务之间的自然断点,别在干活干到一半的时候折腾这些设置。 原文:https://code.claude.com/docs/en/prompt-caching.md

AI 论坛精选