Repolode
karanb192

karanb192/cache-tax

Claude Code 插件,离开时保持提示缓存温热,并在冷发送前预估重写成本。

Star
357
Fork
54
未关闭 Issue
20
最近提交
前天

这是什么?

Cache Tax 是一个 Claude Code 插件(mod),用于解决长会话在提示缓存过期后重新续聊时产生的高额费用。离开前执行 /keepwarm 即可开启一个有时限的保温窗口,期间会以固定间隔对会话发起一次小型 fork 请求,让缓存上下文保持有效。若缓存读取结果显示已经变冷,保温会自动停止。

当你回到上下文较大的冷会话时,插件会拦截第一条普通消息一次,并显示重写缓存的预估费用。确认后重新发送即可正常继续,也可以用 /clear 从笔记开始。提示符上方的状态行会显示保温状态、下次 ping 时间和最近一次读取结果。价格按各模型的标价估算,插件说明订阅套餐并不会因此产生额外扣费。

核心功能

  • 01在设定的时间窗口内定期 ping,保持提示缓存温热
  • 02冷发送前显示预估重写成本,并可拦截消息一次
  • 03缓存读取结果显示已变冷时自动停止保温
  • 04提供 /cache-tax 命令和提示符上方的状态行
  • 05通过插件市场以 Claude Code 插件形式安装

适用场景

  • 长时间编码会话中途离开吃饭或开会,避免回来时重写整段上下文
  • 判断是继续旧会话还是基于摘要笔记重新开始
  • 在按 API 密钥计费的长会话中监控缓存状态和费用

快速上手

  1. 1

    添加插件市场

    claude plugin marketplace add karanb192/claude-code-mods
  2. 2

    安装 cache-tax 插件

    claude plugin install cache-tax@claude-code-mods
  3. 3

    重启 Claude Code 或在已打开的会话中重新加载插件

    /reload-plugins
  4. 4

    在热缓存会话中启用六小时保温

    /keepwarm

使用前须知

  • 需要 Claude Code 2.1.287 或更高版本,且 Claude Code 必须保持运行才能发送保温请求。
  • 每次保温请求都会消耗 token,并非免费。
  • API 密钥和云服务商会话默认缓存为五分钟,需要将 promptCacheTtl 设为 "1h"。

收录于专题

标签

#claude-code#prompt-caching#llm-cost#cli-plugin#typescript#claude-code-plugin#claude-mods#function-hooks

常见问题

cache-tax 是什么?
Claude Code 插件,离开时保持提示缓存温热,并在冷发送前预估重写成本。 Cache Tax 是一个 Claude Code 插件(mod),用于解决长会话在提示缓存过期后重新续聊时产生的高额费用。离开前执行 /keepwarm 即可开启一个有时限的保温窗口,期间会以固定间隔对会话发起一次小型 fork 请求,让缓存上下文保持有效。若缓存读取结果显示已经变冷,保温会自动停止。
cache-tax 可以免费使用吗?用的什么许可证?
cache-tax 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
cache-tax 还在维护吗?
活跃维护中。cache-tax 最近一次提交是在 2026年11月5日。
cache-tax 适合用来做什么?
长时间编码会话中途离开吃饭或开会,避免回来时重写整段上下文 判断是继续旧会话还是基于摘要笔记重新开始 在按 API 密钥计费的长会话中监控缓存状态和费用
cache-tax 怎么安装和运行?
添加插件市场: claude plugin marketplace add karanb192/claude-code-mods 安装 cache-tax 插件: claude plugin install cache-tax@claude-code-mods 重启 Claude Code 或在已打开的会话中重新加载插件: /reload-plugins 在热缓存会话中启用六小时保温: /keepwarm
在哪里获取 cache-tax?
源代码和安装说明在 GitHub 上:https://github.com/karanb192/cache-tax

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目