[DOCS] Runtime error docs omit compact warning-line presentation for failed turns

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/errors

Section/Topic

Error reference introduction and shared runtime-failure guidance for CLI, Desktop, and Claude Code on the web

Current Documentation

The docs currently say on the error reference page:

This page lists runtime errors Claude Code displays and how to recover from each one, plus what to check when responses seem off without an error. These errors and recovery commands apply across the CLI, the Desktop app, and Claude Code on the web, since all three wrap the same Claude Code CLI. Match the message you see in your terminal to a section below.

The surface-specific troubleshooting pages also say:

For runtime API errors that appear in the chat such as API Error: 500, 529 Overloaded, 429, or Prompt is too long, see the Error reference. Those errors and their fixes are the same across the CLI, desktop, and web.

and:

For runtime API errors that appear in the conversation such as API Error: 500, 529 Overloaded, 429, or Prompt is too long, see the Error reference. Those errors and their fixes are shared with the CLI and Desktop app.

What's Wrong or Missing?

Claude Code's v2.1.162 changelog says:

Failed turns now show a compact warning line instead of a multi-line red error block

The current documentation explains what runtime/API failure messages mean, but it does not document the current UI presentation of those failed turns.

That leaves two concrete gaps:

A. The shared error reference omits the current failed-turn rendering

Readers are told how to identify an error message and recover from it, but not that a failed turn now appears inline as a compact warning line in the conversation/transcript.

B. Surface-specific troubleshooting pages mention failures appearing in chat/conversation without describing the visible UI

The Desktop and Claude Code on the web pages acknowledge that these errors appear in the chat/conversation, but they do not tell readers that the current presentation is the compact warning-line UI introduced in v2.1.162.

Suggested Improvement

Add a short note to https://code.claude.com/docs/en/errors near the introduction or Find your error section stating that when a turn fails due to a runtime/API error, Claude Code shows the failure in the conversation as a compact warning line.

If Anthropic wants the shared errors page to remain the canonical explanation, the Desktop and Claude Code on the web troubleshooting pages can keep linking there. But they should either:

1. repeat one sentence describing the compact warning-line presentation, or
2. explicitly note that the linked error reference also covers how failed turns appear in the conversation UI.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/errors | 9-19 | Shared runtime error reference explains message matching and recovery, but not the compact warning-line presentation for failed turns |
| https://code.claude.com/docs/en/desktop | 716 | Desktop troubleshooting says runtime API errors appear in the chat and defers to the shared error reference |
| https://code.claude.com/docs/en/claude-code-on-the-web | 775 | Cloud-session troubleshooting says runtime API errors appear in the conversation and defers to the shared error reference |

Total scope: 3 pages affected

Version context: v2.1.162 changelog entry says failed turns now show a compact warning line instead of a multi-line red error block.