幫助同資料

連接你嘅帳戶。
了解你睇緊嘅讀數。

由第一個帳戶，到理解儲存嘅讀數，呢度會講清楚點樣喺你部 Mac 用 AIUsageWatch。

系統要求同推出資料

AIUsageWatch 係免費原生選單列 app，適用於 macOS 14 或之後版本。公開版本籌備中。推出後，本網站會加入經核實嘅下載連結。你嘅供應商帳戶同各自計劃收費另行處理。

公開版本推出後，先將 app 移到「應用程式」，再啟用 登入時開啟。App 喺選單列運行，唔需要 Dock 圖示。從 Finder 打開已經運行緊嘅 app，會將偏好設定帶到最前。

連接供應商

Codex： 安裝並登入 Codex CLI。將帳戶指向佢嘅設定目錄，通常係 ~/.codex。App 透過本機 CLI app-server 使用該目錄內儲存嘅登入。
Claude： 預設嘅 ~/.claude 帳戶用你喺 claude.ai 嘅 Safari 工作階段。喺偏好設定授權讀取 Safari 嘅 Cookies.binarycookies 檔案。如果用獨立 Claude 設定目錄，就以 Claude Code 登入，並指定相應嘅 CLAUDE_CONFIG_DIR；app 會讀取佢嘅 .credentials.json.
Cursor： 喺 Safari 登入 cursor.com，再喺偏好設定授權讀取 Safari cookie 檔案。Cursor 唔會用帳戶目錄取得讀數。
Grok： 選擇包含以下檔案嘅 Grok 目錄： logs/unified.jsonl。運行 Grok，更新記錄檔內嘅帳單讀數。

App 讀取各來源可提供嘅額度資料。Claude 同 Codex CLI 來源需要相應儲存登入。網站預覽絕對唔會存取你嘅帳戶。

私人同工作帳戶一齊睇

從選單打開 偏好設定… ，或者按 ⌘,。每個帳戶都有標籤、供應商、目錄、顏色同字母。用 + 加入目錄；app 會按目錄內容推測供應商。用新帳戶之前，請確認供應商係咪正確。

另一個 Codex 登入，要選擇佢獨立嘅 CODEX_HOME。另一個 Claude 登入，要用獨立嘅 CLAUDE_CONFIG_DIR ，並有自己儲存嘅憑證。預設 Claude Safari 工作階段包含多個機構時，身份可能唔明確；呢個情況請用獨立設定目錄。Cursor 讀取功能用可用嘅 Safari 工作階段，所以多加一行重複嘅 Cursor 唔會建立獨立登入。

帳戶多咗就會增加欄數，每欄最多三行。自訂字母同顏色幫你認清帳戶。一般設定包括更新時間、百分比標記、字母，同支援嘅 Codex 儲起嘅額度重設到期提示。

了解額度棒

填滿嘅部分代表 剩餘額度。剩餘 0% 時就冇填滿部分。顏色用嚟認帳戶。選單顯示百分比、可取得嘅重設時間、相關週期詳情同讀數狀態。

Claude 包括每週同可取得嘅 5 小時詳情；Codex 選取主要每週限額。Cursor 用自己嘅計劃內用量數字，來源資料冇標明用量週期。Grok 用 CLI 記錄檔內嘅每週點數數字。唔同供應商嘅百分比，唔等於相同數量嘅 token、提示或金額。

喺 Codex 儲起嘅額度重設到期前留意到

當 Codex 回報儲起嘅額度重設嘅可用次數同到期日期，AIUsageWatch 可以喺下一次儲起嘅額度重設到期前，喺帳戶旁邊顯示提示圓點。打開選單睇可用次數同到期資料。儲起但未用嘅額度重設，到期就可能失效；呢個同每週額度按正常時間重設係兩回事。

啟用 重設前提示 ，喺偏好設定選擇 提前 1–14 日。預設提前 2 日，用紅色提示圓點；你可以改顏色。即使關閉帳戶字母，圓點都會繼續顯示。提示需要 app 正在運行、提示已啟用，以及可取得最新到期數據。佢唔會自動使用儲起嘅額度重設，亦唔會發送系統通知。

Codex 自動啟動請求

當 Codex 每週即時讀數顯示仲有 100%，AIUsageWatch 會發送一個小型 codex exec 請求，用該目錄內儲存嘅 CLI 登入。目的係啟動原本可能未開始嘅每週週期。請求會用 Codex 預設可用模型，並 消耗少量該帳戶額度.

請求進行中或失敗時，紅點會標記帳戶。選單解釋狀態，並提供手動重試。App 會喺記憶體記住該每週週期嘅嘗試。只要仲記住呢次嘗試，重複輪詢就唔會再發送請求；重新開啟 app 會清除記憶，如果即時讀數仍然係 100%，就可能再次發送請求。

歷史對話記錄後備來源唔會發送啟動請求。目前版本冇啟用 Claude 自動啟動功能。啟動請求同讀取用量係兩回事，目前偏好設定亦冇 Codex 啟動請求開關。

數字過時、缺失或唔合理

儲存讀數： 上次成功讀數會快取喺你部 Mac，開啟 app 時會還原。更新失敗時，選單會話你知讀數係幾耐之前嘅。
限流或連線失敗： 遇到限流後等 15 分鐘先重試，其他錯誤後等 2 分鐘。 立即更新 會略過呢個等待時間。
Safari 連線： 確認已登入正確供應商、檢查 cookie 檔案授權，並確認工作階段身份明確。
Grok： 運行 CLI，記錄新嘅用量讀數。已過期週期或舊記錄檔會標示為歷史資料，唔會當成即時餘額。
Codex： 確認 CLI 可以使用，同已設定目錄內係你想用嘅登入。如果 app-server 無法使用，對話記錄後備來源可能顯示較舊資料。

供應商端點同回傳資料格式可能改變。讀數唔保證供應商會接受下一個請求。如果餘額或重設時間唔合理，請查供應商自己嘅帳戶頁面。

本機設定同供應商連線

偏好設定同快取讀數儲存喺 ~/Library/Application Support/AiUsageWatch/。App 唔會直接讀取鑰匙圈。供應商 CLI 自行管理登入方式。即時讀取功能會用現有工作階段或憑證聯絡相關供應商。請睇私隱政策，了解 app 本機儲存、供應商連線同支援訊息之間嘅分別。

回報問題

聯絡 AIUsageWatch 支援，附上 app 版本、macOS 版本、供應商、讀數狀態，同重現問題嘅步驟。如果你用診斷 --dump 模式，傳送前請檢查輸出。刪走 token、cookie 值、私人帳戶路徑同其他敏感資料。唔好上傳憑證檔案。