協助與資訊

連接你的帳號。
讀值清楚掌握。

從加入第一個帳號到了解已儲存讀值，這裡說明 AIUsageWatch 如何融入你的 Mac。

系統需求與版本資訊

AIUsageWatch 是免費原生選單列應用程式，適用於 macOS 14 或以上版本。公開版本正在準備中。可下載時，本網站會加入經驗證的下載連結。你的供應商帳號與其方案費用另行計算。

啟用 登入時開啟前，請先將正式推出的應用程式移至「應用程式」。它常駐於選單列，不需要 Dock 圖示。從 Finder 開啟正在執行的應用程式，會將「偏好設定」帶到最前方。

連接服務供應商

Codex： 安裝並登入 Codex CLI。將帳號指向其設定目錄，通常為 ~/.codex。應用程式透過本機 CLI app-server 使用該目錄已儲存的登入。
Claude： 預設的 ~/.claude 帳號使用 Safari 的 claude.ai 工作階段。請在「偏好設定」授予 Safari 的 Cookies.binarycookies 檔案存取權限。若使用獨立的 Claude 設定目錄，請以該 CLAUDE_CONFIG_DIR登入 Claude Code；應用程式會讀取其 .credentials.json.
Cursor： 在 Safari 登入 cursor.com，並在「偏好設定」授予 Safari Cookie 檔案存取權限。Cursor 讀取功能不使用帳號目錄。
Grok： 選擇包含 logs/unified.jsonl的 Grok 目錄。執行 Grok 可更新記錄中的帳務讀值。

應用程式讀取各來源可取得的額度資訊。Claude 和 Codex CLI 來源需要各自相關的已儲存登入。網站預覽不會存取你的帳號。

個人與工作帳號一起查看

從選單開啟 偏好設定… ，或按 ⌘,。每個帳號都有標籤、供應商、目錄、顏色與字母。使用 + 加入目錄；應用程式會從內容推測供應商。使用新帳號前，請確認供應商是否正確。

若要使用另一個 Codex 登入，請選擇其獨立的 CODEX_HOME。若要使用另一個 Claude 登入，請使用獨立的 CLAUDE_CONFIG_DIR ，並確保有該帳號的已儲存憑證。預設 Claude Safari 工作階段包含多個組織時，可能無法明確選定帳號；此時請使用獨立設定目錄。Cursor 讀取功能使用可取得的 Safari 工作階段，因此新增重複的 Cursor 列不會建立獨立登入。

更多帳號會增加欄位，每欄最多三列。自訂字母與顏色有助於辨識帳號。一般設定包括更新時間、百分比標記、字母，以及支援的 Codex 保留的額度重設機會到期提醒。

了解長條

填滿部分表示 剩餘額度。剩餘 0% 時不會有填滿部分。顏色用來辨識帳號。選單顯示百分比、可取得的重設時間、相關週期詳細資訊與讀值狀態。

Claude 包含每週與可取得的五小時詳細資訊；Codex 選取主要每週限制。Cursor 使用自己的方案內用量數值，回傳資料並未說明用量期間。Grok 使用 CLI 記錄中的每週點數數值。不同供應商的百分比不等於相同數量的 token、提示或金額。

在 Codex 保留的額度重設機會到期前留意

當 Codex 回報保留的額度重設機會可用次數及到期日期時，AIUsageWatch 可在下一個保留的額度重設機會到期前，於帳號旁顯示警示圓點。打開選單可查看可用次數與到期資訊。未使用的重設機會可能在到期後失效；這與每週額度正常重設時間不同。

在「偏好設定」中啟用 重設前提醒 ，並選擇 提前 1–14 天。預設提前兩天，使用紅色警示圓點；你可以更改顏色。關閉帳號字母時，圓點仍會顯示。提醒須仰賴應用程式正在執行、已啟用提醒，且可取得最新到期資料。它不會自動使用保留的額度重設機會，也不會發出系統通知。

Codex 的自動啟動請求

當 Codex 即時每週額度顯示剩餘 100%時，AIUsageWatch 會使用該目錄已儲存的 CLI 登入，傳送一個小型 codex exec 請求。目的是啟動原本可能保持閒置的每週週期。它使用 Codex 的預設可用模型，並 消耗該帳號少量額度.

請求正在進行或失敗時，帳號會以紅點標示。選單會說明狀態，並提供手動重試。應用程式會在記憶體中保留該每週週期的嘗試紀錄；只要紀錄仍在，重複輪詢就不會再次傳送請求。重新啟動會清除記憶體紀錄，若即時讀值仍為 100%，可能再次發出請求。

歷史逐字記錄備用來源不會傳送啟動請求。目前版本未啟用 Claude 自動啟動請求。這項行為與讀取用量不同，目前的偏好設定也未提供 Codex 啟動請求開關。

數值過時、遺漏或不符預期

已儲存讀值： 最近一次有效讀值會快取於 Mac，並於啟動時還原。更新失敗時，選單會顯示讀值距今時間。
速率限制或連線失敗： 遇到速率限制後，重試會等待 15 分鐘；其他錯誤後則等待 2 分鐘。 立即更新 會略過此等待時間。
Safari 連線： 確認已登入正確的供應商、檢查 Cookie 檔案授權，並確定工作階段能明確辨識帳號。
Grok： 執行 CLI 以記錄新的用量讀值。已結束的週期或較舊記錄會顯示為歷史資料，而非即時餘額。
Codex： 確認 CLI 可用，且已設定目錄包含預期的登入。app-server 無法使用時，逐字記錄備用來源可能顯示較舊資訊。

供應商端點與回傳資料可能變動。讀值不保證供應商會接受下一個請求。餘額或重設資訊不符預期時，請查看供應商自己的帳號頁面。

本機設定與供應商連線

偏好設定與快取讀值儲存於 ~/Library/Application Support/AiUsageWatch/。應用程式不會直接讀取「鑰匙圈」。供應商 CLI 自行管理登入行為。即時讀取功能使用現有工作階段或憑證連接相關供應商。請閱讀隱私權政策，了解應用程式本機儲存、供應商連線與支援訊息之間的差異。

回報問題

聯絡 AIUsageWatch 支援，提供應用程式版本、macOS 版本、供應商、讀值狀態與重現問題的步驟。若使用診斷 --dump 模式，傳送前請先檢查輸出。移除存取權杖、Cookie 值、私人帳號路徑與任何其他敏感資訊。請勿上傳憑證檔案。