用途：读取 Claude Code 写入 ~/.claude/projects/ 的 JSONL 会话记录，生成按提示词的成本分析、工具/文件热力图、缓存分析、项目对比和基于规则的优化建议，全部在本地运行。
主要能力：仪表盘含 Overview（总览、每日图表、按套餐成本、常用工具、最近会话）、Prompts（按 Token 排序的高成本提示词）、Sessions（逐轮 Token 与工具调用）、Projects（项目对比）、Skills（技能调用及 Token 成本）、Tips（重复读取文件、超大工具结果、低缓存命中率等提示）、Settings（切换 API / Pro / Max 定价方案）。另提供 /api/ 下的 JSON 接口，如 /api/overview、/api/prompts、/api/sessions、/api/projects、/api/tips。
使用方式：需 Python 3.8+，无 pip、Node.js 或构建步骤。安装：git clone https://github.com/nateherkai/token-dashboard.git，cd token-dashboard，python3 cli.py dashboard；Windows 用 py -3 cli.py dashboard。命令包括 dashboard、scan（刷新 SQLite 缓存）、today、stats、tips；可加 --no-open、--no-scan、--projects-dir、--db。环境变量有 PORT、HOST、CLAUDE_PROJECTS_DIR、TOKEN_DASHBOARD_DB；定价可在 pricing.json 中调整。缓存库位于 ~/.claude/token-dashboard.db。
适用场景：个人查看 Claude Code 会话成本与用量趋势，定位高耗 Token 的提示词或项目，编写脚本查询缓存或调用 API 做日志记录。
限制：仅读取缓存文件、不修改原始 JSONL；扫描器按 message.id 去重，数值可能与按原始行求和的工具不同；HOST 建议保持 127.0.0.1，设为 0.0.0.0 会暴露数据到网络；同时运行两个实例会争用 SQLite；无数据时需先 scan；端口冲突可改 PORT。其他功能细节暂未提供。