2026 年三月,工作到一半被用量限制挡下来时,我才打开 Claude 的 Settings 看数字。原来额外用量已经到了 84%,七天用量也过半了。
我想,如果提醒能一直放在眼前,至少可以早一点安排接下来的工作。于是我和 Claude 协作做了一个 Chrome Extension,叫「Claude 用量喵喵」。工具列上是一只橘虎斑,点开可以看用量卡片。
这篇记录的是当时的开发经验。工具后来的版本与服务介面都可能改变,以下不把原本的画面当成所有帐号现在都能取得的结果。
它做什么
我把提醒放在三个地方:工具列 badge、点开后的 popup,以及 claude.ai 页面上的浮动状态条。目的很单纯,让我不用等到被挡下来,才想起去看用量。
当时设计的上半部,是帐号侧的五小时、七天等百分比,以及额外用量栏位。下半部,则整理该浏览器网页对话能观察到的 token 与费用估算。
这里的「费用」需要讲清楚。把估计 token 乘上某份模型价目表,得到的是 API 定价等值估算,不是 Pro/Max 的实际扣额,也不是付款帐单。价格表、模型判定与估算方式不同,结果也会变。
颜色与图示可以提醒我留意,却不能告诉我还能完成多少工作。画面上的数字仍要连同来源、更新时间与错误状态一起看。
两条管道,各自回答不同的问题
第一条管道向 claude.ai 的内部用量端点请求帐号资料。公开程式码中的 background.js可以看到这个流程,以及五小时、七天与额外用量等栏位的解析。
资料来自服务端,不代表这是一套有公开契约、可以长期依赖的开发者 API。栏位、权限或回应方式改变时,工具就需要维护。请求失败,也不能解读成用量为零。
第二条管道在 claude.ai 网页中观察对话请求与串流回应,整理这个浏览器能捕捉到的内容。它不能保证涵盖帐号的全部使用,也不能把估算当成模型实际计费的完整 token 纪录。
因此,上方的方案百分比与下方的网页估算,是不同范围、不同单位的讯号。它们可以并排观察,却不能直接相减,或当成同一分母下的误差。
Claude Code 也需要分开说。Anthropic 的方案说明指出,以订阅登入时,Claude 与 Claude Code 共用方案限制;使用 API 计费则是另一种情况。网页拦截器看不到 CLI 的逐笔对话,不等于 CLI 不会影响帐号侧的方案百分比。
我想保留两条管道,是为了看见各自能提供什么,以及哪些地方仍然不知道。
动手之前先查了一圈
开始写程式前,我找了十多个相关工具。那批样本里有不少 macOS 原生 app,我当时也没有找到符合自己介面与语言需求的组合。
这是一段有限的搜寻经验,不能推成所有工具都只有英文、其他平台都没有选择,或没有人做过双来源介面。
对我而言,产品方向仍然清楚:用 Chrome Extension 呈现,把两条管道放在一起,先把中文做好。当时再补上英文与日文,让介面可以随浏览器语言切换。
这些是当时的取舍。支援范围与安装方法,还是要回到专案目前的版本说明核对,不能由一篇开发纪录保证所有环境都测过。
开发过程踩到的几个坑(对技术没兴趣可直接省略)
第一个坑是回应格式。接内部端点时,我没有可依循的公开格式文件,第一次在 popup 看到原始 JSON,才逐步弄清楚栏位。这帮助我除错,也提醒我:能解析一次,不表示之后不会改。
保留除错资讯有用,但原始回应可能包含帐号或组织资讯。若要拿来讨论问题,我会先移除不需要的栏位,而不是直接把整份内容贴出去。
第二个坑是脚本执行的环境。Chrome 的 content script 说明区分页面与扩充功能的 isolated world。我起初在隔离环境里修改 window.fetch,没有捕捉到页面的请求,后来才把相关脚本放到 MAIN world,再透过事件把资料交回桥接层。
这解决的是脚本在哪里运作的问题。进入页面的执行环境,也表示资料边界需要仔细看,不能因为功能跑通,就推论隔离与安全已经验收。
第三个坑是 icon。前后做了三版,我才用橘虎斑的参考照片,把耳朵与额头的 M 字纹调到接近想要的样子。对这次合作来说,具体参考比继续形容更有帮助。
限制先说清楚
我现在更在意的,是让介面清楚区分帐号资料、局部估算与读取失败。只有一个醒目的百分比,却看不出时间与口径,仍可能让人误判。
登入与资料流向也要说准。同一公开版本的 manifest宣告了 storage、alarms 与 claude.ai 的主机存取范围,并设定页面脚本;background 则使用 credentials: 'include' 随请求沿用登入状态。这不同于宣称程式直接读出 Cookie 值。
使用本机储存,不代表完全没有对外请求。这个工具本来就会向 claude.ai 取得资料。原始码公开,能让人检视,但不能代替对版本、权限与实际套件的确认。
这次没有重新登入帐号测试,也没有替 Web Store 套件或所有依赖做完整安全稽核。这篇能交代的是开发思路与公开程式码中的部分架构,不能把它当成目前每个帐号的功能保证。
我想做的,始终是一个能提醒自己提早看一眼的小工具。把不知道的地方标清楚,会比让每个数字看起来都很精确,更接近它原本的目的。
**2026 年 11 月修订:**保留三月的开发经验,厘清资料来源、估算口径、登入方式与公开原始码能支持的范围。


💬 留言讨论
加载中...