Claude Code 缓存暴跌溯源：git status 变更如何击穿 DeepSeek 兼容接口的 Prompt Cache

近日，有开发者在将 Claude Code 对接 DeepSeek V4 的 Anthropic 兼容接口时，遭遇了离奇的缓存命中率“脉冲式崩溃”现象。在同一轮对话中，缓存命中率从 99% 瞬间暴跌至 0.5%，随后又在下一轮自动恢复。针对这一问题，技术社区展开了深入溯源，揭示了 LLM Prompt Caching 机制的底层工作原理及其脆弱性。

调查发现，Anthropic 及兼容的 DeepSeek 接口采用“字节级精确前缀匹配”策略。缓存必须从第 0 字节开始逐位匹配，前缀的任何微小变化都会导致后续所有长文本的 KV Cache 失效。而在 Claude Code 的实现中，System Prompt 末尾嵌入了 `git status` 快照。当使用 `–resume` 等命令恢复会话时，系统会清除内存缓存并重新执行 `git status`，导致系统提示词的前缀因文件状态变化（如增加了临时文件）而发生偏移。

验证实验显示，仅仅因为 git status 多了一行 26 字节的文件记录，后续 36 万个 token 的 KV Cache 就全部作废。通过源码分析定位，该问题源于 Claude Code 对 `getGitStatus` 函数使用了 lodash memoize 缓存，在特定触发条件下会刷新快照。

为解决此问题，开发者建议设置环境变量 `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1` 来禁用 git 状态注入，从而保证 prompt 前缀的绝对稳定。此外，文章还提供了避免缓存失效的实践建议，包括对话中避免修改 CLAUDE.md、不中途增删 MCP 服务，以及减少不必要的 `–resume` 操作，以最大化 AI 编程过程中的缓存利用率并降低成本。

事件分析

💡 核心观点：从“提示词工程”进阶到“缓存工程”：动态上下文注入与字节级匹配机制的冲突，将重塑 AI 编程工具的设计逻辑。