ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

MacBook刘海变身Claude Code实时仪表盘:Claude Usage Tracker Dynamic Island深度体验

MacBook刘海变身Claude Code实时仪表盘:Claude Usage Tracker Dynamic Island深度体验 MacBook刘海变身Claude Code实时仪表盘Claude Usage Tracker Dynamic Island深度体验【免费下载链接】Claude-Usage-TrackerNative macOS menu bar app for tracking Claude AI usage limits in real-time. Built with Swift/SwiftUI.项目地址: https://gitcode.com/gh_mirrors/cl/Claude-Usage-TrackerClaude Usage Tracker 是一款原生 macOS 菜单栏应用Swift/SwiftUI 构建用于实时监控 Claude AI 的用量限额。除了菜单栏图标与用量弹层它最让人眼前一亮的功能是把 MacBook 顶部的刘海Notch变成了 Claude Code 的实时活动仪表盘——官方称之为 Dynamic Island灵动岛Beta。Claude 正在思考、写代码、读文件还是跑命令需要你介入吗抬头看一眼刘海就知道无需切换窗口。什么是「刘海仪表盘」它显示什么Dynamic Island 模式在你打开 Claude Code 会话时于屏幕顶部的刘海两侧浮现一条极小的状态条左侧状态符号大脑/文档/终端/铃铛 项目名取当前工作目录名右侧状态描述文字思考中…、执行中…、需要输入 多会话计数徽标点击刘海展开成一张会话清单每个会话的项目名、当前任务或上一条提示词摘要、已运行时长最近出错的会话还会挂一个红色警示标记。多开几个终端并行干活时×3徽标会告诉你同时有几个 Claude 在跑。六种状态一目了然状态图标颜色含义思考中紫色正在处理你的请求编写中 / 读取中青色正在写代码或读文件执行中️绿色正在跑终端命令需要输入橙色Claude 在等你如权限确认图标持续脉冲提醒完成✅灰色本轮结束等待下一轮状态定义集中在 ClaudeCodeSession.swift符号与颜色的单一数据源就在这里。一键开启三步激活刘海状态显示开启过程几乎没有手动配置全部在设置页内完成点击菜单栏图标 → 设置 → Dynamic Island对应 NotchHUDSettingsView.swift 的页面打开「启用 Dynamic Island」开关——应用会立即向~/.claude/settings.json写入 8 个被动钩子SessionStart、PreToolUse、Stop、Notification 等并在本机回环地址启动一个只读监听服务可选打开「空闲时自动隐藏」——所有会话空闲数秒后HUD 自动收起来不打扰你设置页底部还会实时反馈两件事钩子安装状态已安装 / 部分安装 / 检测到旧版本与本地服务监听状态。端口被占用时会出现「重试」按钮点一下即可恢复。旧版已废弃分支留下的钩子在启用时会被自动替换清理不会残留。它如何做到「实时」8 个只读钩子 本机监听器理解原理后会发现这个设计非常克制事件源Claude Code 原生的 Hook 机制。钩子把每次工具调用前后、提示词提交、会话起止等 8 类事件以 HTTP 请求推送到应用内置的监听器NotchHookServer.swift。只监听 127.0.0.1服务只绑定本机回环地址永远不暴露到网络并带并发连接数上限与连接超时防止被拖垮。纯只读绝不越权监听器对每个请求先返回200再解析内容——HUD 没有任何代码路径能替你做决定。也就是说当 Claude 弹出权限确认时它只会在刘海上脉冲提醒你审批权永远在你自己的终端里。这是它和早期实验版本会应答权限请求最大的区别。状态机驱动事件经 NotchSessionStore.swift 这个纯 Reducer 归约为 6 种会话状态每 30 秒清扫一次「僵尸会话」等待输入的状态有更长的宽限期避免你离开时被误清。精准落在内屏刘海接外接显示器时HUD 会自动寻找带物理刘海的内置屏渲染v3.3.0 修复见 NotchHUDController.swift 的屏幕定位逻辑无刘海的显示器上则显示为悬浮小药丸。安装与构建从哪拿到它三种方式任选其一方式一Homebrew推荐brew install --cask hamed-elfayome/claude-usage/claude-usage-tracker方式二直接下载——从 Releases 页取Claude-Usage.zip解压后拖入「应用程序」即可。v2.0 起已通过 Apple 官方代码签名无安全弹窗。方式三源码构建git clone https://gitcode.com/gh_mirrors/cl/Claude-Usage-Tracker cd Claude-Usage-Tracker open Claude Usage.xcodeproj # Xcode 中 ⌘R 运行工程入口在 ClaudeUsageTrackerApp.swiftHUD 视图层位于 MenuBar/NotchHUD/ 目录想研究实现可以配合测试文件 NotchHUDCoreTests.swift 一起看。常见问题速答菜单栏有图标刘海却不动Dynamic Island 是 Beta 功能且仅对 ClaudeAnthropic档案生效若当前档案是 OpenAI Codex 类型相关集成会自动隐藏切换到 Claude 档案即可。没有刘海的显示器会退化为悬浮小药丸形态功能一致。担心它偷跑我的终端命令不会。钩子只上报「发生了什么」本地服务先应答后解析、无网络暴露架构上不存在代答路径。想关掉设置页关闭主开关即自动卸载全部钩子其他用户钩子原样保留。写在最后一个约 6MB 的原生小应用把「Claude 现在在干嘛、它在等我吗」这件高频问题压缩成了刘海两侧的一瞥之隙。对习惯多终端并行 Claude Code 的开发者来说Dynamic Island 模式目前是它最有想象力的部分——而考虑到它仍是 Beta、且钩子方案完全只读现在上车几乎没有成本。【免费下载链接】Claude-Usage-TrackerNative macOS menu bar app for tracking Claude AI usage limits in real-time. Built with Swift/SwiftUI.项目地址: https://gitcode.com/gh_mirrors/cl/Claude-Usage-Tracker创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进