skills.rest
VMRam95
VMRam95COMMUNITY
Explore all skills by this author →
GitHub

claude-code-usage

Parse local stats cache files to monitor Claude Code OAuth usage and token consumption.

Updated May 10, 2026
Search Tags:#monitoring#api#claude#quota#tokens#usage
One-click install
npx skills add https://github.com/VMRam95/vmram-skills --skill claude-code-usage-vmram95
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-code-usage
Source: https://github.com/VMRam95/vmram-skills/tree/main/skills/claude-code-usage
Command: npx skills add https://github.com/VMRam95/vmram-skills --skill claude-code-usage-vmram95

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps users track their API token consumption and OAuth usage limits, preventing unexpected service interruptions due to quota exhaustion.

Core Features & Use Cases

  • Usage Tracking: Provides a breakdown of token consumption across different models like Sonnet, Opus, and Haiku.
  • Quota Management: Calculates remaining usage capacity based on daily, weekly, or monthly periods.
  • Use Case: A developer can quickly check if they are approaching their daily Claude Code limit before starting a large refactoring task to ensure they have enough quota to complete the work.

Quick Start

Ask the assistant to check your current Claude Code usage for the month.

Frequently Asked Questions about claude-code-usage

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

FAQPage Schema
How do I monitor Claude Code token usage and quota limits?▼

This skill monitors Claude Code OAuth usage limits and token consumption by parsing the local ~/.claude/stats-cache.json file. It aggregates request and model-specific token data to provide a breakdown of your consumption metrics.

Can I track token consumption for specific Anthropic models like Sonnet and Opus?▼

Yes, usage tracking provides a breakdown of token consumption across different models like Sonnet, Opus, and Haiku. It parses local stats cache files to aggregate model-specific token data for your Claude Code requests.

How do I check remaining Claude Code quota before starting a large task?▼

Quota management calculates remaining usage capacity based on daily, weekly, or monthly periods. This allows developers to proactively check if they are approaching their Claude Code limit before starting a large refactoring task to ensure they have enough quota.

Do I need a specific file to check Claude Code API usage limits?▼

Yes, monitoring Claude Code OAuth usage limits requires access to the local ~/.claude/stats-cache.json file. The skill parses this specific cache file to aggregate request and model-specific token data for calculating your remaining capacity.

Why does Claude Code stop working unexpectedly during development?▼

Unexpected service interruptions during development are typically caused by OAuth quota exhaustion. Monitoring token consumption and calculating remaining capacity proactively prevents these interruptions by tracking your usage limits across daily, weekly, or monthly periods.

Related Skills

Explore More Software Engineering Skills→
KIM-KYOUNG-OHKIM-KYOUNG-OH

usage-pattern-analyzer

Analyzes Claude Code session logs and stats-cache.json to identify usage trends and automation opportunities.

Community
Advanced
BrunoAMSilvaBrunoAMSilva

copilot-usage-metrics

Retrieves Copilot usage metrics for GitHub organizations and enterprises via REST API and CLI scripts.

Community
Intermediate
andy-austinandy-austin

connect-mcp-server

Connect MCP servers to Claude Code via HTTP, stdio, and SSH transports.

Community
Advanced
chiptoe-svgchiptoe-svg

add-dashboard

Add a local monitoring dashboard for NanoClaw deployments.

Community
Intermediate