<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Ty Cagle</title>
    <description>The latest articles on DEV Community by Ty Cagle (@tjcages).</description>
    <link>https://dev.to/tjcages</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4243587%2Fe73852a5-8100-4a73-9160-5aa9b03a92a2.png</url>
      <title>DEV Community: Ty Cagle</title>
      <link>https://dev.to/tjcages</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/tjcages"/>
    <language>en</language>
    <item>
      <title>What to do when you hit your Claude Code usage limit</title>
      <dc:creator>Ty Cagle</dc:creator>
      <pubDate>Fri, 20 Nov 2026 20:41:16 +0000</pubDate>
      <link>https://dev.to/tjcages/what-to-do-when-you-hit-your-claude-code-usage-limit-814</link>
      <guid>https://dev.to/tjcages/what-to-do-when-you-hit-your-claude-code-usage-limit-814</guid>
      <description>&lt;p&gt;You're mid-task and Claude Code stops with &lt;code&gt;You've hit your session limit&lt;/code&gt;. Here's what's going on, what you can do right now, and how to make the next window last longer.&lt;/p&gt;

&lt;h2&gt;
  
  
  1. Find out which limit you hit
&lt;/h2&gt;

&lt;p&gt;On a Pro or Max plan, every request counts against two limits at once: a &lt;a href="https://support.claude.com/en/articles/11647753-how-do-usage-and-length-limits-work" rel="noopener noreferrer"&gt;five-hour session limit&lt;/a&gt; and a weekly limit. Whichever runs out first stops you. Both are &lt;a href="https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan" rel="noopener noreferrer"&gt;shared with claude.ai and Claude Desktop&lt;/a&gt;, so a long chat on the web leaves less for the terminal.&lt;/p&gt;

&lt;p&gt;Run &lt;code&gt;/usage&lt;/code&gt; to see both limits and when each one resets. The message also tells you which one you hit:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;You've hit your session limit&lt;/code&gt;:&lt;/strong&gt; the five-hour window. It resets in full five hours after your first message.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;You've hit your weekly limit&lt;/code&gt;:&lt;/strong&gt; resets at a fixed day and time on your account (Settings &amp;gt; Usage shows it).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;You've hit your Opus limit&lt;/code&gt; / &lt;code&gt;Sonnet limit&lt;/code&gt;:&lt;/strong&gt; a model-specific cap. This is the only case where switching models gets you going again.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A &lt;code&gt;529 overloaded&lt;/code&gt; error isn't a usage limit at all. It means the servers are busy, so retry or switch models.&lt;/p&gt;

&lt;h2&gt;
  
  
  2. What you can do right now
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Option&lt;/th&gt;
&lt;th&gt;How&lt;/th&gt;
&lt;th&gt;Cost&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Wait&lt;/td&gt;
&lt;td&gt;Claude Code &lt;a href="https://code.claude.com/docs/en/interactive-mode#wait-for-a-usage-limit-to-reset" rel="noopener noreferrer"&gt;picks the task back up after the reset&lt;/a&gt; in interactive sessions (v2.1.234+)&lt;/td&gt;
&lt;td&gt;Nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Use a saved limit reset&lt;/td&gt;
&lt;td&gt;
&lt;a href="https://support.claude.com/en/articles/17007452-what-is-a-limit-reset" rel="noopener noreferrer"&gt;Settings &amp;gt; Usage&lt;/a&gt; on the web or in Claude Desktop, when Anthropic has given you one&lt;/td&gt;
&lt;td&gt;Nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Turn on usage credits&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;/usage-credits&lt;/code&gt; opens Settings &amp;gt; Usage. Set a monthly cap&lt;/td&gt;
&lt;td&gt;
&lt;a href="https://support.claude.com/en/articles/12429409-manage-usage-credits-for-paid-claude-plans" rel="noopener noreferrer"&gt;API rates&lt;/a&gt; per turn&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Use an API key&lt;/td&gt;
&lt;td&gt;Sign in with a Claude Console account&lt;/td&gt;
&lt;td&gt;Per token, billed apart from your plan&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Upgrade&lt;/td&gt;
&lt;td&gt;&lt;a href="https://claude.com/pricing" rel="noopener noreferrer"&gt;Max or Ultra&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;$100 or $200 a month as of November 2026. Weekly limits still apply&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;h2&gt;
  
  
  3. Make the next window last
