ccusage is a command-line tool that reads the usage logs coding agents keep on your computer and turns them into reports. Run one command and it shows tokens and estimated cost in US dollars by day, week, month or session, for Claude Code, Codex, OpenCode, Gemini CLI, goose and many more. It can also watch Claude Code's 5-hour usage windows live. It suits anyone who uses AI coding agents and wants to see where their usage goes.
It reads the data already on your computer, so you see usage across many coding agents in one table without signing in anywhere.
Before you start
1A computer with macOS, Windows or Linux.
2Node.js or Bun on your computer
3A coding agent, such as Claude Code or Codex, already used on the same computer
✓Free. Nothing to pay.
How to start
Install itPaste the install request into an AI agent you already use, or run the official command yourself or follow the official guide.macOS, Windows, Linuxnpx ccusage@latestmacOS, Windows, Linuxbunx ccusagemacOS, Windows, Linuxnpm install -g ccusage
Set it upFollow the first-run steps in the official guide.
Give it a first taskDescribe what you want in your own words, and check the first result before relying on it.
Steps follow the creator's instructions.
Stuck setting it up?
Tell us what happened. We confirm scope and price before any paid work.