Claude Usage Tracker

Claude Usage Tracker 是什麼？

Claude Usage Tracker 是一款本機優先工具，能自動探索並彙整多個本機開發工具的 Claude AI 用量成本。它掃描已知資料目錄、解析 JSONL/log 檔案、使用模型特定定價計算成本，並在互動儀表板中顯示結果。

核心目的是成本追蹤與視覺化—讓您能依來源、模型與時間區間檢視花費，而無需將用量資料傳送到雲端。一切皆在本機執行，儀表板由 Chart.js 驅動。

主要功能

• 自動偵測 9+ 整合 Claude 的工具 並合併其用量資料，提供統一檢視。
• 使用模型特定每百萬 Token 定價計算成本，適用於 Anthropic 模型系列 (Opus、Sonnet、Haiku)，包含輸入/輸出及快取讀寫（若適用）。
• 使用 Chart.js 的暗色互動儀表板，提供視覺化圖表與細分。
• 時間基礎成本追蹤，包含日、周、月及全時段成本檢視。
• 模型與來源分析，包含每模型成本細分及篩選（來源、模型、日期範圍、最低成本）。
• 尖峰模式視覺化，透過熱圖及兩種檢視：Peak Hours（日×小時格線）與 Peak Days（GitHub 風格行事曆）。
• 工作階段層級細節，包含可展開的工作階段記錄、具顏色來源卡片、每階段成本標示（例如最昂貴階段）及工作階段細節面板。
• 專案節奏預測，提供基於目前花費速度的 monthly projections。
• macOS 應用程式套件選項，可建置獨立 .app 以雙擊啟動。

如何使用 Claude Usage Tracker

1. 安裝並啟動 最新發行版（建議）或從原始碼本機執行工具。
2. 執行掃描收集資料並渲染儀表板：macOS 應用程式會收集最新資料並顯示互動儀表板，瀏覽器模式則啟動本機伺服器並載入 dashboard.html。
3. 檢視儀表板，使用可用圖表、熱圖及篩選探索總成本，並依來源/模型及時間區間細分。

快速入門選項（從儲存庫）：

• macOS (Apple Silicon/Intel)： 下載最新發行版、解壓、Claude Usage Dashboard.app 移至「應用程式」，再雙擊啟動。
• 從原始碼建置： 複製儲存庫、執行 ./build-app.sh，再雙擊建置的應用程式。
• 瀏覽器模式（任一 OS）： 執行 node collect-usage.js，以 python3 -m http.server 8765 啟動本機伺服器，並開啟 http://localhost:8765/dashboard.html。

使用情境

• 彙整多個 Claude 工具的花費： 若您使用多個本機整合（如 Cursor、Windsurf、Claude Desktop 及 Continue.dev），追蹤器會將這些來源的用量合併至單一儀表板。
• 找出花費最高時段： 使用 Peak Hours（日×小時熱圖）及 Peak Days 行事曆，辨識最具成本用量的工作階段時段與日期。
• 稽核特定工作階段或日期： 展開日期的工作階段記錄，檢視每階段成本，並在工作階段細節面板查看 Token 細分與對話記錄。
• 比較日對日變化： 使用 Yesterday Delta 快速比較今日與昨日花費。
• 規劃本月預期： 檢視 Monthly Projections，依目前花費速度估計本月成本。

常見問題

• 追蹤器會將用量資料傳送至伺服器嗎？ 不會。專案描述明確表示「No cloud」與「No telemetry」，一切皆留在您的機器上。

• 支援哪些工具？ 儲存庫列出來自 OpenClaw/Clawdbot、Claude Code CLI、Claude Desktop（本機代理模式）、Cursor、Windsurf、Cline、Roo Code、Aider 及 Continue.dev 的 Claude 用量。工具偵測為自動化。

• 讀取哪些資料格式？ 它掃描已知目錄並解析 JSONL/log 檔案；支援工具區段指定每個列出工具的 JSONL。

• 若工具未安裝或無用量資料怎麼辦？ 工具偵測行為描述為：若工具未安裝或無資料，則靜默略過。

• 如何計算成本？ 使用 Anthropic 的每百萬 Token 定價計算，適用於支援模型系列 (Opus、Sonnet、Haiku)，依提供的輸入/輸出及快取讀寫計算。

替代方案

• 本機日誌分析 + 試算表： 匯出或收集 Claude 使用日誌，並在試算表中手動計算成本。這比互動儀表板更手動，但可適應自訂工作流程。
• 供應商提供的用量儀表板（若有）： 有些供應商提供用量檢視，用於帳單/用量報告。這些通常聚焦單一產品/帳戶，而非彙整多個本機工具。
• 通用開發人員時間/成本分析工具： 分析 IDE 活動或依使用事件計算成本的工具可提供幫助，但可能無法模擬 Claude 專屬 Token 定價，或自動解析各工具的儲存格式。
• 其他本機優先監控儀表板： 可在瀏覽器中視覺化本機日誌的相關工具，能提供類似圖表，但可能需要您準備資料，而非依賴追蹤器的自動偵測與 JSONL 解析。