>Frequently Asked Questions
Everything you need to know about ccboard, Claude Code usage tracking, and how the leaderboard works.
[01]What is ccboard?
ccboard is a leaderboard that ranks developers by their Claude Code CLI usage. It shows estimated costs, token counts, daily activity streaks, and model breakdowns — giving you and your team visibility into how much you're actually using Claude Code as a development tool.
[02]Is ccboard free?
Yes. ccboard is completely free to use. There are no paid tiers, no ads, and no data monetization.
[03]Who is ccboard for?
Any developer using Claude Code (Anthropic's CLI coding assistant). Whether you're curious about your own usage, want to benchmark against peers, or are a team lead tracking adoption — ccboard gives you the numbers.
[04]How do I join the leaderboard?
Sign in with your GitHub account, then follow the setup guide in your dashboard. You'll install ccusage (a local CLI tool), run a single sync command, and your data appears on the leaderboard within seconds.
[05]What is ccusage?
ccusage is the companion CLI that reads Claude Code's local log files on your machine, extracts aggregate metrics (tokens and costs), and sends them to ccboard. It never reads your code, project names, or conversation content.
[06]What data does ccboard track?
Only aggregate Claude Code metrics — input, output, cache-creation, and cache-read tokens per day, the estimated cost at API pricing, and which Claude models you used (Sonnet, Opus, Haiku, etc.).
[07]What does ccboard NOT track?
It does not track any code, file paths, project names, git branches, session IDs, conversation content, or anything from claude.ai web chat. It also does not track API tokens used by your own applications.
[08]Is my data private?
The CLI enforces a strict privacy allowlist — only aggregate token counts and costs leave your machine. No code, prompts, or project context is ever transmitted. Your profile on ccboard shows only the metrics you've synced.
[09]Where does the data come from?
ccusage reads the JSONL log files that Claude Code stores locally in ~/.claude/ on your machine. No API calls to Anthropic are made — everything is parsed from your local logs.
[10]What does the "cost" number mean?
It's the estimated cost of your token usage at Anthropic's published API rates. This is a calculated estimate, not an actual bill. Think of it as a proxy for how intensively you're using Claude Code.
[11]How are streaks calculated?
A streak counts consecutive days where you used Claude Code. If you use it on Monday, Tuesday, and Wednesday, that's a 3-day streak. Missing a day resets it. The leaderboard shows your current active streak.
[12]How is ranking determined?
By default, users are ranked by estimated cost (highest first). You can also sort by total tokens, number of active days, or current streak. Each column is sortable, and you can filter by time period (this week, this month, or all time).
[13]Does ccboard track API usage from my own apps?
No. Only Claude Code CLI usage is tracked. If you call the Anthropic API from your own code, that usage is completely separate and not included in ccboard.
[14]Which Claude models are tracked?
All models available through Claude Code — including Sonnet, Opus, and Haiku across their version families. Your profile page shows a detailed breakdown of which models you've used and how much.
[15]How often is the leaderboard updated?
The leaderboard refreshes every hour. Your individual data updates the moment you run a sync from the CLI — it will be reflected on the next leaderboard refresh.
[16]Can I see my historical usage over time?
Yes. Your profile page includes an activity heatmap, a usage chart over time, and a model breakdown chart. You can view these by clicking your name on the leaderboard.