Claude 提示缓存 1412 次调用零命中：一个时间戳导致失效

作者开启 Claude 提示缓存后，发现 1412 次调用的 cache_read_input_tokens 均为 0，API 未报错。排查出三个独立问题：系统提示以“Current time: 09:41:07”开头，导致前缀每次变化；工具列表由 Python set 构建，字符串哈希随机化使 4 个 worker 发送的工具顺序不同；缓存断点前内容必须逐字节一致。文章强调需主动检查缓存命中字段，否则会持续按全价重复计费。

AI推荐理由 文章基于 1412 次调用中 cache_read_input_tokens 全为 0 的实际日志，定位出三个导致 Claude 提示缓存完全失效的原因：系统提示以动态时间戳开头、工具列表由 Python set 构建导致顺序随机、以及缓存断点前内容不一致；并强调 API 不报错、需主动读取缓存字段。对使用 Claude API 的开发者有直接排错价值，属于具体可验证的工程经验。