cd /news/ai-tools/what-to-do-when-you-hit-your-claude-… · home › topics › ai-tools › article
[ARTICLE · art-173468] src=dev.to ↗ pub= topic=ai-tools verified=true sentiment=· neutral

What to do when you hit your Claude Code usage limit

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.

recommendation

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.

more in playbook: Controlling LLM cost
by read3 min views2 publishedNov 20, 2026

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.

On a Pro or Max plan, every request counts against two limits at once: a five-hour session limit and a weekly limit. Whichever runs out first stops you. Both are shared with claude.ai and Claude Desktop, so a long chat on the web leaves less for the terminal.

Run /usage to see both limits and when each one resets. The message also tells you which one you hit:

You've hit your session limit: You've hit your weekly limit: You've hit your Opus limit / Sonnet limit: A 529 overloaded error isn't a usage limit at all. It means the servers are busy, so retry or switch models.

| Option | How | Cost |

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

| Turn on usage credits | /usage-credits opens Settings > Usage. Set a monthly cap | API rates per turn | | Use an API key | Sign in with a Claude Console account | Per token, billed apart from your plan | | Upgrade | Max or Ultra | $100 or $200 a month as of November 2026. Weekly limits still apply |

If 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. Most people burn their limit on the model, not the work. Claude Code's default model on Pro and Max is Opus 5.5, so every turn runs on Opus unless you change it: renames, commit messages and one-line fixes included. Anthropic's own cost guide says Sonnet handles most coding tasks well for less.

/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. The model swap is the big one. Moving routine turns off Opus stretches a plan much further than trimming context does.

Switching models by hand works until you forget. I'm building AutoRouter, 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.

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

For the same breakdown across every coding agent and plan, see AI coding usage limits, explained. Disclosure: I'm a co-founder of AutoRouter.

── more in #ai-tools 4 stories · sorted by recency
── more on @anthropic 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/what-to-do-when-you-…] indexed:0 read:3min 2026-11-20 · —