---
title: "Token Monitor 實測：把一堆 AI 工具的 token 用量，收進同一個畫面"
description: "同時開 Claude Code、Codex、Copilot、Cursor，額度到底燒到哪？Token Monitor 把這些工具的用量收在同一個畫面，還能跨裝置同步。這篇是 Windows 實測：怎麼裝、Hub URL 設定藏在哪、為什麼要自己做 Dashboard、覺得卡的時候調哪裡，還有我做過的資安檢查。"
canonical_url: "https://blog.markkulab.net/post/token-monitor-ai-token-dashboard"
author: "Mark Ku"
author_url: "https://blog.markkulab.net/author/mark-ku"
site: "Mark Ku's Blog"
date_published: "2026-09-19 10:00:00 +0800"
category: "AI"
tags: ["Token Monitor", "Claude Code", "Codex", "AI 工具", "Token 用量", "成本控管", "Electron"]
language: "zh-TW"
license: "CC BY 4.0"
license_url: "https://creativecommons.org/licenses/by/4.0/"
attribution: "轉載或引用請註明作者並附上原文連結"
---

# Token Monitor 實測：把一堆 AI 工具的 token 用量，收進同一個畫面

## 前言：工具開一排，額度到底燒到哪去了

現在寫程式，同時開著 Claude Code、Codex、GitHub Copilot、Cursor 已經很正常。但工具一多，幾個問題就來了：

- 快撞上限了嗎？通常都是跳警告才知道。
- 錢花在哪個工具上？每家都有自己的後台，要比就得一個一個開。
- 哪一台機器燒的？公司筆電、家裡桌機、伺服器上跑的 agent，各燒各的。

