Codenotch：AI 用量限额边缘监视器

项目简介

Codenotch 是一个 macOS 应用，能把一个小的黑色「刘海」固定在屏幕边缘，随时显示每个编程助手的用量限额已经消耗了多少，以及它当前仍在工作、已经完成，还是在等你回复。

把鼠标悬停在圆环上，就能看到该供应商的限额窗口和重置时间。Claude 的圆环显示的是与 Claude Code 自带 /usage 相同的 current session 窗口，所以两者的数字不会互相矛盾。

同一套用量百分比、重置时间和会话状态，也能通过 Codenotch 的手机 App（iOS 和 Android）查看。项目还提供了基于 Rust/Tauri 2 的 Windows 版本，界面设计和接入的供应商与 Mac 版相同。

主要功能

• 边缘圆环：每个供应商对应一个圆环，显示已经消耗的限额比例；悬停即可查看限额窗口与重置时间。
• 状态提示：圆环会区分「工作中」「已完成」「等待你的回复」三种状态。
• 覆盖众多编程助手：Claude Code、Cursor、Codex、DeepSeek Platform、Antigravity、GLM、MiniMax、QianwenAI、Grok、OpenCode、Command Code、GitHub Copilot、Kimi、Kiro、Amp、Apify、Kilo，以及自定义 OpenAI 兼容 / Anthropic Messages / Google Gemini 端点。
• 本地模型监控：自动检测本机 Ollama、LM Studio、oMLX，为每个已加载的模型显示一个格子，可查看 RAM/VRAM、卸载时间、上下文上限、量化方式，以及每秒 token 数与思考速度。
• 手机配对：在 Mac 上打开 Settings › Phone › Connect a Phone…，会出现有效期五分钟的二维码，用手机 App 扫码即可同步；手机只读取圆环已经展示的内容，不会接触 token、凭据或原始 API 响应。
• 菜单栏自定义（v1.24.0）：菜单里提供供应商卡片与每张卡片的 Detail 开关；可以设置显示内容、读数格式、按剩余量排序，以及点击菜单栏图标时执行什么操作；圆环可按手动、剩余最多或即将过期作废的配额排序。

安装与使用

macOS

从 发布页 下载 Codenotch.dmg，把应用拖进「应用程序」文件夹即可。安装包已签名并公证，之后可以自行更新。要求 macOS 15 或更高版本，为 Universal binary。

如果 macOS 提示应用「已损坏」，那是下载隔离标记而不是文件损坏，把应用拖入「应用程序」后执行一次：

xattr -dr com.apple.quarantine /Applications/Codenotch.app

Windows

在发布页下载 Codenotch-Setup.exe，为当前用户安装，不需要管理员权限；如果系统缺少 WebView2，安装程序会自动获取。安装包未做代码签名，首次运行时 SmartScreen 会提示 Windows protected your PC，选择 More info，再点 Run anyway 即可。

测量本地模型速度

若要在 Settings → Ollama 中开启 Measure speed and thinking，需要保持 Codenotch 打开，并经由它的本地中继连接：

OLLAMA_HOST=http://127.0.0.1:11435 ollama run gemma4:e4b --think

速度在原生 Ollama 响应完成后更新，思考内容需要流式推理。直接请求 Ollama 默认端口（11434）只能提供模型检测。

注意事项

• 大多数供应商会借用本机已有工具的凭据或会话（例如 Claude Code、Cursor、GitHub CLI、Kimi Code CLI 的登录状态）；DeepSeek、MiniMax、QianwenAI 则需要你在 Codenotch 内显式登录，它不会读取浏览器的 Cookie 或凭据存储。
• 在设置里关闭某个供应商，会停止它的用量轮询并遗忘已有读数；被借用的账号仍保持在其原工具中登录。
• 手机配对只接受局域网地址，拒绝任何经由公网路由的请求；每个配对码一次性使用，五分钟后过期。
• 预览版构建来自每次提交，未做公证（ad-hoc 签名），同样需要清除隔离标记后才能打开。

---

本作品整理自 GitHub 开源项目 vinzdg/codenotch，原作者 @vinzdg，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。