leeguooooo/claude-code-usage-bar

解决的问题

Claude Code 无法提供关于速率限制、上下文窗口使用情况或提示缓存状态的详细实时可见性。该项目消除了切换窗口或上下文以检查剩余配额和重置时间的需要。

工作原理

它直接集成到 Claude Code 的 statusLine 中，可在终端中显示，或为 macOS 桌面应用提供浮动 HUD。它跟踪官方的 5 小时和 7 天速率限制，监控当前模型和上下文窗口的填充程度，并计算提示缓存保持“新鲜”的倒计时。它可以作为轻量级守护进程运行，每秒刷新一次数据，同时保持 CPU 使用率低于 1%。

适用人群

使用 Claude Code 或 Claude 桌面应用，并希望获得可快速查看的实时 API 使用情况和会话状态仪表板的开发者和高级用户。

主要亮点

• 官方速率追踪：显示 5 小时/7 天使用条形图，带有重置倒计时和窗口结束预测。
• 缓存监控：包含倒计时计时器，显示提示缓存保持“温暖”的剩余时间。
• 双界面支持：同时支持终端状态行和 macOS 浮动 HUD。
• 可自定义视觉样式：提供 3 种样式和 9 种主题，可更改状态栏外观。
• 低开销：可选守护进程模式，确保对 CPU 影响极小。
• 零依赖安装：提供预构建二进制文件或 Python 包两种安装方式。