Claude Code "usage limit reached": Causes and Fixes — 5-Hour and Weekly Limits, and the API Escape Hatch
Working in Claude Code, you suddenly see "Claude usage limit reached. Your limit will reset at 3pm" and stop cold. This is not an error or a bug: it is how the Pro/Max subscription usage limits work. This article explains the two-tier structure (a rolling 5-hour window that recovers ~5 hours after your first prompt, plus a weekly window that resets every 7 days, and on Max a separate weekly cap just for Opus), the fact that Claude Code and the Claude apps share the same plan allowance, the four biggest consumption drivers (model choice where Opus burns far more than Sonnet, context size, long continuous sessions, and subagents/MCP), five ways to keep working when you hit the cap (drop to Sonnet with /model, trim context with /compact, wait out a 5-hour window, switch to pay-as-you-go API, or buy credits / upgrade), how to see what is left (/usage, /status, and Settings to Usage for the weekly reset date), and the difference between subscription limits and API limits (429, retry-after, tiers). Because the exact numbers get revised over time, it avoids asserting current figures and recommends checking the live official view.