Agent Battery：把 Claude Code 與 Codex 的剩餘用量，顯示成 Mac 狀態欄的電池百分比

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

Agent Battery 是一個 macOS 狀態欄小工具（github.com/geebos/agent-battery，Swift 原生，作者 geebos 的個人專案，42 顆星），它做的事很單純：把你 Claude Code 與 Codex 還剩多少用量，變成 Mac 右上角那顆電池圖示裡的百分比，再附上重置時間。它最主打的賣點是不向你伸手要 API Key、也不連任何官方介面，資料全從你電腦裡的本地檔案讀出來。但這份「免 Key」並非全無成本：對 Claude Code 使用者來說，它得在你首次設定時改寫 ~/.claude/settings.json，植入一個狀態列掛鉤才拿得到用量；而且這個專案截至目前並沒有附任何授權條款，原始碼公開，法律上屬於「保留所有權利」，等於你並未取得使用、修改或散布的明確權利。這兩點是裝之前一定要先想清楚的地方。

一句話結論：Agent Battery 把 Claude Code 與 Codex 的剩餘用量做成一顆 Mac 狀態欄電池，免 API Key、讀本地檔案，適合重度使用者隨時瞄一眼。代價是它會動你的 Claude Code 設定檔、專案未附授權條款、也未經蘋果簽署公證；如果你要的只是「在 Mac 選單列看用量」，已經 MIT 授權、15709 顆星的 CodexBar 早就把同一件事做得更完整。

把 AI 編程額度變成狀態欄裡的電池百分比

Agent Battery 的彈窗把用量拆成兩個欄位：5 小時區間的剩餘，以及一個更長的週期額度，並附上各自的重置時間（這是它顯示的欄位，確切的計費規則請以 Claude Code 與 Codex 官方說明為準）。帳面欄位一目瞭然，問題出在實戰當下：一連好幾個小時在終端機裡工作時，額度往往是在你最不希望它見底的時候見底，例如正卡在某個難重現的問題中間，只能被迫停下來等重置。Agent Battery 想補的就是這塊可見性：讓你不必切到後台頁面查，抬頭看一眼狀態欄就知道還能不能撐完手邊的工作。

Pin

裝起來之後，它會常駐在 Mac 選單列，平時顯示你主要工具的 5 小時剩餘額度（低於門檻時變色提醒）；點開彈窗，則能把 Claude Code 與 Codex 兩邊的 5 小時額度、週額度、以及對應的重置時間並排放出來比對。更新頻率預設 30 秒拉一次，也能設成 1、3、5 分鐘，還備有開機自動啟動、門檻自訂、並排顯示模式、中英雙語這些配套。它只讀不寫你的額度數字。

免 API Key 的代價：它讀的是本地檔案，不是官方介面

多數看板走的是「你授權、它代抓」的模式，等於把一把能動你帳號的鑰匙交給第三方 App，這在工具來源不明時特別讓人猶豫。Agent Battery 刻意繞開這條路，不向你索取 Key，而是直接讀你電腦裡已經存在的本地檔案。對不願再把金鑰交給第三方的開發者來說，這點確實誘人，但要留意，這層隱私優勢並非 Agent Battery 獨有：MIT 授權、15709 顆星的 CodexBar 同樣是免登入讀本地，卻不必改你的設定檔。換句話說，「免 Key」在這裡只是入場券，兩者真正的差別，落在 Agent Battery 要不要動你的 ~/.claude/settings.json。

而「免 Key」的取捨，在 Claude Code 與 Codex 兩邊並不對稱。Codex 那側很乾淨，因為 Codex 本來就會把限流事件寫進本地工作階段日誌，Agent Battery 只要讀那個檔案就有數字。Claude Code 那側就沒這麼省事，因為 Claude Code 不會主動把限流資訊寫成外部可讀的檔案，所以 Agent Battery 得先在你環境裡植入一組腳本、再改你的設定檔，把狀態列指令串到它自己的收集器上，才有東西可讀。要從互動與路由這一層看住你的用量，也可以搭配 像 AiMaMi 那類把 Codex 對話與模型路由集中管理的桌面工具，或 像 FreeLLMAPI 那類整合多家 AI 額度的 API 閘道。

Claude Code 的用量，得動一次設定檔才拿得到

