Claude Usage Tracker

Claude Usage Tracker 是什么？

Claude Usage Tracker 是一款本地优先工具，能自动发现并汇总多个本地开发工具中的 Claude AI 用量成本。它扫描已知数据目录，解析 JSONL/log 文件，使用模型特定定价计算成本，并在交互式仪表板中显示结果。

核心目的是成本跟踪和可视化——让你按来源、模型和时间段查看支出，而无需将用量数据发送到云端。一切都在你的机器上运行，仪表板由 Chart.js 驱动。

主要功能

• 自动检测 9+ 个集成 Claude 的工具 并合并其用量数据，提供统一视图。
• 使用模型特定每百万 Token 定价计算成本，适用于 Anthropic 模型家族（Opus、Sonnet、Haiku），包括输入/输出及适用情况下的缓存读/写。
• 基于 Chart.js 的暗色主题交互式仪表板，包含可视化图表和细分视图。
• 基于时间的成本跟踪，支持日、周、月及全时段成本视图。
• 模型和来源分析，包括按模型成本细分及过滤（来源、模型、日期范围、最低成本）。
• 峰值模式可视化，通过热图和两种视图：Peak Hours（日×小时网格）和 Peak Days（GitHub 风格日历）。
• 会话级细节，包括可展开会话日志（带颜色编码来源卡片）、按会话成本标注（例如最贵会话）及会话详情面板。
• 项目节奏预测，基于当前支出速度提供 monthly projections 月度预测。
• macOS 应用包选项，可构建独立 .app 以双击启动。

如何使用 Claude Usage Tracker

1. 安装并启动 最新发行版（推荐）或从源代码本地运行工具。
2. 运行扫描收集数据并渲染仪表板：macOS 应用收集最新数据并显示交互式仪表板，浏览器模式启动本地服务器并加载 dashboard.html。
3. 查看仪表板，使用可用图表、热图和过滤器探索总成本，并按来源/模型及时间段细分。

快速启动选项（从仓库）：

• macOS (Apple Silicon/Intel)： 下载最新发行版，解压，将 Claude Usage Dashboard.app 移至 Applications，然后双击启动。
• 从源代码构建： 克隆仓库，运行 ./build-app.sh，然后双击生成的 app。
• 浏览器模式（任意 OS）： 运行 node collect-usage.js，用 python3 -m http.server 8765 启动本地服务器，然后打开 http://localhost:8765/dashboard.html。

使用场景

• 汇总多个 Claude 工具的支出： 如果你使用多个本地集成（如 Cursor、Windsurf、Claude Desktop 和 Continue.dev），追踪器会将这些来源的用量合并到一个仪表板。
• 找出支出最高时段： 使用 Peak Hours（日×小时热图）和 Peak Days 日历，识别用量最贵的时段和日期。
• 审计特定会话或日期： 展开某日期的会话日志，检查按会话成本，并在会话详情面板查看 Token 细分和对话历史。
• 比较日环比变化： 使用 Yesterday Delta 一目了然比较今日与昨日支出。
• 规划本月预期： 查看 Monthly Projections，基于当前支出速度估算月度成本。

常见问题

• 追踪器会将用量数据发送到服务器吗？ 不会。项目描述明确表示“无云端”和“无遥测”，一切数据留在你的机器上。

• 支持哪些工具？ 仓库列出了来自 OpenClaw/Clawdbot、Claude Code CLI、Claude Desktop（本地代理模式）、Cursor、Windsurf、Cline、Roo Code、Aider 和 Continue.dev 的 Claude 用量。工具检测为自动进行。

• 读取哪些数据格式？ 它扫描已知目录并解析 JSONL/log 文件；支持工具部分指定了每个列出工具的 JSONL 格式。

• 如果工具未安装或无用量数据怎么办？ 工具检测行为描述为：如果工具未安装或无数据，则静默跳过。

• 如何计算成本？ 使用 Anthropic 的每百万 Token 定价计算，支持的模型家族（Opus、Sonnet、Haiku）成本基于提供的输入/输出及缓存读/写。

替代方案

• 本地日志分析 + 电子表格： 导出或收集 Claude 用量日志，在电子表格中手动计算成本。这比交互式仪表板更手动，但可适配自定义工作流。
• 供应商提供的用量仪表板（如果可用）： 部分提供商为计费/用量报告提供视图。这些通常聚焦单一产品/账户，而非跨多个本地工具汇总。
• 通用开发者时间/成本分析工具： 分析 IDE 活动或基于用量事件计算成本的工具可提供帮助，但可能无法模拟 Claude 特定 Token 定价，或自动解析各工具存储格式。
• 其他本地优先监控仪表板： 可在浏览器中可视化本地日志的相邻工具能提供类似图表，但可能需手动准备数据，而非依赖追踪器的自动检测和 JSONL 解析。