cc-usage — Token 用量统计

扫描本地 Claude Code 日志（~/.claude/projects/ ），按 日期 × 模型 维度统计 token 消耗和 API 等价费用。

纯 Python 3 脚本，无需安装任何依赖，跨平台（Mac / Linux / Windows）。

触发词

• "/cc-usage"

• "看看用量"

• "token 消耗"

• "用量统计"

执行步骤

• 根据用户需求确定参数（天数、项目、输出格式）

• 运行分析脚本

• 把结果整理成易读的 Markdown 表格返回给用户

脚本位置

.claude/skills/cc-usage/scripts/analyzer.py

用法

默认：全部历史，所有项目

python3 .claude/skills/cc-usage/scripts/analyzer.py

最近 N 天

python3 .claude/skills/cc-usage/scripts/analyzer.py --days 7

只看某项目（模糊匹配目录名）

python3 .claude/skills/cc-usage/scripts/analyzer.py --project mylife

输出 CSV（可导入 Excel）

python3 .claude/skills/cc-usage/scripts/analyzer.py --csv

只看模型汇总

python3 .claude/skills/cc-usage/scripts/analyzer.py --summary

默认行为

用户没指定天数时，默认跑 --days 7 （最近 7 天）。

输出要求

脚本跑完后，AI 应该：

• 把关键数据整理成 Markdown 表格（按天 × 模型）

• 给出日小计和总计

• 附上模型汇总（哪个模型最费钱）

• 如有异常（某天突然暴涨），主动指出

跨平台说明

• 路径：使用 os.path.expanduser('~') 自动适配

• 时区：使用 datetime.astimezone() 自动检测系统本地时区

• 依赖：仅 Python 3 标准库，无需 pip install

维护提示

新模型上线时需更新脚本里的 MODEL_SHORT 和 PRICING 字典。