中文 | 日本語 | 한국어 | Deutsch | Français | Español

ccclub.dev

Claude Code leaderboard among friends.

Get Started

npx ccclub init

It asks your name, gives you a 6-letter code. Send it to friends:

npx ccclub join YHAW6P

Done. Usage syncs automatically via Claude Code hook. No config, no signup, no account.

Once a friend joins, check the leaderboard:

ccclub

What gets uploaded

ccclub reads the local usage logs (~/.claude/projects/) that Claude Code already writes, bundles them into 30-minute summaries (token counts + cost), and uploads those numbers. No prompts, no code, no file paths, no project names — just counters. Run ccclub show-data to audit exactly what gets sent.

Commands

Everyday use — these four are all you need:

ccclub init                        # One-time setup, creates a group
ccclub join <CODE>                 # Join a friend's group
ccclub sync                        # Manual sync (also runs on session end)
ccclub                             # Show the leaderboard

More options:

ccclub -d 1                        # Time window: 1 / 7 / 30 / all
ccclub --cache                     # Include cache tokens in count
ccclub --all                       # Show all members, including those with no activity today
ccclub --global                    # Everyone who opted in
ccclub -g YHAW6P                   # Specific group

If you want more, it's there:

ccclub create                      # Make another group
ccclub profile                     # See your profile
ccclub profile --name "new name"   # Change display name
ccclub profile --avatar "URL"      # Custom avatar
ccclub profile --public            # Show up on global board
ccclub profile --private           # Hide from global (default)
ccclub show-data                   # See exactly what gets uploaded

Web Dashboard

Every group gets a live page:

https://ccclub.dev/g/YHAW6P

Period switcher (today / 7d / 30d / all time), avatars, auto-refresh every 5 minutes. There's also a global page at /g/global for public users.

Privacy

Uploads only this:

{
  "blockStart": "2025-02-13T00:00:00Z",
  "blockEnd": "2025-02-13T00:30:00Z",
  "inputTokens": 48210,
  "outputTokens": 12050,
  "cacheCreationTokens": 0,
  "cacheReadTokens": 31200,
  "totalTokens": 91460,
  "costUSD": 0.2184,
  "models": ["claude-sonnet-4-5-20250929"],
  "entryCount": 23
}

You are private by default — visible only in groups you've joined. Global leaderboard is opt-in (ccclub profile --public).

Architecture

packages/
  shared/     Types + constants
  cli/        ccclub — Commander.js CLI
  worker/     Cloudflare Worker — Hono API + KV + dashboard

Auto-sync: Claude Code SessionEnd + Stop hooks run ccclub sync --silent (throttled to once per 5 minutes).

Development

pnpm install
pnpm build
pnpm dev:worker                    # localhost:8787

# In another terminal
CCCLUB_API_URL=http://localhost:8787 ccclub init

License

MIT