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

現在一天的開發流程裡，同時開著 Claude Code、Codex、GitHub Copilot、Cursor 已經是常態。工具變多之後，幾個很實際的問題就跑出來了：

• 快撞上限了嗎？ Claude Code 的 5 小時工作階段、每週額度，Codex 的週期，各家規則不一樣，通常要等跳警告才知道。
• 錢花在哪個工具上？ 每個工具有自己的後台或自己的 CLI 指令，要比較就得一個一個開。
• 哪一台機器燒的？ 公司筆電、家裡桌機、WSL 裡跑的 agent，用量各自散在各自的本機 log。

Token Monitor 想解的就是這件事：一個桌面 widget，讀本機各家工具的 log，把 token 用量、成本、各家方案剩餘額度收在同一個畫面，並且可以跨裝置同步。

這篇不是功能翻譯，是一份實測紀錄。我在自己的 Windows 機器上實際裝了 v0.59.0 跑起來，把安裝、設定、踩到的坑、可以調的旋鈕、以及我做過與沒做過的資安檢查，一次整理清楚。

這篇驗證了什麼、沒驗證什麼

先把話講在前面，避免讀者把我的實測結果放大解讀：

導入評估：給要決定要不要用的人

如果你是幫團隊評估、沒時間讀完整篇，這一段就夠了。三句話結論：

1. 它是完整的開源軟體，不是半開源。 MIT 授權，src/agent、src/electron、src/hub、worker/ 全部在 repo 裡，底層的解析引擎 tokscale 也是獨立的 MIT 專案。沒有付費牆、沒有授權金鑰、沒有功能鎖。
2. 非常適合自己二次開發。 這是我覺得它最大的價值。理由在下面展開。
3. 它沒有網頁 Dashboard。 所有畫面都在 Electron widget 裡，Hub 只給 API。想要瀏覽器開、掛大螢幕、做團隊共用看板，一定要自己接。這是目前最明顯的缺口，也剛好是二次開發最好的切入點。

為什麼說「適合二次開發」

評估一個開源專案能不能改，我會看四件事，它四項都過：

實務上二次開發有兩條路，成本差很多，建議先試第一條：

走 B 路線唯一要有的心理準備：上游更新非常快，5 天內就發了三個版本，fork 放著不管，過一陣子就很難合回來。

適合與不適合

Token Monitor 在做什麼

一句話：它不碰你的 prompt 與程式碼，只讀各家工具留在本機的用量紀錄，然後把數字加總起來。

它把資料拆成三個面向，不同工具的支援程度不一樣：

支援的工具現在有 37 種以上，常見的幾個：

另外像 OpenRouter、Minimax、火山引擎、Ollama Cloud 這些，是走 API key 或 cookie 只查額度，不算用量。

架構：Local 與 Sync 兩種模式

理解這兩個模式，後面的設定才不會亂：

重點：

• Local 是預設值，裝完就會動，不需要 Hub、不需要設定檔。
• Sync 是選用的，所有裝置要連到同一個 Hub，Hub 只能選一種。
• 有裝 widget 的機器會自動回報自己的用量，只有沒有 widget 的機器才需要另外跑 headless agent。
• 底層解析引擎是 tokscale（Rust，MIT），Token Monitor 負責 UI 與同步。

安裝：Windows 實測流程

三個平台的安裝方式：

我這次走 Windows。以下是實際跑過的步驟。

1. 下載

$url = "https://github.com/Javis603/token-monitor/releases/download/v0.59.0/Token-Monitor-Setup-0.59.0.exe"
curl.exe -sL -o "$env:TEMP\Token-Monitor-Setup-0.59.0.exe" $url

檔案約 113.8 MB。可以順手比對一下 GitHub Release 頁面標示的檔案大小是否一致。

2. 先驗簽章，再執行

從網路抓回來的執行檔，執行前確認簽章是基本功：

$sig = Get-AuthenticodeSignature "$env:TEMP\Token-Monitor-Setup-0.59.0.exe"
$sig | Format-List Status, StatusMessage
$sig.SignerCertificate | Format-List Subject, Issuer, NotAfter

我這邊實際跑出來的結果：

Status        : Valid
StatusMessage : Signature verified.

Subject    : CN=SignPath Foundation, O=SignPath Foundation, L=Lewes, S=Delaware, C=US
Issuer     : CN=GlobalSign GCC R45 CodeSigning CA 2020, O=GlobalSign nv-sa, C=BE
NotAfter   : 2027/9/8 上午 01:23:55

