kelviq/tare

来源：https://github.com/kelviq/tare

tare

问问 Claude Code 你的用量去哪儿了。
你撞上了用量上限却不知为何。配额消耗得比以前更快。你怀疑有东西在后台偷偷吞噬 token。
所有答案其实就在你的电脑里——Claude Code 会记录每一次请求日志。
tare 让 Claude Code 学会读自己的日志，这样你直接问就行。
无需仪表板，无需学命令。
只需安装一次，然后用自然语言提问即可。

Tare：扣除容器重量，以计算内容物。会话消耗的大部分是容器——反复重发的上下文——而这正是这些工具所扣除的。

安装

在任意终端执行一条命令：

npx skills add kelviq/tare -g -y --copy --agent claude-code  

就这么多。无需其他设置——无需账户、包或配置。
启动一个新的 Claude Code 会话，它即刻生效——输入 / 并检查 tare 是否出现。
如果未出现，请参阅故障排除说明——在从未安装过技能的机器上，安装器可能遗漏。
（其他安装方式——手动安装、团队安装或作为 Claude Code 插件——请查看 INSTALL.md。）

然后直接提问

打开 Claude Code，像对人说话一样提问。以下问题都有效——措辞无需完全匹配，抱怨你的限制即可：

当你达到上限时

为什么我昨天达到了用量上限？
晚上会话开始十分钟就被锁定了——这怎么可能？
我是达到了 5 小时上限还是每周上限？
为什么这周配额消耗这么快？

你的 token 去向

我这周的 token 到底用在了哪里？
我的哪个项目在消耗配额？
哪个模型花费最高？
Claude 反复读取的最昂贵文件是哪个？
昨天那个超长会话实际花了我多少？
我的 MCP 服务器是否增加了大量上下文？
子代理和技能带来了多少开销？

在开始大型任务前

我当前的 5 小时窗口还剩多少？
现在开始大型重构安全吗，还是应该等窗口重置？

检查遗漏事项

是否有东西在后台运行 Claude Code？
我睡觉时 Claude Code 是否在活跃？
我上个月设置了一个自动化流程——它花了我多少？

调整配置

我开始在任务间使用 /clear——有效吗？对比一下这周和上周。
最新的 Claude Code 更新是否改变了我的用量？
如果直接购买 API，我的用量成本会是多少？
做什么改变能最大节省用量？

报告与分享

生成一份可在浏览器中打开的用量报告。
给我一份可公开分享的摘要——不含任何私密信息。
将我的用量导出为电子表格。

喜欢用命令？输入 /tare 执行完整诊断，也可使用变体命令处理常见需求——用自然语言提问始终有效：

你将获得什么

不是一堆数字——而是原因。
关于“为什么昨天达到上限”的答案可能像这样：

昨天 99% 的用量来自你运行的某个工具，而非你本人。
有个东西在你的网站项目中生成了 1,553 个短会话——共 9,022 个请求，最多同时运行 51 个会话。
而你当天的实际手动操作仅 93 个请求。每个新会话都从头重建上下文，这是消耗 token 最昂贵的方式……

随后是证据、检查建议和调整方案。
如果一切正常，它也会说明：用量正常，无异常，以下是你的常规用量。
实际输出示例见 examples/——包括由 /tare share 生成的可分享摘要和 HTML 报告。

原始 token 计数之外的洞察

• 精确总量。 Claude Code 日志格式会重复记录 API 响应；简单计数会使总量虚高——在本项目所用数据上高估 86%。tare 能正确去重。
• 上下文的真实代价。 会话早期读取的文件会在后续每条消息中重新发送。tare 将成本归因于触发读取的工具，而非仅归于其返回结果——这就是为何一次早期大文件读取可能悄然占据一周用量。
• 滚动窗口。 离开后配额不会重置；四小时前的工作仍计入。tare 能告诉你被锁定的瞬间窗口有多满。
• 自动化特征。 数百个短并行会话是脚本行为，而非人类操作。tare 识别此特征并会指出。

设计注重隐私

所有操作仅在你的机器上运行，数据绝不外传。脚本完全不进行网络连接。
当你请求可分享摘要时，它仅包含总量、日期和工具名称——不含提示词、文件路径或内容、命令、会话或账户标识符——因此你可以公开发布或发送给同事并询问“我遗漏了什么？”。
勿轻信承诺：SECURITY.md 明确列出每个文件的读写和发送内容，并展示如何用一条 grep 命令自行验证所有说法。

要求

• macOS 或 Linux 上的 Claude Code
• Python 3.9+ —— 所有 Mac 已预装；无需安装包
• 目前仅读取 Claude Code 日志，不支持其他编程代理

演示

https://github.com/user-attachments/assets/358ecacb-972b-4452-9633-e530af3d5490

开发者指南

该技能的所有功能，你也可手动实现：三个无依赖 Python 脚本，附带脚本化、cron 定时、CSV 导出、实时逐请求遥测等方案——详见 CLI.md。
欢迎提交 Issue 和 PR。
有用的方向：交互式 TUI、Windows 路径支持、跨用户匿名摘要聚合以发现个人无法察觉的模式、更精准的工具结果 token 估算。
采用 MIT 许可证。