For Claude Code developers

Know exactly
where your
money went.

Claude Code shows a running token total. claudeCost shows which subagent burned what, how full your context window is right now, and every dollar spent per project — ever.

View on GitHub ↗ npm start → localhost:7799
localhost:7799 — claudeCost
claudeCost dashboard — real-time cost and context monitoring for Claude Code
// The problem

Claude Code hides the bill until it's too late.

You're running a multi-agent workflow. Three subagents spin up. The context window fills. Compaction fires silently and drops context you needed.

Later you check your bill. $50 this week. Which project? Which session? Which agent? There's no answer in the UI.

claudeCost reads Claude's own JSONL session files and gives you a real-time breakdown — before the damage is done.

# without claudeCost

Session tokens: 284,921
Cost: ???
Agent breakdown: not available
Context fill: unknown
⚠ compaction fired (no warning)

# with claudeCost

main session $0.62
↳ code-reviewer $0.14
↳ test-runner $0.06
context fill: 65% · 130K / 200K
my-app (all time) $41.20 · 18 sessions
// What you get

Everything Claude Code
won't tell you.

01
Per-subagent cost attribution
Every agent in your workflow gets its own cost line. See exactly which subagent is expensive — in real time, not after the fact.
unique
02
Live context fill %
Watch your context window fill up in real time. Get a warning before compaction fires and silently discards context you depend on.
unique
03
Session drill-down
Click any project to expand its full session history. Every session: date, cost, turn count. Answer "what did this project cost me?" for any timeframe.
unique
04
Today / week / month / all time
Spend buckets across all time horizons, broken down by project. Know when you're approaching your weekly or monthly limit before you hit it.
spend visibility
05
Accurate to the cent
Prices match Anthropic's published API rates exactly. Input, output, cache creation, cache read, and web search tool calls are all priced separately.
precise
06
Zero config, zero dependencies
Reads directly from ~/.claude/projects via file watching. No API key, no database, no build step. npm start and open localhost:7799.
simple
// How it compares

Not the first.
But the most complete.

Feature claudeCost ccusage claude-code-dashboard claude-context-monitor
Web dashboard ✓ — ✓ —
Real-time context fill % ✓ — bar only ✓
Per-subagent cost ($) ✓ — — —
Today / week / month spend ✓ ✓ — —
All-time per-project cost ✓ monthly only — —
Per-session drill-down ✓ — — —
Web search tool pricing ✓ — — —
No API key or config ✓ ✓ ✓ ✓
// Get started

Up in 30 seconds.

1
Clone the repo
$ git clone https://github.com/
  ibrahimokdadov/claudecost.git
$ cd claudecost
2
Install dependencies
$ npm install
3
Start the dashboard
$ npm start
claudeCost running → http://localhost:7799
4
Start Claude Code
Open any project with Claude Code. The dashboard updates automatically as you work — no hooks required.
Requirements
Node.js 18+ · Claude Code (any version) · Windows, macOS, or Linux
How it works
Watches ~/.claude/projects/ via chokidar. Reads JSONL session files incrementally. No hooks, no API calls, no external services.
Optional: set a budget
Open the dashboard and enter a monthly limit. The budget tile turns orange when you hit 80% of your limit (configurable).
Custom port
CLAUDECOST_PORT=8080 npm start