Codenotch完整指南把Claude Code、Cursor、Codex的AI用量配额钉在屏幕边缘一目了然【免费下载链接】codenotchA macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge.项目地址: https://gitcode.com/gh_mirrors/co/codenotchCodenotch 是一款开源的 macOS / Windows 桌面小工具把 Claude Code、Cursor、Codex 等 AI 编程助手的用量配额钉在屏幕边缘剩多少、何时重置、AI 是否还在干活看一眼就知道不用再去每个助手的设置页里翻找。为什么需要 Codenotch告别配额焦虑用 AI 编程助手的人多半有过这种体验写到一半Claude 突然提示 usage limit reached才知道额度用光了同时开着 Claude、Cursor、Codex 干活却不知道现在哪个还有余量Agent 在后台跑了 40 分钟结束没结束、卡住没卡住全靠盯终端。Codenotch 的思路很简单在屏幕边缘钉一个黑色刘海notch每个 AI 服务占一个圆环环上直接标出已用百分比。它读取的是各工具自己缓存的官方用量数据本机会话、本地数据库、官方端点不抄任何浏览器 Cookie也不发起多余的请求。三分钟安装macOS 与 Windows 双平台macOS 安装步骤从项目的发布页下载Codenotch.dmgUniversal 二进制macOS 15 及以上拖入应用程序文件夹首次启动即可应用已签名公证之后每天自动检查并静默安装更新。⚠️ 如果是预览构建非正式 notarized 版被 macOS 提示已损坏那是隔离标记问题在终端执行一次xattr -dr com.apple.quarantine /Applications/Codenotch.app即可。Windows 安装Windows 版基于 Rust/Tauri与 macOS 版同款设计、同款数据源代码在 windows/ 目录。安装器以当前用户身份安装、无需管理员权限首次运行时 SmartScreen 会提示选择更多信息 → 仍要运行即可。支持的 AI 服务20 个 Provider 一览Codenotch 的每个环对应一个 AI 服务。大部分服务自动借用你 Mac 上已有工具的登录态无需二次登录只有 DeepSeek、MiniMax、千问等少数服务需要你在 Codenotch 内显式登录一次服务数据来源能看到什么Claude CodeClaude Desktop 缓存 /claude /usage/ 钥匙串 OAuth当前会话窗口 全模型窗口、剩余重置次数Cursor编辑器本地 SQLite 会话配额百分比与重置时间Codex本机 Codex 登录5 小时窗口 每周窗口GitHub Copilotgh auth login会话Copilot 配额Gemini / Grok / Kimi / Kiro / Amp / Apify / Kilo各自 CLI 的本地登录态官方用量端点数据DeepSeek / 千问 / MiniMax内置网页显式登录余额、30 天消耗、积分窗口Ollama / LM Studio本地运行时模型占用、tok/s 速度、上下文用量每个 Provider 的悬浮卡片都会按服务特性展示对应的额度维度比如 Apify 展示的是本月消费 vs 月度上限各服务的细节说明见 docs/providers/amp.md 等文档以及数据源总表README.md 中的 What it reads。看懂配额圆环颜色、数字与重置倒计时圆环的进度是已用比例颜色一眼分级已用颜色含义0–49% 绿色余量充足50–79% 黄色接近上限80–99% 橙色即将用尽100% 满环 图标变暗已触顶等待重置鼠标悬停在环上会弹出详情卡片每个额度窗口的用量条、Resets in 51 min 这类倒计时以及 Claude 的剩余重置次数。设计源稿是 docs/design/frame-125-detail.png两个实用细节倒计时对着时钟算即使没刷新数据也精确到秒想改成显示重置日期或调整环形强调色去 Settings → Appearance 即可。会话监控与提醒它知道AI 还在干吗Codenotch 不只看额度还回答is it still working? 会话忙碌时环内有一条旋转的细弧⏸️ Agent 停下来等你输入改代码确认、回答提问时环变成脉冲式琥珀色✅ 会话结束或等你确认时刘海自动展开 5 秒 系统提示音点一下直接把对应应用切到前台 主额度突破 80%、达到 100%各推送一次系统通知窗口真正滚动后才允许再次提醒每个 Provider 可单独静音。所有提醒自动展开、提示音都能在设置里独立开关——开会时静音、平时保留。进阶玩法多账号、本地 LLM、手机同步双账号双环用CLAUDE_CONFIG_DIR~/.claude-work分开的 Claude 工作号会出现在个人号旁边各自限额、各自排序Codex 的多 profile~/.codex-slug同理。本地模型Ollama 和 LM Studio零配置自动检测每个加载的模型一个格子悬停可看 RAM/VRAM、tok/s、上下文用量想测生成速度让请求走 Codenotch 的本地中继即可。手机看同一块刘海iOS / Android 端扫码配对仅限同一 Wi-Fi配对码 5 分钟过期只读取刘海已展示的数据绝不传输令牌或凭据。协议细节见 docs/phone-link-protocol.md。菜单栏模式可在菜单栏图标直接显示72% · 2h 18m式摘要不改变后台读取行为。常见问题 FAQ数据准确吗每个适配层读取的都是官方应用自己在读的数据内部端点、本地库、LSP 响应响应格式被单元测试锁定一旦读取失败显示stale/needsAuth/error等可见状态而不是编一个百分比。轮询策略是会话运行时 30 秒一次空闲时 5 分钟一次且自动为 429 限流做指数退避。会动我的凭据吗不会。不复制、不刷新、不写入任何登录凭据DeepSeek 等内置网页登录也只在你点Sign in之后才发请求。刷新太勤会被限流吗不会Claude 端点 429 时自动按 60 秒起步、翻倍退避、上限 15 分钟也可以右键刘海选Refresh now手动刷新。参考资料项目说明与全部数据源表格README.md交互设计规格圆环、颜色、悬停卡片的精确尺寸docs/specs/2026-08-28-usage-notch-design.md各 Provider 适配实现Sources/Providers/各服务专属文档docs/providers/贡献与构建指南make run/make testCONTRIBUTING.md把额度钉在视线里把AI 用没用完、干没干完从问题变成余光里的答案——这就是 Codenotch 想做的事。【免费下载链接】codenotchA macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge.项目地址: https://gitcode.com/gh_mirrors/co/codenotch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考