[DOCS] CLI Reference Missing `claude doctor` Command
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:
claudeclaude "query"claude -p "query"cat file | claude -p "query"claude -cclaude -c -p "query"claude -r "<session>" "query"claude updateclaude 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
/doctorslash command is listed indocs/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): "Useclaude doctorto 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): "Runclaude doctorafter installation to check your installation type and version." - Slash Commands Guide (
docs/en/slash-commands.md): Lists/doctoras 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.
---
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