1. 项目概述:Claude Code Tokens Tracker工具
作为一名长期使用Claude API的开发者,我深知token消耗监控的重要性。每次看到账单上那些不明不白的token支出,总让人头疼不已。为此,我开发了这款Claude Code Tokens Tracker工具,它就像是你代码中的"智能电表",能实时监测每个API调用的token消耗情况。
这个工具的核心价值在于:
- 实时可视化监控:告别"黑盒"操作,每个API调用的token消耗都清晰可见
- 多维度数据分析:按工具、文件、时间等维度深入分析使用情况
- 零侵入集成:通过hook机制自动收集数据,无需修改现有代码
提示:虽然工具能精确统计token用量,但实际账单可能受服务商套餐、促销活动等因素影响,建议仅作为优化参考。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心功能解析
2.1 实时监控系统
监控模块采用轮询机制,每2秒扫描一次会话记录文件。其工作原理如下:
- 通过文件系统watcher监听.claude/sessions目录变化
- 解析最新会话JSON文件,提取token使用数据
- 聚合统计:总消耗、输入/输出token比例、各工具调用占比
关键数据结构示例:
javascript复制{
"total_tokens": 2456,
"input_tokens": 892,
"output_tokens": 1564,
"tools": [
{"name": "code-generator", "count": 3, "tokens": 1200},
{"name": "doc-writer", "count": 5, "tokens": 800}
]
}
2.2 历史统计功能
每日统计模块采用增量存储设计:
- 原始数据:按天存储为JSON文件(data/daily/YYYY-MM-DD.json)
- 聚合数据:生成周报、月报时动态计算,避免冗余存储
统计维度包括:
- 时间趋势分析(日/周/月)
- 工具使用热力图(按小时分布)
- 文件级消耗排名
2.3 Hook收集机制
数据收集采用Claude官方提供的PostToolUse钩子:
json复制{
"hooks":
