开源 · Electron · 本地优先 · MITTokenUsage
你的 Token 量化与优化指挥中心
TokenUsage 读取 Claude Code 本地会话日志，把看不见的 token 消耗变成可分析、可追踪、可优化的项目级数据。
项目重点
Token 花在哪里？
按项目、模型、会话和活动类型拆开看。
哪些在浪费？
自动检测重复读取、过大上下文和闲置工具配置。
怎么省下来？
给出健康评分、缓存 ROI 和可复制的修复建议。
A-F
健康评分
9
浪费检测
10
活动分类
数据留在本地，不上传会话内容，不需要云端账号。
不只是统计总额，而是解释为什么花。
首页总览把花费、会话、缓存命中率、项目排行、模型分布、工具调用和优化洞察放在同一个分析面板里。
Total Spend
$124.50
跨项目累计成本
Sessions
279
Claude Code 会话
Cache Hit
61.2%
提示缓存效率
Projects
6
正在追踪项目
从账单数字，回到开发行为。
Claude Code 已经留下了详尽 JSONL 会话日志，TokenUsage 做的是把这些原始记录变成开发者能行动的数据。
Token 花在哪里
按项目、模型、会话、工具和活动类型下钻，不再只看一个总账单。
缓存是否真的省钱
展示缓存毛节省、写入成本和净收益，低命中率会直接暴露出来。
哪类任务最烧钱
自动区分功能开发、调试、重构、测试、Git、构建、探索、规划等活动。
哪里存在浪费
检测重复读取、过大的 CLAUDE.md、未使用 MCP / Skill / Agent、bash 输出过长等问题。
发现浪费，并给出可以复制执行的修复建议。
每个项目都会得到 A-F 健康等级。高影响问题会优先展示，并附带解释和修复命令。
读取无用目录
High发现 node_modules、dist、.git 等高噪声读取。
重复读取文件
Medium跨轮次反复读取相同文件会放大上下文成本。
会话预热过大
HighCLAUDE.md、MCP Schema、Agent 定义过多会让每次冷启动变贵。
闲置工具配置
Medium未调用的 MCP、Skill、Agent 仍可能在每次会话里消耗 token。
Cache ROI
+$86.30 netGross Savings
$124.50
缓存读取节省
Write Cost
$38.20
缓存写入成本
Hit Rate
68.5%
提示缓存命中
echo "node_modules/" >> .claudeignore
echo "dist/" >> .claudeignore
来自 TokenUsage 当前应用的真实截图。
参考 TokenUsage 本体和 Remotion 宣传片的产品结构，页面展示总览和项目详情两个核心工作台。
总览仪表盘
KPI、每日活动、项目排行、模型分布、Token 构成、缓存 ROI 和聚合优化洞察。
项目详情
聚焦单个项目的会话时间线、成本分析、工具调用、Shell 分类和健康问题。
安装后自动读取 Claude Code 日志。
无需接入服务器，也不需要上传数据。应用会扫描本机 Claude Code 会话文件并建立本地 SQLite 分析库。
01
下载桌面安装包
从 GitHub Releases 获取 macOS / Windows / Linux 对应版本。
02
自动扫描日志
启动后读取 ~/.claude/projects/**/*.jsonl，并增量解析新会话。
03
按项目优化
查看健康评分、缓存 ROI、浪费检测结果，把建议应用到项目配置中。
先看清每个 token 花在哪里。
TokenUsage 是 Happy Code 的第一个成本透明工具，也是后续 Agent 工具矩阵的基础能力之一。