Claude Usage MAC 版

面向 Claude Code 用户的免费开源菜单栏应用:在菜单栏显示会话、每周和额度用量,并在状态行显示上下文。

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 不会修改或重新打包该应用。

相似应用

FULLMAC.app 不托管此应用。下载按钮会将你带到开发者自己的页面。