用途:分析 Claude Code 的本地会话数据,输出用量与成本报告。
主要能力:统计输入、输出与缓存 token 总量;按 Anthropic 定价估算成本;跟踪 5 小时计费区块并给出燃烧率;按模型(如 Opus、Sonnet)拆分;统计工具调用频率;按项目和会话给出统计;展示每日用量趋势。
数据来源:脚本读取 Claude Code 的原生 JSONL 会话文件,位置包括 ~/.config/claude/projects/(Linux/macOS 主路径)、~/.claude/projects/(旧版 Unix)、%USERPROFILE%.claude\projects\(Windows 默认),也可通过 CLAUDE_CONFIG_DIR 环境变量指定自定义路径。提取字段包括 message.usage、message.model、message.content[].type == "tool_use"、costUSD、requestId(去重键)、timestamp。当数据中存在 costUSD 时优先使用该值,否则回退到计算估算。
使用方式:运行 python plugins/cc-usage/skills/cc-usage/scripts/cc_usage.py,或通过 Bash 执行 python <path-to-script>/cc_usage.py [options]。常用选项:-d/--days 指定分析天数(默认 7)、-p/--project 按项目名子串过滤、--no-block 隐藏当前计费区块、--no-projects 隐藏项目明细、--no-tools 隐藏工具统计、--no-sessions 隐藏最近会话、-n/--top 指定每节条目数(默认 10)、--json 输出原始 JSON 而非格式化 markdown。
报告包含:概览、当前计费区块、按模型用量、工具用量(含条形图)、项目明细、最近会话、每日趋势。
限制:定价定义在 scripts/cc_usage.py 顶部的 MODEL_PRICING 表中,更新价格需修改该表,本文不重复具体数字以避免偏差;具体价格与平台支持情况请以脚本和数据源为准。