Claude Usage Analytics

Inspired by Claude Goblin by Kurt Buhler - A brilliant tool for analyzing Claude usage data. Kurt's innovative approach to persisting usage history beyond Claude Code's rolling 30-day window inspired this entire extension. Check out his work!

What is Claude Usage Analytics?

Claude Usage Analytics is a VS Code extension that provides real-time insights into your Claude Code usage. Built by Reid Havens of Analytic Endeavors, this tool transforms raw usage data into actionable intelligence—helping you understand costs, monitor usage patterns, and discover insights in your AI-assisted development workflow.

Track your Claude Code usage with real-time analytics in VS Code. Monitor costs, tokens, and subscription tier. Explore personality insights, achievement badges, and coding patterns. Features a 4-tab dashboard and 7 status bar widgets showing lifetime costs, daily spending, cache efficiency, and usage trends.

Screenshots

Status Bar with Tooltip

View Dashboard Screenshots

Overview

Overview Report

Cost Analysis

Cost Report

Messages

Messages Report

Personality

Personality Report

Key Features

Status Bar Widgets

Seven live statistics widgets always visible at a glance:

Widget	Icon	Displays	Click Action
Local History Cost	`$(graph)`	Total spending (local storage)	Opens Overview tab
Today's Cost	`$(calendar)`	Real-time current day usage	Opens Cost tab
Messages	`$(comment-discussion)`	Total message count	Opens Messages tab
Tokens	`$(symbol-number)`	Token consumption	Opens Messages tab
Personality	Emoji	Politeness score %	Opens Personality tab
Activity	Chart	Code blocks generated	Opens Personality tab
Subscription	`$(pulse)`	Subscription tier (Max 20x, Pro, etc.)	Opens Overview tab

Interactive Dashboard

A comprehensive 4-tab analytics panel with deep insights:

Tab	Content
Overview	Hero stats, quick metrics, daily activity visualization, model distribution breakdown
Cost	Detailed cost analysis, 7-day trends, monthly projections, highest spending days, cache savings calculations
Messages	Token breakdown (input/output/cache), peak usage hours, activity patterns, session statistics
Personality	Achievement badges, personality trait scores, expression analysis, mood & sentiment tracking

Feature Details

Cost Analytics

Understand exactly where your tokens go

Real-time cost tracking with model-specific pricing (Opus vs Sonnet rates)
Real-time today's cost calculated directly from conversation files
Daily/weekly/monthly breakdowns with trend analysis
Cost projections based on your usage patterns
Cache savings calculator showing money saved through prompt caching
Comparison metrics vs yesterday and vs average day
Highest spending day identification

Personality Insights

Discover your unique interaction style

Politeness Score — Measures "please" and "thanks" frequency
Frustration Index — Tracks caps lock usage, expletives, and facepalms
Curiosity Score — Questions asked per message ratio
Achievement Badges — Unlock milestones as you hit usage goals:
- Token Titan (1M+ tokens)
- Conversation Master (1000+ messages)
- Streak Champion (7+ day streak)
- Politeness Pro (80%+ politeness)
- ...and more!

Subscription Display

Know your current plan at a glance

Subscription tier display — Shows Max 20x, Max, Pro, or Free
Plan information from Claude Code credentials
Green status indicator when tier is detected

Activity Tracking

Analyze your coding patterns

Code blocks generated with line counts
Top programming languages used
Request type distribution (debugging, features, explanations, refactoring)
Peak hours analysis — when you're most active
Night owl vs early bird scoring

Note: Code block statistics are collected from your extension install date forward. To include historical code stats, use the backfill script with your Claude.ai data export.

Privacy & Security

This extension prioritizes your privacy:

Aspect	Implementation
Data Location	All data stays on your machine
Network Calls	None — fully offline operation
Telemetry	None — zero tracking or analytics
Free Forever	Always free to use; source is not distributed to prevent repackaging and resale

Data Sources:

