# claude doctor Command

> It checks your install from the shell and changes nothing.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude doctor, Claude Code diagnostics

## Think of it like

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

## 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

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.

## Example code

```bash
claude doctor
```

Check the install without starting a session.

## Why it matters

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

## Common mistake

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

## Three principles

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

## Related terms

- [/doctor Command](https://learn.benibix.com/term/ai/doctor-command)
- [/debug Command](https://learn.benibix.com/term/ai/debug-command)
- [Claude Code CLI Command](https://learn.benibix.com/term/ai/claude-code-cli-command)

## Told apart from

- [claude doctor vs /doctor](https://learn.benibix.com/compare/claude-doctor-command-vs-doctor-command): 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.

## Taught in

- [Install, Update and Doctor](https://learn.benibix.com/learn/ai-claude-code-commands/install-update-and-doctor): Claude Code Commands, 2/17

![Two prompts. In the shell you type claude and a word, such as claude update. Inside a session you type a slash, such as /model.](https://learn.benibix.com/diagrams/cli-shell-vs-session.svg)

---

Source: https://learn.benibix.com/term/ai/claude-doctor-command
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
