Analyze your Claude Code or Droid token usage and costs from local JSONL files with multi-provider support — incredibly fast and informative!
better-ccusage is a fork of the original ccusage project that addresses a critical limitation: while ccusage focuses exclusively on Claude Code usage with Anthropic models, better-ccusage extends support to external providers that use Claude Code with different providers like Anthropic, Zai, Dashcope and many models like glm-4.5, glm-4.6, kat-coder, sonnet-4, sonnet-4.5 and Qwen-Max etc..
The original ccusage project is designed specifically for Anthropic's Claude Code and doesn't account for:
- Zai providers that use Claude Code infrastructure with their own models
- GLM-4.5, GLM-4.6, kat-coder models from other AI providers
- Multi-provider environments where organizations use different AI services through Claude Code
better-ccusage maintains full compatibility with ccusage while adding comprehensive support for these additional providers and models.
📊 better-ccusage - Enhanced Claude Code/Droid Usage Analyzer with Multi-Provider Support
The main CLI tool for analyzing Claude Code/Droid Usage from local JSONL files with support for multiple AI providers including Anthropic, Zai, and GLM-4.5, GLM-4.6 models. Track daily, monthly, and session-based usage with beautiful tables and live monitoring.
🤖 @better-ccusage/codex - OpenAI Codex Usage Analyzer
Companion tool for analyzing OpenAI Codex usage. Same powerful features as better-ccusage but tailored for Codex users, including GPT-5 support and 1M token context windows.
🔌 @better-ccusage/mcp - MCP Server Integration
Model Context Protocol server that exposes better-ccusage data to Claude Desktop and other MCP-compatible tools. Enable real-time usage tracking directly in your AI workflows.
Thanks to better-ccusage's incredibly small bundle size, you can run it directly without installation:
# Recommended - always include @latest to ensure you get the newest version
npx better-ccusage@latest
bunx better-ccusage
# Alternative package runners
pnpm dlx better-ccusage
pnpx better-ccusage
# Using deno (with security flags)
deno run -E -R=$HOME/.claude/projects/ -S=homedir -N='raw.githubusercontent.com:443' npm:better-ccusage@latest💡 Important: We strongly recommend using
@latestsuffix with npx (e.g.,npx better-ccusage@latest) to ensure you're running the most recent version with the latest features and bug fixes.
Analyze OpenAI Codex usage with our companion tool @better-ccusage/codex:
# Recommended - always include @latest
npx @better-ccusage/codex@latest
bunx @better-ccusage/codex@latest # ⚠️ MUST include @latest with bunx
# Alternative package runners
pnpm dlx @better-ccusage/codex
pnpx @better-ccusage/codex
# Using deno (with security flags)
deno run -E -R=$HOME/.codex/ -S=homedir -N='raw.githubusercontent.com:443' npm:@better-ccusage/codex@latest
⚠️ Critical for bunx users: Bun 1.2.x's bunx prioritizes binaries matching the package name suffix when given a scoped package. For@better-ccusage/codex, it looks for acodexbinary in PATH first. If you have an existingcodexcommand installed (e.g., GitHub Copilot's codex), that will be executed instead. Always usebunx @better-ccusage/codex@latestwith the version tag to force bunx to fetch and run the correct package.
Integrate better-ccusage with Claude Desktop using @better-ccusage/mcp:
# Start MCP server for Claude Desktop integration
npx @better-ccusage/mcp@latest --type http --port 8080This enables real-time usage tracking and analysis directly within Claude Desktop conversations.
# Basic usage
npx better-ccusage # Show daily report (default)
npx better-ccusage daily # Daily token usage and costs
npx better-ccusage monthly # Monthly aggregated report
npx better-ccusage session # Usage by conversation session
npx better-ccusage blocks # 5-hour billing windows
npx better-ccusage statusline # Compact status line for hooks (Beta)
# Live monitoring
npx better-ccusage blocks --live # Real-time usage dashboard
# Filters and options
npx better-ccusage daily --since 20250525 --until 20250530
npx better-ccusage daily --json # JSON output
npx better-ccusage daily --breakdown # Per-model cost breakdown
npx better-ccusage daily --timezone UTC # Use UTC timezone
npx better-ccusage daily --locale ja-JP # Use Japanese locale for date/time formatting
# Project analysis
npx better-ccusage daily --instances # Group by project/instance
npx better-ccusage daily --project myproject # Filter to specific project
npx better-ccusage daily --instances --project myproject --json # Combined usage
# Compact mode for screenshots/sharing
npx better-ccusage --compact # Force compact table mode
npx better-ccusage monthly --compact # Compact monthly reportbetter-ccusage extends the original ccusage functionality with support for:
- Track usage when using Zai's Claude Code/Droid integration
- Support for Zai-specific model variants
- Accurate cost calculation for Zai pricing
- Full support for GLM-4.5, GLM-4.6 models from various providers
- Token counting and cost calculation optimized for GLM-4.5, GLM-4.6
- Compatibility with existing Claude Code workflows
- Automatic detection of provider from usage data
- Separate reporting and aggregation by provider
- Unified interface for multi-provider environments
- 📊 Daily Report: View token usage and costs aggregated by date
- 📅 Monthly Report: View token usage and costs aggregated by month
- 💬 Session Report: View usage grouped by conversation sessions
- ⏰ 5-Hour Blocks Report: Track usage within Claude's billing windows with active block monitoring
- 📈 Live Monitoring: Real-time dashboard showing active session progress, token burn rate, and cost projections with
blocks --live - 🚀 Statusline Integration: Compact usage display for Claude Code status bar hooks (Beta)
- 🤖 Multi-Provider Model Tracking: Track models from Anthropic, Zai, Dashcope and other providers
- 📊 Model Breakdown: View per-model cost breakdown with
--breakdownflag - 📅 Date Filtering: Filter reports by date range using
--sinceand--until - 📁 Custom Path: Support for custom Claude data directory locations
- 🎨 Beautiful Output: Colorful table-formatted display with automatic responsive layout
- 📱 Smart Tables: Automatic compact mode for narrow terminals (< 100 characters) with essential columns
- 📸 Compact Mode: Use
--compactflag to force compact table layout, perfect for screenshots and sharing - 📋 Enhanced Model Display: Model names shown as bulleted lists for better readability
- 📄 JSON Output: Export data in structured JSON format with
--json - 💰 Cost Tracking: Shows costs in USD for each day/month/session
- 🔄 Cache Token Support: Tracks and displays cache creation and cache read tokens separately
- 🔌 MCP Integration: Built-in Model Context Protocol server for integration with other tools
- 🏗️ Multi-Instance Support: Group usage by project with
--instancesflag and filter by specific projects - 🌍 Timezone Support: Configure timezone for date grouping with
--timezoneoption - 🌐 Locale Support: Customize date/time formatting with
--localeoption (e.g., en-US, ja-JP, de-DE) - ⚙️ Configuration Files: Set defaults with JSON configuration files, complete with IDE autocomplete and validation
- 🚀 Ultra-Small Bundle: Unlike other CLI tools, we pay extreme attention to bundle size - incredibly small even without minification!
| Feature | ccusage | better-ccusage |
|---|---|---|
| Anthropic Models | ✅ | ✅ |
| Zai Provider | ❌ | ✅ |
| GLM-4.5 Models | ❌ | ✅ |
| GLM-4.6 Models | ❌ | ✅ |
| kat-coder | ❌ | ✅ |
| Multi-Provider Support | ❌ | ✅ |
| Provider Detection | ❌ | ✅ |
| Cost Calculation by Provider | ❌ | ✅ |
| Original ccusage Features | ✅ | ✅ |