§01 · The Model

Usage limit

Also called Rate limit · Usage cap · 5-hour window · Weekly limit

The cap on how much agent work your plan or API key allows in a window. Hitting it pauses you; it isn't the context window.

A usage limit is the ceiling your plan or API key puts on how much model work you can do in a period. Subscription plans (Claude Pro and Max, ChatGPT Plus and Pro) meter usage in rolling windows, commonly a few hours plus a weekly cap, and pause you when it's spent. API keys meter differently: requests and tokens per minute, plus whatever spend tier your account sits in. Both are set by the model provider, not the harness.

The confusing part is that the limit drains in tokens, and tokens are mostly input tokens. A session with a bloated context window burns the allowance many times faster than a lean one, because every model provider request re-sends the whole history. People who 'barely did anything' and still hit the wall usually had one giant session open all day. And a usage limit is not a context limit: one says stop for now, the other says this conversation can't hold more.

To stretch it: keep sessions short and focused, compact before the window balloons, use a cheaper model for grunt work and the strong one for planning, and keep the prefix cache warm so repeated input is billed as cheap cache tokens. If you're regularly capped, an API key with pay-as-you-go pricing removes the window but makes every token visible on a bill, which is its own kind of discipline.

In the tools
  • Claude CodeSubscription limits reset on a rolling window; /status shows the plan, and /cost shows what the session consumed.
  • CodexChatGPT-plan usage has its own windows; /status reports where you stand.
  • Anthropic APIRate limits are per minute and scale with your usage tier; spend limits are set in the console.
In conversation

It says I've hit my limit until 4pm and I only ran three tasks.

Three tasks in one 200k-token session. Each request re-read all of it. Split the work into fresh sessions next time.

Related terms
Learn it in the school
Words are the easy part

Course 01 puts every one of these terms to work: you install Claude Code, run the loop, and ship a real project — permission modes, compaction, hooks and all.

Start Course 01 →