~/.claude/stats-cache.json — Token usage and model statistics (Claude Code's rolling 30-day window, updated periodically by Claude Code)
~/.claude/analytics.db — SQLite database preserving your full usage history (managed by this extension)
~/.claude/conversation-stats-cache.json — Personality and code stats (updated by backfill script)
~/.claude/projects/*/ — Conversation history for personality analysis and real-time today's cost
~/.claude/.credentials.json — Subscription tier information (read-only). On macOS, credentials live in the system Keychain (service Claude Code-credentials) and are read via the security CLI; macOS may prompt once to allow access.

Note: Today's stats may show $0.00 if Claude Code hasn't updated its cache yet. End your session or wait for the automatic cache update to see current data.

Data & History

Initial Data Window

When you first install the extension, your "Local History" stats will only include data from Claude Code's cache file—typically the last ~30 days. This is because Claude Code maintains a rolling window and doesn't preserve older data.

Automatic History Accumulation

Once installed, the extension automatically saves your usage data to a local SQLite database (~/.claude/analytics.db). From this point forward, your history is preserved forever—even as Claude Code's cache rolls over.

Over time, your "Local History" totals will grow to include months or years of usage data.

Managing History

Use the "Claude Analytics: Clear History Before Date" command to remove old data:

Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
Type "Claude Analytics: Clear History"
Select a cutoff date
Confirm deletion

This is useful if you want to reset your stats or remove data from a specific period.

Backfill from Claude.ai Export (Optional)

Want to import your full Claude.ai conversation history? You can backfill data from a Claude.ai data export:

Export your data from claude.ai (Settings > Account > Export Data)
Extract the downloaded ZIP file
Run the included Python script:

python backfill_claude_export.py "path/to/data-export-folder"

This imports:

Daily message counts and estimated token usage
Estimated API-equivalent costs
Code blocks and lines of code (with language breakdown)
Personality analysis (questions, please/thanks, etc.)
Activity patterns (peak hours, night owl/early bird scores)
Claude thinking time analytics
User active time estimates

Why backfill? The extension can only track code blocks and personality stats from the day you install it. Running the backfill script imports your complete history from Claude.ai, giving you accurate lifetime statistics.

See the backfill section in the extension's dashboard for detailed instructions.

External Usage Data (Copilot, Forge, etc.)

Import usage data from any external AI tool into your analytics dashboard. Create a JSON file at ~/.claude/external-additions.json:

{
  "source": "copilot-cli",
  "lastUpdated": "2026-04-09T12:00:00Z",
  "rows": [
    { "date": "2026-04-01", "cost": 1.23, "messages": 15, "tokens": 50000, "sessions": 3 }
  ],
  "modelRows": [
    {
      "date": "2026-04-01",
      "model": "claude-sonnet-4-6",
      "input_tokens": 30000,
      "output_tokens": 10000,
      "cache_read_tokens": 8000,
      "cache_write_tokens": 2000
    }
  ]
}

External data merges seamlessly into all dashboard views, streaks, and lifetime totals. The JSON file is the source of truth and is re-loaded on every VS Code restart.

Field	Required	Description
`source`	Yes	Identifier for the data source (e.g., "copilot-cli")
`rows`	Yes	Daily aggregate usage data
`modelRows`	No	Per-model token breakdown for accurate cost calculation

GitHub Gist Backup

Sync your analytics data across multiple machines using GitHub Gist.

Setup

Create a GitHub Personal Access Token:
- Go to GitHub Settings > Developer Settings > Personal Access Tokens > Tokens (classic)
- Click "Generate new token (classic)"
- Give it a descriptive name like "Claude Analytics Backup"
- Select the gist scope (allows creating and updating Gists)
- Click "Generate token" and copy it immediately
Configure the Extension:
- Open VS Code Settings (Ctrl+, or Cmd+,)
- Search for "Claude Usage Gist"
- Enable Gist Sync: Enabled
- Paste your token in Gist Sync: Token
- (Optional) Set a specific Gist ID if syncing to an existing Gist
Sync Options:
- Auto-sync: Enabled by default when Gist sync is enabled - automatically syncs on each data update
- Manual sync: Run "Claude Analytics: Sync to Gist" command from Command Palette
- Import: Run "Claude Analytics: Import from Gist" to restore data from a backup

Multi-Machine Setup

Set up Gist sync on your primary machine (this creates the Gist automatically)
Open VS Code Settings and copy the Gist Sync: Gist Id value
On secondary machines:
- Configure with the same token
- Paste the Gist ID
- Run "Claude Analytics: Import from Gist" to sync historical data

Security Notes

Your token is stored in VS Code user settings (not workspace settings)
Gists are created as private by default
The database contains only usage statistics - no conversation content
Never share your Personal Access Token

Installation

Option 1: From VS Code Marketplace (Recommended)

Search for "Claude Usage Analytics" in the VS Code Extensions panel, or install via command line:

code --install-extension analyticendeavors.claude-usage-analytics

Option 2: From .vsix

Download the latest .vsix from the Releases page and install manually:

code --install-extension claude-usage-analytics-1.1.14.vsix

Requirements

Requirement	Details
VS Code	Version 1.95.0 or higher
Claude Code CLI	Must be installed and authenticated
Operating System	Windows 10/11, macOS, or Linux
Node.js	v18+ (included with VS Code)

Pre-requisites

Install Claude Code CLI: Follow Anthropic's installation guide
Authenticate: Run claude auth login to authenticate
Verify: Run claude --version to confirm installation

Usage Guide

The extension adds widgets to your VS Code status bar:

Left side: Cost, messages, tokens, personality, activity stats
Right side: Subscription tier indicator

Click any widget to open the dashboard focused on the relevant tab. Each tooltip shows "Click to open [Tab Name]" for easy navigation.

Keyboard Shortcuts

Shortcut	Action
`Ctrl+Alt+C`	Show Analytics Panel
`Ctrl+Alt+R`	Refresh All Data

On macOS, use Cmd instead of Ctrl

Command Palette

Access via Ctrl+Shift+P (or Cmd+Shift+P on Mac):

Command	Description
`Refresh Claude Usage`	Force refresh all statistics
`Scan Live Today Stats`	Scan JSONL files for real-time today's usage
`Show Claude Analytics Panel`	Open the dashboard
`Show Claude Analytics - Overview`	Jump to Overview tab
`Show Claude Analytics - Cost`	Jump to Cost tab
`Show Claude Analytics - Messages`	Jump to Messages tab
`Show Claude Analytics - Personality`	Jump to Personality tab
`Export Claude Usage Data`	Export usage data to JSON or CSV
`Claude Analytics: Clear History Before Date`	Delete historical data before a cutoff date
`Claude Analytics: Recalculate Historical Costs`	Rescan all JSONL files and rebuild database
`Claude Analytics: Sync to Gist`	Backup database to GitHub Gist
`Claude Analytics: Import from Gist`	Restore database from GitHub Gist
`Claude Analytics: Configure Gist Sync`	Open Gist sync settings

Architecture Overview

claude-usage-analytics/
├── src/
│   ├── extension.ts        # Extension entry point & command registration
│   ├── statusBar.ts        # 7 status bar widgets with tooltips
│   ├── dashboardView.ts    # 4-tab webview dashboard
│   ├── dataProvider.ts     # Stats parsing, cost calculations & real-time today
│   ├── database.ts         # SQLite persistence for historical data
│   └── limitsProvider.ts   # Subscription tier from credentials
├── out/                    # Compiled JavaScript
├── media/
│   ├── icon.png           # Extension icon (128x128)
│   └── claude-icon.svg    # Activity bar icon
└── package.json           # Extension manifest & configuration

Key Components

Component	Responsibility
StatusBarManager	Creates and updates 7 status bar items with rich tooltips
DashboardViewProvider	Renders the 4-tab webview with real-time data
getUsageData()	Parses `stats-cache.json` and calculates all metrics
getTodayRealTimeUsage()	Reads JSONL files for accurate today's cost
getSubscriptionInfo()	Reads subscription tier from credentials (file on Linux/Windows, Keychain on macOS)

Frequently Asked Questions

Why don't I see any data?

Ensure Claude Code CLI is installed and you've used it at least once. The extension reads from ~/.claude/stats-cache.json which is created after your first Claude Code session.

How accurate are the cost calculations?

Costs use model-specific pricing from modelPricing.json:

Claude Fable 5 / Mythos 5: $10/1M input, $50/1M output, $12.50/1M cache write, $1.00/1M cache read
Claude Opus 4.8 / 4.7 / 4.6 / 4.5: $5/1M input, $25/1M output, $6.25/1M cache write, $0.50/1M cache read
Claude Opus 4.1 / 4 / 3: $15/1M input, $75/1M output, $18.75/1M cache write, $1.50/1M cache read
Claude Sonnet 5: $2/1M input, $10/1M output, $2.50/1M cache write, $0.20/1M cache read (introductory pricing through 2026-08-31; $3/$15 thereafter)
Claude Sonnet 4.6 and earlier: $3/1M input, $15/1M output, $3.75/1M cache write, $0.30/1M cache read
Claude Haiku 4.5: $1/1M input, $5/1M output, $1.25/1M cache write, $0.10/1M cache read
Claude Haiku 3.5: $0.80/1M input, $4/1M output, $1/1M cache write, $0.08/1M cache read
Claude Haiku 3: $0.25/1M input, $1.25/1M output

modelPricing.json stores the base input/output rates; cache rates are derived from the input rate (1.25x for cache writes, 0.1x for cache reads).

Today's cost is calculated in real-time from conversation files for maximum accuracy.

Claude Code credentials may not be found. Ensure you're authenticated with claude auth login. On macOS, credentials are stored in the system Keychain — the first read may trigger a one-time Keychain access prompt; choose "Always Allow" so the widget can update without further prompts.

How often does data refresh?

Automatic: Every 15 minutes by default. Configurable via the claudeUsage.refreshIntervalSeconds setting (0 = disabled, 10–3600 seconds).
Manual: Click refresh button or press Ctrl+Alt+R

Why does "Today's" usage show $0.00 when I'm actively using Claude?

The extension calculates today's cost in real-time from your local Claude Code conversation JSONL files (~/.claude/projects/), so this should rarely happen on 1.1.11+. If it does, click the refresh button or run "Scan Live Today Stats" from the command palette to force a fresh scan.

If today's cost is still empty after a manual scan, your ~/.claude/projects/ directory may be missing or the JSONL files weren't written for that session. Verify with ls ~/.claude/projects/ (or dir %USERPROFILE%\.claude\projects on Windows).

Token counts and message stats in the Account Total view rely on Claude Code's stats-cache.json, which Claude Code updates periodically rather than in real-time. The pie chart and streak supplement automatically from the live scan and SQLite history, so newly-released models and recent days show up even when that cache is stale.

Is my data sent anywhere?

No. All analysis happens locally. There are no network calls — the extension operates fully offline.

Can I use this without Claude Code CLI?

No. This extension specifically reads Claude Code's local statistics files. It's designed as a companion tool for Claude Code users.

Troubleshooting

Status bar shows "Claude" but no statistics

Verify Claude Code is installed: claude --version
Check authentication: claude auth status
Confirm stats file exists: ls ~/.claude/stats-cache.json
Try using Claude Code once to generate initial data

Subscription shows "N/A"

Re-authenticate: claude auth login
Restart VS Code
Check credentials file exists: ls ~/.claude/.credentials.json (on macOS, run security find-generic-password -s "Claude Code-credentials" instead — credentials live in the Keychain)

Dashboard not loading

Try the refresh command: Ctrl+Alt+R
Reload VS Code window: Ctrl+Shift+P > "Reload Window"
Check for extension errors in Developer Tools: Ctrl+Shift+I

Personality stats seem wrong

Personality analysis requires conversation history in ~/.claude/projects/. If you recently cleared your history or are using a new machine, stats will rebuild over time.

Contributing

This extension is free and always will be. Source code is not publicly distributed to prevent unauthorized repackaging and resale. If you'd like to report a bug or request a feature, please use the Issues page.

Changelog

Full release history is in CHANGELOG.md. Latest highlights:

v1.1.14 (2026-07-08)

Claude Sonnet 5 pricing added at $2/$10 per MTok (introductory pricing through 2026-08-31; $3/$15 thereafter), matched ahead of the generic Sonnet tier so it isn't overcosted at $3/$15.

v1.1.13 (2026-06-12)

Claude Fable 5 / Mythos 5 pricing added at $10/$50 per MTok (verified against Anthropic docs); previously fell through to the default Sonnet rate, undercosting by more than 3x. Also added the non-dated claude-haiku-4-5 alias.

v1.1.12 (2026-06-01)

Opus 4.8 pricing added at $5/$25 per MTok (verified against Anthropic docs); resolves to the new Opus tier in cost calculations.

v1.1.11 (2026-05-06)

Opus 4.7 pricing added at $5/$25 per MTok (verified against Anthropic docs).
Pie chart now shows newly-released models (e.g. Opus 4.7) immediately, even before Claude Code's stats-cache.json records them.
Cache Savings stat now uses per-model rates instead of a flat Sonnet estimate — accurate for Opus-heavy users.
Streak no longer breaks to 0 when stats-cache.json is stale; supplemented from SQLite + live scan.
Today's cost populates immediately on dashboard open (was showing $0.00 until the 3-second scan fired).
Scan completes in ~1s instead of 30s on large histories via JSONL mtime filter; "Scan failed" toasts gone.
Accessibility (WCAG 2.1 AA): full ARIA tab pattern, screen-reader labels on charts, keyboard focus rings, and prefers-reduced-motion support.
Model name version parsing: chart labels now show the actual model version (Opus 4.7, Sonnet 4.6, Haiku 3.5) instead of always saying "4.5".

v1.1.10 (2026-05-06)

macOS subscription tier fix (#7): credentials now read from the system Keychain via the security CLI, with the on-disk .credentials.json as a fallback.

v1.1.9 (2026-04-09)

External additions sidecar: import usage data from any external AI tool (Copilot CLI, Forge CLI, etc.) via ~/.claude/external-additions.json.
Pricing fixes: Haiku 3.5 reverted to correct $0.80/$4, Opus 4.5 corrected to $5/$25, missing Opus 4.1 and Sonnet 4.5 entries added.

License

MIT License with Commons Clause — see LICENSE for details.

Free to use, modify, and distribute. Commercial sale or resale prohibited.

Acknowledgments

Built with Claude Code
Inspired by the need to understand AI-assisted development patterns

Built by Analytic Endeavors

Claude Usage Analytics

Analytic Endeavors

Claude Usage Analytics

What is Claude Usage Analytics?

Screenshots

Overview

Cost Analysis

Messages

Personality

Key Features

Status Bar Widgets

Interactive Dashboard

Feature Details

Cost Analytics

Personality Insights

Subscription Display

Activity Tracking

Privacy & Security

Data & History

Initial Data Window

Automatic History Accumulation

Managing History

Backfill from Claude.ai Export (Optional)

External Usage Data (Copilot, Forge, etc.)

GitHub Gist Backup

Setup

Multi-Machine Setup

Security Notes

Installation

Option 1: From VS Code Marketplace (Recommended)

Option 2: From .vsix

Requirements

Pre-requisites

Usage Guide

Status Bar Navigation

Keyboard Shortcuts

Command Palette

Architecture Overview

Key Components

Frequently Asked Questions

Why don't I see any data?

How accurate are the cost calculations?

Why does the subscription widget show "N/A"?

How often does data refresh?

Why does "Today's" usage show $0.00 when I'm actively using Claude?

Is my data sent anywhere?

Can I use this without Claude Code CLI?

Troubleshooting

Status bar shows "Claude" but no statistics

Subscription shows "N/A"

Dashboard not loading

Personality stats seem wrong

Contributing

Changelog

v1.1.14 (2026-07-08)

v1.1.13 (2026-06-12)

v1.1.12 (2026-06-01)

v1.1.11 (2026-05-06)

v1.1.10 (2026-05-06)

v1.1.9 (2026-04-09)

License

Acknowledgments