Claude Code 的用量監控不是裝完就能用，得手動設定一次。流程是這樣：打開 Agent Battery，點選單列圖示進設定，在 Claude Code 區塊按一下 Setup，它會先把你現有的 ~/.claude/settings.json 備份一份，接著在 ~/.agent-battery/ 放進一支收集器與一支包裝器，最後把 statusLine.command 改去呼叫包裝器；如果你本來就有自訂的狀態列指令，它會保留下來、繼續一併執行。設定完之後，隨便在任何目錄跑一次 claude，等狀態列觸發，彈窗裡就會出現 Claude Code 的 5 小時與週剩餘額度。

這段流程不算麻煩，但有兩個現實值得先記住。它動的是 Claude Code 的核心設定檔，雖然會自動備份，但建議你先把現有的 settings.json 複製一份到別處、記下原本的 statusLine.command 內容，萬一要還原成原狀才有依據，尤其你的 ~/.claude/settings.json 裡已經掛了別的工具或自訂狀態列時。另一個現實是，這類靠截取日誌與狀態列輸出運作的工具有個天生弱點：它的資料來源是 Claude Code 把限流資訊寫進本地 JSON 的那個格式，一旦上游官方調整了輸出結構，顯示就會暫時失準，得等作者更新才能恢復。如果你才剛開始把 Claude Code 接進日常流程，2026 Claude Code 完整教學 那篇把設定檔與狀態列的基礎講得較完整，先讀過會更容易看懂 Agent Battery 動了哪一塊。

Codex 不必設定，因為日誌本來就寫在那裡

Codex 那側幾乎是免設定。Codex 本機就會持續產生工作階段日誌，Agent Battery 只要指向 ~/.codex/sessions/**/*.jsonl 這個路徑、抽取最近的 rate-limit 欄位，數字就出來了，這側連設定頁都不必開。

但免設定背後藏著同一個脆弱點，只是換了一個檔案格式。Codex 的限流資訊能不能被讀到，取決於 Codex 把事件寫進 JSONL 的欄位結構，這同樣是上游一改就得跟著改的環節。所有靠截取本地日誌運作的監控工具都吃這碗飯，它的存在只是再次提醒你：這類工具的穩定性綁在別人的輸出格式上，最好對「偶爾會因為格式變動而暫時失準」這件事有心理準備，別期待裝完就能永遠不動。

把風險攤開來看：授權、簽署、平台、成熟度

把 Agent Battery 裝到主力機之前，有四個面向得一次性想清楚，它們共同決定這工具適不適合你。

授權這關最重。截至撰稿時，這個專案在 GitHub 上並沒有附任何授權條款（LICENSE 檔不存在）。這代表原始碼雖然看得到，但法律上預設是「保留所有權利」，你看得到，卻未取得使用、修改或散布的明確權利。實務上這表示：你不能合法把它的原始碼拿去改了再發布，公司團隊要在內部大量部署前也應先向作者確認授權；個人單機使用風險較低，但多數人與其等專案補上 LICENSE，會直接選已 MIT 授權的 CodexBar。

簽署狀態是另一道門檻。因為沒有蘋果簽署，Agent Battery 目前未經簽署與公證，首次執行時 macOS 會把它當成來路不明的 App 擋在門外，你得自己到「系統設定 → 隱私與安全性」最底下找到它、按「仍要開啟」放行才能用。對一支會改你 Claude Code 設定檔的工具來說，這道手動放行也是你評估是否信任它的時機。

平台也是硬限制。它只跑在 macOS 14.0 或更新版本上，Swift 原生寫成，Windows、Linux 與舊版 Mac 使用者直接不在支援範圍；要在 Windows 上盯 DeepSeek 用量，那是 DeepSeekMonitorWindows 的地盤。

成熟度更得留意。這是 2026 年 4 月才開張的個人專案，截至目前 42 顆星、2 個 fork、單一維護者，跟 15709 顆星、知名開發者 steipete 維護的 CodexBar 相比，能見度與被檢驗的時間都短得多。把這四個面向疊起來看，這是一支年輕、未授權、未簽署、會改設定檔的單人專案，用它等於願意承擔這組風險，去換一個尚未經長期檢驗的額度顯示。

跟 CodexBar、DeepSeekMonitor 擺在一起比一比

光看 Mac 上的 AI 用量監控，Agent Battery 並不是唯一選擇，把幾個主流的擺在一起反而看得更清楚：

