richhickson/claudecodeusage

解决的问题

Claude Usage 是一款 macOS 菜单栏应用，旨在帮助 Claude Code CLI 工具的用户管理使用限制，并随时掌握会话状态。它免除了手动检查使用配额的麻烦，也不会错过 AI 代理会话需要用户输入或权限时的通知。

运作方式

该应用会从 macOS Keychain 读取 OAuth 凭证，以查询 Anthropic 的使用 API。为了提供会话警报，它利用 Claude Code 的 hooks 系统，安装一个小型 shell script，将会话状态（运行中、需要注意或已完成）写入本地 JSON 文件，应用随后会监控这些文件。

适用对象

在 macOS 上使用 Claude Code CLI 的开发人员，希望实时、可视化地查看 Token 限制，并在 AI 编码会话需要注意时获得通知。

特色亮点

• 使用量追踪：监控会话、每周及各模型的限制，并提供颜色编码的状态指示器（绿色、黄色、红色）以及超额追踪。
• 会话警报：当会话需要输入时，提供 macOS 通知和菜单栏铃声，并具备“点击聚焦”功能，可直接跳转至特定的终端标签页。
• Claude 状态：整合来自 status.claude.com 的中断通知。
• Claude Code 配置：内置全局 CLAUDE.md 文件编辑器及对话保留设置。
• 轻量级：使用原生 Swift 构建，资源占用极低。