你的 macOS 编程助手使用仪表盘：实时监控 Claude、Cursor、Codex 等 AI 工具的用量与状态

你是否经常在写代码时突然发现——Claude Code 提示“今日配额已用尽”，Cursor 的自动补全变灰，Codex 拒绝响应，却完全记不清自己刚才是不是刚用过 5 分钟？Codenotch 就是为此而生：一款轻量、隐私优先的 macOS 原生应用，它像一块“智能屏边小黑条”，默默贴在屏幕边缘，实时显示你正在使用的各大编程 AI 工具（Claude Code、Cursor、Codex、Antigravity、GLM、Grok、OpenCode）各自的用量进度、重置时间、当前会话状态——而且不重复登录、不接管账号、不上传任何数据，所有信息均从你本地已登录的工具中“借读”而来。

核心功能

一目了然的用量可视化：每个支持的 AI 工具都以一个彩色环形进度条（ring）呈现，填充比例精确反映当前周期内已消耗的配额（如 Claude 的 5000 token/小时、Codex 的 5 小时/周），避免因超限导致编码中断。
精准同步官方计费窗口：Claude Code 的环形图严格对齐其内置 /usage API 返回的“当前会话”时间窗（例如 “2024-06-15T14:22:00Z → 2024-06-15T15:22:00Z”），确保 Codenotch 显示与官方客户端完全一致，消除认知偏差。
多账号并行识别与区分：支持同一工具的多个登录实例——比如个人账号 ~/.claude 和工作账号 ~/.claude-work 会分别显示为“Claude”和“Claude (work)”两个独立环，各自跟踪配额、会话与重置时间，完美适配多身份开发者日常。
实时运行状态感知：环内动态指示当前状态：细弧线旋转 = 正在后台处理请求；琥珀色脉动环 = 请求被阻塞（如等待你确认权限、输入密钥或选择模型），悬停即可查看具体卡在哪一环节、运行于哪个编辑器进程。
零侵入式凭证复用：无需额外登录——Claude 读取 Keychain 中 OAuth Token，Cursor 解析本地 SQLite 状态库，Codex 复用 ChatGPT 登录态，Grok 读取 ~/.grok/auth.json，所有凭证均未离开你的 Mac，也绝不触碰你的密码或主账号。
智能边缘吸附与自适应布局：可自由选择钉在顶部（适配 M 系列 Mac 硬件刘海，无缝融合）、底部（自动跟随 Dock 隐藏/位移）、左侧或右侧；悬停展开详情，闲置时收缩为极简药丸状，兼顾信息性与桌面整洁度。
完全离线的本地决策逻辑：用量计算、状态判断、重置倒计时全部在本地完成；即使网络中断，仍能基于最后一次有效读数持续显示，并明确标注“离线”状态，而非伪造数据误导用户。
静默自动更新与强签名验证：集成 Sparkle 框架，每日后台静默检查更新；每个发布版本均使用 EdDSA 密钥签名，安装前强制校验，确保你运行的每一行代码都来自原作者，杜绝供应链劫持风险。

技术亮点

协议驱动的 Provider 架构：每个 AI 工具对应一个独立 UsageProvider 实现（位于 Sources/Providers/），必须显式声明其数据来源可信等级：.official（直连厂商 API）、.derived（解析本地状态推导）、.manual（仅计数，无时间窗），UI 层据此差异化渲染，杜绝将估算值伪装成官方指标。
弹性降级的数据存储设计：核心 UsageStore 不依赖单一成功响应——当某工具 API 超时或返回异常，它不会崩溃或显示空白，而是将状态降级为可见提示（如“连接失败”“配额未知”），并保留上次有效读数跨 App 重启持久化，保障长期可用性。
纯 Swift 原生 macOS 开发：零 Web 视图、零 Electron、零跨平台框架，深度调用 AppKit、Keychain Services、FileManager、SQLite.swift 等系统能力，实现亚秒级响应、低内存占用（常驻约 12MB）与原生动效体验。
沙盒兼容的凭证访问策略：严格遵循 macOS App Sandbox 要求——读取 Cursor SQLite 文件时申请 com.apple.security.files.user-selected.read-only 权限，访问 Keychain 使用 kSecAttrAccessGroup 隔离，所有操作均通过系统 API 安全委托，非 root 权限亦可稳定运行。

适合哪些人用

这款工具专为高频混合使用多款编程 AI 工具的专业开发者、技术团队成员及开源协作者设计。尤其适合以下两类真实场景：

远程结对编程工程师：同时开着 Cursor（主编辑器）、Claude Code（深度推理）、Codex（快速查文档），开会前 5 分钟急需生成一段复杂 SQL——Codenotch 底部一瞥即知“Codex 还剩 1.2 小时，Claude 已耗尽，Cursor 配额充足”，立刻切换工具链，避免反复试错浪费时间；
企业合规开发者：公司要求工作账号与个人账号物理隔离（~/.claude-corp vs ~/.claude），且需定期汇报各工具用量。Codenotch 不仅自动识别双账号，其 Settings 中每行明确标注“此账号由 Cursor 编辑器管理，关闭后仅停止读取，不会登出 Cursor”，满足审计与安全双重需求。

快速上手

无需编译，直接下载官方 Release 即可运行：

前往 GitHub Releases 页面，下载最新 Codenotch-x.x.x.zip；
解压后拖入 Applications 文件夹，首次运行时按提示允许辅助功能权限（用于检测 Cursor 窗口状态）；
确保你已在 Mac 上登录至少一款支持的工具（如打开 Cursor 并完成 Sign In）；
点击菜单栏图标 → “Settings” → 选择屏幕边缘位置、展开行为（悬停/常显/隐藏）、是否显示 Dock 图标；
如需调试，终端执行 CODENOTCH_DEMO=1 open -n /Applications/Codenotch.app 可加载模拟数据，无需真实账号。

同类对比 / 注意事项

与浏览器插件类监控工具（如 Claude Usage Tracker）的本质区别：后者仅监控网页端，无法感知本地应用（Cursor、Grok CLI、Antigravity LSP）；Codenotch 是唯一覆盖 CLI、Electron、Swift 原生等全形态编程工具的 macOS 专用方案。
不支持 Windows/Linux：明确限定为 macOS 平台，依赖大量系统级 API（Keychain、Dock 管理、App Sandbox），暂无跨平台计划。
Antigravity 免费版限制：当 Antigravity 未授权时，仅统计本地请求次数，不显示 Google Cloud 配额，此为厂商 API 限制，非项目缺陷。
首次启动延迟：因需扫描 ~/.claude* 目录及解析多个本地数据库，首次加载可能需 3–5 秒，后续启动毫秒级响应。