用途：查询 Claude Code OAuth API 的使用限额，涵盖会话（5 小时）与每周（7 天）两个窗口，适用于用户询问用量、剩余额度或速率限制的场景。
主要能力：显示会话与周用量百分比、重置剩余时间和重置时间点；用进度条、颜色状态标识用量健康度（绿色 0-50%、黄色 51-80%、红色 81-100%）；内置约 60 秒缓存以避免频繁请求 API；支持强制刷新与 JSON 机器可读输出；另可通过脚本做会话重置提醒或重置检测通知。
使用方式：在工具目录下运行 ./scripts/claude-usage.sh（默认读取新鲜缓存），--fresh 强制从 API 刷新，--json 输出 JSON，--cache-ttl 300 自定义缓存时长。缓存默认位于 /tmp/claude-usage-cache，可用 CACHE_FILE 与 CACHE_TTL 环境变量覆盖。提醒功能用 ./scripts/session-reminder.sh；轮询监控用 ./scripts/monitor-usage.sh 与 ./scripts/setup-monitoring.sh，也可经 clawdbot cron add 定时执行。
适用场景：开工前确认剩余额度、接入状态栏显示、脚本化监控和在配额重置时收到通知。
限制：依赖已认证的 Claude Code CLI；macOS 通过 Keychain 读取凭据，Linux 需 secret-tool（可安装 libsecret-tools），未安装或未认证时会报无凭据错误；API 请求失败需检查网络或令牌是否过期。价格、平台支持范围及其他未提及信息暂未提供。