# claudeusage

> Independent Claude Code usage tracker and public leaderboard. Open-source sync CLI. Not affiliated with Anthropic.

## Product facts

- CLI: npx claudeusage-sync. Requires Node.js 22+.
- Sync uploads numeric aggregates and private device/sync metadata, not prompts or source code.
- Weighted tokens = input + output + 1.25 * cache creation + 0.10 * cache reads.
- API-equivalent costs are estimates, not invoices or subscription charges. Unknown prices are unpriced.
- Public leaderboard is free and includes generated demo profiles disclosed by a board notice and individual profile notices. Demos are not real usage or endorsements and are excluded from uploaded-usage totals. Detailed user analytics require membership; demo profiles are public.
- Membership: 14-day card-upfront trial, then $1.99/month or $12.99/year. Auto-renews unless canceled.
- Public model mix and token composition are all-time. Timeline ranges are separate.

## Pages

- [Setup](https://www.claudeusage.com/docs)
- [Leaderboard](https://www.claudeusage.com/leaderboard)
- [Agent reference](https://www.claudeusage.com/for-agents)
- [Full guide text](https://www.claudeusage.com/llms-full.txt)
- [Privacy](https://www.claudeusage.com/privacy)
- [Why your Claude Code token counts look different](https://www.claudeusage.com/guides/claude-code-token-counts): Raw tokens, cache reads, and weighted tokens answer different questions. Here is how to compare them without confusing usage with a bill.
- [API-equivalent cost is not your Claude subscription bill](https://www.claudeusage.com/guides/claude-code-cost-vs-subscription): A profile can show thousands of dollars in estimated usage without you owing that amount. Here is what the cost number actually means.
- [Track Claude Code usage across your machines](https://www.claudeusage.com/guides/track-claude-code-usage): Install nothing globally. Preview your local usage, approve a device, and keep one profile for the machines you work on.
- [What a Claude Code usage tracker uploads](https://www.claudeusage.com/guides/claude-code-usage-privacy): The boundary between local session files, private sync metadata, and the numbers visible on a public profile.