claude-code - 💡(How to fix) Fix [FEATURE] Show error reason in retry status line [2 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#56257Fetched 2026-05-06 06:32:59
View on GitHub
Comments
2
Participants
2
Timeline
6
Reactions
0
Author
Timeline (top)
labeled ×3commented ×2renamed ×1

Error Message

There is no indication of what error triggered the retry (429, 529, timeout, ECONNRESET, etc.). Additionally, pressing Esc cancels the retry loop but does not display the error — it simply returns to the input prompt and the error information is lost entirely. Show the error type inline in the retry status: When the user presses Esc to cancel the retry loop, display the last error message before returning to the input prompt, so the error is not lost.

  • Opening log files in another terminal to find the error — this is cumbersome and the log path is not well-documented.
  • Waiting for all 10 retries to complete hoping the error is shown at the end — wastes time if the issue is persistent.
  1. If it's a network error or auth issue, I'd rather cancel immediately and fix the problem
  2. But currently I can't tell the difference, and pressing Esc loses the error entirely

Code Example

Retrying in 4s · attempt 6/10

---

Retrying in 4s · attempt 6/10 (529 overloaded_error)

---

Retrying in 4s · attempt 6/10 (ECONNRESET)
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing requests and this feature hasn't been requested yet
  • This is a single feature request (not multiple features)

Problem Statement

When Claude Code retries an API request, the status line only shows:

Retrying in 4s · attempt 6/10

There is no indication of what error triggered the retry (429, 529, timeout, ECONNRESET, etc.).

Additionally, pressing Esc cancels the retry loop but does not display the error — it simply returns to the input prompt and the error information is lost entirely.

This means the user is completely blind during the retry window and has no way to make an informed decision about whether to wait or take action (check network, API key, rate limits, etc.).

Proposed Solution

Show the error type inline in the retry status:

Retrying in 4s · attempt 6/10 (529 overloaded_error)
Retrying in 4s · attempt 6/10 (ECONNRESET)

When the user presses Esc to cancel the retry loop, display the last error message before returning to the input prompt, so the error is not lost.

Alternative Solutions

  • Opening log files in another terminal to find the error — this is cumbersome and the log path is not well-documented.
  • Waiting for all 10 retries to complete hoping the error is shown at the end — wastes time if the issue is persistent.

Priority

Medium - Would be very helpful

Feature Category

Interactive mode (TUI)

Use Case Example

  1. I'm working in Claude Code and send a prompt
  2. The status shows "Retrying in 4s · attempt 6/10" — I don't know why
  3. If it's a 529 (overloaded), I'd be happy to wait a minute
  4. If it's a network error or auth issue, I'd rather cancel immediately and fix the problem
  5. But currently I can't tell the difference, and pressing Esc loses the error entirely

Additional Context

  • Platform: macOS (darwin)
  • Claude Code version: 2.1.128
  • API: Anthropic API compatible (third-party provider)

extent analysis

TL;DR

Displaying the error type inline in the retry status and showing the last error message when the user cancels the retry loop can improve the user experience.

Guidance

  • Modify the retry status line to include the error type, such as (529 overloaded_error) or (ECONNRESET), to provide immediate feedback to the user.
  • Update the Esc key behavior to display the last error message before returning to the input prompt, ensuring the error information is not lost.
  • Consider logging the error messages in a well-documented location, such as a log file, to provide an alternative way for users to access error information.
  • Review the current logging mechanism to ensure it is user-friendly and accessible.

Example

# Pseudo-code example of displaying error type in retry status
retry_status = f"Retrying in {timeout}s · attempt {attempt}/{max_attempts} ({error_type})"
print(retry_status)

Notes

The proposed solution requires modifications to the Claude Code application, specifically the retry mechanism and error handling. The exact implementation details may vary depending on the application's architecture and programming language.

Recommendation

Apply the proposed workaround by modifying the retry status line and Esc key behavior to display error information, as it directly addresses the user's need for informed decision-making during the retry window.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [FEATURE] Show error reason in retry status line [2 comments, 2 participants]