企业官网建设流程全解析

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/codenotch

Codenotch 是一款开源的 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 安装步骤

1. 从项目的发布页下载Codenotch.dmg（Universal 二进制，macOS 15 及以上）；
2. 拖入"应用程序"文件夹，首次启动即可；
3. 应用已签名公证，之后每天自动检查并静默安装更新。

⚠️ 如果是预览构建（非正式 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 内显式登录一次：

每个 Provider 的悬浮卡片都会按服务特性展示对应的额度维度，比如 Apify 展示的是"本月消费 vs 月度上限"：

各服务的细节说明见 docs/providers/amp.md 等文档，以及数据源总表：README.md 中的 "What it reads"。

看懂配额圆环：颜色、数字与重置倒计时

圆环的进度是已用比例，颜色一眼分级：

鼠标悬停在环上，会弹出详情卡片：每个额度窗口的用量条、"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 test）：CONTRIBUTING.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