Home/Wiki Errors/Claude Code
Claude Code / Rate limits

You've hit your session limit / weekly limit - Claude Code

Your Claude Code subscription or organization allowance is exhausted for the current rolling window. This is account quota, not a local project bug.

Claude Code session limitClaude Code weekly limitClaude Code Opus limit reset
Paste an error to match it against the wiki. / 粘贴报错后自动匹配。

Error text / 报错原文

  • You've hit your session limit
  • You've hit your weekly limit
  • You've hit your Opus limit

What it means

Your Claude Code subscription or organization allowance is exhausted for the current rolling window. This is account quota, not a local project bug.

Most common causes

  • Long autonomous sessions with many tool calls
  • Multiple parallel agents consuming the same plan allowance
  • Large files or MCP tool schemas inflating every request
  • Temporary provider-side throttling that looks like a quota wall

Fastest fix

  • Run /usage and check the reset time
  • Use /compact or /clear before continuing
  • Switch to a cheaper or available model with /model
  • Pause parallel Claude Code sessions until the reset window

Safe fix

  • Reduce persistent instructions and oversized CLAUDE.md files
  • Disable unused MCP servers before large tasks
  • Buy extra usage only from the official billing flow
  • Track rate limit fields in the status line for long work sessions

What not to do

  • Do not rotate shared accounts to bypass plan controls
  • Do not paste OAuth tokens into third-party routers
  • Do not delete project files while trying to fix a quota message

How to confirm the fix

Run the smallest reproducible command first, then retry the agent task only after authentication, quota, and tool discovery are stable.

claude --version
claude doctor
claude config get autoUpdates --global

Related errors

Related tools

Sources