TokenBBQ – 跨Claude、Codex、Gemini追踪AI编码令牌使用量

TokenBBQ是一个由offbyone1开发的开源工具，旨在帮助开发者可视化其AI编码工具的实际成本。它通过扫描本地文件系统，读取Claude Code、Codex、Gemini、OpenCode、Amp和Pi-Agent等工具的使用数据，并将所有信息汇总到一个交互式仪表板中。

该工具的设计理念是简单易用：只需运行npx tokenbbq@latest即可启动，无需安装、无需配置、无需API密钥。它会在本地打开一个位于localhost:3000的仪表板，所有数据仅保留在用户机器上，唯一的网络请求是获取模型定价。

TokenBBQ的仪表板功能丰富，包括每日成本时间线（堆叠条形图，按提供商分组）、成本分解（环形图，显示每个工具的支出）、热门模型排名（按总成本排序）、月度趋势（折线图）以及过去90天的活动热图（类似GitHub贡献图）。此外，还有详细的每日表格，可展开查看每个来源和模型的细分数据。仪表板支持浅色/深色模式切换，时间筛选器可设置为7、30、90、180、365天或全部时间，表格列可点击排序，并每5秒自动刷新。

对于更喜欢命令行的用户，TokenBBQ提供了多种CLI命令，如daily（终端中显示每日表格）、monthly（月度表格）、summary（紧凑摘要）、scan（将仪表板数据以JSON输出到stdout）、--json（JSON输出）等。用户还可以通过--port指定自定义端口，使用--no-open阻止自动打开浏览器。

TokenBBQ还提供了一个桌面小部件（支持Windows和macOS），它是一个始终置顶的悬浮条，位于屏幕顶部，显示claude.ai的5小时和7天窗口利用率以及今日本地AI工具令牌支出。点击可展开查看每个来源的细分，并有一个“打开完整仪表板”按钮，可直接启动与npx命令相同的仪表板。小部件二进制文件可在GitHub Releases页面下载。

该工具目前支持的工具及其数据位置包括：Claude Code（~/.claude/projects//*.jsonl）、Codex（~/.codex/sessions//*.jsonl）、Gemini（~/.gemini/tmp//chats/session-*.json）、OpenCode（~/.local/share/opencode/）、Amp（~/.local/share/amp/threads//*.json）、Pi-Agent（~/.pi/agent/sessions/**/*.jsonl）。对于Windows，路径会相应调整，部分工具可通过环境变量覆盖目录。

TokenBBQ的工作原理是：扫描文件系统中的已知AI工具数据目录，解析JSONL、JSON或SQLite文件以提取令牌使用事件，从LiteLLM获取当前模型定价（离线时有回退），计算成本并按日、月、来源和模型聚合，最后在本地提供交互式仪表板。该项目基于@ryoppippi的ccusage的数据加载模式，采用MIT许可证发布。