[Bug] Anthropic API Error: Rate limit reached despite low session/weekly usage; missing per-minute limit documentation

Bug Description
I'm being blocked by "API Error: Rate limit reached" while running a subagent processing 148 PDFs. My session usage shows 6% and weekly usage 29% — both well below limits. I waited 3+ hours with no resolution. There is no documentation on what short-term (per-minute) rate limits apply to Claude Code subscriptions. Paying customers need transparency: what are the actual limits, where can we see them in real time, and why does the UI show low usage while blocking requests?

Environment Info

• Platform: darwin
• Terminal: Apple_Terminal
• Version: 2.1.85
• Feedback ID: e6c1351b-d1ea-4dbe-8f8d-bf56f189df12

Errors

[{"error":"Error: 429 {\"type\":\"error\",\"error\":{\"type\":\"rate_limit_error\",\"message\":\"Extra usage is required for long context requests.\"},\"request_id\":\"req_011CZTxMdaHqLNSHtJGUM7mh\"}\n    at generate (/$bunfs/root/src/entrypoints/cli.js:11:57550)\n    at makeRequest (/$bunfs/root/src/entrypoints/cli.js:50:5435)\n    at processTicksAndRejections (native:7:39)","timestamp":"2026-03-27T17:10:01.590Z"},{"error":"Error: 429 {\"type\":\"error\",\"error\":{\"type\":\"rate_limit_error\",\"message\":\"Extra usage is required for long context requests.\"},\"request_id\":\"req_011CZTxNiUF7LaP4P6xcKcGt\"}\n    at generate (/$bunfs/root/src/entrypoints/cli.js:11:57550)\n    at makeRequest (/$bunfs/root/src/entrypoints/cli.js:50:5435)\n    at processTicksAndRejections (native:7:39)","timestamp":"2026-03-27T17:10:16.363Z"},{"error":"Error: 429 {\"type\":\"error\",\"error\":{\"type\":\"rate_limit_error\",\"message\":\"Extra usage is required for long context requests.\"},\"request_id\":\"req_011CZTzBdn9KJGLNwCx2QKas\"}\n    at generate (/$bunfs/root/src/entrypoints/cli.js:11:57550)\n    at makeRequest (/$bunfs/root/src/entrypoints/cli.js:50:5435)\n    at processTicksAndRejections (native:7:39)","timestamp":"2026-03-27T17:34:00.003Z"},{"error":"Error: 429 {\"type\":\"error\",\"error\":{\"type\":\"rate_limit_error\",\"message\":\"Extra usage is required for long context requests.\"},\"request_id\":\"req_011CZTzBgmyT62A9ymPGpF8M\"}\n    at generate (/$bunfs/root/src/entrypoints/cli.js:11:57550)\n    at makeRequest (/$bunfs/root/src/entrypoints/cli.js:50:5435)\n    at processTicksAndRejections (native:7:39)","timestamp":"2026-03-27T17:34:00.354Z"},{"error":"Error: 429 {\"type\":\"error\",\"error\":{\"type\":\"rate_limit_error\",\"message\":\"Extra usage is required for long context requests.\"},\"request_id\":\"req_011CZTzDinaR8nr1J17kMm68\"}\n    at generate (/$bunfs/root/src/entrypoints/cli.js:11:57550)\n    at makeRequest (/$bunfs/root/src/entrypoints/cli.js:50:5435)\n    at processTicksAndRejections (native:7:39)","timestamp":"2026-03-27T17:34:27.942Z"},{"error":"Error: 429 {\"type\":\"error\",\"error\":{\"type\":\"rate_limit_error\",\"message\":\"Extra usage is required for long context requests.\"},\"request_id\":\"req_011CZU1BTtCLy1Z531h4Pvmt\"}\n    at generate (/$bunfs/root/src/entrypoints/cli.js:11:57550)\n    at makeRequest (/$bunfs/root/src/entrypoints/cli.js:50:5435)\n    at processTicksAndRejections (native:7:39)","timestamp":"2026-03-27T17:47:04.155Z"}]