Claude Code Usage Tracker

December 15, 2025 · View on GitHub

一个用于追踪 Claude Code 使用统计的桌面应用程序，使用 Tauri、React 和 Rust 构建。

English Documentation

注意: 数据来源于本地会话文件解析，而非 Anthropic 官方 API。统计数据仅供参考，可能与官方账单数据存在差异。

功能特性

实时用量追踪: 监控所有 Claude Code 项目的 token 使用量、费用和消息数量
今日统计: 查看从本地午夜开始的每日使用量，支持时区感知计算
项目级分析: 按单个项目分解使用情况，提供详细统计数据
消耗速率监控: 追踪当前会话的 token 消耗速率和预计每小时费用
模型分布: 通过交互式饼图可视化不同 Claude 模型的使用情况
使用趋势: 通过 30 天趋势图查看历史使用模式
紧凑模式: 最小化悬浮窗口，支持置顶显示，不影响工作流程
会话窗口追踪: 监控 5 小时滚动会话窗口，显示重置倒计时

截图

正常模式

总体统计

项目视图

紧凑模式

紧凑总览视图

紧凑总览

紧凑项目视图

紧凑项目

安装

下载预编译版本

从 Releases 页面下载适合您平台的最新版本。

安装版

平台	格式
Windows	`.msi`, `.exe`
macOS (Intel)	`.dmg`
macOS (Apple Silicon)	`.dmg`
Linux	`.deb`, `.AppImage`

绿色版（免安装）

无需安装，下载即可运行：

平台	格式
Windows	`*_windows_portable.exe`
Linux	`*_linux_portable.AppImage`

从源码构建

前置条件

Node.js 20+
Rust (stable)
Tauri CLI

设置

# 克隆仓库
git clone https://github.com/LyndonWangWork/Claude-Code-Usage-Tracker.git
cd Claude-Code-Usage-Tracker

# 安装前端依赖
cd web
npm install

# 运行开发服务器
cd ..
npm run tauri dev

构建

npm run tauri build

使用方法

启动应用 - 应用会自动检测您的 Claude Code 数据目录
查看总体统计 - 查看总费用、token 数量、消息数和会话指标
浏览项目 - 切换到项目标签页查看每个项目的详细数据
切换紧凑模式 - 点击紧凑模式按钮切换到紧凑悬浮窗口
置顶窗口 - 使用图钉按钮保持窗口始终在最前面

数据来源

应用程序从 Claude Code 的本地存储读取使用数据：

默认位置: ~/.claude/projects/
自定义位置: 通过 CLAUDE_CONFIG_DIR 环境变量设置

发布

发布通过 GitHub Actions 自动化完成。创建新版本：

更新 src-tauri/tauri.conf.json 和 src-tauri/Cargo.toml 中的版本号
提交版本更改
创建并推送版本标签：
```
git tag v0.1.0
git push origin v0.1.0
```
GitHub Actions 将自动为所有平台构建
将创建包含构建产物的草稿发布
审核草稿发布后正式发布

技术栈

前端: React, TypeScript, Tailwind CSS, Recharts
后端: Rust, Tauri v2
构建: Vite, Cargo

致谢

特别感谢 Maciek-roboblog 的 Claude Code Usage Monitor 项目提供的灵感和参考实现。