Llm Usage Dashboard

LLM Usage Dashboard
一次看到 Codex (OpenAI) 與 Claude Code (Anthropic) 的訂閱用量、剩餘額度與重置時間，以及各專案的 token 消耗與預估花費。在本機桌面常駐執行，資料只讀你自己電腦上的檔案、不上傳任何雲端。

⚡ 一行安裝

只要電腦有 Node.js（你在用 Codex CLI / Claude Code，通常都已經有了）：
首次執行會自動下載 Electron（約 100MB+），之後啟動就很快。

📦 npm 套件頁：

📊 它顯示什麼

重點功能

- 🔒 純本機、不連網：只讀取你電腦上 Codex / Claude Code 自己產生的紀錄檔，不上傳、不需 API key。
- 🟢 Codex 額度為官方精確值：直接讀取 Codex 寫入的 rate_limits（used_percent + 重置時間）。視窗名稱一律依 Codex 回報的 window_minutes 決定 —— 不同版本的 Codex 會把 5 小時或每週視窗放在同一個欄位，寫死欄位名稱會標錯。
- 📈 各專案分項：自動依工作目錄歸戶，看出哪個專案吃掉最多額度。
- 🗓 月報（每日 × 每專案）：一張矩陣看完整個月——橫軸是日期、縱軸是專案，格子顏色代表當日用量強度，滑過可看該日的 tokens / 花費 / 請求次數。可切換月份、Tokens／花費、全部／Codex／Claude，並一鍵匯出 CSV（含 UTF-8 BOM，Excel 直接開）。
- 💵 花費估算：依模型單價把 token 換算成約略美金成本（訂閱制非實際帳單，僅供參考）。單價取自 Anthropic 與 OpenAI 官方定價頁（2026-08-24 核對），分別以「未命中輸入 / 輸出 / 5 分鐘快取寫入 / 1 小時快取寫入 / 快取命中」五種費率計算。單價表沒有的新模型會在畫面上明確標示，不會默默以 $0 計入。
- 🔄 常駐 + 自動更新：縮到系統匣常駐，檔案變動即時刷新，另每 5 分鐘自動拉取一次。
- 🚀 開機自動啟動：一個勾選即可隨 Windows 開機背景啟動。

🖥 使用方式

1. 執行 npx llm-usage-dashboard（或全域安裝後執行 llm-usage-dashboard）。
2. 主視窗開啟，立即看到所有用量。
3. 關閉視窗 = 縮到系統匣（不會結束）。點系統匣圖示可再開啟。
4. 系統匣圖示右鍵選單：
   - Open Dashboard — 開啟主視窗
   - Refresh now — 立即重新整理
   - Start with Windows — 開機自動啟動開關
   - Open data folders — 開啟 Codex / Claude 的資料夾
   - Quit — 結束程式

🔧 需求

- Node.js 18 以上（執行 node -v 確認）
- Windows / macOS / Linux 桌面環境
- 電腦上有在使用 Codex CLI 或 Claude Code（否則沒有可顯示的資料）

資料來源

同時涵蓋 CLI 與桌面版 —— 兩者共用同一份本機檔案。

❓ 常見問題

Q：會用掉我的 API 額度嗎？需要 API key 嗎？
不會、也不需要。它只是讀取你本機既有的紀錄檔來統計，完全離線運作。

Q：Claude 的額度為什麼是「估算」？
Anthropic 沒有把官方配額數字寫進本機檔案，所以 Claude 的 5 小時 / 每週是依 token 紀錄重建的估算視窗；Codex 則因為官方有寫入 rate_limits，顯示為精確值。

Q：花費金額準確嗎？
訂閱制不是按 token 計費，所以金額僅為依模型單價換算的參考值，非實際帳單。

Q：執行 llm-usage-dashboard 沒反應？
改用 npx llm-usage-dashboard（有時全域 bin 目錄不在系統 PATH 中）。

📜 授權與隱私

- 本工具在你的電腦本機執行，所有用量資料不會離開你的裝置。
- 顯示的花費為估算值，僅供參考，不代表實際帳單。

本頁為 LLM Usage Dashboard…