TokenTracker：本機 token 記錄與費用儀表板的邊界

TokenTracker：本機 token 記錄與費用儀表板的邊界 的定位

TokenTracker是一個本地優先的儀表板，記錄來自29種AI編碼工具（包括Claude Code、Codex CLI、Cursor、Gemini CLI和Qoder）的令牌用量和成本。它從不讀取提示詞、回應或檔案內容，只收集令牌計數和時間戳。無需帳戶或API金鑰，除非啟用可選的排行榜，否則所有資料都保留在機器上。該專案用JavaScript編寫，並以MIT授權發布。

在Node.js 20+環境下執行npx tokentracker-cli，會自動為偵測到的工具安裝鉤子，同步現有資

在 xiufengsun/TokenTracker 的 README 脈絡中，第 1 節要核對的是 npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3。先記錄專案版本、作業系統與輸入資料，再執行或閱讀上述入口；觀察命令回傳值、產生的檔案、服務埠或裝置反應。對這個觀察點來說，輸入應保持可重複，輸出則要保留原始檔名、日誌和錯誤訊息，才能分清是設定不符、依賴缺失，還是功能本身沒有涵蓋。

TokenTracker 的 README 若只列出概念或展示片段，本文就只把它寫成定位。沒有明列的效能、相容性與安全保證，不延伸成承諾；要採用時，應把 從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 對應到實際環境，檢查第 1 個觀察點是否得到預期結果。

針對 xiufengsun/TokenTracker，第 1 節還要把檔案、命令與結果放在同一筆紀錄中。若入口是 npx tokentracker-cli，就記下它接受的參數、執行前後的目錄內容，以及失敗時顯示的第一個錯誤。若入口是通訊通道、桌面程式或硬體，則分別記錄登入狀態、視窗行為、裝置回應與網路條件。這些紀錄能回答本文的具體問題：從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 是否真的在目前環境成立。第 1 節的判斷只涵蓋 README 有指向的範圍，不能用其他專案的經驗補齊空白；版本升級後也要重看 TokenTracker 的變更內容，確認設定鍵、輸出格式和權限要求沒有改變。

npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3 對應的資料流

料，並在http://localhost:7680開啟儀表板。儀表板顯示用量趨勢、模型分解和成本分析。macOS選單列應用和Windows系統匣應用可從發布頁面取得，每個應用都在webview中嵌入儀表板。也提供了透過npm或Homebrew進行全域安裝的說明。

TokenTracker使用三種偵測方法。像Claude Code和Codex這類基於鉤子的工具，會向其設定檔中寫入SessionEnd或TOML通知鉤子。像OpenCode和OpenClaw這類基於外掛的工具，會從npm套件取

在 xiufengsun/TokenTracker 的 README 脈絡中，第 2 節要核對的是 npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3。先記錄專案版本、作業系統與輸入資料，再執行或閱讀上述入口；觀察命令回傳值、產生的檔案、服務埠或裝置反應。對這個觀察點來說，輸入應保持可重複，輸出則要保留原始檔名、日誌和錯誤訊息，才能分清是設定不符、依賴缺失，還是功能本身沒有涵蓋。

TokenTracker 的 README 若只列出概念或展示片段，本文就只把它寫成定位。沒有明列的效能、相容性與安全保證，不延伸成承諾；要採用時，應把 從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 對應到實際環境，檢查第 2 個觀察點是否得到預期結果。

針對 xiufengsun/TokenTracker，第 2 節還要把檔案、命令與結果放在同一筆紀錄中。若入口是 npx tokentracker-cli，就記下它接受的參數、執行前後的目錄內容，以及失敗時顯示的第一個錯誤。若入口是通訊通道、桌面程式或硬體，則分別記錄登入狀態、視窗行為、裝置回應與網路條件。這些紀錄能回答本文的具體問題：從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 是否真的在目前環境成立。第 2 節的判斷只涵蓋 README 有指向的範圍，不能用其他專案的經驗補齊空白；版本升級後也要重看 TokenTracker 的變更內容，確認設定鍵、輸出格式和權限要求沒有改變。

npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3 的首次操作