簽章有效，簽署者是 SignPath Foundation，與專案文件裡寫的「由 SignPath.io 提供免費程式碼簽章」一致。這代表檔案沒有被竄改、來源可追溯，但不代表程式內容安全，那是另一回事，後面資安章節再談。

3. 安裝

雙擊安裝即可。要靜默安裝的話：

Start-Process "$env:TEMP\Token-Monitor-Setup-0.59.0.exe" -ArgumentList "/S" -Wait

裝完後的位置：

要完整移除的話，解除安裝之後記得把上面的應用程式資料目錄一起刪掉。

踩坑：從 VS Code 的終端機啟動，程式會秒退

這個坑花了我一點時間，值得記一下。

我第一次用終端機啟動它，程式立刻以 exit code 0 結束，連 %APPDATA%\Token Monitor\ 都沒建出來。加上參數想看日誌，得到一個很奇怪的訊息：

Token Monitor.exe: bad option: --enable-logging

bad option 是 Node.js 的錯誤格式，不是 Electron 的。查下去發現原因：

$env:ELECTRON_RUN_AS_NODE
# 1

VS Code 的擴充套件主機會把 ELECTRON_RUN_AS_NODE=1 傳給它開出來的終端機。 這個環境變數會讓任何 Electron 應用程式退化成純 Node 執行，於是它把 --enable-logging 當成 Node 參數，看不懂就結束了。

解法是啟動前把它清掉：

$env:ELECTRON_RUN_AS_NODE = $null
Start-Process "$env:LOCALAPPDATA\Programs\Token Monitor\Token Monitor.exe"

這不是 Token Monitor 的問題，任何 Electron app 從 VS Code 終端機啟動都會踩到。平常用開始選單或桌面捷徑點開就完全不會遇到。

第一次啟動：本機模式裝完就動

清掉環境變數後再啟動，日誌立刻看得出它在做什麼：

Checking for update
[collector] Watching C:\Users\<you>\.claude\projects (native events)
[collector] Watching C:\Users\<you>\.openclaw\agents (native events)
[collector] Watching C:\Users\<you>\.copilot (native events)
[collector] Watching C:\Users\<you>\AppData\Roaming\Code\User\workspaceStorage (native events)
[collector] Watching C:\Users\<you>\.lmstudio\server-logs (native events)
[collector] Watching C:\Users\<you>\.gemini\antigravity (native events)
Update for version 0.59.0 is not available (latest version: 0.59.0)

幾個觀察：

• 它只監看我機器上真的存在的工具目錄，沒裝的工具不會去碰。
• 用的是作業系統原生的檔案事件（native events），不是輪詢整個磁碟。
• 啟動時會自己檢查 GitHub 上有沒有新版。

預設會追蹤 28 個 client，設定檔在 %APPDATA%\Token Monitor\settings.json。我實際讀到的幾個預設值：

多裝置同步：Hub URL 要去哪裡設

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

Hub URL 的設定位置

widget 右下角的 ⚙ 齒輪 → Multi-device Sync（多裝置同步） → 選 Connect to a hub（連接到 Hub） 那顆 radio

選下去之後才會出現 URL 與密鑰兩個欄位。沒有先選那顆 radio，欄位是不會出現的，這是很多人以為「找不到設定」的原因。

三種 Hub 選一個

三種擇一，所有裝置連同一個。設定步驟：

1. 在當 Hub 的那台，⚙ → Multi-device Sync → Host hub on this device。它會產生一組隨機密鑰，並列出其他裝置可以連的區網網址（有裝 Tailscale 或 ZeroTier 的話，這裡也會列出那些位址）。
2. 在其他每一台，⚙ → Multi-device Sync → Connect to a hub，貼上網址與密鑰。
3. 沒有安裝 widget 的機器（例如純跑 agent 的伺服器）才需要另外跑 npm run agent。

跨網段的情境，走 Tailscale 或 ZeroTier 會比開防火牆對外簡單，也比較安全。

Hub 有完整 API，但官方沒有附網頁 Dashboard

這是我覺得最值得寫的一段，也是「要自己改」的地方。

Hub 本身提供一組乾淨的 JSON API，但官方沒有做一個給瀏覽器看的網頁版儀表板。所有畫面都在 Electron widget 裡。想在瀏覽器或電視上掛一個大畫面，就得自己接。

Hub API 一覽

驗證方式二選一：

Authorization: Bearer <secret>

X-Token-Monitor-Secret: <secret>

先確認 Hub 活著：

curl http://127.0.0.1:17321/api/health

再把統計抓下來看結構：

