什么是Claude Usage Checker
Claude Usage Checker 是一款专为 Claude Code 和 Claude Max 用户设计的命令行工具，用于实时检查账户的使用情况和配额限制。该工具通过交互式运行 Claude CLI 并读取其输出的 `/usage` 信息，向用户提供清晰、结构化的使用报告。它适用于所有关心自身 API 调用消耗、剩余额度以及重置时间的开发者或高级用户。由于 Claude 的配额通常按周重置，且包含多个模型（如 Sonnet）的独立计数，因此准确掌握这些信息对于避免服务中断至关重要。该工具本身不修改任何配置或执行敏感操作，仅作为查询辅助，确保用户在资源紧张时能提前规划。需要注意的是，使用前必须已安装并登录 Claude CLI，否则工具将无法获取有效数据。
核心功能特点
- 自动启动 Claude CLI 并模拟交互会话以读取使用数据
- 解析并格式化显示当前会话、每周及额外使用的详细配额信息
- 明确标注各配额项的下次重置时间，便于用户安排开发任务
- 以表格形式输出结果，包括使用百分比、花费金额和具体时间点
- 支持处理登录状态检测，若未登录会提示用户手动完成浏览器认证
适用场景
Claude Usage Checker 特别适合那些频繁使用 Claude Code 进行代码生成、调试或文档编写的开发者。在日常工作中，开发者可能并不清楚自己本周已消耗多少 tokens，尤其当同时使用多个模型时，总用量容易超出预期。此时运行此工具可快速查看剩余额度，判断是否还能继续提交复杂请求，从而避免因超限导致任务中断。此外，对于订阅了 Claude Max 服务的团队用户而言，了解‘Extra usage’部分的消费情况有助于控制成本，防止意外超支。另一个典型场景是临近周末时主动检查重置时间——例如发现‘Weekly (all models)’将在今晚 23:59 重置，便可放心安排高负载任务。该工具也适合自动化脚本中集成，作为每日配额监控的一部分，提升工作效率与可控性。