---
slug: "ccusage"
name: "ccusage"
effect: "Reports token usage and costs for Claude Code, Codex and other coding agent CLIs from local data"
category: "devtool"
url: "https://ccusage.com"
github: "ccusage/ccusage"
pricing: "open-source"
license: "MIT"
tags: ["cli", "token-usage", "cost-tracking", "claude-code", "codex"]
platforms: ["claude-code", "codex", "gemini-cli"]
install_kind: "cli"
date_added: "2026-10-14"
drop_score: 52
stars: 19007
pushed_at: "2026-10-15T00:41:03Z"
signals_status: "ok"
signals_fetched_at: "2026-10-15T01:18:54.508Z"
page: "https://agenttooldrop.com/tools/ccusage"
---

# ccusage

Reports token usage and costs for Claude Code, Codex and other coding agent CLIs from local data

Category: Devtools. Pricing: Open source. License: MIT.

Platforms: claude-code, codex, gemini-cli.

## Why you would want it

ccusage reads the usage data that coding agent CLIs store locally and turns it into daily, weekly, monthly and session reports, with per-model breakdowns and separate cache token counts. One report covers Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot CLI and more than a dozen other tools, and there are Claude Code extras such as 5-hour billing window reports and a status line integration. Output is a table or JSON, and an offline mode uses cached pricing data.

## Best for

- Tracking spend across several coding agents
- Claude Code users watching 5-hour usage windows
- Exporting usage as JSON for your own dashboards

## Use it when

You want to see how many tokens and dollars your coding agent sessions use, by day, model, session or project.

## Skip it if

You need team-wide spend tracking: it only reads local data on the machine where it runs. Costs are calculated from LiteLLM pricing data, not read from your provider bill.

## Editor note

Moved from ryoppippi/ccusage to ccusage/ccusage.

## Install

Run with npx:

```sh
npx ccusage@latest
```

Source: https://github.com/ccusage/ccusage#readme

## Live signals

Fetched 2026-10-15T01:18:54.508Z (status: ok).

- Repository: ccusage/ccusage
- Stars: 19,007
- Forks: 877
- Open issues and PRs: 3
- License (GitHub): NOASSERTION
- Last push: 2026-10-15
- Latest release: v20.0.33 (2026-10-14)

## Links

- Website: https://ccusage.com
- GitHub: https://github.com/ccusage/ccusage
- Install instructions verified at: https://github.com/ccusage/ccusage#readme
- Source for this entry: https://github.com/ccusage/ccusage
- AgentToolDrop page: https://agenttooldrop.com/tools/ccusage
- Full catalog (JSON): https://agenttooldrop.com/tools.json