Claude Counter 完全指南:一个极简浏览器扩展让 claude.ai 的 Token 与配额彻底透明
【免费下载链接】claude-counterA minimal browser extension that shows token count, cache timer, and usage bars on claude.ai.项目地址: https://gitcode.com/gh_mirrors/cl/claude-counter
Claude Counter是一款专为 claude.ai 打造的极简浏览器扩展:它实时显示当前对话的Token 计数、缓存剩余计时器,以及5 小时会话 / 7 天周配额的使用进度条与重置倒计时。无需注册、无需配置,装上即用,让 Claude 的用量从此透明可控。
一、三大核心功能,一眼看懂 Claude 用量 🔍
1️⃣ Token 计数:实时看到对话的"体积"
对话越长,Claude 消耗越多。Claude Counter 会在页面顶部显示当前对话的近似 Token 数,并配一条对照200k 上下文上限的迷你进度条——条子快满了,就该考虑开新对话了。
- 采用内置的
o200k_base分词器本地估算,数值仅供近似参考 - 200k 上下文上限等关键常量定义在 src/content/constants.js
2️⃣ 缓存计时器:省钱倒计时 ⏱️
Claude 的对话在回复后有约 5 分钟的缓存窗口,窗口内继续提问更便宜。扩展会显示cached for X:XX倒计时,提醒你趁缓存还在赶紧追问。缓存窗口常量同样来自 src/content/constants.js(CACHE_WINDOW_MS,5 分钟)。
3️⃣ 使用量进度条:会话与周配额一目了然 📊
在输入框下方,扩展会显示两条进度条:
| 进度条 | 窗口 | 说明 |
|---|---|---|
| Session | 5 小时 | 当前会话窗口用量 + 重置倒计时 |
| Weekly | 7 天 | 本周累计用量 + 重置倒计时 |
数据来自 Claude 原生/usage接口加实时 SSEmessage_limit流,是未取整的精确比例,比 claude.ai 自带 /usage 页面上的四舍五入百分比更准。用量接近 90% 时进度条会变色警示。
二、三种安装方式,一分钟上手 🚀
Chrome / Edge / Chromium 用户
- 到项目 Releases 页面下载 v0.4.2 的 zip 安装包
- 打开
chrome://extensions,开启右上角开发者模式(Developer mode) - 把 zip 文件直接拖拽到扩展页面,即完成安装
Firefox 用户
- 下载
.xpi安装包 - 将其拖入任意 Firefox 窗口,点击添加即可
用户脚本方式(免装扩展)
如果你习惯用脚本管理器(如 Tampermonkey),也可以直接安装用户脚本版本 userscript/claude-counter.user.js,功能与扩展版一致。
三、它是怎么做到的?(不用读代码也能懂)🧠
整个扩展只由几段轻量 JS 组成,核心思路是"旁听 + 展示":
- 旁听 API:页面加载时注入一个桥接脚本,旁听 claude.ai 自己的网络请求(只读、不修改),拿到对话内容和配额信息 —— 见 src/injected/bridge.js
- 本地计数:内置
o200k_base分词器对消息逐条估算 Token,并按消息指纹缓存结果避免重复计算 —— 见 src/content/tokens.js - 界面注入:监听页面 DOM 变化,把 Token 计数、进度条等 UI 悄悄挂到合适的锚点上,切换对话时自动跟随 —— 见 src/content/ui.js 与样式 src/styles.css
- 消息通道:内容脚本与注入脚本之间通过
postMessage桥通信 —— 见 src/content/bridge-client.js - 总调度:URL 变化、窗口重置、每分钟刷新等逻辑集中在 src/content/main.js
扩展的注册信息(只在claude.ai域名生效、不声明任何数据收集权限)见 manifest.json。
四、隐私说明:数据不出本机 🔒
- 无外部服务器、无追踪:所有计算都在你浏览器本地完成
- 只读取你已登录的
lastActiveOrgcookie,用于调用 Claude 自家的/usage接口 - 网络请求仅发往 claude.ai,不产生任何第三方通信
- 第三方依赖仅内置了 MIT 许可的
gpt-tokenizer,许可信息见 THIRD_PARTY_NOTICES.md
五、写在最后 ✨
Claude Counter 用极小的体积解决了大痛点:Token 用了多少、缓存还剩多久、本周配额烧掉了百分之几——三个问题,装完扩展秒答。项目采用 MIT 协议开源,代码量精炼,非常适合想给浏览器扩展"加个小挂件"的开发者拿来研读。
【免费下载链接】claude-counterA minimal browser extension that shows token count, cache timer, and usage bars on claude.ai.项目地址: https://gitcode.com/gh_mirrors/cl/claude-counter
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考