用量看板出现在 · 横条 / 面板 / 弹窗收录

Cache Control 提示缓存倒计时

输入框上方显示缓存命中与失效倒计时。

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+ 且账号已开通该功能。