Claude Prompt Cache 完全指南：5m / 1h 档位实测

一、Cache 是什么？

Anthropic 提供 prompt cache 机制：相同 prompt 第二次调用时，输入价直接打折。具体折扣看 Claude Opus 4.7 官方 L3 详情，含 cache_read 5m / cache_write_5m / cache_write_1h 三档。

二、3 档定价（实测）

• cache_read_5m — 5 分钟内重读同一 prompt，$0.30/M（基础价的 10%）
• cache_write_5m — 写入 5 分钟缓存，$3.75/M（基础价的 25%）
• cache_write_1h — 写入 1 小时缓存，$6/M（基础价的 40%）

三、6 个该开 cache 的场景

1. 长 system prompt（>1k tokens）— 重读成本高，cache 必开
2. 多轮对话— 第 2 轮开始所有历史都是 cache hit
3. 批量任务（同 prompt 100 次）— 第 2-100 次全 cache hit
4. RAG 检索— 检索到的文档固定，cache 后只算新 query
5. Few-shot— 示例固定，cache 后只算新 input
6. Agent loop— 工具描述固定，cache 后只算新任务

四、3 个不该开 cache 的场景

1. 短 prompt（<500 tokens）— cache write 成本反而更高
2. 每次 prompt 都不一样— cache hit 率 0% = 浪费
3. 5m 内不会重读— 5m 缓存过期，浪费 write 钱

五、决策清单

1. 看 Anthropic 官方 cache 档位定价

2. 看 Laozhang.ai Claude 详情 = 中转站是否透传 cache 价

3. Claude 检测 跑一次 = 验证 cache 协议透传