Claude usage
Your Claude profiles, their state, and the last usage readings of each one: how much of each limit is used, and when it resets.
How to read it
- Your profiles: one row for each profile: its id, its kind,
defaultif it is your default, and a badge. Greenokmeans that turns can use it. Yellow<state> until <time>means that it is limited until that time. - Under each profile: one reading for each limit type. It shows the percent used, a yellow
badge if the status is not
allowed, and "resets … (in …)". The meter is yellow at 80 % and red at 90 %. - "read … ago" says how old the reading is. A reading comes only when a turn on that profile ends.
- The quota file is a fallback. It shows only if no profile has a reading. Interactive Claude Code sessions write it, not fleet turns.
- If more than one box sends usage, the panel shows one part for each box.
When it looks wrong
| You see | It means | Do this |
|---|---|---|
| "no credential profile yet" | You have no profile | fleet profile add main --kind subscription --default |
| "no reading yet: a turn on this profile reports one" | No turn on this profile ended yet | Nothing. Wait for a turn to end. |
A yellow limited until … |
The account is at its limit. Its agents are paused. |
Wait for the reset, or move an agent: fleet agent profile <agent> <profile>. See a usage limit. |
limited with the reason auth |
The login does not work | Make a new token and run fleet profile rotate <name> |
| "reset time unknown" | The limit message had no reset time | fleet tries again after 1 h |
| A quota-file error ("no such file or directory") | dash.quota_file names a file that is not there |
Fix the path, or remove the key |
| "Your profiles" is not there, but boxes show usage | A known fault: with more than one box with usage, or before the first quota-file read, the page does not show the profiles | Use fleet profile ls |
Members see only their own profiles. Admins also see profiles with no owner. The filter does not
change this panel. Code: fleet/internal/api/state.go (usage), fleet/internal/dash/usage.go.