写代码写到一半,额度没了。这是不少 Claude Code 用户都遇到过的场景:一个功能还没收尾,用量先见底,只能停下来等窗口重置。Claude Code 本身带了一个 /usage 命令,能看已经用掉多少额度,但有人觉得不够用——他想要一个持续跟踪、还能告诉他"按当前速度还能撑多久"的东西。
于是他写了一个小工具,和 Claude Code 并排运行,盯着五小时窗口和每周上限两条线,估算自己大概什么时候会撞线。
难预测的,是任务到底吃多少额度
用 Claude Code 的一个体会是:很难预判某个任务会消耗多少额度。有时候几个提示词就能把一个完整功能搭出来;有时候只是修一个 bug,却演变成漫长的调试,Claude 反复读文件、跑命令、改代码。两种都在烧额度,但烧的速度完全不是一回事。
Claude Code 同时有五小时使用窗口和每周上限,做较大项目时两条线都得盯着。当前五小时窗口里可能还剩不少,但每周上限已经快到了。而且因为消耗速率并不恒定,"已经用掉 60%"这个数字,并不能说明还能干多少活。
内置的 /usage 命令查当前状态够用,但每写几个提示词就中断一次工作流去查,实在麻烦。更关键的是,它不会告诉你:按最近这阵子的用法,剩下额度是二十分钟后见底,还是能再安心干一小时。
一个本地跑的小仪表盘
这个工具叫 Usage Window,用 Python 写成,通过 Claude Code 已有的状态栏接口接入。它不需要 API key,也不依赖额外的 Python 包,整个东西都在本地运行。安装只需执行 python3 usage_window.py --install,这一步会配置 Claude Code 把用量信息传给脚本,脚本再把这些观测记录进本地的一个 SQLite 数据库。
装好之后,可以在另一个终端窗格里打开仪表盘,和 Claude Code 并排看。主界面有两个仪表,分别对应五小时和每周额度,显示已用多少、还剩多少、各自什么时候重置,另外还有当前上下文用量和活跃使用窗口的时间线。
作者最喜欢的功能是"预计触限时间":工具根据最近若干次观测里额度的消耗速度,粗略算出按这个节奏还能撑多久。这个预测需要足够多的近期数据,所以不是任何时候都会给出估算。
另外还有两个视图值得一提:
- 历史视图:查看过去一小时、24 小时或七天里用量怎么变化,带图表和逐条观测记录。
- 会话视图:显示每个 Claude Code 会话最近一次记录的活动、所用模型和上下文用量。
此外还有一个 /usage-window 斜杠命令,不打开仪表盘也能快速看一眼快照。因为用的是 Claude Code 本来就提供的数据,这个工具不需要发任何网络请求,也不收集对话内容。仪表盘会随新观测到达而更新,并对超过五分钟的读数做标记,让人知道信息已经过期。
默认值只是起点
装上 Usage Window 之后,作者说自己对 Claude Code 会话的管理好了不少。快接近用量上限时,他会把手头的活收个尾,而不是再开一个复杂的新任务。借助工具收集的历史数据,他也更清楚自己在长时间编码会话里通常会消耗多少额度。
做这个工具的过程,还让他对 Claude Code 其他可改的地方产生了兴趣。他此前试过用钩子让智能体更可靠,比如加了一个 Stop 钩子,让 Claude 在完成任务前先回顾一份它以前犯过的错误清单。
Claude Code 现在还支持 mods,把可定制性又往前推了一步。mods 能改变 Claude Code 的行为方式,甚至改动它的界面。你可以做一个在终端里显示额外项目信息的 mod,做一个阻止某些命令执行的 mod,或者改变 Claude 处理特定工具调用的方式。
Anthropic 自己已经在用 mods 实现 Claude Code 的部分内置功能,包括它的 /diff 界面。社区做的 mod 可以通过插件系统安装,也可以直接让 Claude Code 按某个具体需求生成一个。
在作者看来,这是 Claude Code 比较有意思的一面:想要的功能不一定非得等 Anthropic 发布,稍微动手试一下,就能自己造出来,让 Claude Code 按自己想要的方式工作。
他说自己只是摸到了 Claude Code 可定制能力的表层,手头还有几个想法想试。对经常用 Claude Code 的人,他的建议是去翻一翻它的钩子、插件和 mods——你一直缺的那些功能,可能比想象中容易自己搭出来。
热门跟贴