缓存存活时间(TTL)

缓存存活时间(TTL)是已缓存提示前缀在未被使用时可保留的时长;过期后,下次请求必须重新处理并写入它。

截至 2026 年 9 月,Anthropic API 的默认寿命为五分钟。一小时寿命的写入价格是基础输入价的 2 倍,五分钟则为 1.25 倍。计时并非从写入起固定到期:每次读取都会免费延长寿命,因此请求持续在期限内到达,缓存便能维持。计时从请求开始而非响应结束算起,较长的回答会占去一部分时间。

选择寿命相当于预测停顿。工作中断二十分钟后恢复时,一小时缓存可让首个请求直接读取前缀,而不必重建。若请求始终在五分钟内接续,较长寿命通常只是增加写入价格。

编码代理通常代你选择。截至 2026 年 9 月,Claude Code 在 Claude 订阅套餐的包含用量内为主会话请求一小时寿命;使用 API 密钥、云服务商或用量积分时为五分钟,子代理默认也是五分钟。promptCacheTtl 设置可覆盖主会话的选择。

无论寿命多长,过期后的首个消息通常最贵,因为它无法命中缓存,必须重新处理整个上下文。若读取只需基础输入价的十分之一,而写入至少需要 1.25 倍,重建一次很长的上下文可能比连续读取十次还贵。

← 全部术语