claude-usage

Claude Usage Calculator 是一款专为 Claude Max 订阅用户设计的本地用量分析工具。该 Skill 通过解析 OpenClaw 代理生成的本地会话数据，反向实现了 Anthropic 官方未公开的积分计算体系，帮助用户精准掌握订阅资源消耗情况。

核心用法方面，用户首次使用需配置每周重置时间和订阅档位（Pro/5×/20×），后续即可通过命令行快速获取用量报告。工具支持多维度查询：weekly 概览展示总积分消耗与预算占比、5小时滑动窗口速率限制预警、会话排名及模型分布；单会话模式可深入分析特定对话的 Token 构成与模型占比；JSON 输出模式便于与其他工具集成。所有数据均从 ~/.openclaw/agents/main/sessions/ 本地读取，无需网络连接。

显著优点包括：一是计算精确性，基于社区逆向研究的积分公式（区分 Opus/Sonnet/Haiku 不同输入输出费率，且 Cache 读取免费），准确反映官方计费逻辑；二是本地隐私保护，纯 Python 标准库实现，零外部依赖，所有敏感会话数据仅在本地处理；三是灵活的阈值监控，特别针对 Claude Max 特有的 5 小时速率限制窗口提供可视化进度条，避免服务中断；四是配置持久化，一次设置后自动保存用户偏好。

潜在局限性在于：首先，数据源依赖 OpenClaw 代理，未使用官方 API 或未使用 OpenClaw 的用户无法获取数据；其次，积分公式基于社区逆向工程，若 Anthropic 调整计费策略可能存在计算偏差；再者，界面为命令行交互，对非技术用户不够友好；最后，时区处理依赖系统命令，在部分容器环境可能需要额外配置。

适合群体主要包括：高频使用 Claude Max 的开发者与研究员，需要监控多会话预算分配；运营团队管理共享账号，需追踪成员使用情况；以及关注成本优化的 AI 重度用户，希望基于 5 小时窗口调整使用策略。

使用风险主要涉及：一是 T3 来源（GitHub 个人账号），虽代码已审计但仍建议审查后使用；二是读取本地敏感会话历史，虽无上传行为但需确保运行环境安全；三是配置保存机制使用 --save 显式确认，避免误操作；四是作为非官方工具，存在因 Claude 计费规则变更导致数据失准的可能性。