跳到正文
claudemods

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

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

上下文仪表 在 Claude Code 中运行

上下文仪表

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

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

已在 v2.1.291 实测

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

工具调用计数器

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

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

已在 v2.1.291 实测

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 汇总的是同一份会话用量数据,单位为美元。它只是对本次会话的估算,并不是你的账单。