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許可證釋出。