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許可證發佈。