Orpheus
Claude usage limits

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

Ways to see Claude Code usage, as of November 2026
WhereWhat it showsWhat it leaves out
/usagePlan usage bars and reset times, session cost, activity stats, a breakdown by skill, subagent, plugin and MCP serverThe breakdown covers only this machine's local history
Settings > UsageCurrent session used and time remaining, next weekly reset, usage creditsWhich agent used what
Statusline rate_limits5-hour and 7-day percentage and reset time, always on screenOther accounts; appears only on Pro, Max and Ultra after the first response
ccusageToken and cost reports from local logs: daily, weekly, monthly, by session and by 5-hour blockAnthropic's own percentages; other machines
Claude-Code-Usage-MonitorLive terminal view with burn-rate forecastingOther machines
Sources: Claude Code docs, Anthropic Help Center, and each tool's documentation. Checked .

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.

  1. Install jq

    The script parses JSON with jq: brew install jq on macOS, or your Linux package manager.

  2. 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.

  3. Point Claude Code at it

    Add this to ~/.claude/settings.json:

    { "statusLine": { "type": "command", "command": "~/.claude/statusline.sh" } }
  4. Send one message

    The bar reads something like [Opus 5.5] 5h: 42% (resets Fri 14:10) | week: 61% (resets Mon 00:00). The rate_limits object 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_DIR for running several accounts side by side, and settings live under that folder,4 so add the statusLine block to each folder's settings.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, and CLAUDE_CONFIG_DIR can 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

  1. CommandsClaude Code docsUndated. Checked
  2. Manage costs effectivelyClaude Code docsUndated. Checked
  3. Customize your status line: Rate limit usageClaude Code docsUndated. Checked
  4. Environment variables: CLAUDE_CONFIG_DIRClaude Code docsUndated. Checked
  5. ccusage guide: Directory detectionccusage docsChecked
  6. Claude-Code-Usage-MonitorGitHub, Maciek-roboblogChecked
  7. ccusageGitHub, ryoppippiChecked