{"slug": "what-to-do-when-you-hit-your-claude-code-usage-limit", "title": "What to do when you hit your Claude Code usage limit", "summary": "A developer is building AutoRouter, a macOS app that routes each Claude Code turn to the cheapest capable model and shifts work to another connected account when a plan's five-hour or weekly limit runs out. The writeup explains that Pro and Max plans share limits with claude.ai and Claude Desktop, that Opus 5.5 is the default model so routine turns burn the most expensive tier, and that switching to Sonnet, using opusplan, or setting subagent models stretches a plan further than trimming context.", "body_md": "You're mid-task and Claude Code stops with `You've hit your session limit`. Here's what's going on, what you can do right now, and how to make the next window last longer.\n\nOn a Pro or Max plan, every request counts against two limits at once: a [five-hour session limit](https://support.claude.com/en/articles/11647753-how-do-usage-and-length-limits-work) and a weekly limit. Whichever runs out first stops you. Both are [shared with claude.ai and Claude Desktop](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan), so a long chat on the web leaves less for the terminal.\n\nRun `/usage` to see both limits and when each one resets. The message also tells you which one you hit:\n\n`You've hit your session limit`:` You've hit your weekly limit`:` You've hit your Opus limit` / `Sonnet limit`:\nA `529 overloaded` error isn't a usage limit at all. It means the servers are busy, so retry or switch models.\n\n| Option | How | Cost | \n|---|---|---|\n| Wait | Claude Code [picks the task back up after the reset](https://code.claude.com/docs/en/interactive-mode#wait-for-a-usage-limit-to-reset) in interactive sessions (v2.1.234+) | Nothing | \n| Use a saved limit reset | [Settings > Usage](https://support.claude.com/en/articles/17007452-what-is-a-limit-reset) on the web or in Claude Desktop, when Anthropic has given you one | Nothing | \n| Turn on usage credits | `/usage-credits` opens Settings > Usage. Set a monthly cap | [API rates](https://support.claude.com/en/articles/12429409-manage-usage-credits-for-paid-claude-plans) per turn | \n| Use an API key | Sign in with a Claude Console account | Per token, billed apart from your plan | \n| Upgrade | [Max or Ultra](https://claude.com/pricing) | $100 or $200 a month as of November 2026. Weekly limits still apply | \n\nIf you just need to finish one thing, usage credits with a low cap is the least painful. Every overflow turn bills at its model's API price, so leaving Opus on for a rename gets expensive.\n\nMost people burn their limit on the model, not the work. Claude Code's default model on Pro and Max is [Opus 5.5](https://code.claude.com/docs/en/model-config), so every turn runs on Opus unless you change it: renames, commit messages and one-line fixes included. Anthropic's own [cost guide](https://code.claude.com/docs/en/costs#choose-the-right-model) says Sonnet handles most coding tasks well for less.\n\n`/model sonnet`. Switch to `/model opus` when a task really needs it.`opusplan`:`/model opusplan` runs Opus while you plan and Sonnet while it executes (Shift+Tab cycles into plan mode).`model: haiku` or `model: sonnet` to their frontmatter, or set `CLAUDE_CODE_SUBAGENT_MODEL`. Otherwise an Opus session runs Opus subagents.`/clear` between unrelated tasks.`/compact` helps when you need to keep going, but the compaction itself is one big request.`/loop` tasks, subagents and agent teams all send their own requests. Agent teams can use `/usage` breaks recent usage down by skill, subagent, plugin and MCP server, and flags anything behind 10% or more of it.\nThe model swap is the big one. Moving routine turns off Opus stretches a plan much further than trimming context does.\n\nSwitching models by hand works until you forget. I'm building [AutoRouter](https://autorouter.com), a Mac app that does it per turn: a router that lives inside all your coding agents and runs on the AI subscriptions you already pay for. In Claude Code you pick it with `/model`. Hard work goes to the strongest model your plans cover, and quick tasks go to the cheapest model that can handle them. Every turn shows which model ran, what it cost and why.\n\nWhen one plan hits its limit, AutoRouter moves to the connected account with the most room left before it spends any credit. With Pro, turns keep going from its monthly included usage until your plan resets. It's free to start and runs on macOS 14 or later.\n\nFor the same breakdown across every coding agent and plan, see [AI coding usage limits, explained](https://autorouter.com/blog/ai-coding-usage-limits).\n\n*Disclosure: I'm a co-founder of AutoRouter.*", "url": "https://wpnews.pro/news/what-to-do-when-you-hit-your-claude-code-usage-limit", "canonical_source": "https://dev.to/tjcages/what-to-do-when-you-hit-your-claude-code-usage-limit-814", "published_at": "2026-11-20 20:41:16+00:00", "updated_at": "2026-11-20 20:44:55.539132+00:00", "lang": "en", "topics": ["ai-tools", "ai-agents", "developer-tools", "large-language-models"], "entities": ["Anthropic", "Claude Code", "AutoRouter", "Opus 5.5", "Sonnet", "Claude Console"], "also_reported_by": [], "takeaway": "Claude Code defaults to Opus 5.5 on Pro and Max, so routing routine turns to Sonnet or opusplan (Opus for planning, Sonnet for execution) and setting CLAUDE_CODE_SUBAGENT_MODEL stretches a plan further than trimming context does.", "recommendation": {"advice": "Switch routine Claude Code turns to Sonnet or opusplan and set CLAUDE_CODE_SUBAGENT_MODEL, since every turn otherwise runs on Opus 5.5 and drains the shared five-hour and weekly limits.", "playbook": "llm-cost", "playbook_url": "https://wpnews.pro/playbooks/llm-cost"}, "alternates": {"html": "https://wpnews.pro/news/what-to-do-when-you-hit-your-claude-code-usage-limit", "markdown": "https://wpnews.pro/news/what-to-do-when-you-hit-your-claude-code-usage-limit.md", "text": "https://wpnews.pro/news/what-to-do-when-you-hit-your-claude-code-usage-limit.txt", "jsonld": "https://wpnews.pro/news/what-to-do-when-you-hit-your-claude-code-usage-limit.jsonld"}}