ccusage
Fast local CLI to track tokens and estimated costs across Claude Code, Codex, and 12+ other coding agents. No data upload. Cache support. Offline mode.
Editor's Verdict
Key Takeaways
- All Sources by Default
- Focused Views
- Local Data Sources
- Cost Analysis
In-Depth Review: What is ccusage?
ccusage is a fast, local CLI tool that monitors token usage and cost estimates across 15+ popular coding agent CLIs, including Claude Code, Codex, OpenCode, and more. It reads usage logs directly from your machine—no data ever leaves your system. Features include cost analysis with cache token accounting, responsive terminal tables, JSON export, and offline mode with pre-cached pricing. Ideal for developers who want real-time visibility into their AI coding expenses without compromising privacy.
Core Features
All Sources by Default
View all detected supported coding agent CLI usage by default, including Claude Code, Codex, OpenCode, and many more.
Focused Views
Start with all detected CLIs, then narrow the same usage views to one source when needed.
Local Data Sources
Reads local usage logs from multiple coding CLIs without uploading your data.
Cost Analysis
Estimate USD spend from token counts and model pricing, with cache token accounting where available.
Enhanced Display
Responsive terminal tables stay readable across wide and narrow terminals.
JSON Output
Export data in structured JSON format for programmatic use.
Claude Code Features
Blocks and statusline remain separate because they depend on Claude-specific local data and hooks.
Cache Support
Tracks cache creation and cache read tokens separately.
Offline Mode
Use pre-cached pricing data without network connectivity.
Multiple Cost Modes
Supports auto, calculate, and display modes for accurate cost estimation.
Pricing
Open Source (Free)
- All sources by default
- Focused views
- Local data sources
- Cost analysis
- Enhanced display
- JSON output
- Claude Code features
- Cache support
- Offline mode
- Multiple cost calculation modes
Pros and Cons
Pros
- Open Source & FreeReleased under the MIT License, completely free to use and modify.
- Broad CLI SupportSupports 15+ coding agent CLIs including Claude Code, Codex, OpenCode, and more.
- Privacy-FirstAll data is read locally without uploading to any external server.
- Accurate Cost EstimationProvides detailed token and cost analysis with cache token accounting and multiple calculation modes.
- Offline CapableWorks offline with pre-cached pricing data, no network required.
Cons
- Limited to Supported CLIsOnly works with the specific coding agent CLIs listed; custom or lesser-known CLIs are not supported.
- Requires Local LogsDepends on local usage logs being present; no cloud or remote data aggregation.
- Claude Code Default RetentionClaude Code only retains logs for 30 days by default, limiting historical analysis unless configured otherwise.
- Claude-Only Advanced FeaturesBlocks and statusline features are exclusive to Claude Code data, not available for other sources.
- No Cloud Sync or SharingNo built-in cloud sync or team sharing capabilities; output is local only.
Use Cases & Recommended Professions
Software Engineer→ View Toolkit
Tracks token usage and costs when using AI coding assistants to optimize spending.
AI/ML Engineer→ View Toolkit
Monitors API costs and token consumption across multiple AI models and coding agents.
DevOps Engineer→ View Toolkit
Analyzes usage patterns and cost trends for AI-powered development tools in CI/CD pipelines.
Data Scientist→ View Toolkit
Evaluates token efficiency and pricing for data analysis tasks using coding agents.
Technical Project Manager→ View Toolkit
Oversees team spending on AI coding tools and ensures cost-effective usage.
Researcher→ View Toolkit
Studies token cost patterns and pricing models across different AI coding assistants.
Frequently Asked Questions
Alternative AI Tools
View Detailed Comparison →
CodeGPT
Bring your own API key for transparent, unlimited AI coding. Supports Claude, Gemini, OpenAI. Privacy-first, no middlemen. Trusted by 2M+ developers.
OpenCode
OpenCode is a free, open-source AI coding assistant supporting multiple providers (OpenAI, Anthropic, local models) with CLI/TUI, custom tools, and privacy-centric local execution.
Kilo
Free AI coding tool with 500+ models at cost. Open source, no lock-in. Works in VS Code, JetBrains, CLI, and cloud. Trusted by 3M+ developers.
Tabby
Self-hosted, secure AI coding assistant with code completion, answer engine, and inline chat. Private and flexible.
Continue
Create, share, and use custom AI code agents with Continue. Features agent, chat, edit modes, and autocomplete for VS Code and JetBrains.
Tabby
Accelerate coding with Tabby's AI-powered code completion, answer engine, and inline chat. Self-hosted, secure, and flexible. Supports VS Code, Neovim, IntelliJ, and more.
Cline
Cline is the open source AI coding agent that helps you ship secure code with Claude in VS Code, terminal, and more. Plan, act, and automate across your workflow.
Cassandra Research
Australia's leading AI-powered tax and legal research platform. Instant analysis of ITAA 1997, ATO rulings, and case law for professionals.
Scale Labs
Your hub for cutting-edge AI research on agents, safety, and evaluation. Explore leaderboards, model showdown rankings, and insightful blogs.
OpenCode
OpenCode: open source AI coding agent for terminal, IDE, or desktop. Free models, any provider, privacy-first. 160K+ GitHub stars.
OpenCode
OpenCode is an open-source, terminal-native AI coding assistant supporting Claude, GPT-4, Gemini, and local models. Boost productivity with agent mode and seamless CLI integration.
Deep Kondah
In-depth technical blog on AI, LLMs, cybersecurity, eBPF, and software engineering. Stay informed and ahead.
ℹ️ Curation Disclosure: The overview and features of ccusage were synthesized using AI and fact-checked by our curation team to ensure accuracy.
