claudeusage

privacy

Privacy

claudeusage is built around a simple promise: only aggregate usage numbers leave your machine, and only aggregate numbers are ever public. This page explains exactly what that means.

Last updated June 2026

What the CLI uploads

The claudeusage-sync CLI reads your local Claude Code logs in ~/.claude/projects/, sums them locally, and uploads only numeric totals:

  • API-equivalent cost in USD
  • active hours and session counts
  • input, output, and cache token totals
  • per-model usage mix
  • day-level activity used to draw your contribution grid

The CLI is open source (MIT), so you can read every line of what it sends: claudeusage-sync.

What never leaves your machine

  • prompts and responses
  • your code and file contents
  • raw Claude Code JSONL files
  • file paths and project names
  • individual message and request IDs (only counts are sent)

To merge usage across your devices, the CLI uploads a one-way hash of your machine name (SHA-256 of hostname + OS username). Your raw hostname and username never leave your machine.

What is never shown publicly

Every public response is filtered through a server-side allow-list, so these are never visible on a profile or the leaderboard:

  • your email address and sign-in provider
  • machine identifiers and hashes
  • sync tokens
  • exact timestamps — public profiles are day-level only

Country

We store a coarse, nation-level country code (for example, us) derived once at sign-up from your connection’s region. We never store your IP address and never derive a precise location. If your region is unknown, your country is simply left blank.

Identity and anonymity

You sign in with Google or GitHub. Your email and provider stay private. You can choose a public display name or stay anonymous (shown as anonymous-…), and you can switch between the two at any time.

Deletion

You can delete your account from the dashboard. Deletion removes your public profile and revokes all sync tokens. Aggregated, fully anonymized counts that cannot be tied back to you may be retained.

Not affiliated with Anthropic

claudeusage is an independent project and is not affiliated with, endorsed by, or sponsored by Anthropic. “Claude” is used descriptively to refer to Anthropic’s Claude models.