[Token Monitor](https://github.com/Javis603/token-monitor) 就是在解這件事：一個桌面小視窗，讀你電腦上各家工具留下的紀錄，把用量、花費、剩餘額度全部收在同一個畫面，而且可以多台機器一起看。

![Token Monitor 的 GitHub 專案首頁，支援 Windows、macOS、Linux](https://blog.markkulab.net/content/markku/posts/token-monitor-ai-token-dashboard/images/01-token-monitor-github.webp)

這篇不是翻譯官方文件，是我自己在 Windows 上裝 v0.59.0 實際跑過一輪的紀錄。

## 先講結論

沒時間讀完的話，看這段就夠了。

**✅ 值得裝。** 本機用的話裝完就能用，不用設定，不用帳號。

**✅ 它是開源的（MIT）。** 原始碼完整放在 GitHub 上，程式分成四塊：桌面程式、背景收集器、Hub、Cloudflare Worker，各自獨立。想改哪一塊就只碰那一塊，不用讀懂整包。打包指令也現成（`npm run dist:win`），改完就能產出自己的安裝檔。所以**非常適合自己拿來二次開發**。

**❌ 它沒有網頁版的 Dashboard。** 這是目前最大的缺口。所有畫面都在桌面程式裡，想用瀏覽器開、想掛在大螢幕上、想做一個團隊共用的看板，都得自己做。

好消息是它把資料開得很大方：Hub 有一組完整的 API，資料撈出來自己畫就好，**完全不用改到它的原始碼**。我們就是這樣接的，後面會講。

適不適合你，大概是這樣：

| 你的情況 | 建議 |
| --- | --- |
| 同時用 3 個以上 AI 工具 | 裝，馬上有感 |
| 有好幾台機器 | 裝，這是它最強的地方 |
| 團隊想要共用看板 | 可以做，但要自己接 API |
| 想要「裝完就有網頁報表」 | 會失望，它不做這件事 |

另外先說清楚我**驗證到哪裡**，免得你把我的結論放太大：安裝、簽章、預設設定、它讀哪些資料夾、對外連了哪裡，這些我都實際跑過。至於逐行看原始碼、對 Hub 做攻擊測試，我沒做。

## 它到底在讀什麼

一句話：**它不看你的 prompt，也不看你的程式碼，只讀各家工具留在你電腦上的用量紀錄。**

像 Claude Code 會把每次對話記在 `~/.claude/projects/`，Codex 記在 `~/.codex/`，Token Monitor 就是去讀這些檔案，把 token 數加一加、成本算一算。

它抓三種東西：

- **用量**：花了多少 token、多少錢、快取命中率
- **額度**：各家方案還剩多少、什麼時候重置
- **單次對話明細**：某一次對話裡，每則訊息各用了多少

目前支援 37 種以上的工具，常見的 Claude Code、Codex、Copilot、Cursor、Antigravity、OpenCode、Cline 都有。底層解析是用 [tokscale](https://github.com/junhoyeo/tokscale) 這個 Rust 專案（也是 MIT），Token Monitor 負責畫面跟同步。

## 兩種用法：一台機器，或多台一起

這兩種模式先搞懂，後面設定才不會亂：

```mermaid
flowchart LR
  subgraph Local["一台機器（預設，零設定）"]
    W1["桌面程式"] --> F1["讀本機的<br/>~/.claude、~/.codex…"]
  end

  subgraph Sync["多台一起（選用）"]
    D1["機器 A"] --> HUB["Hub"]
    D2["機器 B"] --> HUB
    HUB --> V1["任一台的畫面"]
    HUB --> V2["你自己做的 Dashboard"]
  end
```

重點只有兩個：

- **預設就是一台機器的模式**，裝完就會動，什麼都不用設。
- **多台要同步的話，得先挑一個 Hub**，所有機器連同一個。

## 安裝

到 [GitHub Releases](https://github.com/Javis603/token-monitor/releases) 抓 `Token-Monitor-Setup-x.x.x.exe`（約 113 MB），雙擊一路下一步就好。macOS 用 `brew install --cask token-monitor`，Linux 抓 `.AppImage`。

我有順手驗一下數位簽章（`Get-AuthenticodeSignature`），結果是 Valid，簽署者 SignPath Foundation，跟官方文件寫的一致，代表檔案沒被動過手腳。

裝完之後，設定跟資料會放在 `%APPDATA%\Token Monitor\`，之後想移除乾淨的話這個資料夾記得一起刪。

## 裝完之後長怎樣

一開起來，它馬上就開始讀了。從日誌看得出它在盯哪些資料夾：

```text
[collector] Watching C:\Users\<you>\.claude\projects
[collector] Watching C:\Users\<you>\.copilot
[collector] Watching C:\Users\<you>\.gemini\antigravity
```

幾個觀察：

- **只看你電腦上真的有的工具**，沒裝的就不碰。
- 用系統的檔案異動通知，不是傻傻掃整顆硬碟。
- 開機時會自己去 GitHub 看有沒有新版。

預設會追 28 個工具，設定檔在 `%APPDATA%\Token Monitor\settings.json`。

## 多台機器同步：Hub URL 藏在哪

這是最多人卡住的地方，先講位置。

> **桌面程式右下角的 ⚙ 齒輪 → Multi-device Sync（多裝置同步） → 點「Connect to a hub（連接到 Hub）」那顆圓點**

**要先點那顆圓點，網址跟密碼的欄位才會跑出來。** 沒點就只看到幾個選項，很多人以為「怎麼沒有地方填」，就是卡在這。

Hub 有三種選法，挑一個就好，所有機器連同一個：

| 方式 | 適合誰 | 缺點 |
| --- | --- | --- |
| **用其中一台當 Hub** | 家裡或公司有一台常開機的電腦 | 那台程式關掉，大家就都不同步了 |
| **裝在 NAS 或伺服器上** | 有常開的機器 | 要下指令，稍微麻煩一點 |
| **Cloudflare Worker** | 想從手機看、或跨不同網路 | 要有 Cloudflare 帳號 |

最簡單的是第一種：在常開的那台選「Host hub on this device」，它會自己產生一組密碼，然後列出其他機器可以連的網址。其他機器就填那個網址加密碼。

跨網路的話，走 Tailscale 或 ZeroTier 會比開防火牆簡單，也安全得多。

## 它沒有網頁 Dashboard，所以我們自己做了一個

前面提過，這是它最大的缺口。所有畫面都鎖在桌面程式裡。

但 Hub 本身其實開了一組滿完整的 API，資料要多少有多少：

| 網址 | 拿到什麼 |
| --- | --- |
| `/api/health` | 確認 Hub 活著（這支不用密碼） |
| `/api/stats` | 全部統計：今日、本月、全部，含工具、模型、專案、額度 |
| `/api/stats/stream` | 即時推播，有變動就推給你 |
| `/api/devices` | 每台機器的狀況 |

用密碼的方式很單純，加一個 header 就好：

```bash
curl -H "Authorization: Bearer 你的密碼" http://127.0.0.1:17321/api/stats
```

所以我們就用這組 API，做了一個單一檔案的 `dashboard.html`，瀏覽器直接打開，填網址跟密碼就會動：

![自製的 Hub Dashboard：今日、本月、全部、活躍四張卡片，底下是工具排行榜、Token 組成、每日趨勢跟各家方案的剩餘額度](https://blog.markkulab.net/content/markku/posts/token-monitor-ai-token-dashboard/images/02-hub-dashboard-overview.webp)

往下捲是每台機器的狀況：

![Dashboard 下半部：兩台機器的系統、版本、最後回報時間，以及 28 個工具的追蹤狀態](https://blog.markkulab.net/content/markku/posts/token-monitor-ai-token-dashboard/images/03-hub-dashboard-devices.webp)

這塊其實很實用，一眼就看得出哪台是背景跑的、哪台是有開視窗的、各自最後回報是什麼時候。**如果某一台的「最後回報」停在幾小時前，通常就是同步出問題了。**

要自己做的話，其實只要三件事：

1. 做一個填網址跟密碼的表單
2. 接 `/api/stats/stream`，有資料就重畫
3. 把回來的 JSON 攤平成表格

不難，而且完全不用碰它的原始碼。

## 覺得卡卡的？先關掉沒在用的工具

有人反應更新頻率調高之後會卡。設定都在 ⚙ 裡面，幾個可以動的：

| 設定 | 預設 | 怎麼調 |
| --- | --- | --- |
| 追蹤的工具 | 全開（28 個） | **先調這個，最有感**。沒在用的通通關掉 |
| 畫面更新間隔 | 15 秒 | 這只是重畫畫面，調小效果有限 |
| 歷史資料寫入 | 15 分鐘 | 機器慢的話往上調，不要往下 |
| 專案分類 | 開 | 專案資料夾很多的話，關掉會輕鬆很多 |
| WSL 掃描 | 開 | 沒在用 WSL 就關掉 |

順序很重要：**先關掉沒在用的工具，再考慮動時間。** 預設 28 個全開，但大部分人真正在用的可能只有三四個。把其他的關掉，比調更新頻率有效多了。

另外一個跟效能無關、但很重要的設定：

**Claude Code 預設只留 30 天的對話紀錄**，超過就自己清掉了。Token Monitor 有一個「保留已刪除的用量」選項，建議開著，它會把看過的每日用量另外存一份，來源被刪也不影響你看趨勢圖。

但要注意，它只能救**裝了之後**的資料。裝之前被刪掉的就回不來了。所以如果你想長期看趨勢，越早裝越好。

## 資安：我檢查了什麼

既然要導入，順手掃一下是合理的。完整稽核我沒做，但基本的幾項跑過了。

**看它連去哪裡。** 程式跑起來之後我看了它建立的連線，只有兩個地方：GitHub（檢查更新）跟 `api.anthropic.com`（查 Claude 還剩多少額度）。

**沒有開任何對外的埠。** 這點滿重要的，只要你沒把它設成 Hub，它就不會在你電腦上開任何服務。

**讀的範圍很乾淨。** 從日誌看，它盯的都是各家 AI 工具自己的資料夾，沒有掃你的專案原始碼或整個使用者目錄。

**官方聲明不送任何統計回去給作者。** 加上原始碼公開，這點可以自己查證。

至於我**沒做**的：沒有逐行看原始碼，沒有驗證下載的程式真的是那份原始碼編出來的，也沒有對 Hub 做攻擊測試。

幾個自己用的時候要注意的：

- **填進去的憑證是存在你電腦上的。** 查額度那塊要填 API key 或 cookie，這些會存在 `%APPDATA%\Token Monitor\` 裡面。那台電腦多安全，這些憑證就多安全。
- **Hub 密碼是大家共用的。** 用「其中一台當 Hub」的方式是純 HTTP，**不要直接對外網開埠**，走區網或 Tailscale。
- **用 Cloudflare Worker 等於把統計放到網路上。** 密碼要夠長。雖然不含對話內容，但你的工作節奏會被看見。
- **專案資料夾名稱會同步出去。** 完整路徑跟對話標題不會，但資料夾名稱會。公司專案的命名如果本身就敏感，這點要先想過。

## 幾個要注意的地方

- **更新很快。** 5 天內發了三個版本。修得快是好事，但 Windows 每次都要重下 113 MB。在意流量的話可以關掉自動更新。
- **Cursor 偶爾會同步失敗。** 我這邊出現過 `Cursor API returned status 404`，不影響其他工具。Cursor 走的是帳號層級的匯出，本來就會慢幾分鐘。
- **只有一台機器的話，同步那塊完全可以不用碰。**
- **這篇是 Windows 11 + v0.59.0 的紀錄**，版本一直在動，你看到的畫面可能跟我不一樣。

## 結論

Token Monitor 解的問題很具體：AI 工具變多之後，用量跟額度散得到處都是。它的做法是讀本機紀錄、不碰內容、要的話可以跨機器同步，這個界線劃得很合理。

三句話收尾：

1. **自己一台用，裝完就結束了**，不用設定。
2. **多台要同步，記得先點「Connect to a hub」那顆圓點**，欄位才會出現。
3. **想在瀏覽器看，就得自己接 API。** 這是它目前最明顯的缺口，但也因為它是開源的、API 開得夠大方，補起來不難。真的想大改，原始碼跟打包指令都在，MIT 授權，隨你改。

---

## 關於本文與作者

本文出自 [Mark Ku's Blog](https://blog.markkulab.net/post/token-monitor-ai-token-dashboard)

授權條款： [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — 轉載或引用請註明作者並附上原文連結

### 關於作者

**[Mark Ku](https://blog.markkulab.net/author/mark-ku)** — Software Solution Provider

- 10+ 年資深軟體工程師，現為 AI 應用 Builder
- 專注大型平台架構設計，從北美電商到AI SaaS訂閱收費系統
- 結合 AI Agent 與自動化，打造高效可演進的產品技術基礎

### 作者開發的免費工具

以下工具皆可免費使用：

- [免費 PDF 簽名工具](https://blog.markkulab.net/tools/pdf-sign): 線上 PDF 簽名工具，瀏覽器內完成手繪、打字、上傳簽名，可拖曳放置、縮放、下載。所有處理都在你的裝置完成，檔案不會上傳。
- [VS Code Refactory](https://blog.markkulab.net/tools/refactory): Refactory 是一款 VS Code 重構擴充套件：34 個重構動作、37 條 code smell 檢查、Code Health 儀表板、18 種語言、534 支測試。懂你的專案慣例：介面放哪、DI 註冊寫在哪、'use client' 該不該加；還會用 git 修改頻率 × 複雜度排出「該先修哪個檔案」，並一鍵把壞味道交給你自己電腦上的 Claude Code 修。免費使用，原始碼不離開你的機器。
- [DB-Kit 資料庫管理工具](https://blog.markkulab.net/tools/db-kit): DB-Kit 是一個用 Tauri + Rust + React 打造的輕量跨平台資料庫管理工具，用單一一致的介面同時管理 MySQL、MariaDB、PostgreSQL、SQL Server、Oracle、SQLite、MongoDB、Redis、Kafka、Elasticsearch 與 RabbitMQ 十一種資料來源：連線密碼以 OS keychain 加密、SSH Tunnel、完整 CRUD、視覺化查詢建構器、多結果集同時顯示、跨連線資料傳輸、結構與資料比對（同步 SQL、結構快照）、Excel / CSV 匯入匯出、執行計畫視覺化、ER 圖、排程備份、SQL 壓力測試（p50～p99 延遲百分位）、15 條規則的 SQL 審查、執行前 AI 審查並逐句備份的「審查並執行」（自動產生回滾腳本）、Kafka 訊息瀏覽與監控告警；繁中 / 英文雙語介面，內建 AI 助手（本機 CLI 或 Anthropic / OpenAI 相容 API，自然語言生成 SQL、AI 審查與調校建議）與命令列工具 dbk。免費開源（MIT），提供 Windows / macOS / Linux 安裝檔。
- [VS Code Super Mermaid](https://blog.markkulab.net/tools/super-mermaid): Super Mermaid 是一款 VS Code 擴充套件：開箱即用的漂亮 Mermaid 圖表，自動上色、即時預覽、滑鼠平移縮放、PNG / SVG 高解析匯出，內建 21 種範本與多種主題。免費開源（MIT）。
- [React Super Mermaid](https://blog.markkulab.net/tools/react-super-mermaid): react-super-mermaid 是一個開源 React 元件庫：一行 <MermaidViewer> 即可渲染漂亮的 Mermaid 圖表，內建 colorful / sketch 主題、平移縮放、圖內搜尋、SVG / PNG 高解析匯出。輕量、SSR 安全、完整 TypeScript 型別。免費開源（MIT）。
- [Jira / Confluence Super Mermaid](https://blog.markkulab.net/tools/jira-super-mermaid): Atlassian Forge app：在 Jira issue 與 Confluence 內文直接寫 Mermaid 語法，畫流程圖、時序圖、狀態機與甘特圖。11 種圖表、SVG / PNG 匯出、明暗主題、完整中日韓文字支援。取得 Runs on Atlassian 資格：圖表存在你自己的站台，app 不呼叫任何第三方服務。免費，即將上架 Atlassian Marketplace。
- [Mermaid 線上預覽](https://blog.markkulab.net/tools/mermaid-preview): 在瀏覽器裡寫 Mermaid、即時看圖，整張圖表壓進網址就能分享。免註冊、不上傳伺服器，相容 mermaid.live 的分享連結。
- [React Intl Phone Number](https://blog.markkulab.net/tools/react-intl-phone-number): react-intl-phone-number 是一個開源 React 元件：framework-agnostic、不依賴 antd，提供 E.164 進出、可搜尋國旗 / 國碼下拉、可配置驗證等級（strict / mobile-strict / loose）、可主題化 CSS 與 i18n，電話邏輯由 google-libphonenumber 驅動。輕量、完整 TypeScript 型別。免費開源（MIT）。
- [Uptime Kuma Cluster](https://blog.markkulab.net/tools/uptime-kuma-cluster): 把單機版 Uptime Kuma 改造成高可用叢集：OpenResty + Lua 智慧負載平衡、MariaDB 共享狀態、健康檢查與自動 Failover，附叢集管理 REST API，一行 Docker Compose 啟動。免費開源（MIT）。
- [AI Podcast Cut 音檔剪輯](https://blog.markkulab.net/tools/ai-podcast-cut): 丟進一段錄音，AI 幫你剪掉「嗯、呃、那個」與講到一半重講的片段，平衡逐段音量，並派第二個 agent 覆核每一刀。辨識與去人聲都在你自己的電腦上跑，不上傳、不需要金鑰。剪點會貼齊字邊界與零交越、每一刀都有漸弱漸強，句尾還留得住呼吸感。Windows / macOS / Linux 桌面應用，MIT 開源，Windows 安裝檔內建 ffmpeg。
- [open-pos 開源餐飲 POS](https://blog.markkulab.net/tools/open-pos): 一台電腦加一台出單機就能開店。資料存在自己的硬碟裡、沒有月租、沒有綁約，MIT 全開源。金額用整數元依營業稅法拆算稅額，銷售額加稅額恆等於總額；出單走網路型 ESC/POS（TCP 9100），不必裝廠商驅動。Tauri + Rust + SQLite 桌面應用，v1.0 開發中。
- [特教專案](https://blog.markkulab.net/education): 為特殊教育學生製作的學習教材

### 每日 Podcast

- [Mark's Tech Insights 每日 AI 新鮮事](https://blog.markkulab.net/category/tech-news): 每日精選 AI 與科技趨勢，透過語音摘要快速掌握最新技術動態，涵蓋 AI 應用、軟體架構、DevOps 與工程實戰。 — RSS: https://blog.markkulab.net/feed.xml
- [AI股市蝦聊](https://blog.markkulab.net/category/ai-stock-chat): 每個交易日用 AI 分析台股盤勢，以雙人對話聊當天的盤中觀察與隔日預測。 — RSS: https://blog.markkulab.net/ai-stock-chat/feed.xml
- [開源好物週報](https://blog.markkulab.net/category/open-source-weekly): 每週從 Hacker News、GitHub、Reddit 聲量雷達精選免費開源工具，以雙人對話聊解決什麼痛點與怎麼快速上手。 — RSS: https://blog.markkulab.net/open-source-weekly/feed.xml
- [AI 運動週報](https://blog.markkulab.net/category/sports-weekly): 每週一、三、六以雙人對話聊 NBA、MLB、中職與台灣體育大事，台灣球迷視角，輕鬆有梗不酸人。 — RSS: https://blog.markkulab.net/sports-weekly/feed.xml
- [AI 國際新聞快報](https://blog.markkulab.net/category/world-news): 每天早上以雙人對話把過去一天的國際大事講白：政治外交、全球經濟、衝突與安全、災害與氣候，台灣視角、中立客觀、每則附出處。 — RSS: https://blog.markkulab.net/world-news/feed.xml
- [地端 AI 實驗室](https://blog.markkulab.net/category/local-ai-lab): 每週三、五精選可以下載到自己機器上跑的開源模型與 LoRA，用雙人對話講清楚能用在哪些場景、你的顯卡跑不跑得動、跟同類差在哪，規格一律引述官方 model card。 — RSS: https://blog.markkulab.net/local-ai-lab/feed.xml

### 站長優惠

- [NordVPN](https://blog.markkulab.net/nordvpn): 全球最多人用的 VPN・獨立稽核無日誌
- [PremLogin](https://blog.markkulab.net/premlogin): 訂閱合租平台・串流與 AI 訂閱席位分攤，優惠碼：markku666

### 電子報

[訂閱電子報](https://blog.markkulab.net/subscribe) — 第一時間收到新文章通知，無垃圾信、隨時可取消訂閱。
