Claude Code audita tu CLAUDE.md: qué hace /doctor prompt-audit

Claude Code publicó la versión 2.1.283 el 25 de septiembre de 2026, y entre la lista de cambios hay uno que te va a tocar directamente si llevas tiempo acumulando instrucciones.

Se llama /doctor prompt-audit (también funciona como /checkup prompt-audit). Y lo que hace, según el propio changelog, es auditar tus ficheros CLAUDE.md, tus skills, tus agentes y tus comandos buscando patrones de prompting escritos para modelos antiguos.

O sea, un comando que te dice qué partes de tus instrucciones están escritas para una IA que ya no es la que tienes delante.

¿Qué hace exactamente el comando?

Lo que dice la entrada del changelog es esto y nada más: audita CLAUDE.md, skills, agentes y comandos, y busca patrones de prompting escritos para modelos más viejos.

Ojo con lo que no dice, porque es tan importante como lo que dice.

No dice si solo te lista los problemas o si además te propone el cambio. No dice qué considera "modelo antiguo" ni a partir de qué versión empieza a quejarse. No dice nada de planes, así que no sé si está en el gratuito o solo de pago. Y tampoco aclara si pasa por todos los CLAUDE.md de la jerarquía o solo por el del proyecto donde lo lanzas.

Lo que sí está claro es la superficie que toca: los cuatro sitios donde vive tu contexto. No es un comando de código. Es un comando de instrucciones.

Por qué esto me parece la novedad de la semana

Te lo digo por experiencia. Mi CLAUDE.md ha pasado por varias mudanzas de modelo, y cada vez que cambia el modelo por debajo, el fichero se queda igual.

Ahí está el problema. El modelo evoluciona. Tus instrucciones no. Y tú no te enteras, porque sigue funcionando. Mal, pero funciona.

Lo que pasa en realidad es que acumulas capas. Escribiste una instrucción en su día porque el modelo de entonces se dejaba cosas a medias. Luego otra porque se inventaba rutas. Luego una tercera repitiendo la primera con otras palabras, porque no te acordabas de que ya la habías escrito. Y al final tienes un fichero que es un museo de problemas resueltos.

Cada línea de esas te cuesta contexto en cada mensaje que mandas. No es gratis. Es alquiler que pagas todos los días por un trastero que no abres.

Si nunca te has parado a pensar qué debería llevar ese fichero y qué no, te dejé mi criterio en cómo escribir tu CLAUDE.md para que la IA no se pierda. La idea de fondo es que menos es más, y ahora hay un comando que te ayuda a encontrar el "menos".

¿Y si mi CLAUDE.md lo escribí hace dos semanas?

Pues igual te salva de menos cosas, claro. Pero hay un detalle que se le escapa a mucha gente: la mayoría de los CLAUDE.md que circulan por ahí no los escribió nadie la semana pasada.

Los copiaste. De una plantilla, de un repo de GitHub, del hilo de alguien que lo compartió, de un vídeo. Y esa plantilla se escribió cuando el modelo de turno necesitaba que le dijeras "piensa paso a paso" o "no te inventes nada" o quince variantes de "revisa antes de responder".

Yo mismo he publicado plantillas de CLAUDE.md para empezar un proyecto, y ahí explicaba que en casi todas las que se comparten hay cosas que sobran. Este comando va justo a esa capa.

Así que no, no es un comando solo para veteranos. Es un comando para cualquiera que haya heredado instrucciones que no escribió.

El otro comando que va en la misma dirección

Este cambio no sale de la nada. Si te bajas el changelog de Claude Code y lo lees hacia atrás, hay una entrada anterior (el feed no numera la versión) que añadió /skill-doctor.

Lo que hace /skill-doctor, según esa misma entrada, es mostrarte qué skills cargadas no se usan y cuánto te cuestan en contexto, para que puedas podarlas.

Ves el patrón, ¿no? Primero un comando para saber qué skills te sobran. Ahora otro para saber qué instrucciones están escritas para un modelo que ya no está. Los dos apuntan al mismo sitio: tu contexto está más gordo de lo que necesita, y hasta ahora no tenías forma de medirlo sin ir a ojo.

A mí esto me interesa especialmente porque tengo bastantes skills montadas. Las conté en las skills de Claude Code que uso a diario, y desde entonces la lista solo ha crecido. Tener un comando que me diga cuáles están muertas me ahorra el repaso manual.

/context ahora cuenta algo que antes no contaba

En la misma 2.1.283 hay otro cambio pequeño que conviene que sepas antes de que te lleves el susto.

/context no estaba contando las instrucciones de los servidores MCP. Ahora sí: aparecen como su propia fila y suman al total.

O sea, que si lanzas /context estos días y el número te sale más alto que la última vez que lo mirabas, puede que no hayas engordado nada. Puede que simplemente antes no te lo estaban contando entero.

Que es peor, en realidad. Porque significa que llevabas tiempo pagando ese contexto sin verlo en el marcador.

¿Qué más trae la 2.1.283?

El resto de la versión es mayoritariamente cosas de administración y arreglos.

Hay dos ajustes nuevos de configuración gestionada para empresas: availableModelsMatch, que con el valor "exact" hace que una entrada de availableModels permita solo la versión de modelo que nombra (así los modelos nuevos siguen bloqueados hasta que alguien los añade a mano), y deniedModels, para bloquear modelos concretos aunque availableModels los permita. Si no administras Claude Code para un equipo, eso no te afecta.

También llega el click para expandir mensajes truncados que vienen de tus otras sesiones, en modo pantalla completa. Detalle de interfaz, pero cómodo.

Y de los arreglos, uno que igual te había pasado: el límite semanal de Fable no aparecía en /usage ni en los medidores de uso de VS Code cuando tenías la telemetría desactivada. Ya aparece.

El resto son correcciones de MCP, de plugins y de cosas de gateway. Nada que cambie tu día.

Qué haría yo con esto

Lanza /doctor prompt-audit una vez y lee lo que te saque. Sin tocar nada todavía.

Porque lo interesante del primer informe no es la lista. Es darte cuenta de cuántas de esas líneas ni recordabas haber escrito. Ese es el dato que te dice si tu contexto lo estás gestionando tú o se está gestionando solo.

Y luego, antes de borrar a lo bestia, una advertencia. Una instrucción "de modelo antiguo" no es automáticamente una instrucción inútil. A veces la pusiste porque el modelo fallaba, sí. Pero a veces la pusiste porque tú quieres que se haga así, y eso no caduca con el modelo. Distinguir las dos cosas sigue siendo tu trabajo, no el del comando.

La documentación oficial y las notas de versión están en la web de Claude Code. Y el changelog completo se publica en el repositorio público de Anthropic, que es de donde sale todo lo que acabas de leer.

Si andas metido en esto de Claude Code y quieres saber por dónde vas de verdad, tengo una formación entera sobre crear tu web con Claude Code sin tocar una línea de código.