揭秘 Claude Code 缓存机制：避开这 5 个坑，Token 账单立省 90%

Anthropic 推出的 AI 编程工具 Claude Code 对 Prompt Cache（提示词缓存）极度敏感。由于编程场景下输入与输出 token 比例常高达 30:1，缓存命中与否直接决定了 API 调用成本是相差数倍还是享受 90% 的折扣。文章通过源码分析和实战经验，澄清了缓存基于“前缀匹配”而非内容重复检测的工作原理：服务端仅保存最近发送的 prompt 前缀，前缀的任何细微变动都会导致后续内容缓存全部失效。作者总结了导致缓存失效的五个核心陷阱：中途修改 CLAUDE.md 配置文件、在系统提示中嵌入动态时间戳、对话过程中切换模型、使用 `/compact` 命令破坏前缀结构以及 `/resume` 恢复会话时的序列化差异。针对这些问题，文中给出了明确对策：在会话开始前配置好规则、将动态信息置于消息末尾、保持任务模型一致、尽早执行压缩操作并尽量减少会话恢复频率。

事件分析

💡 核心观点：Prompt Cache 是长上下文时代的成本倍增器，其脆弱性倒逼开发者将 AI 交互从随意对话转向结构化的工程管理。