用途:统计本地 Claude Code 的 token 用量,按日期×模型维度拆分,并估算 API 等价费用,帮助了解消耗情况。
主要能力:扫描本地 Claude Code 日志目录 ~/.claude/projects/;按日期与模型汇总 token 消耗;支持按天数、项目(模糊匹配目录名)过滤;可输出 CSV 便于导入 Excel;可只看模型汇总。触发词包括“/cc-usage”“看看用量”“token 消耗”“用量统计”。
使用方式:脚本为纯 Python 3,无需安装依赖,跨平台(Mac / Linux / Windows)。脚本位置为 .claude/skills/cc-usage/scripts/analyzer.py。常用命令: python3 .claude/skills/cc-usage/scripts/analyzer.py python3 .claude/skills/cc-usage/scripts/analyzer.py --days 7 python3 .claude/skills/cc-usage/scripts/analyzer.py --project mylife python3 .claude/skills/cc-usage/scripts/analyzer.py --csv python3 .claude/skills/cc-usage/scripts/analyzer.py --summary 默认行为:用户未指定天数时默认跑 --days 7。脚本跑完后,AI 应将关键数据整理成 Markdown 表格(按天×模型),给出日小计和总计,附模型汇总,并在某天数据异常暴涨时主动指出。
适用场景:需要查看 Claude Code 历史 token 消耗、按项目或时间段分析用量、导出数据做进一步统计时。
限制与维护:路径使用 os.path.expanduser('~') 自动适配,时区使用 datetime.astimezone() 自动检测系统本地时区,仅依赖 Python 3 标准库。新模型上线时需更新脚本里的 MODEL_SHORT 和 PRICING 字典。其他收费、平台或效果信息暂未提供。