返回资讯中心
外部精选
软件工程
#开发者实时流

开发者推出macOS菜单栏工具,实时显示Claude用量限额

来源标题:Claude usage in your menu bar

一款名为Claude Usage的macOS菜单栏工具和桌面小组件可实时显示Claude套餐的用量限额,包括5小时会话、每周上限及各模型每周上限,数据与Claude Code中/usage命令一致。使用需macOS 14+、Xcode命令行工具及Claude Code登录,通过make install构建安装。点击菜单栏图标可查看各限额、重置时间、进度标记和用量预测。

Hacker News 最新trthomps2026/11/11 · 6 天前15 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

macOS 菜单栏项和桌面小组件,用来显示你的 Claude 套餐限额:5 小时会话、每周上限,以及按模型划分的每周上限。这些数字与 Claude Code 中 /usage 显示的一致。 需要 macOS 14+、Xcode Command Line Tools(xcode-select --install),以及 Claude Code 登录(claude,然后 /login)。 make install # 构建 "Claude Usage.app",复制到 ~/Applications 并启动 只想构建不安装,运行 make app。应用会生成在 build/ 目录下。 菜单栏里看不到?Hidden Bar、Ice、Bartender 这类菜单栏管理工具会把新项放进隐藏区。展开隐藏区,按住 ⌘ 把该项拖到可见区域。再次打开应用(Spotlight、Finder)总会弹出设置。 点击菜单栏项打开详情浮层:每个限额、重置时间、进度标记和预测("Limit in ~1h 12m" 或 "~62% at reset")。 右键菜单有 Refresh、桌面小组件开关、Settings 和 Quit。 桌面小组件:在 Settings 或右键菜单中开启。它位于桌面上,在图标之上、窗口之下。可拖到任意位置;右键有选项,包括 "Keep Above Other Windows"。 终端:ClaudeUsage --print 打印与 /usage 相同的表格。--json 输出解析后的 JSON 数据。 Claude usage · Team · 5x Current session █████████░░░░░░░░░░░░░░░ 37% Resets in 3h 49m · 18:39 ⚠ limit in ~1h 59m at this pace Current week (all models) ████░░░░░░░░░░░░░░░░░░░░ 17% Resets Tue 06:59 · in 5d 16h (~90% at reset) Current week (Fable) ░░░░░░░░░░░░░░░░░░░░░░░░ 0% Resets Tue 07:00 · in 5d 16h 菜单栏设计 菜单栏空间有限,尤其在带刘海的 MacBook 上,放不下的项会直接消失。设计从三个你想一眼看到的问题出发:我用了多少、是不是用得太快、什么时候恢复? 胶囊(默认),两个限额约 80pt。每个限额是一个小圆角条,上面印着百分比,像电池图标。填充会把数字从自身中镂空,所以无论填充边缘落在哪里,数字在亮色或暗色菜单栏上都清晰可读。数字用等宽字体,胶囊按 "88%" 的宽度设计,因此从 19% 变到 20% 不会挪动菜单栏的其他项。 进度插入符。每个胶囊下的小插入符标记窗口已经过去了多少。它的位置就是均匀使用时应处的位置。如果填充超过插入符,按这个速度会在重置前触顶;如果落后,还有余量。插入符不占额外宽度,且位于胶囊之外,不会切断数字。早期版本把它画在胶囊内部,结果 "47%" 看起来像 "4|7%"。 颜色有含义。默认的 Warnings 模式下,胶囊使用菜单栏自身的文字颜色,和任何单色系统项一样,直到某个限额超过 75%(橙色)或 90%(红色)。Claude 模式将其染成陶土色。Mono 从不上色。 到 100% 时胶囊显示倒计时。一旦被限流,百分比就没意义了,胶囊变红并显示距重置的时间(1h12m)。 过期数据淡出。如果最后一次成功获取太旧(离线、登录过期),该项以降低的不透明度绘制,而不是显示你不该信任的数字。浮层会说明原因。 其他样式,在 Settings → Menu bar style 中: 你可以选择显示哪些限额(会话、每周、按模型的每周)。顺序始终遵循服务器:会话在前,然后每周。 数据:GET https://api.anthropic.com/api/oauth/usage,即 Claude Code 的 /usage 读取的端点。它未公开文档化,可能变化。解析器优先使用结构化的 limits 数组,回退到较早的扁平 five_hour/seven_day_* 键,并忽略不认识的字段。 登录:使用 /usr/bin/security 从 Keychain 项 Claude Code-credentials 读取 Claude Code 的 OAuth token。Claude Code 用同一工具写入该项,所以读取不会触发 Keychain 提示。回退到 ~/.claude/.credentials.json。应用从不写凭证,也从不自行刷新 token——那会把 Claude Code 的刷新 token 转走。如果 token 已过期,应用继续显示最后已知的数字(淡出),直到 Claude Code 续期,这会在你下次使用时发生。 轮询:默认每 2 分钟一次(可配置),浮层打开时,以及唤醒后。遇到 HTTP 429 会退避。只缓存百分比和重置时间,位于 ~/Library/Application Support/ClaudeUsage/snapshot.json。token 从不写入磁盘。 重置切换:当某个窗口的重置时间在两次获取之间过去,会立即显示 0%,而不是过期数字。 开发 swift build # 调试构建 swift run ClaudeUsage --print # 终端中查看实时用量 swift run ClaudeUsage --render-previews docs # 重新生成本 README 中的图片 CLAUDE_USAGE_DEBUG=1 "build/Claude Usage.app/Contents/MacOS/ClaudeUsage" # 记录获取和绘制日志 文件 内容 MenuBarRenderer.swift 所有菜单栏绘制(Core Graphics)。用于实时项、Settings 磁贴和预览渲染器。 UsageParser.swift API 响应 → UsageSnapshot Credentials.swift 查找 Claude Code 的登录 UsageStore.swift 轮询、缓存、退避、倒计时背后的时钟 StatusItemController.swift、PopoverView.swift 菜单栏项和浮层 DesktopWidget.swift 桌面面板(macOS 26 上用 Liquid Glass,旧版本用 vibrancy) SettingsView.swift 设置窗口 它是 SwiftPM 可执行文件,不需要 Xcode。scripts/build-app.sh 把二进制包进 app bundle,生成图标并做 ad hoc 签名。设置 SIGN_IDENTITY 可用 Developer ID 签名。 原生 WidgetKit 小组件——自 Sonoma 起在通知中心和桌面上的那种——需要 Xcode 项目、签名的 app extension 和 App Group。桌面面板无需这些就能给你同样的视图。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →