前缀匹配只认从开头起逐字一致的部分
缓存从请求的第一个 token 开始比对,只有与已缓存内容完全相同的连续开头计为命中。出现第一处差异后,其后的全部内容即使与之前相同,也按未命中处理。
和 AI 多轮对话时,每发一条新消息,软件都会把系统设定和此前的全部对话连同新消息一起,重新发给模型一遍。缓存就是为这部分重复内容准备的。
一次请求的开头部分,如果与几分钟内已存入缓存的内容逐字一致,模型会直接读取缓存,不再重新处理。这部分称为命中,按远低于原价的折扣价计费;其余未命中的新内容按原价处理,并写入缓存供下一次使用。折扣多少、缓存保留多久,由各厂商、各模型自定。
以 Claude Opus 5.5 为例(本页所有计算均按这组价格)
Claude Opus 5.5 的 API 标准价(5 分钟缓存),2026-10-16 核对自 Anthropic 官方定价页。Claude 多数其他模型的命中价为原价的 10%;其他厂商的折扣、是否收取写入费各不相同。
示例话题:和 AI 讨论马斯克的飞行汽车,按 Claude Opus 5.5 计价。每一行是一次发送的完整内容,蓝色虚线标出上一次发到哪里,虚线左边与上次逐字一致。
演示即将开始。
先发送第一个问题,再连续点几次「接着问一句」,然后试试另外两个按钮。图中每格代表 1 万 token,系统设定占 3 格。
示例对话仅用于演示计费方式,不代表对相关产品的判断。
以下以 Anthropic 官方文档为准。其他厂商的缓存同样按开头匹配,但有效期和价格各不相同。
缓存从请求的第一个 token 开始比对,只有与已缓存内容完全相同的连续开头计为命中。出现第一处差异后,其后的全部内容即使与之前相同,也按未命中处理。
缓存默认保留 5 分钟,从读写它的那次请求开始计时,每次命中都会免费刷新。超过 5 分钟未被使用即失效,下一次请求需按原价重新处理并写入。
首次写入缓存的内容按原价的 1.25 倍计费,此后每次命中按原价的 5% 计费。只要被命中一次,写入时多付的费用即可收回。
另:在 Opus 5.5 上,能被缓存的内容至少需要 512 token,更短的内容按普通输入计费。
系统设定 3 万 token,每轮新增一问一答共 2 万 token,Claude Opus 5.5,只计输入费用。
缓存是自动的:使用 Claude Code、Codex 等 AI 工具时,缓存由工具自动处理,无需任何手动设置。
各家的缓存价格和有效期不完全相同,本页数字以 Claude Opus 5.5 为准。缓存虽然是自动的,能不能命中还取决于使用习惯。
下面两件事工具替你做不了,养成习惯就能多命中。
中途修改系统提示或项目说明、切换模型、增减工具,都会让此前的缓存失效。确需调整时集中一次改完;改动较大时,直接开启新对话。
两条消息间隔超过 5 分钟,下一条就要整段重新处理。同一份资料的问题尽量集中问完,再去做别的事。
自己调用 API、搭建 AI 应用时适用。
系统提示、参考文档、示例这类长期不变的内容放在请求开头;每次不同的问题、日期、变量放在末尾。开头每多一处变动,可命中的部分就短一截。
Claude API 在请求顶层加上 cache_control 即可启用自动缓存;响应中的 cache_read_input_tokens 是本次命中的 token 数,可据此确认缓存是否生效。