stormzhang/token-tracker

解決的問題

Token Tracker 為多個本地 AI 代理（如 Claude Code、Codex 和 Kimi Code）提供了一種統一的方式，用以監控與分析令牌消耗與成本。它透過將成本、配額與會話細節整合至單一儀表板，解決了使用資料分散的問題，防止「帳單驚喜」，並協助使用者即時追蹤配額限制。

工作原理

該工具以唯讀方式讀取代理設定目錄中的本地會話日誌（JSONL 與 SQLite 檔案）。它透過官方 StatusLine API（適用於 Claude Code 與 Kimi Code）或自訂的「偽狀態列」鈎子（適用於 Codex）直接整合至代理介面，顯示即時指標。此外，還包含一個 CLI 用於產生報告，以及一個使用本地 FIFO 與終端自動化（iTerm2/Ghostty 的 AppleScript）的側邊欄工具，提供活躍會話的即時概覽。

適用對象

使用多個 AI 編碼代理（Claude Code、Codex、Kimi Code）並需要在不手動檢查多個平台的情況下，追蹤其令牌使用量、財務成本與剩餘 API/訂閱配額的開發者與進階使用者。

主要亮點

• 統一追蹤：將 Claude Code、Codex 與 Kimi Code 的資料集中於一處。
• 即時狀態條：直接將即時的令牌、成本與配額指標注入代理的終端介面。
• 多維度報告：產生日度熱力圖、週報與月報，包含成本與令牌分析。
• 互動式側邊欄：一個常駐面板，顯示所有活躍會話、狀態燈與「下一步」建議，支援一鍵跳轉至特定終端窗格。
• 零設定：自動偵測已安裝的代理並讀取本地資料，無需 API 金鑰或雲端上傳。
• 隱私優先：所有資料均在本地儲存與處理。