---
title: ccusage Usage Analysis
---

# ccusage Usage Analysis

[ccusage](https://github.com/ryoppippi/ccusage) is a CLI tool for analyzing Claude Code/Codex CLI usage from local JSONL files, providing incredibly fast and informative token usage and cost analysis.

## What is ccusage

ccusage is a powerful usage analysis tool designed to help developers understand and optimize AI-assisted development costs. It provides detailed statistical reports by parsing local log files.

## Core Features

- **📊 Multi-dimensional Reports**: Daily, weekly, monthly usage reports
- **💰 Cost Analysis**: Precise calculation of token consumption and corresponding dollar costs
- **🤖 Model Breakdown**: Detailed usage ratios for different models (Claude Opus/Sonnet/Haiku)
- **📈 Trend Analysis**: Visualized usage trend changes
- **🔌 Easy Integration**: Supports JSON/CSV export for easy integration with other tools
- **🚀 Status Bar Support**: Integrated with CCometixLine for real-time status bar display

## Usage Guide

ccusage is fully integrated into ZCF and can be used directly via CLI commands.

For detailed usage commands, parameter descriptions, and export formats, please refer to the CLI documentation:

👉 **[Usage Analysis Command Details](../cli/ccu.md)**

## Learn More

- [CCometixLine Status Bar](cometix.md) - View usage in real-time
- [ccusage Official Documentation](https://ccusage.com/) - View complete documentation
