Claude Token Lens

claude-token-lens

[](https://www.npmjs.com/package/claude-token-lens) [](https://www.npmjs.com/package/claude-token-lens) [](https://github.com/wassimbensalem/claude-token-lens)

See exactly what's burning your Claude Code quota — **live**.

Real-time token attribution for Claude Code sessions. Shows burn rate, quota progress, and a per-source breakdown: by tool, agent, skill, and MCP server.


---

The problem

You're running Claude Code and suddenly you've burned through your quota. But *what* consumed it?

• A skill that reads 40k tokens of context on every turn?
• An agent spawning sub-agents that each spin up their own context?
• An MCP tool hitting a large endpoint repeatedly?
• Long Bash output being read back into the model?

The built-in `/stats` command shows a total percentage — but no breakdown. **claude-token-lens** reads the same session files Claude Code writes and shows you a live, per-source attribution table.

---

Install

npm install -g claude-token-lens
claude-token-lens live

Or run without installing:

npx claude-token-lens live
npx claude-token-lens sessions
npx claude-token-lens report

---

Quick start

# 1. Tell the tool which plan you're on (one-time)
claude-token-lens setup

# 2. Run from inside any project you're working on with Claude Code
cd ~/my-project
claude-token-lens live

---

Commands

`live` — real-time dashboard

claude-token-lens live
claude-token-lens live -p /path/to/project

Opens a live terminal UI that refreshes as Claude Code writes new turns.

claude-token-lens                                        v0.1.0  plan: MAX5 (~88k est.)

Window  ████████████░░░░░░░░░░░░░░░░░░  42%  36,960 / 88,