claude doctor vs /doctor
People think claude doctor and /doctor are the same check typed in two places, and they are not. claude doctor runs in your shell with no session open. It only reads, so it is the one to use when Claude Code will not start. /doctor runs inside a session. It checks more, and it offers to fix what it finds once you say yes.
claude doctor Command
It checks your install from the shell and changes nothing.
claude doctor checks your Claude Code install from the shell, with no session. It prints how well the install is doing, any settings file with a mistake in it, and if this computer can use Remote Control. It only reads, and changes nothing. Use it when Claude Code will not start. Inside a session, /doctor does a checkup that also offers fixes.
/doctor Command
It checks your setup and offers to fix what is wrong.
/doctor is a bundled skill that runs a checkup on your Claude Code setup. It looks at the install, the settings files, your extensions and your CLAUDE.md. It flags things like a broken settings file, an extension you never use, or CLAUDE.md lines Claude could learn from the code. Then it proposes fixes and applies them only after you agree. If Claude Code will not start at all, run claude doctor in your shell instead.
In one line
- claude doctor Command
- It checks your install from the shell and changes nothing.
- /doctor Command
- It checks your setup and offers to fix what is wrong.