AgentValley：在 Mac 刘海屏监控 Claude Code 会话

AgentValley 是干什么用的？通俗解释

AgentValley 是一款免费开源的 Mac 应用，把本机 Claude Code 的运行情况集中显示在屏幕刘海下方。通俗地说，它像一个“任务值班台”：你在浏览器、编辑器或其他应用里工作时，抬眼就能知道哪个编程代理还在忙、哪个正在等你回答。每个代理都有独立行和像素程序员形象，主会话启动的子代理也能单独查看。它适合已经使用 Claude Code 的开发者，要求 macOS 15 或更高版本。

多会话与子代理：快速找到等待你的任务

多个终端里的会话会按项目汇总，worktree 也归入对应项目。会话以卡片呈现，下面列出各代理的任务、模型和最近一步操作；子代理还显示已执行的步骤数。你可以据此区分“主代理在实现功能”和“子代理正在查找文件”，减少为了确认状态而反复切窗口。

遇到提问或权限请求，刘海旁会出现红色计数。打开面板即可读到问题或命令，并跳回对应应用。开启“Go to the session’s tab”后，Terminal 和 iTerm2 可以定位具体标签页；Ghostty 在两个会话使用同一文件夹时存在定位歧义。声音提醒默认开启，可在设置中关闭或切换为普通提示音。

从安装到定位会话的实际用法

1. 从官方发布页下载 DMG，将 AgentValley 拖入“应用程序”并启动；使用 Homebrew 时可运行 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”。

查看状态与回复授权是两种能力，回复插件需要手动安装，应用不会替你自动批准。

项目成本、Token 与套餐额度怎么看

点击面板顶部的图表按钮进入 History，可按日、周、月查看记录，再深入到某天的小时分布或某个项目的会话。金额按 API 单价计算，适合比较不同项目的消耗；它不是订阅实际账单，也不能直接当作应付款。Export PDF 可以导出全部项目或指定项目的工作与成本报告。历史保存在 Mac 上，即使 Claude Code 清理旧文件也会保留。

面板还显示近五小时及当天的 Token 使用量，并提供十二小时图表。“Plan limits”默认关闭，启用后可查看 Claude 的五小时、每周用量上限与距离重置的时间。经 2026 年 10 月 25 日核实，应用免费，赞助属于自愿支持；Claude Code 本身的访问、套餐和地区条件需要另行核对。

本地文件读取与可选配置的隐私边界

官网说明应用读取 ~/.claude/projects、~/.claude/sessions，并检查 Claude Code 进程和项目 Git 信息，用于识别应用、分支与会话。自身数据保存在 ~/Library/Application Support/AgentValley。只有开启“Plan limits”时，才会读取 Keychain 中的 Claude Code 登录信息并发送给 api.anthropic.com。应用还会每天向 GitHub 检查更新，可在设置中关闭，安装更新前会询问。

可选的终端状态栏需要你主动执行设置中的命令：它会修改 ~/.claude/settings.json、安装字体，使用 Ghostty 时还会补充一行配置；卸载命令可以撤销这些添加。官网提供了上述实现说明，但未在已检查的首页链接中找到独立隐私政策，因此不将其描述为任何配置下都零联网的工具。

适合谁使用，有哪些限制

它尤其适合同时运行多个本地 Claude Code 会话、经常漏看授权或找不到对应终端的开发者。外接显示器时，可通过 Settings → General → Display 将面板移到相连屏幕，断开后回到刘海。

“quiet”表示代理两分钟没有写入新活动，不是确定卡死，也不是完成进度百分比。当前官方定位限定在 Mac 与 Claude Code，不应据此推断兼容其他编程代理或操作系统。应用代码采用 MIT 许可证，项目独立于 Anthropic。

常见问题

AgentValley 免费吗？

免费。官方提供免费开源应用，自愿赞助不属于解锁功能的付费套餐；这不等于 Claude Code 的使用本身免费。

History 的金额就是实际账单吗？

不是。History 按 API 价格给出使用成本估算，实际支出仍取决于你的账号、访问方式与计费安排。

查看会话必须安装插件吗？

普通会话监控不需要回复插件。只有希望在面板直接允许或拒绝权限请求时，才需手动安装对应插件并重启 Claude Code。

官方下载与开发者支持

• 官方版本与下载
• 源码、安装说明与数据访问说明
• GitHub Issues：反馈问题或建议