Claude Code 总被额度打断?自制一个用量看板提前预警

Claude Code 的五小时额度和每周额度总在关键时刻用完?有用户写了个本地小工具 Usage Window,接上状态栏实时显示用量并估算剩余时间。小编整理了思路、功能和可定制的地方。

写到一半,额度没了:用 Claude Code 开发新功能的人,大概都遇到过这种事。内置的 /usage 命令能查看已用多少,但有位用户想要的是更进一步:持续跟踪,并且告诉他按现在的速度还能干多久。于是他自己写了个小工具,放在 Claude Code 旁边,跟踪五小时和每周两道额度,并估算什么时候会撞线。小编先说结论:这类工具的价值不在“多一个数字”,而在让您提前知道该收尾还是该继续。

为什么额度总是不好预估

这位用户的体会是,一个任务消耗多少额度很难预测。有时几条提示词就能做完一个功能;有时修一个小 bug,变成一场漫长的排查,Claude 反复读文件、跑命令、改代码。两种情况都消耗额度,速度却相差很大。

Claude Code 有五小时窗口和每周额度两道限制,做大项目时两者都要盯。可能当前五小时窗口还剩很多,但周额度已经接近上限。而且因为消耗不均匀,“已经用了 60%”并不能告诉您还能再干多少活。

内置的 /usage 用来看当前进度没问题,但他不想每隔几条提示词就打断一次工作去查。更重要的是,它不会告诉您“按最近的速度,20 分钟内会不会用完”。

他做了一个什么样的用量看板

Claude 用量窗口看板截图

这个小工具叫 Usage Window,用 Python 写成,通过 Claude Code 现有的状态栏接口取得用量数据。它不需要 API 密钥,也不需要额外安装 Python 包,全程在本地运行。按他的描述,运行一次 python3 usage_window.py --install,就会配置好让 Claude Code 把用量信息传给脚本,数据则记录在本地的 SQLite 数据库里。

装好后,可以在终端的另一个分屏里打开看板,和 Claude Code 并排使用。主界面是两个仪表:五小时额度和每周额度,分别显示已用、剩余和重置时间,还有当前上下文用量,以及正在使用的各个额度窗口的时间线。

他最喜欢的是“预计撞线时间”:工具根据最近几次的消耗速度,估算按这个节奏还能继续多久。它需要足够多的近期数据才能预测,所以不是任何时候都有估算。

  • 历史视图:可看过去一小时、24 小时或七天的用量变化,带图表和逐条记录;
  • 会话视图:显示每个 Claude Code 会话最近的活动、使用的模型和上下文用量;
  • 快捷命令:/usage-window 能在不打开看板的情况下给出一份快照;
  • 数据新鲜度:看板随新数据更新,遇到超过五分钟的旧读数会标出来,提醒信息可能过时。

据他说,因为它只用 Claude Code 已提供的数据,既不发出网络请求,也不收集对话内容。

Claude Code 还有不少可以定制的地方

装了这个看板之后,他对会话的管理明显更从容:接近上限时,先收尾手头的事,不再开始复杂的新任务;根据历史数据,也更清楚自己长时间编码一般要消耗多少额度。

这件事也勾起了他对“还能改哪些地方”的兴趣。此前他试过用 hooks(钩子)让智能体更可靠,比如加一个 Stop 钩子,让 Claude 在收工前先对照自己以往犯过的错误清单检查一遍。据他介绍,Claude Code 现在还支持 mods,能改变它的行为,甚至修改界面:可以做一个在终端显示额外项目信息的,可以做一个禁止执行某些命令的,也可以改变某些工具调用的处理方式。Anthropic 自己已经用 mods 实现了一些内置功能,比如 /diff 界面;社区做的 mods 可以通过插件系统安装,也可以让 Claude Code 按需求现场写一个。

想了解 hooks、插件等官方功能,可以看 Claude Code 官方文档,具体名称和用法以文档为准。

小编的看法

额度焦虑的根源,是看不见、预判不了。哪怕不自己写工具,也可以学这位用户的两点思路:一是同时盯五小时窗口和周额度,二是接近上限时优先收尾而不是开新坑。更想省额度的话,可以参考 Claude 额度总不够用?让本地显卡先写代码,能省近一半钱,或者 OpenCode 加 VS Code 的两段式 AI 编程。

常见问题(FAQ)

Claude Code 的额度有几种限制?

据这位用户介绍,有一个五小时使用窗口,另有每周额度,两者要同时关注。

内置的 /usage 命令还不够用吗?

它能告诉您当前已用多少,但没法持续跟踪,也不会估算按当前节奏多久会用完。

这个工具会上传我的对话吗?

据作者描述不会:它只用 Claude Code 提供的用量数据,在本地记录,不发网络请求也不收集对话。

为什么有时看不到“预计撞线时间”?

预测需要足够多的近期观测数据,数据不足时就不会给出估算。

什么是 Claude Code 的 mods?

据原文介绍,它是比 hooks 更深入的定制方式,能改变 Claude Code 的行为甚至界面,具体支持范围请以官方文档为准。