Claude Usage 简介
Claude Usage 是一款为 Claude Code 用户打造的小巧原生应用。它在菜单栏中显示当前的 5 小时会话、所有模型和 Sonnet 的每周用量,以及按量付费的额度,每项都带有用量条和重置时间,无需打开 Claude Code。它还会在 Claude Code 提示符下方添加一行,显示模型、上下文窗口的占用比例和已用令牌数,让你在空间耗尽之前压缩会话。每个终端窗格都显示自己的这一行,在 tmux 中也一样。
Claude Usage 由 GitHub 开发者 Bread-bang 开发,基于 MIT 许可证免费开源。它使用 Swift 和 SwiftUI 编写,没有 Electron,也没有其他依赖,没有自己的服务器和遥测,直接复用 Claude Code 已存放在钥匙串中的登录信息。你需要 macOS 13 或更高版本、Apple Silicon Mac(发布版本仅支持 Apple Silicon),并已登录 Claude Code。构建已经过公证。0.4.3 版修复了 macOS 26 上下拉面板周围出现双重直角边框的问题,以及访达中显示错误版本号的问题。需要了解的限制:它依赖一个未公开的用量端点和 Claude Code 的钥匙串格式,两者都可能在没有通知的情况下改变。
主要功能
Claude Usage 让你随时掌握 Claude Code 的用量上限。
- 会话和每周用量:5 小时会话,以及所有模型和仅 Sonnet 的每周用量。
- 额度:按量付费额度及用量条。
- 重置时间:每个上限都显示何时重置。
- 菜单栏数字:可选择显示哪个时间窗,并以红黄绿颜色提示。
- 上下文显示:在 Claude Code 提示符下方显示模型、占用百分比和已用令牌。
- 按窗格显示:每个终端窗格显示自己的会话,在 tmux 中也可用。
- 设置:可选图标,刷新间隔可设为 30 秒、1 分钟或 5 分钟。
- 容错:刷新失败时保留上次的有效数据并给出提示,遇到频率限制时自动放慢。
0.4.3 版本新功能
Claude Usage 0.4.3 修复了两个显示问题。
- 在 macOS 26 上,下拉面板不再出现双重直角边框
- 访达现在显示真实版本号,而不是 0.2.0
Claude Usage 常见问题
Claude Usage 免费吗?
是的。Claude Usage 基于 MIT 许可证免费开源。
使用 Claude Usage 需要什么?
需要 macOS 13 或更高版本、Apple Silicon Mac,并已登录 Claude Code。先运行一次 claude,让登录信息保存到钥匙串中。
Claude Usage 能在 Intel Mac 上运行吗?
发布版本仅支持 Apple Silicon,因此不能在 Intel Mac 上运行。
Claude Usage 在菜单栏中显示什么?
当前的 5 小时会话、所有模型和仅 Sonnet 的每周用量,以及按量付费额度,每项都带有用量条和重置时间。
什么是上下文显示?
在 Claude Code 提示符下方的一行状态信息,显示模型、上下文窗口的占用比例和已用令牌数。每个窗格各自显示,在 tmux 中也一样。
Claude Usage 会把我的数据发送到别处吗?
不会。它没有自己的服务器,也没有遥测。它唯一的网络请求发往 Claude Code 使用的同一个用量地址,令牌从钥匙串读取并只保存在内存中。
Claude Usage 会覆盖我现有的状态行吗?
不会。只有在状态行位置为空或已是它自己的命令时,它才会注册;绝不会覆盖其他工具的状态行。
Claude Usage 可能会失效吗?
它依赖一个未公开的用量端点和 Claude Code 的钥匙串格式,两者都可能在没有通知的情况下改变。
可以用 Homebrew 安装 Claude Usage 吗?
可以,通过开发者的 tap:brew install bread-bang/tap/claude-usage。
claude-usage.FULLMAC.app 上的 Claude Usage 下载来自哪里?
下载按钮指向 GitHub 上的 Claude Usage 官方发布页面 https://github.com/Bread-bang/claude-usage/releases/latest。claude-usage.FULLMAC.app 不会修改或重新打包该应用。
相似应用
OrbStackOrbStack 是在 Mac 上运行 Docker 容器和 Linux 虚拟机的快速、轻量又简单的方式。它可以直接替代 Docker Desktop:你的 docker 和 docker compose 命令照常可用,首次启动时 OrbStack 还会提出迁移 Docker Desktop 中的容器、镜像和卷。它几秒钟即可启动,在 Apple 芯片上的后台 CPU 占用低于 0.1%,并会把未使用的内存还给 macOS。除了容器,它还能运行来自 16 种发行版的完整 Linux 虚拟机,以及用于本地开发的轻量 Kubernetes 集群。OrbStack 由 Orbital Labs 开发。开发工具
QuotaBar如果你用 ChatGPT 账户使用 OpenAI Codex,用量限制会按 5 小时窗口和每周窗口重置,想知道还剩多少就得打开 Codex 或 ChatGPT。QuotaBar 把剩余百分比显示在 Mac 菜单栏中,每 60 秒刷新一次。点击图标可打开详细面板,查看每个限制窗口及其重置倒计时;也可以打开一个始终置顶的小型悬浮 HUD。开发工具
Stargazer BarStargazer Bar 是一款小巧的 Mac 原生菜单栏应用,帮你盯着 GitHub 仓库。它在菜单栏中实时显示星标数,不用一直开着浏览器标签页也能知道项目的情况;点击即可打开详情菜单:星标与 Fork 趋势图、发布版下载总数以及维护者雷达。公开仓库以星标数衡量。私有仓库没有星标,则以需要你处理的事项衡量:构建失败、未回复的 Issue 或新的拉取请求。开发工具
Notch So GoodNotch So Good 把 MacBook 的刘海变成 AI 编程代理的小型状态显示屏。当 Claude Code 或 OpenAI Codex CLI 工作时,一个黑色胶囊会延伸刘海:左边是名为 Peek 的 3D 角色,右边的圆环显示 5 小时用量窗口还剩多少。会话越需要你,Peek 就从刘海里探出得越多。当任务完成、失败或达到用量上限时,刘海会展开成一张卡片,说明发生了什么、在哪个项目里,点击即可跳到对应的终端标签页,包括 tmux 窗格。开发工具
TintpadTintpad 是一款免费开源的启动器,面向使用 Claude Code、Codex 等命令行编程代理的开发者。在任意位置按下 Option-Command-空格,一滴黑色的“水滴”会从 Mac 的刘海处落下(没有刘海的 Mac 则悬挂在菜单栏下方),里面列出你的代码仓库。输入几个字母并按下 Return,你自己的终端就会在该仓库中打开,代理已按你上次在那里使用的模式运行。开发工具
DeploylightDeploylight 是一款免费开源的菜单栏应用,可实时显示你的部署状态。它支持 Vercel 部署和 Cloudflare Workers Builds,并把两者合并到同一个列表中。菜单栏图标会显示最新一次构建是正在进行、已完成还是失败;构建进行时,还可以显示项目名称和实时计时器。点击菜单中的任意部署,即可在 Vercel 或 Cloudflare 控制台中打开它。开发工具
FULLMAC.app 不托管此应用。下载按钮会将你带到开发者自己的页面。