[DOCS] /doctor command reference missing "works while Claude is responding" behavior

Open 💬 3 comments Opened Apr 20, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

/doctor entry in the slash command reference

Current Documentation

The commands reference currently says:

| /doctor | Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press f to have Claude fix any reported issues |

Nearby entries on the same page explicitly call out when a command works during an active response:

| /status | Open the Settings interface (Status tab) showing version, model, account, and connectivity. Works while Claude is responding, without waiting for the current response to finish |
| /model [model] | Select or change the AI model. For models that support it, use left/right arrows to adjust effort level. The change takes effect immediately without waiting for the current response to finish |

No current /doctor documentation says it can be opened while Claude is still responding.

What's Wrong or Missing?

Changelog v2.1.116 says:

/doctor can now be opened while Claude is responding, without waiting for the current turn to finish

That user-facing behavior is not documented in the slash command reference or other /doctor mentions. Users reading the docs have no way to learn that /doctor is available during an active response, even though similar mid-response behavior is already documented for /status, /model, and /effort.

This makes the /doctor entry incomplete: it documents what the command does, but not an important interaction detail that affects when users can use it.

Suggested Improvement

Update the /doctor row in the commands reference to mention its mid-response availability, using wording consistent with nearby entries. For example:

Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press f to have Claude fix any reported issues. Works while Claude is responding, without waiting for the current response to finish.

Also update other short /doctor mentions that describe when users should run it, so they do not imply the command is only available after the current turn completes.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/commands | Primary slash command reference for /doctor |
| https://code.claude.com/docs/en/troubleshooting | Tells users to run /doctor to diagnose issues |
| https://code.claude.com/docs/en/how-claude-code-works | High-level built-in commands overview that mentions /doctor |

Total scope: 3 pages affected

Source: Changelog v2.1.116

Exact changelog entry:

/doctor can now be opened while Claude is responding, without waiting for the current turn to finish

View original on GitHub ↗

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