What this error means
Background claude --print spawns silently burn Max5 quota; no per-account rate-limit visibility — users lose token budget without awareness or warnings is a Claude Code failure pattern reported for developers trying to understand why claude code cli background processes consume unlimited max5 subscription quota and how to monitor/rate-limit them. Based on the imported evidence, treat this as a tool-specific troubleshooting page rather than a generic API error.
Why this happens
GitHub Issue #60921 opened by user on anthropics/claude-code. Background '--print' mode burns through Max5 tier tokens invisibly. Addresses quota exhaustion for paid subscribers. Related to pre-limit alerts issue #1494 but focused on runtime token leakage from background processes. Covers a revenue impact scenario: paying Max5 users getting unexpectedly throttled. Not in covered-errors.md.
Common causes
- GitHub Issue #60921 opened by user on anthropics/claude-code. Background '--print' mode burns through Max5 tier tokens invisibly. Addresses quota exhaustion for paid subscribers. Related to pre-limit alerts issue #1494 but focused on runtime token leakage from background processes. Covers a revenue impact scenario: paying Max5 users getting unexpectedly throttled. Not in covered-errors.md.
Quick fixes
- Confirm the exact error signature matches
Background claude --print spawns silently burn Max5 quota; no per-account rate-limit visibility — users lose token budget without awareness or warnings. - Check the Claude Code account, local tool state, and provider configuration involved in the failing workflow.
- Reduce request pressure, check quota or plan limits, and retry with backoff instead of immediate repeated requests.
Platform/tool-specific checks
- Verify the command, editor, extension, or API client that produced the error.
- Compare local settings with CI, deployment, or editor-level settings when the error appears in only one environment.
- Avoid deleting credentials, local model data, or project settings until the failing scope is clear.
Step-by-step troubleshooting
- Capture the exact error message and the command, editor action, or request that triggered it.
- Check whether the failure is account/auth, quota/rate, model/provider, local runtime, or deployment configuration.
- Review the source evidence below and compare it with your environment.
- Apply one change at a time and rerun the smallest failing action.
- Keep the working fix documented for the team or deployment environment.
How to prevent it
- Keep provider/tool configuration documented.
- Record non-secret diagnostics such as tool version, provider name, model name, and command path.
- Add a lightweight check before CI or production workflows depend on the tool.