Claude Code Usage — VS Code extension

See your Claude Code usage — tokens, costs, sessions, projects — right inside VS Code.

The extension reads your local Claude Code JSONL transcripts (the ones Claude Code already writes regardless of plan) and renders the same dashboard the Python tool ships, embedded as a VS Code sidebar. No API calls, no telemetry — all data stays on your machine.

Works on API, Pro, and Max plans. Captures usage from the Claude Code CLI, the official VS Code extension, and dispatched Code sessions.

Install

From the VS Code Marketplace

Search the Extensions sidebar for "Claude Code Usage" (publisher: PawelHuryn), or open the marketplace link from the Open VSX page.

From a .vsix file (local install)

git clone https://github.com/phuryn/claude-usage
cd claude-usage/vscode-extension
./scripts/install.sh        # macOS / Linux / WSL
.\scripts\install.ps1       # Windows PowerShell

The scripts run vsce package then code --install-extension against your local VS Code install.

Requirements

• Python 3.8 or newer on your PATH. Almost everyone running Claude Code already has Python installed; if not, see python.org/downloads. On Windows make sure to check "Add Python to PATH" during the installer.

That's the only dependency. The Python sources (cli.py, scanner.py, dashboard.py) are bundled inside the extension — no separate clone or Homebrew install needed.

Usage

1. Click the gauge icon in the activity bar (left sidebar of VS Code).
2. The extension starts the dashboard server on a free local port and embeds it in a sidebar webview.
3. Filter by model, range, or project — same UI as the standalone web dashboard.

Commands

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Settings

How discovery works

When you click the icon, the extension resolves how to run the dashboard in this order:

1. claudeUsage.cliPath setting if you've set one
2. The bundled python/cli.py that ships inside this .vsix (most installs hit this)
3. The claude-usage shim on PATH (if you installed via Homebrew)
4. A cli.py in any open VS Code workspace folder (the legacy "open the cloned repo" path)
5. A sibling cli.py from the extension dir (dev mode, when running from source via F5)

If none of those find anything, you'll get a friendly message in the sidebar — most often "Python 3.8+ is required" with a platform-specific install hint.

Privacy

The extension only:

• Reads local JSONL transcripts from ~/.claude/projects/ (and the Xcode coding-assistant directory on macOS, if present)
• Runs a small HTTP server bound to 127.0.0.1 (localhost-only — never 0.0.0.0) on a port the OS picks for you
• Embeds that server's dashboard in a VS Code webview

No data leaves your machine. No API calls. No telemetry.

Troubleshooting

• "Python 3.8 or newer required" — install from python.org and reload VS Code (Ctrl+Shift+P → Developer: Reload Window). On Windows make sure "Add Python to PATH" is checked in the installer.
• Sidebar stays blank or shows "starting…" — run Claude Usage: Show Logs. The extension logs the resolved Python path, the install mode, the spawn command, and any stdout/stderr from the server.
• Dashboard renders but shows "No usage recorded" — Claude Code hasn't written transcripts to ~/.claude/projects/ yet. Run a Claude Code session first.

Source

The Python tool, this extension, and a Homebrew formula all live at github.com/phuryn/claude-usage. Bug reports and feature discussions: Issues, Discussions.

Made by The Product Compass Newsletter.