How do I check my Claude Code usage?
Short answer
Run /usage in Claude Code to see your plan usage bars, reset times and a breakdown of what used them. Settings > Usage on claude.ai shows the same 5-hour and weekly bars. For a number that stays on screen, add a statusline script that reads rate_limits.five_hour.used_percentage and rate_limits.seven_day.used_percentage.
On this page
Every way to check, side by side
| Where | What it shows | What it leaves out |
|---|---|---|
/usage | Plan usage bars and reset times, session cost, activity stats, a breakdown by skill, subagent, plugin and MCP server | The breakdown covers only this machine's local history |
| Settings > Usage | Current session used and time remaining, next weekly reset, usage credits | Which agent used what |
Statusline rate_limits | 5-hour and 7-day percentage and reset time, always on screen | Other accounts; appears only on Pro, Max and Ultra after the first response |
| ccusage | Token and cost reports from local logs: daily, weekly, monthly, by session and by 5-hour block | Anthropic's own percentages; other machines |
| Claude-Code-Usage-Monitor | Live terminal view with burn-rate forecasting | Other machines |
The /usage command
/usage shows session cost, plan usage limits and activity stats. /cost and /stats are aliases.1 On Pro, Max and Ultra, the dollar figure in the Session block is an API-price estimate that does not affect your bill; the plan usage bars are the part that matters.2
On a Pro, Max, Ultra, Team or Enterprise plan, /usage also attributes recent usage to skills, subagents, plugins and individual MCP servers, and suggests changes for anything behind 10% or more of it. Press d or w to switch between the last 24 hours and the last 7 days.2
The Claude Code docs say
“The figures are approximate and computed from local session history on this machine, so usage from other devices or claude.ai is not included.”
Manage costs effectively, code.claude.com · Checked .
If /usage says rate limited until 3:14am, that means Claude Code cannot fetch your plan limits again until then, not that your work is limited. It shows the last bars it loaded in the past 60 minutes, and r retries.2 /status is not a usage meter in current versions: it shows version, model, account and connectivity.1
Put your limits in the status line
Claude Code pipes JSON session data to your statusline script on stdin. For Pro, Max and Ultra subscribers it includes rate_limits.five_hour and rate_limits.seven_day, each with used_percentage (0 to 100) and resets_at (Unix epoch seconds).3 This is the first-party way to keep both numbers in view.
-
Install jq
The script parses JSON with
jq:brew install jqon macOS, or your Linux package manager. -
Save the script
#!/bin/bash # ~/.claude/statusline.sh: 5-hour and weekly plan usage with reset times input=$(cat) MODEL=$(echo "$input" | jq -r '.model.display_name') FIVE=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty') FIVE_AT=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at // empty') WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty') WEEK_AT=$(echo "$input" | jq -r '.rate_limits.seven_day.resets_at // empty') # resets_at is Unix epoch seconds: date -r on macOS, date -d on Linux fmt_time() { date -r "$1" '+%a %H:%M' 2>/dev/null || date -d "@$1" '+%a %H:%M'; } OUT="[$MODEL]" if [ -n "$FIVE" ]; then OUT="$OUT 5h: $(printf '%.0f' "$FIVE")%" [ -n "$FIVE_AT" ] && OUT="$OUT (resets $(fmt_time "$FIVE_AT"))" fi if [ -n "$WEEK" ]; then OUT="$OUT | week: $(printf '%.0f' "$WEEK")%" [ -n "$WEEK_AT" ] && OUT="$OUT (resets $(fmt_time "$WEEK_AT"))" fi echo "$OUT"Then make it executable with
chmod +x ~/.claude/statusline.sh. -
Point Claude Code at it
Add this to
~/.claude/settings.json:{ "statusLine": { "type": "command", "command": "~/.claude/statusline.sh" } } -
Send one message
The bar reads something like
[Opus 5.5] 5h: 42% (resets Fri 14:10) | week: 61% (resets Mon 00:00). Therate_limitsobject appears only after the first API response in a session, each window can be absent on its own, and Claude Code drops a window once its reset time passes, which is why the script uses// empty.3
If you use more than one Claude account
Each subscription has its own limits, and each of the tools above sees one account at a time, or mixes them:
- Statusline: it shows the account that session is signed in to. Anthropic documents
CLAUDE_CONFIG_DIRfor running several accounts side by side, and settings live under that folder,4 so add thestatusLineblock to each folder'ssettings.json, for example~/.claude-work/settings.json. - Settings > Usage: one signed-in account per browser session.
- ccusage: it reads
~/.config/claude/projects/and~/.claude/projects/and combines both, andCLAUDE_CONFIG_DIRcan be a comma-separated list.5 Combined folders give one report, not one per account. - Claude-Code-Usage-Monitor: it can scan several config folders and keeps separate accounts out of a single 5-hour window, per its README.6
For setting up the folders, see running more than one Claude account and the Orpheus multiple-accounts docs.
Open-source trackers
ccusage is an MIT-licensed CLI with daily, weekly, monthly, session, blocks (5-hour billing windows) and statusline commands.7 Claude Code deletes local session files older than cleanupPeriodDays, 30 days by default, so log-based history stops there.2 Claude-Code-Usage-Monitor is an MIT-licensed terminal tool that forecasts burn rate.6 Both run locally. Neither is made by Anthropic.
Common questions
Why does /usage not match what I used on claude.ai?
The breakdown in /usage is computed from local session history on this machine, so usage from other devices or claude.ai is not included. The plan usage bars come from your account and reflect all of it.
Does /status show my usage?
Not in current versions. /status opens Settings on the Status tab with version, model, account and connectivity. Use /usage for plan limits.
Why is rate_limits missing from my statusline JSON?
It appears only for Pro, Max and Ultra subscribers, or behind a Claude apps gateway with spend limits, and only after the first API response in the session. Each window can also be absent on its own.
Can I see usage for all my accounts in one place?
Not with Anthropic's tools: /usage, Settings > Usage and the statusline each show one signed-in account. Local trackers can read several config folders on one machine.
Sources
- CommandsClaude Code docsUndated. Checked
- Manage costs effectivelyClaude Code docsUndated. Checked
- Customize your status line: Rate limit usageClaude Code docsUndated. Checked
- Environment variables: CLAUDE_CONFIG_DIRClaude Code docsUndated. Checked
- ccusage guide: Directory detectionccusage docsChecked
- Claude-Code-Usage-MonitorGitHub, Maciek-roboblogChecked
- ccusageGitHub, ryoppippiChecked