一個完全在本機執行的 Codex Token 使用量儀表板，提供 Windows 桌面浮窗與瀏覽器版本。
資料直接讀取：
%USERPROFILE%\.codex\state_5.sqlite # Codex（可用 CODEX_STATE_DB 覆寫）
%USERPROFILE%\.zcode\cli\db\db.sqlite # ZCode，桌面浮窗會一併合併（可用 ZCODE_STATE_DB 覆寫）
需求：Node.js 22.5 以上（使用內建 node:sqlite）。首次使用先安裝依賴：
yarn install不需要 API Key，也不會把 session 內容傳送到外部服務。
最簡單的方式是在專案目錄直接雙擊：
啟動 Codex Token 浮窗.cmd
也可以在專案目錄以 PowerShell 7 執行：
yarn desktop桌面模式功能：
- 自動貼齊目前螢幕右下角。
- 預設永遠置頂。
- 每 2 秒更新 Token 與子代理狀態。
- 顯示啟動後新增 Token 與約略 Token／分鐘。
- 顯示活動中子代理名稱、狀態與累計 Token。
- 分別顯示每個子代理自 App 啟動後新增的 Token 與約略 Token／分鐘。
- Windows 11 使用原生 Acrylic 毛玻璃；其他版本使用半透明 CSS 毛玻璃備援。
- 右上角圖釘可切換永遠置頂。
- 右上角展開鍵可切換完整統計。
- 可拖曳最上方標題列移動視窗。
代理狀態判斷：
執行中：狀態為open，且 30 秒內仍有更新。等待中：狀態為open，且 10 分鐘內有更新。未關閉：狀態為open，但超過 10 分鐘沒有更新。已完成：狀態為closed。
請在專案目錄以 PowerShell 7 執行（瀏覽器版只讀 Codex 資料）：
yarn start啟動後會自動開啟：
http://127.0.0.1:4317
停止服務請回到 PowerShell 按 Ctrl+C。
若不希望自動開啟瀏覽器：
yarn start:no-openyarn test- Token 用量：加總 Codex
threads.tokens_used。 - 主對話：只計算一般使用者建立的 Codex task。
- 代理工作：另外列出 sub-agent task 數量與 Token，其消耗會納入總量。
- 歷史趨勢：依每個 task 的最後活動日歸類；跨日 task 的累計 Token 會顯示在最後活動日。
- 頁面每 30 秒自動更新，也可按右上角「更新」立即重新整理。
此工具顯示的是本機 session 記錄中的 Token 數字，適合查看使用趨勢；它不是 OpenAI 帳務頁面，資料可能與最終計費統計存在差異。