claude doctor — terminal health-check command

What

Run claude doctor from your terminal without starting a Claude Code session to get a quick installation health check.

Usage

claude doctor

Details

Prints installation type, version, commit, search status, auto-update channel, and last update result
Checks settings files for validation errors and environment variable problems
Reports Remote Control eligibility status
Shows warnings and installation issues; reports "No installation issues found." when clean
Points to /doctor in a session for the full fix-everything checkup
Reads settings in the current directory without a workspace-trust prompt, so it is safe to run anywhere

Evidence

Terminal health check output header (search for "Claude Code doctor") and "No installation issues found." message — JN_() at line ~768410

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

How sure we are

One source agreesOne thing we can check says the same as this entry.

Anthropic's release notes agree/doctor is now a full setup checkup that can diagnose and fix issues; /checkup is its alias

See this entry in the whole of v2.1.205 →

The build it came inv2.1.205

8 Jul 2026 · 18 entries, this one is #1.

Either side of it

v2.1.204Older
v2.1.206Newer

Open the release →

Names in this entry

slash/doctor
Skill. Run a setup checkup that diagnoses issues and can fix them. Checks installation health, including duplicate or leftover installs, PATH problems, and unparseable settings files. Finds unused skills, MCP servers, and plugins versus their context cost, flags slow hooks, and checks for a newer version on your release channel. Deduplicates local CLAUDE.md files against checked-in ones, trims checked-in CLAUDE.md files by cutting content Claude could derive from the codebase, and migrates the always-loaded guidance that remains into skills and nested CLAUDE.md files that load on demand. Also offers to make auto mode your default and to pre-approve frequently denied read-only commands. Reports findings first and asks for confirmation before changing anything. From the terminal, claude doctor prints read-only installation diagnostics without starting a session. Alias: /checkup. Run /doctor prompt-audit to have Claude audit your CLAUDE.md files, skills, and other configuration for outdated or conflicting instructions instead of running the checkup. The prompt-audit subcommand requires Claude Code v2.1.283 or later. The CLAUDE.md trim check requires Claude Code v2.1.206 or later. Before v2.1.205, /doctor opened a read-only diagnostics screen and pressing f sent the report to Claude

Anthropic's note

Upstream's own release notes for v2.1.205 name something this entry names, so the two are probably about the same change. Probably: the pairing is made on a shared name rather than on the words around it.

/doctor is now a full setup checkup that can diagnose and fix issues; /checkup is its alias

Is this right?