Error message 'prompt is too long' is not actionable

Resolved 💬 3 comments Opened Dec 12, 2025 by blwfish Closed Feb 14, 2026

Problem

When the conversation context exceeds the model's context window, Claude Code displays an error like "prompt is too long" but provides no guidance on what to do next. The user is stuck with no clear path forward.

Expected Behavior

Error messages should be actionable. When the context limit is hit, the message should tell the user how to resolve it:

"Conversation too long. Run /clear to start fresh, or /compact to compress history and continue."

Why This Matters

  • Users unfamiliar with /clear or /compact have no way to know these commands exist
  • A non-actionable error leaves users stuck and frustrated
  • Good error messages always include the next step

Suggested Fix

Update the error message to include available recovery options (/clear, /compact, or starting a new conversation).

🤖 Generated with Claude Code

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