得外掛。對於像Cursor、Hermes和Qoder這類被動讀取器，TokenTracker會讀取這些工具已經產生的SQLite資料庫、JSONL檔案或OpenTelemetry匯出檔案，無需安裝任何內容。聚合後的令牌計數儲存在本地SQLite資料庫中，按30分鐘UTC時段分組，儀表板、選單列應用和小工具都從同一快照讀取。

除了核心儀表板，TokenTracker還附帶一個桌面寵物，它能根據實際編碼活動做出反應，還有四個原生桌面小工具，用於顯示用量、活動熱圖、熱門模型和用量限制，以及15

在 xiufengsun/TokenTracker 的 README 脈絡中，第 3 節要核對的是 npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3。先記錄專案版本、作業系統與輸入資料，再執行或閱讀上述入口；觀察命令回傳值、產生的檔案、服務埠或裝置反應。對這個觀察點來說，輸入應保持可重複，輸出則要保留原始檔名、日誌和錯誤訊息，才能分清是設定不符、依賴缺失，還是功能本身沒有涵蓋。

TokenTracker 的 README 若只列出概念或展示片段，本文就只把它寫成定位。沒有明列的效能、相容性與安全保證，不延伸成承諾；要採用時，應把 從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 對應到實際環境，檢查第 3 個觀察點是否得到預期結果。

針對 xiufengsun/TokenTracker，第 3 節還要把檔案、命令與結果放在同一筆紀錄中。若入口是 npx tokentracker-cli，就記下它接受的參數、執行前後的目錄內容，以及失敗時顯示的第一個錯誤。若入口是通訊通道、桌面程式或硬體，則分別記錄登入狀態、視窗行為、裝置回應與網路條件。這些紀錄能回答本文的具體問題：從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 是否真的在目前環境成立。第 3 節的判斷只涵蓋 README 有指向的範圍，不能用其他專案的經驗補齊空白；版本升級後也要重看 TokenTracker 的變更內容，確認設定鍵、輸出格式和權限要求沒有改變。

TokenTracker：本機 token 記錄與費用儀表板的邊界 的限制與未知

個成就軌道，將里程碑轉化為可收集的徽章。可選的排行榜允許你與其他開發者比較用量，技能標籤頁可以瀏覽250多個公開技能並將其同步到受支援的工具中。這些功能都在README中配有截圖和範例。

README列出了29個受支援的工具，從Claude Code和Cursor到AnythingLLM Desktop和Claude Science。每個列出的工具都能自動偵測。有些工具是被動讀取的，意味著不會新增鉤子或外掛；例如，Cursor使用API加SQLite認證令牌，Qoder讀取本地資料庫。該

在 xiufengsun/TokenTracker 的 README 脈絡中，第 4 節要核對的是 npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3。先記錄專案版本、作業系統與輸入資料，再執行或閱讀上述入口；觀察命令回傳值、產生的檔案、服務埠或裝置反應。對這個觀察點來說，輸入應保持可重複，輸出則要保留原始檔名、日誌和錯誤訊息，才能分清是設定不符、依賴缺失，還是功能本身沒有涵蓋。

TokenTracker 的 README 若只列出概念或展示片段，本文就只把它寫成定位。沒有明列的效能、相容性與安全保證，不延伸成承諾；要採用時，應把 從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 對應到實際環境，檢查第 4 個觀察點是否得到預期結果。

針對 xiufengsun/TokenTracker，第 4 節還要把檔案、命令與結果放在同一筆紀錄中。若入口是 npx tokentracker-cli，就記下它接受的參數、執行前後的目錄內容，以及失敗時顯示的第一個錯誤。若入口是通訊通道、桌面程式或硬體，則分別記錄登入狀態、視窗行為、裝置回應與網路條件。這些紀錄能回答本文的具體問題：從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 是否真的在目前環境成立。第 4 節的判斷只涵蓋 README 有指向的範圍，不能用其他專案的經驗補齊空白；版本升級後也要重看 TokenTracker 的變更內容，確認設定鍵、輸出格式和權限要求沒有改變。

npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3 的維護觀察

專案還包含一個成本引擎，透過LiteLLM為2200多個模型定價，每日自動重新整理，並帶有24小時磁碟快取和離線快照。沒有發布供應商定價的模型顯示$0成本，直到有費率可用。

