ds_usage

Your Claude usage limits in the VS Code status bar, with every reset time on hover.

Your Claude usage limits in the VS Code status bar, so you can see how close you are without opening the usage panel.

Claude 5h 12% · 7d 39% sits in the bottom bar. Hover for every limit and when each one resets; click to refresh. The item turns amber at 75% and red at 90%.

What it touches

Worth reading before you install it, because it uses your Claude Code login.

That login, read-only. The macOS Keychain entry Claude Code-credentials, or ~/.claude/.credentials.json elsewhere. The token is never refreshed, never written back, never logged, and goes nowhere except api.anthropic.com over HTTPS.
One request every few minutes, shared by all your VS Code windows.
Nothing else. No telemetry, no other network calls.

It needs Claude Code installed and signed in. Without that, the item says so and does nothing else. The first time, macOS may ask whether to allow access to that Keychain entry.

It asks rarely on purpose

The usage endpoint answers 429 if it is asked too often, and an early version managed exactly that: every window fetched on its own timer and on every focus, and a click fetched again while the server was saying wait — five requests in fifteen seconds, each one extending the block.

One result for every window. It lives in a file in global storage. Whichever window finds it stale fetches; the rest render what is already there, so opening and focusing windows costs nothing.
A 429 is a wait, not an error. It honours the server's own retry-after, or waits 5 minutes doubling to at most 30, and a click cannot override it. The tooltip says when the next check is due.

A failed check is normal

Claude Code rewrites its login whenever it renews it, and a read that lands in that moment comes back without a token. So a failure keeps the last numbers on screen, retries after 20, 60 and 120 seconds, and only shows a warning after three in a row. The tooltip always names the last failure.

Settings

setting	default
`dsUsage.refreshMinutes`	`5`	how often to fetch
`dsUsage.showInBar`	`five_hour`, `seven_day`	which limits sit in the bar; every limit is in the tooltip
`dsUsage.warnAt`	`75`	amber from this percentage
`dsUsage.alertAt`	`90`	red from this percentage

Not a published API

The numbers come from the same endpoint Claude Code's own usage panel reads. It is internal to Claude Code, so an update could change or remove it, and the extension would then show a warning instead of numbers.

MIT licensed, source on GitHub, free like everything else here.