Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>Usage Meter for Claude CodeNew to Visual Studio Code? Get it now.
Usage Meter for Claude Code

Usage Meter for Claude Code

Yoshiro Moriyama

|
2 installs
| (0) | Free
Shows in the status bar whether your Claude Code plan limits will last until they reset at your current pace.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Usage Meter for Claude Code

English | 日本語

Shows in the VS Code status bar how much of your Claude Code plan limits you have used, next to how much you would have used by now at an even pace. One glance tells you whether the limit will last until it resets.

Week 23% (71%)   Fable 11% (71%)

The first number is what you have used. The number in parentheses is how far through the period you are. Here 71% of the week has passed and 23% of the weekly limit is used, so there is room to spare. If the first number is the larger one, you are on course to run out before the reset.

This extension is not made by or affiliated with Anthropic.

Found a problem or have an idea? Open an issue on GitHub.

Install

The extension works the same on Windows, macOS and Linux (including Ubuntu). It needs the Claude Code extension, signed in with a Claude subscription.

VS Code

  1. Open the Extensions view: Ctrl+Shift+X on Windows and Linux, Cmd+Shift+X on macOS.
  2. Search for Usage Meter for Claude Code and click Install.

You can also install it from the Visual Studio Marketplace page, or from a terminal:

code --install-extension moriyama-dev.vscode-claude-code-usage-meter

Updates are automatic. VS Code installs new versions from the Marketplace by itself (unless you turned off extensions.autoUpdate).

VSCodium

  1. Open the Extensions view, with the same shortcut as in VS Code.
  2. Search for Usage Meter for Claude Code and click Install.

VSCodium gets the extension from Open VSX. You can also install it from a terminal:

codium --install-extension moriyama-dev.vscode-claude-code-usage-meter

Updates are automatic here too: VSCodium installs new versions from Open VSX by itself.

From a .vsix file

Every release also has a .vsix file on GitHub Releases. In the Extensions view, click the ... menu at the top, choose Install from VSIX... and pick the downloaded file. A copy installed this way does not update itself, so install the newer file when a new version is released.

Remote windows

In a Remote - SSH, WSL or dev container window, install the extension on the remote side, where the Claude Code extension runs. VS Code offers Install in SSH: … for this.

What it shows

One status bar item for each limit your plan has:

  • Week: the weekly limit for all models.
  • 5h: the five-hour session limit, on plans that have one.
  • A model name such as Fable: a weekly limit for one model, on plans that have one.

Hover over an item to see, for every limit:

  • the share used and when it resets
  • the share you would have used by now at an even pace
  • a projection: about how much will be used when it resets, or around when it runs out at the current pace
  • how old the numbers are

Click an item, or Refresh now in the tooltip, to refresh at once. A clock icon in front of the first item means the numbers are more than an hour old.

Settings

Setting Default
claudeCodeUsageMeter.refreshOnClickOnly false Refresh only when you click the meter. When off, it refreshes at the interval below.
claudeCodeUsageMeter.refreshIntervalMinutes 5 Minutes between automatic refreshes, 3 or more. Ignored when the setting above is on.

Commands

All of them are in the Command Palette under Claude Code Usage.

Command
Refresh Usage Fetch the numbers now.
Report an Issue Open a new GitHub issue with the versions and your platform already filled in.
Request a Feature Open a new GitHub issue for an idea.
Open on GitHub Open the repository.

The same three feedback links are at the bottom of the tooltip. Nothing is sent until you submit the issue on GitHub, and the pre-filled text holds only version numbers, the operating system, the UI language and the date.

How it works

  • It runs /usage through the Claude Code CLI that ships with the Claude Code extension. /usage is a local command: it makes no model call and uses no tokens. When Claude Code's own cached numbers are a few minutes old, the CLI fetches fresh ones and saves them in its config file.
  • It reads the numbers from that config file, ~/.claude.json (or $CLAUDE_CONFIG_DIR/.claude.json). It also picks up changes Claude Code makes there by itself, for example when you open /usage in the Claude Code panel.
  • Your hooks and MCP servers are turned off for these runs, and no session file is written, so refreshing every few minutes leaves nothing behind.
  • The extension never reads your sign-in credentials and makes no network requests of its own. The only traffic is what the Claude Code CLI does to fetch the usage numbers.
  • It does not read any file in your workspace.

Troubleshooting

The status bar shows Claude — when there is nothing to display. Hover over it for the reason, and open Output › Usage Meter for Claude Code for a log.

  • "The Claude Code extension is not installed." Install Claude Code in the same place this extension runs (for a remote window, on the remote side).
  • "No usage numbers yet." Plan limits exist only for Claude subscriptions; with an API key there is nothing to show. If you have a subscription, start Claude Code once and sign in, then click the item.
  • "Claude Code could not report its usage." The log has the error the CLI returned. Click the item to try again.

Requirements

  • VS Code 1.140 or later. For VSCodium, install it from Open VSX.
  • The Claude Code extension, signed in with a Claude subscription. Tested with Claude Code 2.1.325.

License

MIT

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft