Improve Error Messaging for API Usage Limits

Bug Description
Subject: Proposed Error Message Improvement - Claude Code Limits

❌ USAGE LIMIT. RESET AT 04:00 PM

Current error message cost me 3 days of development time. Here's
what it should say instead:

⚠️ Opus 4 Weekly Limit Reached
You've used your weekly Opus allocation, but you have 58%
of your overall capacity remaining!

Solutions:
→ Switch to Sonnet 4.5: /model
→ View detailed usage: https://claude.ai/settings/usage
→ Weekly Opus resets: Wed 4:00 PM

Need more Opus? Consider upgrading or using API credits.

This follows basic UX principles:

• Specific about which limit was hit
• Shows remaining capacity
• Provides actionable solutions with commands
• Links to detailed usage dashboard
• Explains when limits reset

As a C# developer, I would never ship an error message as vague
as "USAGE LIMIT. RESET AT 04:00 PM" - and neither should a company
building developer tools.

Please implement better error messages in Claude Code.

Abel Briones
Max Plan Subscriber

Environment Info

• Platform: win32
• Terminal: windows-terminal
• Version: 1.0.68
• Feedback ID: bcfac90c-2b7c-4c83-8905-0d097d4743a2

Errors

[{"error":"Error: 400 {\"type\":\"error\",\"error\":{\"type\":\"invalid_request_error\",\"message\":\"prompt is too long: 205004 tokens > 200000 maximum\"},\"request_id\":\"req_011CTog1HriJebeqQjXnrSJH\"}\n    at new sW (unknown:1:28)\n    at new $9 (B:/~BUN/root/claude.exe:1115:1853)\n    at new bW0 (unknown:1:28)\n    at generate (B:/~BUN/root/claude.exe:1115:2310)\n    at makeRequest (B:/~BUN/root/claude.exe:1132:5330)\n    at processTicksAndRejections (native:7:39)","timestamp":"2025-10-05T07:40:42.116Z"},{"error":"MaxFileReadTokenExceededError: File content (56063 tokens) exceeds maximum allowed tokens (25000). Please use offset and limit parameters to read specific portions of the file, or use the GrepTool to search for specific content.\n    at new YO0 (B:/~BUN/root/claude.exe:1416:239)\n    at hrG (B:/~BUN/root/claude.exe:1425:439)\n    at processTicksAndRejections (native:7:39)","timestamp":"2025-10-05T07:41:25.942Z"}]