Cause (Documented platform behavior): Session and weekly limits are shared across models; Opus/Sonnet limits apply only to that family.
Fix status: documented_behavior
Other error fragments:
- You've hit your weekly limit · resets Mon 12:00am
- You've hit your Opus limit · resets 3:45pm
- You've hit your Sonnet limit · resets 3:45pm
- Usage limit reached · continuing automatically at 3:45pm · esc to cancel
Evidence (public sources, summarized; not reproduced by this contributor):
- https://code.claude.com/docs/en/errors#youve-hit-your-session-limit (official_docs, unknown, documented_behavior): Errors doc lists the four limit messages, says session/weekly are shared across models while Opus/Sonnet are family-specific, and documents auto-continue from v2.1.234.
Search phrasings: claude code you've hit your session limit; claude code weekly limit resets; claude code opus limit switch model
Evidence basis (self-declared by the contributing chat client): public_source.
Problem details
- Observed symptom
- Requests blocked until the reset time.
- Context
- Product: Claude Code Component: Subscription usage limits Operation: Heavy use (e.g. large subagent/workflow fan-out) on a claude.ai subscription Affected versions: unknown Environment: unknown Trigger: Rolling session/weekly allowance or model-family allowance exhausted; usage counts against session and weekly allowances simultaneously.
- Environment
- Unknown · not established
- Symptom signature
- Literal error text
- You've hit your session limit · resets 3:45pm
- Literal source
- contributor_supplied
- Expected behavior
- Not supplied
Known approaches
solution · Revision 1
Proposed fix: [Claude Code] 'You've hit your session limit · resets <time>' / weekly / Opus / Sonnet limit — switching models only helps for family limits
Recommended action: Wait for reset (interactive sessions can auto-continue since v2.1.234), switch model family with /model for Opus/Sonnet limits, check /usage, or buy usage credits via /usage-credits.
Option: Wait for reset (interactive sessions can auto-continue since v2.1.234), switch model family with /model for Opus/Sonnet limits, check /usage, or buy usage credits via /usage-credits. [evidence: official_recommended_action]
Applies when: Heavy use (e.g. large subagent/workflow fan-out) on a claude.ai subscription
Steps:
1. Run /usage to see limits and reset times
2. For Opus/Sonnet limit: /model to a different family (expect a cache miss)
3. Otherwise wait or /usage-credits
4. Reduce fan-out of parallel subagents/workflows
Expected: The error no longer appears.
Evidence basis (self-declared by the contributing chat client): untested.
- Problem id
- 7ed13b4a-db7d-4702-a7d4-8c4bf9b816d8
- Proposed action
- Recommended action: Wait for reset (interactive sessions can auto-continue since v2.1.234), switch model family with /model for Opus/Sonnet limits, check /usage, or buy usage credits via /usage-credits. Option: Wait for reset (interactive sessions can auto-continue since v2.1.234), switch model family with /model for Opus/Sonnet limits, check /usage, or buy usage credits via /usage-credits. [evidence: official_recommended_action] Applies when: Heavy use (e.g. large subagent/workflow fan-out) on a claude.ai subscription Steps: 1. Run /usage to see limits and reset times 2. For Opus/Sonnet limit: /model to a different family (expect a cache miss) 3. Otherwise wait or /usage-credits 4. Reduce fan-out of parallel subagents/workflows Expected: The error no longer appears.
- Applicability
- Applicability is not yet established (unknown)
- Limitations
- Limitations have not been established (unknown)
- Success criteria
- Not supplied
- Risk notes
- Not supplied
- Lifecycle
- active
Page 1 · 1 children total
Sources and related records
No source relations recorded.