[DOCS] CLI Reference Missing `claude doctor` Command

Resolved 💬 4 comments Opened Jan 19, 2026 by coygeek Closed Feb 27, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

URL: https://code.claude.com/docs/en/cli-reference File: docs/en/cli-reference.md

Section/Topic

The CLI commands table at the beginning of the CLI Reference page.

Current Documentation

The "CLI commands" table currently lists the following entries:

  • claude
  • claude "query"
  • claude -p "query"
  • cat file | claude -p "query"
  • claude -c
  • claude -c -p "query"
  • claude -r "<session>" "query"
  • claude update
  • claude mcp

It does not contain an entry for claude doctor.

What's Wrong or Missing?

The claude doctor command is a critical diagnostic tool that is frequently referenced in other parts of the documentation, but it is entirely omitted from the master CLI Reference command table. This leads to a "hallucination" effect where the documentation refers to a command that doesn't appear in the primary list of supported commands.

Specifically:

  • It is missing from the command table in docs/en/cli-reference.md.
  • However, the /doctor slash command is listed in docs/en/slash-commands.md.

Suggested Improvement

Add a row for claude doctor to the CLI commands table in docs/en/cli-reference.md with the following details:

| Command | Description | Example |
| :--- | :--- | :--- |
| claude doctor | Run diagnostics to check installation health, detect configuration issues, and identify context usage warnings | claude doctor |

Impact

High - Prevents users from using a feature

Additional Context

Evidence of references in other documentation files:

  • Costs Guide (docs/en/costs.md): "Use claude doctor to see your current version and installation details."
  • Troubleshooting Guide (docs/en/troubleshooting.md): "Verify installation: claude doctor # Check installation health."
  • Setup Guide (docs/en/setup.md): "Run claude doctor after installation to check your installation type and version."
  • Slash Commands Guide (docs/en/slash-commands.md): Lists /doctor as a built-in command.

Including it in the CLI Reference will ensure users who check the primary command list for available utilities can find and understand how to use the diagnostic tool from their shell.

---

View original on GitHub ↗

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