[DOCS] VS Code extension docs missing "Not responding" red spinner indicator after 60-second backend timeout

Open 💬 5 comments Opened Mar 25, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/vs-code

Section/Topic

"Run multiple conversations" section (status indicator descriptions) and "Fix common issues" section

Current Documentation

The VS Code extension page documents two status indicators on the spark icon:

When using tabs, a small colored dot on the spark icon indicates status: blue means a permission request is pending, orange means Claude finished while the tab was hidden.

The troubleshooting section "Claude Code never responds" advises checking connectivity and starting a new conversation but makes no mention of any visual indicator that appears when the backend stops responding.

What's Wrong or Missing?

Claude Code v2.1.83 added a red spinner with "Not responding" label when the VS Code extension backend hasn't responded for 60 seconds. This is a user-facing error state with no documented meaning or recovery path:

  1. The blue/orange dot descriptions don't mention the red spinner state
  2. The troubleshooting section doesn't reference this visual indicator
  3. Users who see the red spinner have no documentation explaining what it means or what to do

Suggested Improvement

Add the red spinner to the status indicator descriptions alongside blue and orange:

When using tabs, a small colored dot on the spark icon indicates status: blue means a permission request is pending, orange means Claude finished while the tab was hidden, and red with "Not responding" means the backend has not responded for 60 seconds.

Add a recovery note in the troubleshooting section or inline:

If the spinner turns red and shows "Not responding," check your internet connection and try starting a new conversation. If the problem persists, see the troubleshooting section.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/vs-code | Status indicator descriptions (blue/orange — missing red) and troubleshooting section |

Total scope: 1 page affected

Source: Changelog v2.1.83

[VSCode] Spinner now turns red with "Not responding" when the backend hasn't responded for 60 seconds

View original on GitHub ↗

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