企业官网建设流程全解析

Codenotch 完整指南：如何读取 Claude、Cursor、Codex、Kimi 等 20+ 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 用量监控应用，把 Claude Code、Cursor、Codex、Kimi 等 20 多种 AI 编码助手的官方用量限额，钉在屏幕边缘的一个小"刘海"上——哪个工具的额度快用完了、什么时候重置、Agent 是还在跑还是卡住等你，一眼就能看穿。下面讲清楚它到底从哪里、用什么方式读取各家官方用量。

Codenotch 用量环长什么样

静止时它只是屏幕边缘的一小片黑色胶囊；指针靠近时展开成一列圆环，每个环代表一个 AI 工具账户。悬停任意一个环，会弹出该工具的限额窗口、已用百分比和重置时间。

安装体验也很直接：下载 .dmg 后拖入"应用程序"即可，应用自身带自动更新（EdDSA 签名，只接受维护者构建的版本）。

Codenotch 读取 AI 用量：三类数据源

没有任何一家厂商提供干净的"你的额度还剩 N%"公开 API。Codenotch 的做法是：每个工具自己的官方客户端在读什么，它就读什么——内部端点、本地数据库、语言服务器的 RPC。所有 Provider 按数据源方式分三类。

类型一：借用本机工具已有的登录（无需重复 Sign-in）

这是大多数 Provider 的方式：Codenotch 不让你重新登录，而是直接借用 Mac 上已装工具的官方会话。

• Claude Code：优先读 Claude Desktop 的用量缓存（只读、严格按账户匹配，超 30 分钟不显示为实时）；其次执行claude的/usage；最后用 Keychain 里的 OAuth token 访问该命令所用的官方端点。
• Cursor：读编辑器本地 SQLite 里的登录会话，或 Keychain 中cursor-agent的登录——无需单独登录。
• Codex：使用本地 Codex 登录（各~/.codex-<slug>配置目录的auth.json），显示 5 小时与周限额，多账户自动变成多个环。
• Kimi：读~/.kimi-code/credentials/kimi-code.json会话，请求 CLI/usage所用的同一/usages官方端点，显示 5 小时窗口与周额度。
• Kiro / Grok / OpenCode / GitHub Copilot / Amp / Apify / Kilo：同样思路——kiro-cli会话、~/.grok/auth.json（过期时用文件自带的 refresh token 在内存里续期，从不写回文件）、opencode-go的官方用量端点、gh auth login的 GitHub 会话、~/.local/share/amp/secrets.json、apify login会话等，全部对接各工具自己使用的同一个官方计费端点。

一个关键安全原则：借来的凭据属于原工具，Codenotch从不复制、刷新或写回任何凭据；关闭某 Provider 只停止轮询、忘掉读数，登录状态原样保留。

类型二：自动检测本地运行时（Ollama / LM Studio）

本地模型没有"额度"，取而代之的是运行状态：

• Ollama（本地）：自动检测本机加载的模型，显示 RAM/VRAM、上下文、卸载时间；开启"Measure speed and thinking"后通过本地中继还能测 tok/s 与思考过程。
• LM Studio：从 LM Studio 自己的 SDK socket 读取每个模型在做什么（提示/生成/排队），从~/.lmstudio/server-logs只读计数与耗时——速度、上下文占用、今日 token 全部可见，不读任何提示词或回复。

类型三：应用内显式登录（WKWebView）

少数工具没有可借用的本地会话，Codenotch 会在自己的内置网页窗口里让你登录，绝不读取浏览器的 Cookie：

• DeepSeek：登录后读取平台账户总览与 API Key/模型用量端点，显示余额、30 天 token/花费、请求数。
• MiniMax：Settings 里粘贴 Coding Plan key，或应用内登录平台。
• QianwenAI：没有用量 API 也没有 key，内置会话是唯一入口，显示控制台的 Token Plan 周期额度。

20+ Provider 接入全清单

以 Amp 为例，它的读取细节——订阅环用官方百分比、Free 额度环标~派生、429 时持久化退避——完整写在 docs/providers/amp.md。

数字为什么不会"装"：Fidelity 三级标注

Codenotch 给每个读数打了保真度标签（源码中的Fidelity）：

• official：厂商直接公布的数字，原样显示；
• derived：从厂商返回的原始金额/额度推算的百分比，前面加~前缀，明确告诉你是推算值；
• manual：手动录入（自定义端点）。

轮询由 Sources/Model/UsageStore.swift 统一调度：会话活跃时每 30 秒刷新一次，空闲时降到 5 分钟，限额窗口翻转时立即刷新。任何失败都会降级为可见状态（stale、needsAuth、error），而不是编一个百分比出来——这是整个项目的诚实底线。

想看源码从哪里入手

• 全部 Provider 适配器：Sources/Providers/，统一实现 Sources/Providers/UsageProvider.swift 协议；
• 用量模型与 Fidelity 定义：Sources/Model/UsageModel.swift；
• 各 Provider 的读取细节文档：docs/providers/；
• 设计规格：docs/specs/2026-08-28-usage-notch-design.md。

💡 小结：Codenotch 读的不是什么"黑科技接口"，而是每个工具官方客户端自己读的那份数据——借用登录、本地运行时、应用内登录三条路，外加严格的数据源标注，把 20 多个 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