Claude Code /doctor ya no solo diagnostica: ahora arregla lo que encuentra

`/doctor` dejó de ser el informe que mirabas cuando algo ya fallaba. Ahora es la revisión completa: te encuentra lo roto y, sobre todo, el peso muerto que te come contexto sin que lo notes, y se ofrece a arreglarlo con tu permiso.

Diagrama de /doctor en Claude Code como revisión completa: tarjeta de checkup con dos secciones: Salud (instalación, MCP servers, hook lento) y Coste de contexto (skills, plugins y CLAUDE.md sin usar o duplicado), y la confirmación de aplicar solo lo que apruebas

TL;DR /doctor pasó de imprimir un informe read-only a hacerte una revisión completa. Sigue cazando lo que está roto (instalación, MCP caídos, hooks lentos), pero ahora también destapa el peso muerto que te come contexto en silencio: skills, MCP y plugins que cargas y no usas, CLAUDE.md duplicado o inflado con cosas que Claude ya deduce del código. Te enseña los hallazgos primero y pide confirmación antes de tocar nada. Alias: /checkup.

Hasta hace nada, /doctor era el termómetro: lo ejecutabas cuando algo ya te dolía, te decía dónde miraba en verde/amarillo/rojo y poco más. Desde la v2.1.205 es otra cosa. Ahora es la revisión médica completa: no espera a que estés enfermo, te encuentra cosas que no sabías que estaban mal (de varias clases a la vez), y se ofrece a arreglarlas.

De tomar la temperatura a la revisión completa

El cambio no es cosmético. /doctor mira ahora dos familias de problemas, y esa es toda la gracia:

Lo que está roto. La salud de la instalación, servidores MCP que no responden, hooks que tardan de más. Errores de verdad.
Lo que sobra. Skills, MCP y plugins que tienes cargados pero no usas (y que pagan peaje en tu contexto en cada turno), CLAUDE.md locales duplicados contra los que ya están commiteados, y contenido de tu CLAUDE.md que Claude podría deducir solo mirando el repo.

La segunda familia es la nueva, y es la que más gente ignora: no da error, no rompe nada, solo te encarece cada mensaje sin que lo veas.

Resultado

> /doctor

Setup checkup · 8 checks

  Health
  🟢 Installation      native · Claude Code v2.1.205
  🟢 MCP servers       4/4 responding
  🔴 Hook slow         PostToolUse 'lint' took 4.2s avg

  Context cost
  🟡 Unused skills     3 loaded, 0 used in last 30 sessions
  🟡 Unused plugins    1 loaded, never invoked
  🟡 CLAUDE.md dupes   2 rules also in the checked-in CLAUDE.md
  🟡 CLAUDE.md derivable  ~40 lines Claude can infer from the code

  1 error · 4 warnings · 3 OK

Apply the proposed fixes? Claude will show each change first.
  [y] review and apply   ·   [n] dismiss

Dices que sí y va uno por uno: te enseña el diff de cada arreglo (desactivar la skill que no tocas, quitar las dos reglas duplicadas del CLAUDE.md, podar las líneas que sobran) y solo aplica lo que apruebas. Nada se cambia a tus espaldas.

Cómo se usa

1. Lánzalo dentro de una sesión

/doctor

/checkup hace exactamente lo mismo. Es su alias, por si te sale antes esa palabra. Este checkup completo (peso muerto incluido, y los arreglos) vive solo dentro de la sesión.

2. Lee los hallazgos antes de decidir

La diferencia clave con la versión vieja: primero reporta, luego pregunta. No aplica nada hasta que dices que sí, y te muestra cada cambio individual. Puedes aceptar el arreglo del hook lento y rechazar la poda del CLAUDE.md si ese trozo lo quieres a propósito.

3. claude doctor desde la shell es otra cosa (más ligera)

claude doctor

Ojo, no lo confundas: la versión de shell no es este checkup. Es el chequeo de instalación de siempre (tipo de instalación, versión, PATH, ripgrep, auto-updates), el que corres cuando Claude ni arranca. De hecho, al terminar te lo dice él mismo: "For a full setup checkup that can also fix issues, run /doctor in a Claude Code session." El barrido de peso muerto y los arreglos con confirmación son solo del /doctor de dentro de la sesión.

Lo que revisa

Familia	Check	Qué destapa
Salud	Instalación	Tipo, versión, integridad del binario
Salud	MCP servers	Cada servidor configurado responde
Salud	Hooks	Señala los que tardan de más
Peso muerto	Skills / MCP / plugins sin usar	Lo que cargas pero no invocas, contra su coste en contexto
Peso muerto	`CLAUDE.md` duplicado	Reglas locales que ya están en el `CLAUDE.md` commiteado
Peso muerto	`CLAUDE.md` derivable	Contenido que Claude puede inferir del propio código

Referencia

Aspecto	Detalle
Comando	`/doctor` (alias `/checkup`), dentro de la sesión
Shell `claude doctor`	Chequeo de instalación más ligero; no hace el checkup ni arregla el peso muerto
Antes	Informe read-only
Ahora	Diagnostica y arregla, con confirmación
Orden	Reporta primero, pregunta después, aplica solo lo aprobado
Cobertura nueva	Skills/MCP/plugins muertos, dedup y poda de `CLAUDE.md`, hooks lentos

Cuando lo que tienes es un síntoma concreto (el search no encuentra, un MCP no conecta, una skill desaparece) y quieres el enfoque de "algo está roto, encuéntralo", ese sigue siendo el /doctor de toda la vida. Este tip es lo contrario: el repaso periódico que caza lo que se te escapó.

Y si el checkup te marca el CLAUDE.md como inflado, aquí tienes qué podar y qué dejar: tu CLAUDE.md está lleno de basura. Para el peaje de los plugins que cargas y no usas, este otro lo desglosa.

Documentación oficial: Slash commands · Claude Code Docs