curl -H "Authorization: Bearer <你的密鑰>" \
     http://127.0.0.1:17321/api/stats | jq '.periods.today | keys'

/api/stats 的回應裡，比較實用的幾塊：

• periods.today / periods.month / periods.allTime：三個時間區間的總量
• periods.*.projects：以專案資料夾為單位的用量，跨裝置會用同一個資料夾標籤彙總
• periods.*.clientModels：工具與模型的交叉分佈
• limits.providers：各家方案的剩餘額度，多台回報同一帳號時，Hub 會保留最新的那筆
• devices：每台裝置的用量、額度、回報時間與是否過期

要做即時畫面的話用 /api/stats/stream 比輪詢好：它每次連線都先送一份完整 snapshot，之後 100 毫秒內的多筆回報會合併成一個 stats 事件，每 30 秒送一次心跳。斷線重連會拿到完整狀態，不用自己補洞。

我們自己接的 Dashboard

因為上面這個缺口，我們就用這組 API 接了一個單檔的 dashboard.html，瀏覽器直接開，填 Hub 網址與密鑰就會動：

上半部對應的資料來源大致是這樣：

往下捲是裝置清單與工具球籃：

裝置清單這塊實際上很有用，一眼就看得出哪台是 headless-agent、哪台是 electron-widget、各自的版本與最後回報時間。版本不一致或某台的「最後回報」停在幾小時前，通常就是同步出問題的第一個線索。

要自己做的話，最小可行版本其實只需要三件事：

1. 一個放 Hub 網址與密鑰的表單（密鑰存 localStorage 就夠）
2. 連 /api/stats/stream，收到 snapshot 與 stats 事件就重畫
3. 把 periods 與 devices 兩棵物件攤平成表格

「半開源」這個說法，我實際查了一下

團隊裡第一輪的印象是「這是半開源，用起來卡卡的，想要順大概得花錢找他們協助」。這個感受我完全理解，但實際查下來，授權的部分要幫它澄清一下：

專案本身 2,221 顆星、219 個 fork、108 個開著的 issue，2026 年 5 月才建立，四個月做到這個完成度，更新頻率相當高。程式碼是真的全部公開的，也附了 npm run dist:win 之類的打包指令，要自己 fork 來改完全做得到。

那「卡卡的」是從哪來的？我的看法是，這幾件事加起來就會有那個感覺，但它們是產品取捨，不是閉源：

• 額度那塊要一個一個手動填憑證。 用量是讀本機 log 自動來的，但 AI Tool Limits 要 API key 或 cookie，工具一多，設定就要填很久。
• Hub 沒有網頁 Dashboard。 前面那一整段就是在補這個洞。
• Windows 安裝檔每次都是全量。 113 MB 一版，而且 5 天內連發了 0.57.0、0.58.0、0.59.0 三版。
• 支援管道主要在 Discord。 對習慣在 issue 上追進度的人來說，會覺得資訊散落。

所以結論是：它不是逼你付費的半開源，是一個更新很快、但預設值不見得符合每個人習慣的活躍專案。 想要順手，正確的做法是 fork 出來改，然後在自己這邊打包：

git clone https://github.com/Javis603/token-monitor.git
cd token-monitor
npm install
npm run dist:win     # Windows x64 安裝檔，產出在 dist/

需要 Node.js 22.15 以上，而且要在目標作業系統上打包，electron-builder 沒辦法在 Windows 上做出 macOS 的 .dmg。

自己 fork 之後要有心理準備：上游更新很快，要定期 rebase，不然過一陣子就合不回去了。

調校：避免「更新頻率一開大就塞住」

另一個常見的抱怨是更新頻率調高之後會卡。可以動的旋鈕都在 ⚙ 設定裡，對應到 settings.json 的欄位如下：

實務上的順序建議是：先關掉沒在用的工具，再考慮動時間間隔。 預設 28 個 client 全開，但大部分人真正在用的可能只有三四個，把其他的關掉，效果比調 refreshMs 明顯得多。

另外一個容易被忽略的設定，跟效能無關但很重要：

Claude Code 預設只保留 30 天的 transcript。 超過就被自己清掉，那段歷史就再也回不來了。兩個做法：

1. 開著 Token Monitor 的 sessionUsageArchiveEnabled，它會把它觀察過的每日用量另外存檔，來源檔案被刪也不影響熱力圖與趨勢。
2. 想連原始 transcript 一起留，在 ~/.claude/settings.json 調保留天數：

{
  "cleanupPeriodDays": 370
}

要注意第 1 點只能救「它開始追蹤之後」的資料，安裝之前就被刪掉的歷史是拿不回來的。所以如果打算長期看趨勢，越早裝越好。