&lt;/h2&gt;

&lt;p&gt;Most people burn their limit on the model, not the work. Claude Code's default model on Pro and Max is &lt;a href="https://code.claude.com/docs/en/model-config" rel="noopener noreferrer"&gt;Opus 5.5&lt;/a&gt;, so every turn runs on Opus unless you change it: renames, commit messages and one-line fixes included. Anthropic's own &lt;a href="https://code.claude.com/docs/en/costs#choose-the-right-model" rel="noopener noreferrer"&gt;cost guide&lt;/a&gt; says Sonnet handles most coding tasks well for less.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Make Sonnet your default:&lt;/strong&gt; &lt;code&gt;/model sonnet&lt;/code&gt;. Switch to &lt;code&gt;/model opus&lt;/code&gt; when a task really needs it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Or use &lt;code&gt;opusplan&lt;/code&gt;:&lt;/strong&gt; &lt;code&gt;/model opusplan&lt;/code&gt; runs Opus while you plan and Sonnet while it executes (Shift+Tab cycles into plan mode).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Give subagents a smaller model:&lt;/strong&gt; add &lt;code&gt;model: haiku&lt;/code&gt; or &lt;code&gt;model: sonnet&lt;/code&gt; to their frontmatter, or set &lt;code&gt;CLAUDE_CODE_SUBAGENT_MODEL&lt;/code&gt;. Otherwise an Opus session runs Opus subagents.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;/clear&lt;/code&gt; between unrelated tasks.&lt;/strong&gt; Claude Code sends the whole conversation with every request, so a quick question at the end of a long session pays for all of it. &lt;code&gt;/compact&lt;/code&gt; helps when you need to keep going, but the compaction itself is one big request.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Watch what runs while you're away:&lt;/strong&gt; scheduled &lt;code&gt;/loop&lt;/code&gt; tasks, subagents and agent teams all send their own requests. Agent teams can use &lt;a href="https://code.claude.com/docs/en/costs" rel="noopener noreferrer"&gt;about 7× the tokens&lt;/a&gt; of a normal session.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Keep usage on screen:&lt;/strong&gt; &lt;code&gt;/usage&lt;/code&gt; breaks recent usage down by skill, subagent, plugin and MCP server, and flags anything behind 10% or more of it.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The model swap is the big one. Moving routine turns off Opus stretches a plan much further than trimming context does.&lt;/p&gt;

&lt;h2&gt;
  
  
  4. Or let something pick the model for you
&lt;/h2&gt;

&lt;p&gt;Switching models by hand works until you forget. I'm building &lt;a href="https://autorouter.com" rel="noopener noreferrer"&gt;AutoRouter&lt;/a&gt;, 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 &lt;code&gt;/model&lt;/code&gt;. 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.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;h2&gt;
  
  
  Quick checklist
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;code&gt;/usage&lt;/code&gt;: which limit, and when does it reset?&lt;/li&gt;
&lt;li&gt;Model-specific limit? Switch models. Session or weekly? Wait, use a saved reset, or turn on capped usage credits.&lt;/li&gt;
&lt;li&gt;Next session: &lt;code&gt;/model sonnet&lt;/code&gt; (or &lt;code&gt;opusplan&lt;/code&gt;), smaller models for subagents, &lt;code&gt;/clear&lt;/code&gt; often.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;For the same breakdown across every coding agent and plan, see &lt;a href="https://autorouter.com/blog/ai-coding-usage-limits" rel="noopener noreferrer"&gt;AI coding usage limits, explained&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Disclosure: I'm a co-founder of AutoRouter.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>claudecode</category>
      <category>ai</category>
      <category>productivity</category>
      <category>programming</category>
    </item>
  </channel>
</rss>
