claude-usage-analyst

Analyzes Claude Code token usage, cost, and quota burn from ccusage data.

1.4k|216|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/daymade/claude-code-skills --skill claude-usage-analyst
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-usage-analyst
Source: https://github.com/daymade/claude-code-skills/tree/main/daymade-claude-code/claude-usage-analyst
Command: npx skills add https://github.com/daymade/claude-code-skills --skill claude-usage-analyst

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ccusage, and includes scripts (resource) and references (resource) components.

What problem does it solve?

When your Claude Code quota runs out unexpectedly or a day's usage looks unusually expensive, raw logs are hard to interpret. This Skill turns local ccusage data into an evidence-based, plain-language explanation of token consumption, cost, model mix, and 5-hour block burn.

Core Features & Use Cases

  • Usage Summaries: Runs a bundled Python analyzer over ccusage daily and block data to report total tokens, estimated cost, input/output split, and cache create/read volumes for any date range and timezone.
  • Model Comparison: Compares two models (e.g., fable vs opus) on both token volume and estimated cost, showing when similar token counts still produce very different bills.
  • Quota Burn Diagnosis: Breaks usage into 5-hour blocks to explain rapid quota exhaustion, distinguishing real typing from cache-read pressure.
  • Use Case: A user asks why their Claude quota was exhausted after only two questions; the Skill shows the session involved many internal turns with cache reads dominating over 80% of tokens.

Quick Start

Ask the assistant to explain today's Claude Code token and cost usage with evidence from ccusage.

Frequently Asked Questions about claude-usage-analyst

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my Claude Code token usage and cost?

Run the bundled analyzer script, which calls ccusage daily and blocks commands with --json output. It reports total tokens, estimated cost, input/output split, and cache create/read volumes for a chosen date range and timezone.

How to compare token cost between Claude models like opus and sonnet?

Pass model aliases to the analyzer with --model-a and --model-b. The comparison reports both token ratio and cost ratio, since a model can have similar token volume but higher estimated cost per effective token.

Why did my Claude quota run out after only a few questions?

A few user questions can trigger many internal turns and tool calls, and cache read tokens often dominate usage because the agent repeatedly re-reads project context. The 5-hour block table shows entries, tokens, and cache read share per block.

Does ccusage show my Claude.ai chat usage?

No. ccusage measures local Claude Code usage logs, including Claude Desktop Code sessions when local logs exist. Ordinary Claude.ai chats are not represented unless they generated Claude Code usage logs.

What if ccusage is not installed on my machine?

Install it globally with npm install -g ccusage@latest or run it via npx ccusage@latest. The analyzer exits with a clear error message if the ccusage binary is not found on the PATH.