從這張表能讀出 Agent Battery 真正的位置。如果你的需求是「在 Mac 選單列看 Claude Code 與 Codex 還剩多少額度、又不想交出 API Key」，CodexBar 早就能做到，而且涵蓋 50 多款 AI 服務、MIT 授權、15709 顆星、出知名 iOS 開發者之手，被檢驗的程度完全不同等級。Agent Battery 比較可能不同的，是把額度畫成電池百分比的呈現風格、以及聚焦在 Claude Code 與 Codex 兩個工具的並排彈窗；它的價值在「餘光可讀」，你不用把焦點從終端機移開，狀態欄那顆電池變色就等同「快沒了」的訊號，比點開彈窗讀數字少一次視線切換，這個差距在除錯到一半時才感受得到。但這層呈現差異是否值得你承擔無授權、未簽署、改設定檔的風險，建議先對照 CodexBar 的實際介面再決定，兩者很可能在核心資訊（5 小時額度、週額度、重置時間）上並無落差。在 Windows 陣營盯 DeepSeek，則交給 DeepSeekMonitorWindows，那條路在另一個平台上，交集有限。

Pin

適合誰，不適合誰

Agent Battery 對口的是那種已經把 Claude Code 或 Codex 當成日常開發主力的使用者。這種人會一連好幾個小時在終端機裡反覆跑 prompt、等模型回應、再接著改程式碼，常常在不知不覺間把 5 小時區間用到見底；對他們來說，狀態欄裡一顆隨時能瞄的電池，確實能避免額度在關鍵時刻突然歸零，還能提前知道重置時間、要不要先把吃重的工作排開。

它對其他幾種人幫不上忙。如果你只是偶爾開網頁端問 AI 兩三個問題、平時很少碰 Claude Code，那根本沒有持續監控額度的必要，裝了還得改設定檔，是白折騰。如果你介意軟體沒有授權條款、或介意未簽署的工具碰你的開發環境設定，那直接選 MIT 授權的 CodexBar 更省心，它在 Mac 上涵蓋的服務也更廣。如果你介意的是「未簽署的本地工具會在你設定檔裡掛收集腳本」這層信任風險，那與「素材外流」是兩回事：前者得靠鎖定權限與沙箱承擔，後者才靠 像 Privacy Filter 那類瀏覽器端脫敏工具 在丟給 AI 前先過濾。

所以決策軸不在「你是不是重度使用者」，CodexBar 對重度使用者更安全。真正的問題是：你要的是「一顆電池百分比加 Claude Code 與 Codex 並排重置時間」這個特定的視覺呈現，而且它對你夠重要，重要到你願意同時接受無授權條款、未簽署公證、以及改 settings.json 這組風險。只有在這個條件成立時，Agent Battery 才值得裝；否則 CodexBar 是更穩當的預設。

常見問題

Agent Battery 是開源軟體嗎？ 不是。原始碼看得到，但沒有 LICENSE 檔，法律上等於「保留所有權利」。嚴格說來，作者連「下載執行」都未明示授權，對一支會改寫你 Claude Code 設定檔、又未經簽署公證的工具來說，這代表使用風險完全由你自負，而非「原始碼公開就能安心跑」。要能放心改、放心散布，選 MIT 授權的 CodexBar。

它會增加我的 Claude Code 或 Codex 額度嗎？ 不會，它只讀不寫額度；想變多只能換方案或等重置。

它需要我交出 API Key 嗎？ 不需要。Codex 的用量直接讀本地工作階段日誌（~/.codex/sessions/**/*.jsonl），不必設定；Claude Code 則需要做一次 Setup，讓它在你電腦寫入兩支腳本、並把 ~/.claude/settings.json 的狀態列指令改去呼叫它的收集器，之後就能拿到限流資訊。

Windows 或 Linux 能用嗎？ 不能。Agent Battery 只跑在 macOS 14.0 或更新版本，是 Swift 原生寫成的狀態欄工具。在 Windows 上想監控 DeepSeek 用量，可以看 DeepSeekMonitorWindows。

為什麼第一次打開會被 Gatekeeper 擋住？ 因為這個應用程式目前未經蘋果簽署與公證。到「系統設定 → 隱私與安全性」裡點「仍要開啟」就能繼續使用。考慮到它會改你的 Claude Code 設定檔，這道手動放行也是你評估是否信任這支工具的時機。

如果你長期靠 Claude Code 與 Codex 寫程式，Agent Battery 看的是額度還剩多少；OpenLess 看的是怎麼把語音變成結構化指令、Everywhere 桌面助手 看的是怎麼讓 AI 看懂你的螢幕，三件事顧的是同一條 AI 編程產線的不同段，要搭在一起才拼得起完整工作流。