Javis603/token-monitor

Local-first desktop widget for tracking token usage, costs, and limits across 36+ AI coding tools—including Claude Code, Codex, Cursor, OpenCode, and OpenClaw—with multi-device sync.

Token Monitor – 是什麼

Token Monitor 是一個跨平台桌面小工具，可監控數十種 AI 驅動的程式碼助理（Claude Code、GitHub Copilot、Cursor 等）的 Token 消耗與配額限制。它讀取每個工具的本機日誌或 API 金鑰餘額，聚合資料，並在可自訂的儀表板中顯示即時數值。此應用程式可跨多台機器同步這些摘要，讓您隨時看到統一、即時的 AI 使用狀況。

核心功能（如 README 所述）

功能	工作方式	你看到的內容
即時 Token 追蹤	讀取 35+ 支援工具的本機轉錄檔、SQLite 資料庫或 API 金鑰餘額端點。	每次 AI 互動後數秒內更新 Token 數量。
會話級分解	開啟特定會話（例如 Claude Code 轉錄）並解析提示/回應的 Token 拆分。	輸入與輸出 Token 的詳細視圖、快取命中與未命中、以及所用模型。
成本顯示	使用內建價格表（或手動輸入的訂閱資訊）將 Token 轉換為 USD、TWD、HKD 或 CNY。	Token 數量與貨幣成本並列顯示；匯率每日更新。
配額/限制監控	從本機匯出檔或 API 金鑰端點（OpenRouter、Minimax 等）查詢特定供應商的限制（每日、每週、計費週期）。	視覺化配額條、滿載百分比指示器，以及接近限制時的警示。
歷史趨勢與熱力圖	本地儲存每日聚合資料（可選：在原始檔案刪除後歸檔使用記錄）。	一年熱力圖、連續使用計數器、按工具或模型的堆疊條形圖/K線圖。
多裝置同步	將裝置使用情況的緊湊摘要發送到一個中心（內建於應用中、自架 Node、或 Cloudflare Worker）。其他裝置透過 Server-Sent Events 接收更新。	所有裝置顯示相同即時資料；iOS 小工具也可從同一中心取得。
匯出	按需或按排程將 Token 使用情況寫入 CSV/JSON。	可輕鬆匯入電子表格、Grafana、Obsidian 或自訂腳本。
自訂 UI	菜單列（macOS）/系統托盤（Windows）彈出視窗、浮動氣泡、macOS 原生小工具預覽、主題與透明度控制、拖曳式佈局編輯器。	選擇符合您工作流程的外觀；可新增捷徑、Discord Rich Presence 等。

支援的工具（節選）

Claude Code, Codex, OpenCode, Hermes Agent, OpenClaw, Cursor, Antigravity, Kimi, Qwen, Grok Build, GitHub Copilot, Pi, Zed, Kilo, Command Code, MiMo Code, ZCode, Kiro, CodeBuddy, WorkBuddy, Proma, Qoder CN, Reasonix, DeepSeek, Cherry Studio, LM Studio, Unsloth, OpenRouter, Minimax, Volcengine, Ollama, Trae CN, Alibaba Cloud，以及任何遵循 New API 餘額格式的第三方 API。

安裝與首次執行

macOS – brew install --cask token-monitor（Apple Silicon 或 Intel dmg）。
Windows – 下載簽署的 .exe（安裝程式或便攜版）。
Linux – 取得 AppImage（x64）。
啟動應用程式；它將自動偵測該機器上的支援工具，並以「僅本機」模式開始追蹤使用情況。

多裝置同步選項

在應用內託管中心 – 選擇一台始終開機的機器，將產生的局域網 URL + 密鑰複製到其他裝置。
自架 Node 中心 – 設定 TOKEN_MONITOR_SECRET 後，在無頭伺服器上執行 npm run hub。
Cloudflare Worker 中心 – 一鍵部署按鈕；將工作器 URL 和密鑰貼到每個客戶端。三種方式均使用 Server-Sent Events，因此所有連接的視窗將在數秒內收到更新。

哪些人可能需要它？

使用多種 AI 程式碼助理的開發者，需要追蹤 Token 支出與配額耗盡情況。
共享 AI 服務預算的團隊，希望獲得透明、以隱私為先的使用狀況視圖。
自由工作者或愛好者，希望在看到 Token 數量的同時即時查看成本，避免意外帳單。
在多台電腦上工作的人（桌面、筆電、WSL、iPhone），希望使用單一儀表板而非每台機器的獨立監控。

隱私說明

所有提示/回應內容均保留在本機設備；僅聚合的 Token 數量、成本和限制資料會發送到同步中心。中心可自架、在應用內運行，或部署至 Cloudflare，讓您完全控制資料的去向。

快速入門檢查清單

為您的作業系統安裝應用程式。
開啟 Token Monitor – 它將自動偵測支援的工具並開始顯示即時使用情況。
（可選）如果您有超過一台裝置，請設定同步中心。
根據您的工作流程自訂儀表板佈局、貨幣和匯出設定。
享受所有 AI 程式碼工具中即時的 Token 支出與配額健康狀況可視化。