ccusage 用于分析 Claude Code CLI 的令牌消耗与费用，适合在用户询问令牌用量、API 成本、用量报告或账单数据时使用。
主要能力：提供多种统计维度，包括按日期（daily，默认）、按周（weekly）、按月（monthly）、按会话（session）、按计费区块（blocks，5 小时窗口）以及供钩子使用的紧凑状态（statusline）。支持按日期范围、项目、模型和实例进行筛选，并可对结果排序。
使用方式：通过 npx 运行，例如 npx ccusage@latest --json --offline。建议始终加上 --json 获得结构化输出，加上 --offline 使用缓存定价以避免 API 调用。常用筛选示例：npx ccusage@latest daily --json --offline --since 20260301 --until 20260311；npx ccusage@latest daily --json --offline --project "my-project"；npx ccusage@latest daily --json --offline --breakdown；npx ccusage@latest daily --json --offline --instances。
关键选项：-s/--since 起始日期（YYYYMMDD）、-u/--until 结束日期、-p/--project 按项目名筛选、-b/--breakdown 显示按模型的成本、-i/--instances 显示项目细分、-o/--order 排序（asc 或 desc）、-z/--timezone 分组时区、-O/--offline 使用缓存定价、-j/--json 输出 JSON。
JSON 输出结构：daily/monthly/weekly 返回包含 date、inputTokens、outputTokens、cacheCreationTokens、cacheReadTokens、totalTokens、totalCost、modelsUsed、modelBreakdowns 等字段的数组；session 返回 sessionId、inputTokens、outputTokens、totalCost、lastActivity、modelsUsed、projectPath 等；blocks 返回 id、startTime、endTime、isActive、totalTokens、costUSD、models 等。
限制：资料未提供安装以外的更多平台支持、定价来源细节或错误处理说明，暂未提供。