Claude Code Usage Analyzer

Claude Code CLI 会话日志分析工具 + Claude Code Skill，一键分析你的 Claude 使用情况。

功能

• Token 统计：Input / Output / Cache Read / Cache Creation 全维度追踪
• 费用估算：基于官方定价自动计算各模型、项目、会话的花费
• 多维分析：按模型、项目、日期、小时、会话、子代理 6 个维度拆解
• 子代理追踪：解析 Explore / Plan / general-purpose 等子代理的使用情况
• 导出报告：支持 JSON / CSV / HTML 三种格式
• Skill 集成：作为 Claude Code Slash Command 直接在对话中使用

快速开始

1. 安装分析工具

pip install git+https://github.com/CookiRui/claude-usage-analyzer.git

2. 安装 Skill

将 skill/usage.md 复制到你的 Claude Code commands 目录：

# 项目级（仅当前项目可用）
mkdir -p .claude/commands
cp skill/usage.md .claude/commands/usage.md

# 全局级（所有项目可用）
mkdir -p ~/.claude/commands
cp skill/usage.md ~/.claude/commands/usage.md

3. 使用

在 Claude Code 中输入：

/usage              # 全量分析
/usage 7            # 最近 7 天
/usage 30 html      # 最近 30 天，导出 HTML 报告

或直接在终端运行：

claude-usage analyze                        # 终端全量分析
claude-usage analyze --days 7 --top 20      # 最近 7 天，Top 20 会话
claude-usage export --format html -o report.html  # 导出 HTML

Skill 参数说明

/usage [天数] [导出格式]

参数	说明	默认值	示例
天数	分析最近 N 天的数据	全部	7, 30, 90
导出格式	导出报告格式	不导出	html, json, csv

输出示例

Claude Usage Report  (2026-02-11 ~ 2026-04-01)
Sessions: 169  |  Messages: 82699  |  Subagents: 1817  |  Est. Cost: $7,382.17

                 Token Summary
+---------------------------------------------+
| Metric         |         Tokens | Est. Cost |
|----------------+----------------+-----------|
| Input          |      1,800,213 |           |
| Output         |     14,453,494 |           |
| Cache Read     | 11,599,951,091 |           |
| Cache Creation |    432,768,911 |           |
| Total          | 12,048,973,709 | $7,382.17 |
+---------------------------------------------+

                 Model Distribution
+-----------------------------------------------------------------------------+
| Model          |     Input |    Output | Sessions | Messages |  %  |   Cost |
|----------------+-----------+-----------+----------+----------+-----+--------|
| claude-opus    | 1,540,148 | 9,453,830 |      141 |    33402 | 68% | $5,143 |
| claude-sonnet  |   156,367 | 4,774,452 |       23 |    15134 | 30% | $2,206 |
+-----------------------------------------------------------------------------+

分析维度

维度	说明
Token Summary	总 token 数和费用
Model Distribution	各模型的使用量、会话数、消息数、费用占比
Project Distribution	各项目的 token 消耗和费用
Daily Trends	每日使用趋势（最近 14 天）
Top Sessions	Token 消耗最高的会话详情
Subagent Distribution	子代理类型分布和 token 统计
Hourly Activity	24 小时活跃度热力图

依赖

• Python 3.10+
• claude-usage-analyzer (pip install)
• Claude Code CLI (~/.claude/ 日志目录)

License

MIT