把Claude消耗数据变成图表Claude Usage Tracker使用历史追踪与CSV导出实战【免费下载链接】Claude-Usage-TrackerNative macOS menu bar app for tracking Claude AI usage limits in real-time. Built with Swift/SwiftUI.项目地址: https://gitcode.com/gh_mirrors/cl/Claude-Usage-Tracker你是否也有过这样的困惑菜单栏里的 Claude 用量百分比只告诉你现在用了多少却无法回答过去一周我到底怎么个烧法Claude Usage Tracker是一款原生 macOS 菜单栏应用Swift/SwiftUI 构建它的使用历史追踪功能会自动为每个账号定时记录用量快照在设置页中绘制出会话、周用量和 API 账单三类图表并支持一键导出 CSV / JSON把消耗数据变成可以分析、归档、复盘的图表素材。本文带你完整走一遍自动记录 → 看图 → 导出数据的全流程。为什么需要使用历史从瞬时值到趋势线菜单栏图标下面这些样式都很眼熟吧显示的是当前时刻的 5 小时会话用量和周用量。但订阅用户真正关心的往往是趋势我的用量是匀速消耗还是某天突然爆掉每周重置每周一时周用量一般烧到多少API 账单每个月的实际开销是多少使用历史功能就是为此而生它把瞬时读数变成时间序列让你看清消耗节奏。一键打开使用历史页面操作路径非常简单点击菜单栏的 Claude Usage 图标打开弹出面板点击Settings设置在个人资料设置分组下找到带柱状图图标的Usage History使用历史选项卡见 SettingsView.swift 中的入口定义。下面的动图是应用设置的完整走查最后停留的位置就是本文主角页面顶部有一个时间刻度下拉框可切换 5 小时 / 24 小时 / 7 天 / 30 天四种窗口见 UsageHistoryView.swift这是后面看图表时的核心操作。它自动记录什么三种快照与两种定时采样使用历史不是你手动点保存才有的而是全自动的。核心逻辑在 UsageHistoryService.swift 中规则可以总结为一张表记录类型触发方式记录内容会话快照session每10 分钟定时采样 每次 5 小时重置时会话用量百分比、token 数周快照weekly每2 小时定时采样 每周一重置时周用量百分比、Opus/Sonnet 等模型分项账单快照billing每次月度计费周期重置时API 花费金额、币种几个值得注意的细节只记有实际用量的点会话为 0% 时跳过避免图表里一堆无效横线recordSessionReset自动清理会话快照最多保留 1000 条约一周的高密度数据周快照最多 500 条防止存储无限膨胀L26-L28按账号隔离多档案Multi-Profile用户每个账号的历史各自独立互不串号数据结构是UsageSnapshot结构体字段定义见 UsageHistory.swift。图表页面怎么看总览折线 账单柱状图打开使用历史页后你会看到两大块图表① 用量总览Usage Overview这是页面主角一张把**会话用量实线渐变面积和周用量虚线**叠在同一个时间轴上的折线图右上角有图例区分两条线CombinedUsageChart。配合底部的小工具条左右箭头以半个窗口长度为步长向前/向后翻历史时段Now 按钮一键跳回当前时刻中间文字显示当前可视的时间范围。小技巧先用7 天刻度看每周重置时的峰值形态再切30 天看长期趋势最后用24 小时定位某一天具体的消耗节奏。② API 账单API Billing如果你配置了 API Console 账号页面下方会多出一张月度 API 花费柱状图billingSection每次月度账单重置记录一个柱子方便对比每月实际开销。没有数据时会显示No data in selected range空状态提示属正常现象。导出 CSV把数据变成 Excel 里的图表页面右上角的Export Data菜单提供两种格式Export as CSV适合 Excel / Numbers / 任意表格软件Export as JSON适合程序处理或备份exportSection。上图为应用图标样式示意导出文件本身的命名规则见下。点击后弹出系统存储面板文件名自动生成格式为claude-usage-history-all-2026-09-26.csvall表示包含全部记录类型日期为导出当天命名逻辑见 exportToFile。CSV 字段速查表CSV 由 exportToCSV 生成共 12 列列名含义Timestamp快照时间yyyy-MM-dd HH:mm:ssReset Type记录类型sessionReset/weeklyReset/billingCycleSession %当时 5 小时会话用量百分比Session Tokens会话已用 token 数Weekly %当时周用量百分比Weekly Tokens周已用 token 数Opus % / Sonnet % / Design % / Fable %各模型的周用量分项API Spend / Currency当月 API 花费美元与币种某条记录里不适用的字段比如会话快照没有账单金额会留空而不是填 0导入表格做计算时可以直接忽略空值。拿到 CSV 之后能做什么在 Excel/Numbers 里按Reset Type筛选出weeklyReset行一眼看出每周重置时的用量峰值对Session %按时间画折线图复盘哪一天烧得最快按月度汇总API Spend核对账单定期导出归档形成跨月、跨年份的个人用量档案。进阶数据存在哪、如何彻底清理历史数据按档案存为 JSON 文件位于~/Library/Application Support/Claude Usage/history/目录下historyDirectory文件名形如usageHistory_档案ID.json。这个文件本身也可以直接备份。切换档案后回到历史页图表会自动加载对应档案的数据loadHistory。想清空某档案历史可在档案管理中删除对应档案服务层同样提供了deleteHistory/clearHistory方法L398-L420。小结Claude Usage Tracker 的使用历史功能把看一眼的百分比升级成了可回看、可导出、可分析的数据资产零配置装上应用、配置好账号快照就开始自动积累看图总览折线 时间窗口切换 账单柱状图趋势一目了然导出一键 CSV/JSON12 个字段开箱即用Excel 党可以直接开始做自己的用量仪表盘。如果你每天和 Claude 打交道建议现在就打开一次设置页里的 Usage History 标签——你的第一张消耗趋势图可能已经攒了十几个数据点了。【免费下载链接】Claude-Usage-TrackerNative macOS menu bar app for tracking Claude AI usage limits in real-time. Built with Swift/SwiftUI.项目地址: https://gitcode.com/gh_mirrors/cl/Claude-Usage-Tracker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
