Cache Control 提示缓存倒计时
输入框上方显示缓存命中与失效倒计时。
> 给订单列表加上分页
⏺ 我先看看列表组件。
缓存 ██████████ 98% 读 80k · 写 1k · 新 300 ⏱ 3:41
5m · 缓存温热:继续对话
缓存 ░░░░░░░░░░ 0% 读 0 · 写 52k · 模型已变更
缓存 ██████████ 98% ⏱ 0:00 · 已过期,建议先 /compact
❯
示意。实际效果取决于 Mod、终端和运行环境。
安装
安装方式比较特殊,请按原作者说明
查看原作者说明 ↗它会碰什么
据原作者说明,收录时核对;可用 claude plugin validate 自行检查。
读取
有读取每次请求的缓存用量、限额窗口、环境变量,以及 ~/.claude.json 与设置文件里的几个键。
写入文件
未说明README 没有权限说明;代码里未见写文件调用。
运行命令
未说明README 没有权限说明;代码里未见启动进程的调用。
联网
未说明README 没有权限说明;代码里未见网络调用,它只读取用量数据。
介绍
Cache Control 是 claude-code-templates 出品的 Claude Code function hooks Mod。它在输入框上方画一条缓存条:每次请求从缓存读了多少、写了多少、没缓存多少,并倒数缓存何时失效,提示继续、/compact 还是 /clear。/cache 打开面板,列出剩余时间条和逐轮表格;缓存快到期时弹 toast。
- 缓存有效期按 Claude Code 自己的规则推断(订阅 1 小时,API key、云厂商或额度 5 分钟,也认相关环境变量和
promptCacheTtl),并根据请求间隔自我修正。 - Claude Code 2.1.290+ 的空闲自动压缩开启时,条上追加压缩倒计时;该标志从
~/.claude.json读取,读不到就不显示。 - 选项含 ttl、warnSeconds、compactAtTokens、band、status、toast、idleCompact。
通过 npx 安装。未实测,预览为示意。
适合谁
- 想避免缓存过期后整段重写的人
- 长会话里要决定何时压缩或清空的人
运行要求
- Claude Code ≥ 2.1.287
- 安装:npx claude-code-templates@latest --mod observability/prompt-cache-control
- 空闲压缩倒计时需要 Claude Code 2.1.290+ 且账号已开通该功能。