vscode-claude-status

Claude Code token usage & cost — always visible in your VS Code status bar.

🌐 English | 日本語

Overview

vscode-claude-status is a Visual Studio Code extension that monitors your Claude Code usage in real time — without leaving your editor.

It reads session data from ~/.claude/projects/ locally (no extra network calls) and queries the Anthropic API at most once per 5 minutes to fetch rate-limit utilization headers. All token costs are calculated client-side using current Claude Sonnet 4.x pricing.

Features

📊 Status Bar — Always Visible

Real-time usage summary pinned to the VS Code status bar.

Hover for a detailed tooltip with full token breakdown and reset times.

🗂 Dashboard Panel

Click the status bar item to open a rich dashboard panel with:

• Current Usage — colour-coded progress bars for 5 h and 7 d windows
• Token Cost — 5 h / today / 7 d cost calculated from local JSONL data
• Project Cost — per-workspace breakdown (today / 7 days / 30 days)
• Prediction — burn rate ($/hr), time-to-exhaustion, daily budget tracking
• Usage History — GitHub-style daily heatmap + hourly pattern bar chart

The panel supports light, dark, and high-contrast VS Code themes natively.

🗂 Project-Level Cost Tracking (VS Code-exclusive)

Automatically maps the open workspace folder to its Claude Code session directory and shows how much you've spent for that specific project — today, this week, and this month.

Multi-root workspaces are fully supported: each folder gets its own breakdown in the dashboard, and the status bar shows the aggregate.

🤖 5h:78% 7d:84% | my-app:$3.21          ← single workspace
🤖 5h:78% 7d:84% | PJ:$5.43              ← multi-root aggregate

🔮 Usage Prediction & Budget Alerts

Based on the last 30 minutes of activity, the extension predicts how long until the 5 h rate limit is exhausted and warns you before it happens.

• Burn rate — current consumption in $/hr (rolling 30-minute window)
• Time-to-exhaustion — estimated minutes until the 5 h window is full, capped at the next window reset time
• Safety indicator — "Safe to start heavy task" if > 30 min remains
• Daily budget — set an optional USD cap; progress bar and alerts fire when the configured threshold (default 80 %) is reached
• VS Code notifications — non-blocking warning at ≤ 30 min, error dialog at ≤ 10 min (with "Open Dashboard" action); budget alert fires once per window

Configure via Settings → Claude Status or the command palette:

Claude Status: Set Budget...

📅 Usage History Heatmap

Understand your long-term usage patterns at a glance.

• Daily heatmap — GitHub Contributions-style grid for the last 30 / 60 / 90 days; green intensity reflects daily spend; hover any cell for exact date and cost
• Hourly bar chart — average cost per hour of day (last 30 days); shows when you typically use Claude Code most heavily

Number of days is configurable via claudeStatus.heatmap.days (30 / 60 / 90).

Requirements

• VS Code 1.109 or newer
• Claude Code CLI installed and authenticated (claude login) — this creates ~/.claude/.credentials.json used for API calls
• Claude Code sessions — the extension reads ~/.claude/projects/**/*.jsonl

Installation

VS Code Marketplace

Search "Claude Status" in the Extensions panel, or:

code --install-extension long-kudo.vscode-claude-status

Install from VSIX

1. Download the .vsix from the Releases page.
2. In VS Code: Extensions (Ctrl+Shift+X) → ⋯ → Install from VSIX…

Build from Source

git clone https://github.com/long-910/vscode-claude-status.git
cd vscode-claude-status
npm install
npm run package       # → vscode-claude-status-*.vsix

Usage

The extension activates automatically on VS Code startup (onStartupFinished).

Configuration

All settings are under the claudeStatus namespace in VS Code Settings.

// Example: settings.json
{
  "claudeStatus.displayMode": "cost",
  "claudeStatus.cache.ttlSeconds": 120,
  "claudeStatus.budget.dailyUsd": 5.00,
  "claudeStatus.budget.alertThresholdPercent": 80,
  "claudeStatus.statusBar.showProjectCost": true
}

Roadmap

Related Projects

• claude-tmux-status — tmux status bar version (same author, Python)
• vscode-view-charset — file encoding viewer (same author)

Contributing

Contributions are welcome. See DEVELOPMENT.md for setup instructions, architecture overview, and release procedures.

License

MIT — © 2026 long-910