Tare: 诊断 Claude Code Token 使用情况和配额限制

Tare 是一款以本地优先为设计的诊断工具，旨在识别 Claude Code 中 Token 消耗过快和配额耗尽的原因。通过分析已存储在用户机器上的会话日志，Tare 允许开发者使用纯英文查询其使用历史，从而准确确定哪些文件、工具或自动化流程正在消耗其配额。

Token 审计与限制诊断

Tare 将原始会话日志转化为可操作的见解，超越了简单的 Token 计数，从而识别使用量激增的根本原因。该工具可以回答特定的操作问题，例如：

• 配额耗尽： 识别用户是触及了五小时滚动窗口限制还是每周上限。
• Token 归属： 确定哪些项目、模型或特定文件正在消耗最多的 Token。
• uma 识别后台进程或自动化脚本是否正在产生并行会话，从而推高成本。
• 优化： 比较实施诸如使用 /clear 重置上下文等策略前后的使用模式。

高级使用分析

与简单的 Token 计数不同，Tare 实现了多个逻辑层以确保报告的准确性：

• 去重： Claude Code 的日志格式经常多次重复 API 响应；Tare 会对其进行去重，以防止虚增总量（在某些情况下，虚增比例可能高达 86%）。
• 上下文成本计算： Tare 将文件读取的成本归于会话中随后的每一条消息，因为它意识到在长会话早期读取的大文件会持续占据上下文窗口。
• 滚动窗口追踪： 该工具追踪五小时滚动窗口，以告知用户在锁定时刻其配额的具体填充程度。
• 自动化检测： Tare 能够识别数百个短促、并行的会话特征，这通常表明是脚本而非人工交互。

隐私与技术要求

Tare 默认设计为保护隐私。所有分析都在用户机器上本地进行，且脚本不会进行任何网络连接。在生成可分享的摘要时，该工具会脱敏处理提示词、文件路径和账户标识符，仅提供总量、日期和工具名称。

技术要求：

• OS： macOS 或 Linux。
• Runtime： Python 3.9+。
• 兼容性： 目前仅支持 Claude Code 日志。

安装与界面

用户可以使用以下命令将 Tare 作为 Claude Code skill 安装：

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

安装完成后，用户可以通过 Claude Code 中的纯英文查询或特定的斜杠命令进行交互：

| Command | Function | | :--- | :--- | | | /tare | Token 使用情况及原因的全面诊断 | | /tare usage | 带有归属分析的一览式面板 | | /tare window | 五小时滚动窗口的状态 | | /tare report [days] | 生成并打开 HTML 使用报告 | | /tare tools [days] | 上下文填充工具的分析 | | /tare share [days] | 创建用于公开分享的脱敏摘要 |

社区见解与替代方案

社区讨论突出了用户在面对 Token 限制的“黑盒”性质时反复遇到的挣扎。一些用户已经实现了自定义的状态行，以实时追踪使用量，从而避免意外情况。

"I just used Claude to write a plug-in which changed the bottom of the CLI to say: ( ) Usage: 34% (resets in 2h 47m) Context: 56%... That way if my usage starts shooting up, it's very easy to notice."

其他用户指出，配额快速耗尽通常是由分发多个子代理的开放式请求或大型上下文缓存的过期引起的，从而导致重复的高成本读取。