Skip to content
BENIBIX Learn

claude doctor Command

Also known as claude doctor, Claude Code diagnostics

It checks your install from the shell and changes nothing.

Think of it like

It is like a nurse who checks you and writes a note, but gives no pills.

Example

Claude Code quits as soon as Jack opens it. He runs claude doctor, which shows a broken line in his settings file. He fixes the line, and it starts.

Why it matters

When the program itself will not open, you cannot type /doctor. This still works.

Definition

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.

Example code

bash
claude doctor
Check the install without starting a session.
claude doctor runs at the shell prompt. /doctor runs inside a chat.

Common mistake

Waiting for it to fix things. It only reports. /doctor is the one that offers fixes.

Key takeaways

  1. 1
    From the shell. No session.
  2. 2
    Read-only. It changes nothing.
  3. 3
    When it will not start. Use this first.

Compare

Learn it properly