Usage Meter for Claude CodeEnglish | 日本語 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.
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. InstallThe 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
You can also install it from the Visual Studio Marketplace page, or from a terminal:
Updates are automatic. VS Code installs new versions from the Marketplace by itself (unless you turned off VSCodium
VSCodium gets the extension from Open VSX. You can also install it from a terminal:
Updates are automatic here too: VSCodium installs new versions from Open VSX by itself. From a
|
| 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
/usagethrough the Claude Code CLI that ships with the Claude Code extension./usageis 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/usagein 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.