跳到正文
claudemods

Claude Code 用量与费用插件:上下文、额度与费用

Claude Code 用量与费用插件会显示上下文窗口占用、5 小时与 7 天套餐用量、会话费用和工具调用次数,让额度上限和上下文压缩不再突然到来。

Cache Clock 在 Claude Code 中运行精选

Cache Clock

在 Claude Code 状态栏下方显示提示缓存:热缓存的剩余时间、命中率,以及缓存变冷后需重新缓存的 token 数。

  • 状态栏
  • 读取文件
  • 写入文件
  • 执行命令
  • 添加命令/工具

已在 v2.1.296 实测

上下文仪表 在 Claude Code 中运行精选

上下文仪表

在状态栏显示上下文窗口占用、5 小时与 7 天套餐用量和会话花费,并在接近上限时发出提醒。

  • 状态栏
  • 弹出通知
  • 修改界面

已在 v2.1.310 实测

工具调用计数器 在 Claude Code 中运行精选

工具调用计数器

统计 Claude 每轮和每个会话的工具调用次数,在加载指示器旁显示计数,并新增 /tally 查看明细。

  • 加载动画
  • 对话记录
  • 状态栏
  • 拦截工具调用
  • 修改界面
  • 添加命令/工具

已在 v2.1.310 实测

Compact Adviser 在 Claude Code 中运行精选

Compact Adviser

在一段工作告一段落时告诉你该运行 /compact 了:由 TypeSafe 的 Jev 判断这是不是合适的检查点。

  • 状态栏
  • 面板
  • 弹出通知
  • 读取文件
  • 写入文件
  • 网络访问
  • 读取你的提示词
  • 修改界面
  • 添加命令/工具
  • 存储数据

已在 v2.1.291 实测

Context Bar 在 Claude Code 中运行精选

Context Bar

在 Claude Code 输入框上方用一条堆叠横条显示上下文窗口,每个类别一种颜色,并附带 token 数。

  • 输入框上方
  • 修改界面
  • 添加命令/工具
  • 存储数据

已在 v2.1.291 实测

Context Inspector 在 Claude Code 中运行精选

Context Inspector

显示 Claude Code 上下文窗口被什么占满、其中有多少是重复读取和重复输出,以及压缩保留了什么。

  • 状态栏
  • 面板
  • 弹出通知
  • 写入文件
  • 拦截工具调用
  • 读取你的提示词
  • 修改界面
  • 添加命令/工具

已在 v2.1.303 实测

ctx-handoff 在 Claude Code 中运行精选

ctx-handoff

保持提示缓存不过期,把你教给 Claude 的内容整理成项目笔记,并可在上下文写满时完成交接。

  • 输入框上方
  • 状态栏
  • 弹出通知
  • 读取文件
  • 写入文件
  • 调用模型(消耗你的额度)
  • 拦截工具调用
  • 读取你的提示词
  • 修改界面
  • 添加命令/工具
  • 存储数据

已在 v2.1.303 实测

Project Sentinel 在 Claude Code 中运行精选

Project Sentinel

为长时间运行的 Claude Code 任务提供状态带、上下文交接、提示缓存追踪和权限规则。

  • 输入框上方
  • 面板
  • 加载动画
  • 状态栏
  • 弹出通知
  • 读取文件
  • 执行命令
  • 调用模型(消耗你的额度)
  • 拦截工具调用
  • 读取你的提示词
  • 修改界面
  • 添加命令/工具
  • 存储数据

已在 v2.1.296 实测

Token Weather 在 Claude Code 中运行精选

Token Weather

在输入框上方用天气预报显示 Claude Code 上下文窗口的占用,并附带最近几轮的趋势和提示缓存倒计时。

  • 输入框上方
  • 读取文件
  • 执行命令
  • 修改界面
  • 存储数据

已在 v2.1.307 实测

Usage Meter 在 Claude Code 中运行精选

Usage Meter

在 Claude Code 输入框上方用小横条显示 5 小时与 7 天套餐用量、重置倒计时和会话花费。

  • 输入框上方
  • 弹出通知
  • 修改界面

已在 v2.1.291 实测

Use Haiku 在 Claude Code 中运行精选

Use Haiku

在 Claude Code 提示前加 _,这一轮就用 Haiku 运行,并在输入时、运行中和回答下方都有提示。

  • 加载动画
  • 对话记录
  • 状态栏
  • 读取你的提示词
  • 修改界面

已在 v2.1.303 实测

Claude Code 用量与费用插件让限制你会话的各项数字始终可见:上下文窗口占用了多少、5 小时和 7 天套餐窗口已经用掉多少、本次会话到目前为止花了多少钱,以及 Claude 调用了多少次工具。你可以提前看到上下文压缩或速率限制即将到来,而不是在任务进行到一半时突然撞上。

Claude Code 用量与费用插件的数字从哪里来?

主要来源是 $.session.usage()。它返回 startedAt、context(token 数、窗口大小和百分比)、rateLimits(每个套餐窗口一项,包含 percentUsed)以及 cost。不带明细调用时它不会发出任何请求,所以插件可以在每个回合结束后免费读取。插件通常在 turn.complete、session.compact 时以及通过较慢的 $.clock.every 定时器刷新,然后用 $.ui.status 写出结果。

session.measure 会在每个回合结束后以及套餐用量变化时触发,适合需要对阈值做出反应的插件。活动计数器(例如工具调用计数)会统计 tool.call 事件,并把总数保存在 $.state 中。mods 参考文档介绍了用量对象的结构。

安装前应该检查什么?

用量显示类插件需要的权限应该非常少:通常只有 修改界面,没有别的。如果用量插件显示 网络访问,说明它正在把你的数字发送到某个地方,请弄清楚发到了哪里。用量插件带有 调用模型 则是危险信号,因为它会消耗它声称要追踪的那份额度。

再检查它如何处理缺失的数据。在第一次回复之前还没有上下文数据;使用 API 密钥时也没有套餐窗口。细心的插件会省略这些部分,而不是显示一个误导人的 0。还要确认警告提示是每个阈值只弹出一次,还是每次刷新都弹出。

看到这些数字后该怎么做?

当上下文超过约 80% 时,运行 /compact 并附上一句简短说明,指出需要保留什么;或者运行 /clear,带着一份总结重新开始。当 5 小时窗口用量偏高时,把耗时较长的任务推迟,或者换用更小的模型。用量插件不会改变任何限制;它们只是足够早地提醒你,让你有时间做出选择。

常见问题

读取用量会消耗 token 吗?
当插件不带明细地调用 $.session.usage() 时不会。它返回的是 Claude Code 已经在跟踪的数据。请求明细则会发送一次 token 计数请求。
为什么用量插件没有显示 5 小时或 7 天的数据?
套餐用量窗口只存在于订阅方案中。使用 API 密钥时没有速率限制窗口可显示,所以好的插件会直接省略它们,而不是显示 0。
费用数字和 /cost 一样吗?
它和 /cost 汇总的是同一份会话用量数据,单位为美元。它只是对本次会话的估算,并不是你的账单。