usage-cost

Estimate Claude Code subscription costs by replaying local transcript usage.

2|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/zachmayer/skills --skill usage-cost
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: usage-cost
Source: https://github.com/zachmayer/skills/tree/main/.claude/skills/usage-cost
Command: npx skills add https://github.com/zachmayer/skills --skill usage-cost

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you determine the most cost-effective Claude Code subscription plan by analyzing your actual local usage patterns against various pricing tiers.

Core Features & Use Cases

  • Usage Simulation: Replays your local transcript history to simulate how different plans (Pro, Max 5x, Max 20x) would handle your specific burst patterns.
  • Cost Comparison: Provides a clear breakdown of flat fees versus potential overage costs to identify the cheapest plan for your workflow.
  • Use Case: If you are unsure whether to upgrade to a Max plan, run this tool to see if your current usage bursts would trigger expensive overages on the Pro plan.

Quick Start

Use the usage-cost skill to analyze my Claude Code transcripts from the last 30 days and recommend the cheapest plan.

Frequently Asked Questions about usage-cost

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

FAQPage Schema
How do I estimate Claude Code subscription costs from local transcript files?

To estimate Claude Code subscription costs, this Skill replays local .jsonl transcript usage against empirical plan rate limits to simulate how Pro, Max 5x, and Max 20x tiers handle your specific burst patterns. It then calculates potential overage costs to identify the cheapest plan for your workflow.

Can I compare Pro versus Max tier pricing using my historical API token consumption?

Yes, you can compare Pro versus Max tier pricing using your historical API token consumption. The tool provides a clear breakdown of flat fees versus potential overage costs by replaying your actual local transcript history against different pricing tiers to recommend the most cost-effective plan.

Do I need the Click CLI framework to run a Claude Code billing analysis?

Yes, you need the Click CLI framework installed to execute the billing analysis script. The Skill requires Click for command-line execution and also needs local access to your .jsonl transcript files generated by Claude Code to perform the usage simulation.

What is the best way to optimize Claude Code spend and avoid expensive overages?

The best way to optimize Claude Code spend is to run a usage simulation that replays your local transcript history against empirical plan rate limits. This identifies whether your current usage bursts would trigger expensive overages on the Pro plan, helping you decide if upgrading to a Max plan is cheaper.

Why does my Claude Code usage burst trigger overages on the Pro plan?

Usage bursts trigger overages on the Pro plan because your historical API token consumption exceeds the empirical rate limits for that tier during peak periods. Replaying your local .jsonl transcripts against plan rate limits simulates these bursts to calculate the exact financial impact.