AI Usage Check 是一个轻量级命令行工具，专为开发者设计，用于实时监控和管理跨平台 AI 服务的 token 使用情况、配额消耗与费用支出。该工具通过整合 Anthropic OAuth API 和 OpenClaw 会话日志数据，提供统一的视图来追踪 Claude 模型的使用情况以及其他主流 AI 平台（如 Ollama、OpenAI 等）的调用统计。无需复杂依赖，仅需 Python 3.10+ 和标准库即可完成运行，极大简化了多 AI 环境下的资源监控流程。
工具的核心能力在于自动获取 Anthropic 账户的真实配额信息，包括每周使用百分比、5 小时滚动窗口使用率以及按模型（Sonnet、Opus）细分的用量分布。同时，它还能从本地 OpenClaw 会话记录中解析出非 Anthropic 提供商（如本地部署的 Ollama 或云端 OpenAI）的 token 调用次数和预估成本，实现全生态覆盖的用量审计。当检测到 Claude Code 的 OAuth 令牌过期时，脚本会自动触发刷新机制，确保数据持续准确。
此外，AI Usage Check 支持多种输出格式：默认生成带有进度条和可视化图表的易读报告，也支持 JSON 格式输出，便于集成到自动化脚本、定时任务或自定义仪表盘中。无论是作为日常开发中的心跳检测，还是用于构建用量告警系统，该工具都能以极低开销提供高价值洞察，帮助团队优化成本并避免意外超限。
核心功能特点
- 实时查询 Anthropic 账户的 OAuth 配额，显示每周使用率和月度支出对比
- 自动刷新过期的 Claude Code OAuth 令牌，保障数据持续可用
- 解析 OpenClaw 会话日志，统计非 Anthropic 平台的 token 调用与成本估算
- 支持按模型细分用量（如 Sonnet、Opus），提供精细化消费分析
- 输出包含可视化图表的报告，也支持 JSON 格式供脚本程序调用
- 零外部依赖，仅使用 Python 标准库，部署简单高效
适用场景
AI Usage Check 特别适合需要长期运行 AI 辅助开发的工程师和运维人员。例如，在团队协作环境中，成员可能同时使用 Claude Code 进行代码生成，又通过本地 Ollama 部署大模型进行推理测试。此时，该工具可统一展示所有渠道的 token 消耗趋势，防止因分散使用导致预算超支。对于订阅了 Anthropic Pro 或 Max 计划的用户，它能清晰呈现剩余额度与重置时间，辅助合理安排高成本模型的使用频率。
另一个典型应用场景是自动化监控与告警系统。开发者可将脚本加入 crontab 定时执行，配合 Prometheus 或 Grafana 等工具绘制用量曲线图，并在接近配额阈值时发送通知。尤其在企业级部署中，集中管理多个账号的 AI 支出尤为重要。此外，独立开发者或开源项目维护者若希望控制 API 调用成本，也可借助此工具设定每日/每周预算上限，避免因突发高负载请求造成意外费用。
由于其轻量化设计和无侵入性，该工具还适用于边缘场景，比如作为 CI/CD 流水线中的前置检查步骤，确保自动化任务不会因配额耗尽而中断。或者作为个人开发者的日常健康检查工具，在终端快速查看当前 AI 使用情况，提升开发效率的同时增强财务透明度。