Sesgo declarado, como siempre: enseño Claude Code a equipos de ingeniería, así que cualquier cosa que cambie cuánto contexto arrastras y cuánto te cuesta mantener la configuración me toca de lleno. Precisamente por eso esta pieza va de hechos verificables y de qué te toca decidir, no de vender un comando de mantenimiento como una revolución.
La semana pasada la portada se la llevó el
navegador integrado en el escritorio. Pero
en la misma tanda de versiones hay un cambio más callado que afecta a algo que
casi nadie mira hasta que duele: la higiene de tu propia configuración. El
comando /doctor deja de ser una pantalla de solo lectura y pasa a diagnosticar
y arreglar.
Los hechos
Según el resumen semanal oficial (semana 28, 6–10 de julio de 2026)
y la referencia de comandos, a partir
de la v2.1.205 /doctor "ahora diagnostica problemas y puede arreglarlos, en
lugar de imprimir un informe de solo lectura". Antes de esa versión, /doctor
abría una pantalla de diagnóstico de solo lectura y, si pulsabas f, mandaba el
informe a Claude. Ahora es un checkup accionable. Su alias es /checkup.
Esto es lo que revisa, según la documentación:
- Salud de la instalación: instalaciones duplicadas o restos de otras
anteriores, problemas de
PATHy ficheros de settings que no se pueden parsear. - Coste de contexto: encuentra skills, servidores MCP y plugins sin usar frente a lo que te cuestan en contexto.
- Tu memoria: deduplica los
CLAUDE.mdlocales contra los versionados en el repo y migra la guía que se carga siempre hacia skills yCLAUDE.mdanidados que se cargan bajo demanda. - Hooks lentos: los marca.
- Versión: comprueba si hay una más reciente.
- Permisos: te ofrece poner el auto mode como tu modo por defecto y preaprobar comandos de solo lectura que rechazas con frecuencia.
La regla de oro del comando es la que importa para soltarlo sin miedo: informa
primero de lo que encuentra y pide confirmación antes de cambiar nada. Nada se
toca a tus espaldas. Y desde la terminal, claude doctor imprime el diagnóstico
de instalación de solo lectura sin arrancar una sesión, útil para scripts o
para una comprobación rápida.
No es un preview: es comportamiento estable a partir de la v2.1.205. Para tenerlo, actualiza.
Por qué esto importa (y no es un simple "arreglar la instalación")
El titular fácil es "un comando que revisa tu setup". El titular real, para un
equipo que trabaja con Claude Code todos los días, es el contexto. Cada skill,
cada servidor MCP, cada plugin y cada línea de CLAUDE.md que se carga siempre
ocupa sitio en la ventana de contexto de cada sesión. Ese peso se paga en tokens,
en latencia y, cuando el CLAUDE.md se infla con cosas que Claude podría deducir
del propio código, en calidad: más ruido, menos foco.
El problema es que esa deuda es invisible. Nadie borra el MCP que probó una tarde,
ni el skill que se instaló para un experimento, ni recorta el CLAUDE.md que
lleva medio año creciendo a base de "por si acaso". Lo que hace el nuevo /doctor
es poner número a esa deuda y ofrecerte saldarla: te dice qué no usas y qué te
cuesta, y te propone mover la guía siempre-cargada a skills y CLAUDE.md anidados
que se activan solo cuando hacen falta.
Qué te afecta, según quién seas
Si eres quien usa Claude Code a diario. Pásale /doctor de vez en cuando,
sobre todo si notas que las sesiones arrancan pesadas o que la instalación se
comporta raro (rutas, settings, restos de versiones antiguas). Como informa antes
de tocar, puedes revisar cada hallazgo y aceptar solo lo que te convenza. La parte
de deduplicar y adelgazar el CLAUDE.md es la de mayor retorno: es justo la
disciplina de mantener la memoria útil y ligera que trabajamos en el curso de
CLAUDE.md y memoria.
Si administras Claude Code para un equipo. Aquí hay dos palancas. La primera
es el inventario de contexto: skills, MCP y plugins sin usar multiplicados por
todas las máquinas del equipo son coste real y repetido; un checkup periódico los
saca a la luz. La segunda son las ofertas de permisos: /doctor puede
proponer poner el auto mode por defecto y preaprobar comandos de solo
lectura que se rechazan una y otra vez. Son decisiones de política, no de gusto
personal, así que conviene tomarlas con criterio antes de repartirlas: qué se
permite sin preguntar y qué no es justo el tipo de decisión que trabajamos en el
curso de permisos, settings y seguridad.
Si mantienes documentación interna u onboarding. Ojo con un detalle: el
comportamiento anterior cambió. Si tu guía interna decía "abre /doctor y pulsa
f para mandar el informe a Claude", esa instrucción ya no describe lo que pasa.
Ahora el comando actúa directamente (con confirmación). Actualiza esa línea antes
de que alguien te pregunte por qué no aparece la pantalla de siempre.
Qué llevarte
/doctoraccionable (v2.1.205): deja de ser solo lectura; ahora diagnostica y arregla, siempre pidiendo confirmación antes de cambiar nada. Alias:/checkup.- Ataca el coste de contexto: encuentra skills, MCP y plugins sin usar frente
a lo que cuestan, y propone mover guía siempre-cargada a skills y
CLAUDE.mdbajo demanda. - Higiene de instalación y memoria: duplicados,
PATH, settings ilegibles, deduplicación deCLAUDE.mdy hooks lentos, todo en una pasada. - Palancas de equipo: puede ofrecerte auto mode por defecto y preaprobar comandos de solo lectura; decídelo como política, no por comodidad.
- En terminal:
claude doctorimprime diagnóstico de solo lectura sin arrancar sesión.
Preguntas rápidas
¿Puede romperme la configuración sin avisar? No. La documentación es explícita: informa primero de los hallazgos y pide confirmación antes de cambiar nada. Revisa y acepta solo lo que quieras.
¿En qué se diferencia de lo que hacía antes?
Antes de la v2.1.205 /doctor era una pantalla de solo lectura y pulsabas f
para enviar el informe a Claude. Ahora el propio comando propone y aplica los
arreglos (con tu confirmación).
¿Sirve para bajar el gasto de tokens?
Indirectamente, sí: al detectar skills, MCP y plugins sin usar y al adelgazar el
CLAUDE.md que se carga siempre, reduces el contexto que arrastra cada sesión.
No es un cambio de precio, es menos peso muerto.
¿Vais a hacer del checkup de configuración una rutina de equipo? Decidir cada
cuánto pasar /doctor, qué guía vive en CLAUDE.md y qué se mueve a skills bajo
demanda, y qué permisos preaprobáis sin preguntar es justo el tipo de criterio que
trabajamos en la formación en directo para equipos — sobre vuestro
repo, vuestra configuración y vuestra política real.