TokenTracker預設是本地優先的。可能離開機器的唯一資料是一個匿名的每日心跳（機器ID、應用版本、作業系統和shell的雜湊）以及透過PostHog傳送的匿名儀表板頁面瀏覽事件，且自動擷取和會話錄製已停用。兩者都可以透過TOKENTRACKER_NO_TELEMETRY=1或DO_NOT_TRACK=1關閉。

在 xiufengsun/TokenTracker 的 README 脈絡中，第 5 節要核對的是 npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3。先記錄專案版本、作業系統與輸入資料，再執行或閱讀上述入口；觀察命令回傳值、產生的檔案、服務埠或裝置反應。對這個觀察點來說，輸入應保持可重複，輸出則要保留原始檔名、日誌和錯誤訊息，才能分清是設定不符、依賴缺失，還是功能本身沒有涵蓋。

TokenTracker 的 README 若只列出概念或展示片段，本文就只把它寫成定位。沒有明列的效能、相容性與安全保證，不延伸成承諾；要採用時，應把 從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 對應到實際環境，檢查第 5 個觀察點是否得到預期結果。

針對 xiufengsun/TokenTracker，第 5 節還要把檔案、命令與結果放在同一筆紀錄中。若入口是 npx tokentracker-cli，就記下它接受的參數、執行前後的目錄內容，以及失敗時顯示的第一個錯誤。若入口是通訊通道、桌面程式或硬體，則分別記錄登入狀態、視窗行為、裝置回應與網路條件。這些紀錄能回答本文的具體問題：從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 是否真的在目前環境成立。第 5 節的判斷只涵蓋 README 有指向的範圍，不能用其他專案的經驗補齊空白；版本升級後也要重看 TokenTracker 的變更內容，確認設定鍵、輸出格式和權限要求沒有改變。

TokenTracker：本機 token 記錄與費用儀表板的邊界 的採用判斷

README指向完整的隱私政策，並邀請稽核遙測來源檔案。它不聲稱任何正式的安全認證或獨立稽核。

環境變數控制除錯輸出、HTTP逾時、Git歸因和WSL解析。TOKENTRACKER_WSL_MODE變數接受wsl-first、native-first、wsl-only、native-only和both，預設值為wsl-first。該專案根據MIT授權發布，該授權授予使用、複製、修改、合併、發布、散佈、再授權和出售軟體副本的許可權。授權不提供任何擔保，並否認責任；它沒有提及安全狀況或支援。

在 xiufengsun/TokenTracker 的 README 脈絡中，第 6 節要核對的是 npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3。先記錄專案版本、作業系統與輸入資料，再執行或閱讀上述入口；觀察命令回傳值、產生的檔案、服務埠或裝置反應。對這個觀察點來說，輸入應保持可重複，輸出則要保留原始檔名、日誌和錯誤訊息，才能分清是設定不符、依賴缺失，還是功能本身沒有涵蓋。

TokenTracker 的 README 若只列出概念或展示片段，本文就只把它寫成定位。沒有明列的效能、相容性與安全保證，不延伸成承諾；要採用時，應把 從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 對應到實際環境，檢查第 6 個觀察點是否得到預期結果。

針對 xiufengsun/TokenTracker，第 6 節還要把檔案、命令與結果放在同一筆紀錄中。若入口是 npx tokentracker-cli，就記下它接受的參數、執行前後的目錄內容，以及失敗時顯示的第一個錯誤。若入口是通訊通道、桌面程式或硬體，則分別記錄登入狀態、視窗行為、裝置回應與網路條件。這些紀錄能回答本文的具體問題：從本機資料同步、工具掛鉤與桌面元件檢查 TokenTracker 是否真的在目前環境成立。第 6 節的判斷只涵蓋 README 有指向的範圍，不能用其他專案的經驗補齊空白；版本升級後也要重看 TokenTracker 的變更內容，確認設定鍵、輸出格式和權限要求沒有改變。

編輯結論

適合需要直接研究 TokenTracker 並能處理其環境條件的人；不適合把 README 的示範、統計或自報數據當成正式保證。採用前先針對 npx tokentracker-cli、Node.js 20+、http://localhost:7680、sqlite3 執行最小流程，保存版本、設定、輸入與輸出，再決定是否納入工作流；若結果不符，回到 xiufengsun/TokenTracker 的 README、issue 與 release 逐項比對。

官方來源

1. Official documentation
2. Official README
3. Project repository
4. Release notes