資安檢查：我做了什麼、沒做什麼

既然要導入，「順便掃一下漏洞」是合理的要求。完整稽核我沒有做，但幾項基本檢查是實際跑過的，結果如下。

做過的檢查

1. 安裝檔簽章：Get-AuthenticodeSignature 顯示 Valid，簽署者 SignPath Foundation，簽發者 GlobalSign。檔案沒被竄改。

2. 對外連線：程式跑起來之後，實際看它建立了哪些連線：

$pids = (Get-Process | Where-Object { $_.ProcessName -like "*Token*" }).Id
Get-NetTCPConnection -State Established | Where-Object { $pids -contains $_.OwningProcess }
Get-NetTCPConnection -State Listen | Where-Object { $pids -contains $_.OwningProcess }

結果只有兩個對外目的地：

本機模式下沒有開任何監聽埠，跟 hubMode: "local" 的設定一致。這點滿重要的：沒有開 Hub 的話，它不會在你的機器上開任何對外的服務。

3. collector 讀取範圍：從啟動日誌可以確認它監看的都是各家 AI 工具自己的 log 目錄，沒有掃描整個使用者資料夾或專案原始碼。

4. 授權與隱私聲明：MIT，原始碼完整公開；官方文件聲明不送任何遙測給維護者，網路行為限於更新檢查、你自己啟用的功能，以及多裝置同步。

沒做的檢查

• 沒有逐行審查原始碼
• 沒有反組譯，沒有驗證發佈的 binary 真的是那份原始碼編出來的
• 沒有對 Hub 端點做攻擊測試

自己用的時候要注意的風險

• 憑證是存在本機的。 AI Tool Limits 要填 API key、cookie 或 access token，這些會存在 %APPDATA%\Token Monitor\credentials.json。那台機器的安全等級，就是那些憑證的安全等級。
• Hub 密鑰是共享密鑰。 所有裝置用同一組。用 A 方案（widget 內建 Hub）時是純 HTTP，不要直接對公網開埠，走區網或 Tailscale / ZeroTier。
• Cloudflare Worker 方案等於把統計放上網際網路。 密鑰要夠長，而且要記得它保護的是「你所有 AI 工具的用量與帳號額度」，雖然不含 prompt 內容，但工作節奏、專案名稱這類資訊還是會外露。
• 專案標籤會跨裝置同步。 periods.*.projects 會帶專案資料夾名稱。絕對路徑與對話標題留在本機不會上傳，但資料夾名稱會。公司專案的命名如果本身就敏感，這點要先想清楚。

注意事項 / PS

• 版本更新非常快。 5 天內三個版本，好處是問題修得快，代價是 Windows 每次都要重下 113 MB。在意流量的話可以關掉自動更新，固定一段時間手動更新一次。
• Cursor 帳號可能會同步失敗。 我這邊啟動時出現 cursor sync failed: Cursor API returned status 404 Not Found，其他工具不受影響。Cursor 走的是帳號層級的用量匯出，本來就會有幾分鐘延遲，不是即時的。
• WSL 裡走 SQLite 的工具可能要另外處理。 檔案型的用量會自動合併，但 OpenCode、Hermes 這類用 SQLite 的，官方文件說可能需要在 WSL 裡另外跑一個 headless agent。
• Local 模式不需要 Hub。 只有一台機器的話完全不用碰同步設定，裝完就結束了。
• 本文的實測環境是 Windows 11 + v0.59.0，版本一直在動，看到這篇時介面與預設值可能已經不一樣了，請以當下版本的設定畫面為準。

結論

Token Monitor 解的是一個很具體的問題：AI coding 工具變多之後，用量與額度散落各處。它的做法是讀本機 log、不碰內容、可選擇性地跨裝置同步，這個邊界劃得相當合理。

三個實務重點收尾：

1. 單機用就裝完收工，預設值就能用，不用碰任何設定。
2. 多裝置的關鍵在 Hub URL 那顆 radio，⚙ → Multi-device Sync → Connect to a hub，選了才會出現欄位。
3. 想要瀏覽器看大畫面，就得自己接 API。 Hub 的 /api/stats 與 /api/stats/stream 規格完整，做一個單檔 HTML 就夠用了，這也是這個專案目前最值得自己動手補的一塊。

至於「用起來卡卡」的感覺，實測下來多半可以靠關掉沒在用的工具解決，不需要走到 fork 的程度。真的要改，原始碼與打包指令都在，MIT 授權，沒有任何付費牆擋著。