Rate limit error on MAX+ plan when invoking slash commands with low usage
Resolved 💬 6 comments Opened Mar 30, 2026 by syspir Closed May 12, 2026
Bug description
When invoking a custom slash command (/helpdesk), Claude Code returns:
Claude API Error: Rate limit reached
This happens despite being on a MAX+ plan with only a few percent of session usage consumed.
Steps to reproduce
- Have a MAX+ subscription with low usage (single-digit % of monthly quota)
- Create a custom slash command (
.claude/commands/helpdesk.md) that:
- Has
model: sonnetin frontmatter - Uses
allowed-tools: Bash, Read, Grep, Glob, Agent - Auto-executes a CLI command via
!backtick syntax producing ~80 lines of output - Has a ~130-line prompt template
- Invoke the command:
/helpdesk 000329608 - Get
Claude API Error: Rate limit reached
Expected behavior
The slash command should execute normally since the plan has sufficient quota remaining.
Actual behavior
Immediate rate limit error before the command starts processing. Retrying after a few seconds sometimes works.
Environment
- Plan: MAX+ (Claude Code)
- Model: Sonnet (specified in command frontmatter)
- Platform: Linux
- Claude Code: CLI
Notes
- The error is from Anthropic API, not from any external API called by the command
- Large
CLAUDE.mdcontext (~400 lines) may contribute to the issue - This seems like a per-minute/per-request rate limit rather than a monthly usage limit
- The issue is intermittent — sometimes the same command works fine
This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