Claude Code Usage Time Marker
See how much of your Claude Code limits you have used, and whether you are spending them faster or slower than an even pace.
This is an unofficial extension. It is not affiliated with or endorsed by Anthropic.
What you get
- A view in the Claude Code sidebar. One card per limit: the current session, the week, and the weekly limit of a single model such as Fable or Opus, if your plan has one.
- A popover. Hover over a status bar entry and the same cards appear, without opening the sidebar.
- Status bar entries. One per limit, such as
✻ Session: 31% (↑1.9x, ETA 1h49m, resets in 4h11m).
How to read a card
Each bar has a marker. It stands where your usage would be right now if you spent the limit evenly over its window. The label above the marker tells you how far you are from that point.
Example: you have used 31% of the session, but only 16% of the five hours have passed. The label reads ↑ 90% · 44m: you are 90% over an even pace, which equals 44 minutes of budget spent ahead of time.
↑ means over pace: at this rate the limit runs out before it resets.
↓ means under pace: you have budget to spare.
The status bar
✻ Fable: 12% (↓0.8x) ✻ Week: 22% (↓0.9x) ✻ Session: 31% (↑1.9x, ETA 1h49m, resets in 4h11m)
After the share you have used, the parentheses hold:
↑ or ↓: you are over or under an even pace.
1.9x: how fast you are spending. 1.9x is 90% over an even pace, 0.9x is 10% under it.
ETA 1h49m: when the limit is reached if you go on like this. It only shows while that is before the reset.
resets in 4h11m: when the window starts anew.
An entry can also draw its usage as a bar, with a marker │ where an even pace would stand:
✻ Session ▬▬▬▬│▬▬════ 60% (↑1.5x, ETA 1h20m, resets in 3h)
Click an entry to open the view. The settings decide which entries show, what each says in parentheses, and whether it draws a bar.
Where to find the view
- Click the Claude Code icon in the activity bar. The Claude Code sidebar opens.
- Look for the section Usage Pace in that sidebar. If it is collapsed, click its title.
If the section is missing, run Claude Code Usage Time Marker: Show from the Command Palette.
Requirements
- The official Claude Code extension. It is installed along with this one.
- Claude Code signed in with a Claude subscription. Session and weekly limits belong to subscriptions; with API key billing there is nothing to show.
Tested on macOS. Windows and Linux are untested.
Where the numbers come from
The extension asks the Claude Code program that ships inside the official extension. It sends the same request that feeds the "Account & Usage" panel there.
- It never reads your login token. Claude Code talks to Anthropic itself.
- No model runs, so a refresh uses none of your limit.
- Nothing is sent anywhere else.
The numbers refresh every 60 seconds.
This request is undocumented, and Anthropic marks it as experimental. A Claude Code update can change it. If that happens, the view shows a message instead of the bars until this extension is updated. Claude Code itself is not affected: the extension only reads.
Settings
The gear at the top right of the view and of the popover opens the settings, and so does Claude Code Usage Time Marker: Settings in the Command Palette. Every setting is described there. The ones you are most likely to change, each starting with claudeUsagePace.:
| Setting |
What it does |
statusBar.session, statusBar.weekly, statusBar.modelLimits |
Show or hide the entry of a limit. |
statusBar.sessionParts, statusBar.weeklyParts, statusBar.modelLimitsParts |
What an entry says in parentheses: its pace, the ETA, the reset. |
statusBar.sessionBar, statusBar.weeklyBar, statusBar.modelLimitsBar |
Draw the usage as a bar, beside the number or in its place. |
statusBar.barStyle |
The look of the bars: tube (default), line or blocks. |
prediction |
The prediction under each bar. |
refreshSeconds |
Seconds between two reads. The minimum is 60. |
Your user settings apply in every window. Set claudeUsagePace.settingsScope to workspace to let a workspace have its own.
Optional: the card “API Cost Value”
If you use the same account on multiple machines and want to compare their usage, this card is for you. Important: it shows no real costs, only what your subscription usage on this machine would have cost at API list prices. Off by default: claudeUsagePace.apiCostValue.enabled.
License
MIT