macOS menu bar & Windows tray app pinning Claude Code, Codex, Antigravity & Grok CLI quota, burn rate, and cost to your screen. Local-first, no LLM API calls. HTML reports, 14 themes.

Usage – Claude、Codex、Antigravity、Grok 的实时配额监视器

功能概述

usage 是一个桌面工具，用于监控多种 AI 编程助手（Claude Code、Codex、Google Antigravity、Grok CLI）的令牌配额限制，并在 macOS 菜单栏或 Windows 系统托盘中显示剩余百分比。指示器随着配额减少会从绿色→黄色→红色变化，点击后会打开一个包含详细分类、故障警报和快速操作的小面板。

适用人群

在日常编码工作流中经常使用 Claude Code、Codex、Antigravity 或 Grok 的开发者。
希望避免在重构过程中因配额重置而感到惊讶的用户。
需要无需打开浏览器或日志文件就能快速直观查看剩余 AI 助手预算的团队。

工作原理（概览）

数据源 – 应用读取 Claude Code、Codex、Grok 和 Muse Code 在您机器上写入的本地日志文件。对于 Antigravity，它使用 Antigravity CLI 已存储的 OAuth 令牌调用 Google 的官方配额端点。
菜单栏/托盘 UI – 一个小图标以颜色编码显示当前会话/每周配额百分比。点击后会展开一个面板，显示按项目划分的令牌数量、成本估算和任何故障横幅。
Claude Code 集成 – 可以在 Claude Code 内部安装可选的状态行钩子。它会在 Claude 窗口底部添加一行摘要，并可启用额外辅助功能（侧面板、令牌节省器、初学者模式等）。
报告与主题 – 应用可以生成令牌趋势和成本的离线 HTML/CSV 报告，您还可以从 16 种视觉主题中选择。
CLI 模式 – 对于 Linux 或无头使用，uvx usage-cli（或 uv tool install usage-cli）会运行终端 UI，并提供 usage status --json 命令，供其他工具（Starship、tmux、自定义脚本）使用。

主要功能

功能	您看到/可做的	重要性
配额监视器	绿-黄-红图标带百分比；点击查看会话、每周和按项目分类的详细信息。	提供即时视觉反馈，防止意外配额耗尽。
Antigravity 和 Grok 卡片	显示 Gemini 池使用量或 Grok 每周信用额度，与 Claude/Codex 并列。	将您所有的 AI 编码预算集中在一处。
故障警报	当 Claude、Claude API 或 Codex API 状态页面报告问题时，显示红色横幅。	让您暂停工作，而不是等待失败的请求。
上下文和缓存警告	当上下文窗口即将填满时，状态行提示您 `/clear` 或 `/compact`。	节省可能浪费在大型提示上的令牌。
Claude Code 侧面板	在编辑器旁边显示配额、其他对话和后台任务。	减少上下文切换；您可以同时监控多个聊天。
进度管家	当您开始新会话时，AI 会提醒最后一次请求、未提交的更改和未完成的待办事项。	无需手动总结；节省时间和令牌。
令牌节省器	要求 Claude/Codex 提供更短、更简洁的回复，同时保持代码准确性。	根据作者测量，平均回复长度减少约 40%。
初学者和配额感知模式	提供技术术语解释，并在任务超过剩余配额时发出警告。	对新手和预算敏感的工作很有帮助。
HTML 报告	每日/每周令牌趋势、成本、项目排名、"年度回顾"热图；导出为 HTML、CSV、PNG。	离线分析 AI 使用情况和预算。
16 种视觉主题	经典、矩阵、Windows 95、新闻等。	根据您的桌面风格个性化外观。
跨平台	macOS（菜单栏）	Windows（系统托盘）

安装与入门

macOS – brew install --cask aqua5230/usage/usage（推荐）或从最新版本下载 .app zip 文件。
Windows – 下载 usage-windows.zip，解压缩，运行 usage.exe。需要 Edge WebView2（大多数 Windows 10/11 机器已自带）。
Linux / 其他操作系统（仅限终端） – uvx usage-cli（无需永久安装）或 uv tool install usage-cli 以获得持久usage命令。
首次启动后，点击弹出窗口中的 Set Up Status Line 以安装 Claude Code 钩子（或从源代码运行相应命令）。然后重新启动 Claude Code/Codex。

限制与注意事项

应用仅读取本地日志；如果您清除这些日志，将丢失历史数据。
Antigravity 配额需要网络访问和已存储的 OAuth 凭据；否则卡片将被隐藏。
初学者模式和配额感知模式会发送一个 Claude 请求来获取术语解释——会有少量额外配额消耗。
在 Linux 上，UI 仅限终端版本；完整的菜单栏/托盘 UI 仅适用于 macOS/Windows。
所有成本估算使用内置的模型定价表，并离线计算。

快速入门清单

为您的平台安装应用。
至少运行一次 Claude Code、Codex、Antigravity 或 Grok 会话，以便创建日志。
打开菜单栏/托盘图标，点击 Set Up Status Line 以启用 Claude 集成。
选择您喜欢的视觉主题。
（可选）在设置面板中开启 初学者模式 或 配额感知模式。
如果您想在 shell 或 tmux 配置中使用 usage status --json 来获取数字，请使用它。

上述所有细节均直接取自项目 README，未推断任何额外功能。

aqua5230/usage