Claude Code usage report
Show what your Claude Code sessions cost, in tokens and dollars per day, week, project, model or session, from local transcripts with no network.
Free
Works with the AI Agents you already use
Claude Code
Cursor
Codex CLI
Muse
Dots+22 moreClaude CodeCursorCodex CLIMuseDots
OpenClaw
Manus
Grok
Grok Bot+18 agentsClaude Code usage report
Example session with this skill installed
/claude-code-usage-report
In words: what did my Claude Code sessions cost in the last 7 days, by day, and which sessions cost the most?
- Read your context and instructions
- Compiled the claude code usage
The skill ran its bundled script on your transcripts (here: a config folder with three synthetic sessions, so the numbers are small) and printed:
Claude Code usage 2026-10-09 to 2026-10-15 (7 days), by day
Day Reqs Input Output Cache wr Cache rd Fresh Cost
---------- ---- ----- ------ -------- -------- ----- -----
2026-10-09 0 0 0 0 0 0 $0.00
2026-10-10 0 0 0 0 0 0 $0.00
2026-10-11 0 0 0 0 0 0 $0.00
2026-10-12 1 500k 80k 100k 2M 680k $1.23
2026-10-13 0 0 0 0 0 0 $0.00
2026-10-14 2 130k 32k 30k 900k 192k $1.51
2026-10-15 3 380k 100k 150k 3.2M 630k $4.93
---------- ---- ----- ------ -------- -------- ----- -----
Total 6 1.01M 212k 280k 6.1M 1.5M $7.67
Most expensive sessions
Cost Fresh Project Last Session
----- ----- ------- ----- ----------------------------------
$4.10 635k alpha 10-15 Synthetic session one (00000001)
$2.34 187k beta 10-15 Synthetic session two (00000002)
$1.23 680k alpha 10-12 Synthetic session three (00000003)
Fresh = input + output + cache writes. Cache reads are cheap and listed apart.
Dollars are API list prices. On a subscription plan nothing is billed per token: read them as how fast limits fill.
Next steps the skill offers: report --by project (the same week per project), report --by model, today (cost, fresh tokens, cache reads, requests and the split by project for today), and --json on any of them. Nothing is changed: the script reads the transcripts and keeps an index of token counts under cost-guard/ in the config folder.
Connects securely to your tools. The creator never sees your data.
About this skill
Claude Code usage report shows what your Claude Code sessions cost. Type /claude-code-usage-report and it prints a table of tokens and dollars for the last 7 days, or grouped by project, model, week or session, with a quick view of today and this week and a JSON option. It is free. Dollars are API list prices; on a subscription plan nothing is billed per token, so read them as how fast your limits fill.
Everything stays on your machine. The skill runs a small bundled Node script (Node 18 or newer, no dependencies, MIT license) that reads the transcripts under your Claude config folder (CLAUDE_CONFIG_DIR, default ~/.claude) and adds up their usage records. It sends nothing anywhere and has no network code. To keep repeat runs fast it saves an index of token counts, session titles and project folders in a cost-guard folder inside your Claude config folder. The index holds no prompts, answers or tool output.
The script is the bin, src, LICENSE and package.json of claude-cost-guard, unchanged from its release tag v1.0.1. For daily and weekly budgets with warnings inside Claude Code, see the full open-source tool: https://github.com/nrzz/claude-cost-guard
How to use
Skills on Agensi run inside your AI agent. Copy the prompt, paste it into your agent, and it connects to Agensi and installs this skill for you. If a payment is needed, your agent shows it to you first.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scanned
Verified clean 1 day ago
- Free to download with an account
Requires