实时监控Claude Code OAuth配额的双窗口限制（5小时会话+7天周期），智能缓存、精准重置提醒，避免API调用中断。
说明：
## 核心用法
Claude Code Usage 是一个命令行配额监控工具，专为 Claude Code 开发者设计。核心功能是实时查询并可视化展示两个关键限制窗口：
– **Session（5小时窗口）**：短期速率限制，高频开发时的瓶颈
– **Weekly（7天窗口）**：长期配额限制，影响持续使用能力
基础命令 `./scripts/claude-usage.sh` 即可获取带进度条和颜色编码的直观输出。支持 `–fresh` 强制刷新、`–json` 机器可读输出、`–cache-ttl` 自定义缓存。
## 显著优点
1. **零配置即用**：自动从系统钥匙链读取OAuth凭证（macOS Keychain / Linux secret-tool）
2. **智能双重监控**：不仅显示当前使用率，还计算精确到分钟的剩余重置时间
3. **两种自动化方案**：
– Session Reminder：自调度cron链，在配额重置**瞬间**通知，误差<1分钟
– Reset Detection：轮询监测，适合不想依赖cron精度的场景
4. **API友好**：60秒智能缓存避免频繁调用Anthropic端点
5. **状态可视化**：???三色进度条，一眼识别风险等级
## 潜在缺点与局限性
– **平台依赖**：macOS/Linux only，Windows需WSL
– **前置条件**：必须已完成Claude Code CLI的OAuth授权流程
– **凭证风险**：脚本需要访问系统钥匙链，虽为只读但仍属敏感权限
– **监控盲区**：无法预测未来使用量，仅反映历史消耗趋势
– **API稳定性**：依赖未公开的 `api.anthropic.com/api/oauth/usage` 端点，存在变更风险
## 适合人群
– **重度Claude Code用户**：日活开发、依赖AI辅助编码的专业开发者
– **CI/CD集成者**：需要在脚本中程序化检查配额的后端工程师
– **多账户管理者**：同时维护多个Anthropic账户的开发者需分别配置
– **成本敏感型团队**：需要监控团队级配额消耗的技术负责人
## 常规风险
| 风险类别 | 等级 | 说明 |
|———|——|——|
| 凭证泄露 | 中 | 钥匙链访问权限若被恶意脚本滥用可读取其他密码 |
| API滥用 | 低 | 高频`–fresh`调用可能触发Anthropic侧限流 |
| 通知疲劳 | 低 | 自动化监控设置不当可能导致消息轰炸 |
| 端点失效 | 中 | 非公开API可能无预警变更或废弃 |
**建议**：生产环境使用Session Reminder方案（精确且API调用最少），定期检查脚本更新以适配API变更。
会员专属
