claude-spend
A Claude Code plugin with two complementary cost views for anyone working with Claude / the Anthropic API:
| Slash command | Source of numbers | Authority | Per-project breakdown |
|---|
/claude-spend | Anthropic Admin API cost_report | Billed | Per-model only |
/claude-usage | ccusage parsing ~/.claude/projects/**/*.jsonl | Estimate | Yes (rich) |
/claude-spend answers "what did Anthropic actually charge me?" /claude-usage answers "which of my projects/sessions/tools burned the most tokens?" Use the right one for the question.
There's also an opt-in statusline (statusline.ps1, Windows/PowerShell) that paints model + context-window % + cache stats + per-session cost into Claude Code's status bar every turn — see the Statusline section below.
Example output
/claude-spend 7:
Anthropic billed cost — last 7 days (since 2026-05-18 UTC)
================================================================
TOTAL: $42.71
By day:
2026-05-18 $ 3.21 ██████
2026-05-19 $ 5.04 █████████
...
By model:
$ 21.12 claude-opus-4-7
$ 14.06 claude-sonnet-4-6
$ 7.53 claude-haiku-4-5
/claude-usage project:
| Project | Cost-eq | Sessions | Tokens (M) | Cache % |
|----------------------------------|---------|----------|------------|---------|
| C:\Users\you\Projects\claude-spend| $34.18 | 12 | 8.3 | 87% |
| C:\Users\you\Projects\experiments | $18.42 | 7 | 4.9 | 82% |
| ... |
Install
Option 1 — direct from git (simplest)
/plugin install https://github.com/aasadi1978/claude-spend.git
Option 2 — add a marketplace, then install
/plugin marketplace add aasadi1978/claude-spend
/plugin install claude-spend
Option 3 — local install
Clone the repo, then:
/plugin install /absolute/path/to/claude-spend
After install, /help lists both /claude-spend and /claude-usage, and Claude will also invoke the skills on natural-language queries.
One-time setup
For /claude-spend (Admin API key)
Required only if you want the billed cost view.
- Sign in at https://console.anthropic.com/settings/admin-keys with an account that has admin role on the organization.
- Create a new Admin Key (distinct from the regular Messages API key). Copy it once — it won't be shown again.
- Save it as a single line, no quotes, no trailing newline to:
- macOS / Linux:
~/.claude/.anthropic-admin-key
- Windows:
C:\Users\<you>\.claude\.anthropic-admin-key
The script resolves the path via Path.home() — same plugin works on every OS.
For /claude-usage (Python deps + ccusage)
Required only if you want the local usage view.
# Python deps for the per-project / chart / report / dashboard subcommands
pip install pandas plotext plotly streamlit
# ccusage CLI (downloaded automatically by npx on first run — no manual install needed)
# Just make sure node/npx is on PATH: npx --version
The plain /claude-usage (daily summary) only needs npx — Python deps are only for project, --g, --graph, and --report subcommands. Each script catches ModuleNotFoundError and prints the install command, so you'll find out exactly when you need them.
Usage
/claude-spend — billed cost
/claude-spend # last 30 days
/claude-spend 7 # last 7 days
/claude-spend 90 # last quarter
/claude-spend 365 # last year (the max)
Natural language: "what's my Anthropic spend this month?", "how much have I been charged for Claude this week?"
/claude-usage — local token + cost breakdown via ccusage
/claude-usage # daily rollup (default)
/claude-usage daily # same as above
/claude-usage session # per-session breakdown
/claude-usage current # just this session (resolves the UUID for you)
/claude-usage monthly # monthly rollup
/claude-usage project # per-project Markdown table (needs pandas)
/claude-usage --g # terminal bar charts (needs pandas + plotext)
/claude-usage --graph # Streamlit dashboard (needs pandas + plotly + streamlit)
/claude-usage --report # CSV + Markdown report (needs pandas)
/claude-usage --live # printout: how to run the live 5h burn-rate TUI yourself
Natural language: "per-project cost", "how many tokens have I used", "show my ccusage report".
