Claude Code guide

How to check Claude Code usage limits and reset times on macOS

A quick way to see your current Claude Code limit, understand when it resets, and avoid discovering it only when a coding task stops halfway through.

AI Usage Ball showing Claude, Codex, and Antigravity usage as liquid gauges

Claude Code is most useful when it stays in the flow of a task. The awkward moment is reaching a usage limit halfway through debugging, reviewing a large change, or letting an agent work through a test failure. The first step is knowing which limit you are looking at and when it will reset.

Check your current Claude Code usage

Inside an active Claude Code session, use the built-in /usage command. Anthropic documents it as the command for viewing your plan usage limits and current rate-limit status.

/usage

This is the best source of truth for the account that is currently signed in. The status can vary by plan, model, conversation complexity, and the tools you use.

What does the reset time mean?

Claude describes usage limits as a budget over a period of time. When you reach a session limit, Claude shows the time that limit will reset. For many individual plans, the included session allowance resets on a five-hour cycle; some plans also include weekly limits with a separately assigned reset time.

Do not confuse usage limits with context limits. A usage limit is how much Claude you can use over time. A context limit is how much information one conversation can hold. Starting a new conversation can help with context, but it does not reset a usage limit.

Why Claude Code can affect your Claude web usage

For Claude subscriptions, work done across Claude product surfaces can count toward the same usage allowance. That means a long Claude Code task can matter when you later use Claude on the web or desktop app, and the reverse can also be true.

The exact limits and resets depend on your plan and can change, so avoid relying on old screenshots or a fixed quota number from someone else's account. Check /usage and the usage area in Claude Settings for the current account-specific answer.

A practical workflow for fewer interruptions

  1. Check before a long task. Run /usage before a large migration, deep debugging session, or long agent run.
  2. Keep the reset visible. If you know a reset is close, plan research, reviews, or smaller local work around it instead of starting a task you cannot finish.
  3. Watch context separately. Use Claude Code's /context when a conversation is getting large. Use /compact or a new session when appropriate.
  4. Reduce avoidable usage. High-effort settings, large prompts, and tool-heavy tasks can consume usage faster. Use only the level of effort and tools the task needs.

Keep the next reset on your desktop

If checking /usage in the terminal is enough, you do not need another tool. If you regularly switch between Claude, Codex, and other coding assistants, a persistent visual indicator can make the reset time easier to notice before you commit to a long task.

AI Usage Ball is a local macOS app that reads available usage information from your existing authenticated sessions and shows the remaining Claude usage and reset time as a desktop or menu bar gauge. It also supports Codex / ChatGPT and Antigravity. No usage data is routed through an AI Usage Ball server.

Sources and further reading

See your next reset before it stops your flow.

AI Usage Ball is free to try for 30 days on macOS. It keeps Claude, Codex / ChatGPT, and Antigravity usage in sight while you work.

Start free on macOS