AgentValley：在 Mac 瀏海追蹤 Claude Code

AgentValley 是做什麼的？白話說明

AgentValley 是一款免費開源的 Mac 應用程式，將本機 Claude Code 的會話集中顯示在螢幕瀏海下方。白話來說，它是一個小型工作看板：讓你知道哪個 AI 程式代理還在執行、哪個正在等你回覆，不必輪流打開每個終端機視窗。每個代理都有自己的列與像素人物，會話叫出的子代理也能單獨辨識。需要 Claude Code 與 macOS 15 以上版本。

費用估算與用量上限怎麼看

透過圖表按鈕進入 History，可選日、週、月，再查看某天的各小時或專案內的會話。金額以 API 價格估算，適合比較消耗，不應直接當成訂閱帳單或應付金額。Export PDF 能匯出全部專案或單一專案的工作報告。記錄保留在 Mac，即使 Claude Code 清理舊檔仍會存在。

面板也顯示近五小時與今天的 Token，附十二小時圖表。「Plan limits」預設關閉，開啟後顯示五小時、每週上限及重置倒數。2026 年 10 月 25 日確認應用程式免費，贊助為自願支持；Claude Code 的存取與計費條件另計。

找出需要你回應的會話與子代理

會話依專案分組，worktree 也會歸到所屬專案。每張會話卡片列出任務、模型與最近一步動作；子代理另有步驟計數，方便區分主要實作和委派出去的搜尋或規劃。

遇到提問或權限請求時，瀏海旁會出現紅色數字。展開面板即可閱讀，再跳回相應應用程式。啟用「Go to the session’s tab」後，Terminal 與 iTerm2 可定位分頁；Ghostty 若有兩個會話使用相同資料夾，可能無法唯一判定分頁。音效預設開啟，可關閉或改為單純提示音。

安裝後如何追蹤一個工作階段

1. 下載官方 DMG，將 AgentValley 拖進「應用程式」後啟動；也能使用 brew install --cask morsechimwai/tap/agent-valley 安裝。
2. 啟動 Claude Code 會話，將指標移到瀏海，確認專案與最近動作是否符合該工作階段。
3. 在別的程式按 Control–Option–Command–A 開啟面板，以方向鍵選列、Return 跳回會話。
4. 若要在面板回覆權限，於 Claude Code 設定啟用「Answer from the notch」，執行畫面提供的外掛指令，再重新啟動 Claude Code。讀完請求後，自行選擇「Allow once」或「Deny」。

回覆外掛是手動選用項目，不等同於基本的會話顯示。

本機資料與選用功能的存取範圍

官方說明會讀取 ~/.claude/projects、~/.claude/sessions，檢查程序與專案 Git 資訊，自身資料存於 ~/Library/Application Support/AgentValley。只有啟用「Plan limits」時才會從鑰匙圈讀取 Claude Code 登入資料，並傳送至 api.anthropic.com。每天向 GitHub 檢查更新的行為可以關閉。

選用的終端機狀態列會修改 ~/.claude/settings.json、安裝字型，使用 Ghostty 時另加一行設定；移除指令可撤銷這些添加。本機處理不代表所有選項都完全不連線，使用前應理解額外功能的存取範圍。

哪些使用者適合採用

適合同時跑多個本機會話、容易漏看授權或找不到終端機分頁的開發者。可從設定將面板移到外接螢幕，拔除後回到瀏海。「quiet」只代表兩分鐘沒有寫入活動，不是確定當機，也不是工作完成百分比。官方目前描述的範圍是 Mac 上的 Claude Code。應用程式原始碼採 MIT 授權，專案與 Anthropic 無隸屬關係。

常見問題

AgentValley 免費嗎？

免費且開源。自願贊助不是解鎖功能的付費方案，也不代表 Claude Code 本身的存取免費。

顯示的費用等於帳單嗎？

不是。History 使用 API 價格做估算，實際支出仍依帳號與計費方式而定。

查看會話一定要裝外掛嗎？

基本監控不需要回覆外掛。要從面板直接允許或拒絕請求時，才需手動安裝並重新啟動 Claude Code。

官方下載與開發者支援

• 官方版本與下載
• 原始碼與設定說明
• GitHub Issues：問題與建議