¿Qué hace /doctor en Claude Code? Qué cambia el chequeo en tu CLAUDE.md, qué detecta prompt-audit y cómo encontrar skills que consumen contexto (2026)

Existen dos comandos con nombres casi idénticos:

• claude doctor, ejecutado en tu terminal, es solo de diagnóstico. Anthropic dice: "Para diagnósticos de instalación de solo lectura sin iniciar una sesión, ejecuta claude doctor en tu terminal en su lugar".
• /doctor, ejecutado dentro de una sesión, es el chequeo completo. La referencia de comandos lo describe como una ejecución que "diagnostica problemas de instalación, configuración, extensiones y CLAUDE.md, y propone correcciones que Claude aplica después de que confirmes".

El registro de cambios de Claude Code marca cuándo cambió la versión dentro de la sesión: "/doctor es ahora un chequeo de configuración completo que puede diagnosticar y solucionar problemas; /checkup es su alias". Por lo tanto, /checkup y /doctor ejecutan lo mismo.

La documentación de skills de Anthropic enumera cinco áreas.

Salud de la instalación. Instalaciones duplicadas o sobrantes, problemas de PATH, archivos de configuración imposibles de analizar y si hay una versión más reciente disponible en tu canal de lanzamiento.

Extensiones. El chequeo compara "skills no utilizadas, servidores MCP y plugins" con "su costo de contexto", y busca hooks lentos.

Archivos CLAUDE.md. Archivos CLAUDE.md locales que duplican los registrados (checked-in), contenido registrado que Claude podría derivar del código base y la guía que siempre se carga y permanece, la cual Claude ofrece migrar a skills y archivos CLAUDE.md anidados que se cargan bajo demanda.

Permisos. Una oferta para hacer del modo auto tu modo de permiso predeterminado y para pre-aprobar comandos de solo lectura que sueles denegar.

Uso. En los planes Pro, Max, Ultra, Team y Enterprise, los cambios que /usage recomienda para reducir el uso de tu plan, medido durante los últimos siete días. Anthropic dice: "Claude propone los cambios que puede realizar por sí mismo e informa el resto como consejos, como un comando para que tú lo ejecutes". El chequeo de uso requiere Claude Code v2.1.305 o posterior, y el chequeo lo omite mientras Remote Control está conectado.

La parte del chequeo relativa a CLAUDE.md es importante porque la guía de CLAUDE.md registrada siempre se carga.

La documentación de memory de Anthropic explica qué recorta y qué conserva. El chequeo "propone recortes para un CLAUDE.md registrado: elimina el contenido que Claude puede derivar del código base, como diseños de directorios, listas de dependencias y resúmenes de arquitectura, y conserva dificultades (pitfalls), fundamentos y convenciones que difieren de los valores predeterminados de las herramientas".

Esa división es la parte útil. Un árbol de directorios o una lista de dependencias es algo que Claude puede leer del repositorio cada vez que lo necesite. Una nota sobre por qué una migración debe ejecutarse primero, o una convención que sigue tu equipo y que una herramienta no asumiría, no se puede derivar del código. El chequeo trata el primer tipo como costo y el segundo como valor.

Por qué el tamaño importa

La guía de Anthropic para CLAUDE.md es directa: "apunta a menos de 200 líneas por archivo CLAUDE.md. Los archivos más largos consumen más contexto y reducen la adherencia".

Algunos límites relacionados de la misma documentación:

• Advertencias. "Si uno de tus archivos de instrucciones supera la longitud recomendada, verás una advertencia al inicio y cuando ejecutes /status."
• Tamaño combinado. También verás una advertencia cuando los archivos que están dentro de esa longitud sumen más de un límite combinado al inicio de la sesión.
• Techo máximo. "Claude Code omite cualquier archivo que supere los 4 MiB".
• Las importaciones no ayudan con el tamaño. Dividir en importaciones @path "ayuda a la organización pero no reduce el contexto, ya que los archivos importados se cargan con el CLAUDE.md que los importa".

Si el problema es un CLAUDE.md anidado que Claude parece ignorar a mitad de camino, ese es un límite por archivo separado. Nuestra guía sobre por qué Claude ignora el final de un CLAUDE.md de subdirectorio lo cubre.

A dónde va la guía recortada

El chequeo no solo borra. Para la guía que siempre se carga pero que solo importa en ocasiones, ofrece moverla a skills y archivos CLAUDE.md anidados "que se cargan bajo demanda". Las reglas con alcance de ruta (path-scoped rules) son la otra opción documentada: se cargan "solo cuando Claude trabaja con archivos que coinciden".

El chequeo revisa tu configuración. prompt-audit revisa tu escritura. Anthropic dice: "Para auditar tus instrucciones en lugar de tu configuración, ejecuta /doctor prompt-audit en el prompt de Claude Code".

Su documentación de memory describe lo que busca: "Claude busca problemas como instrucciones escritas para modelos más antiguos, referencias a archivos o comandos que no existen y archivos que se contradicen entre sí".

Cada uno de estos es un modo de falla real:

• Instrucciones escritas para modelos más antiguos. La entrada del registro de cambios que lo introdujo describe la auditoría como una verificación de "patrones de prompting escritos para modelos más antiguos".
• Referencias obsoletas. Una ruta de archivo que se movió o un script que fue renombrado pueden hacer que Claude busque algo que no está allí.
• Contradicciones. Anthropic señala que "si dos instrucciones se contradicen, Claude puede elegir una arbitrariamente".

Una versión posterior cambió el orden del informe: "las rutas obsoletas, los comandos obsoletos y los archivos de instrucciones contradictorios ahora encabezan el informe, y se mantienen las palabras clave de pensamiento que Claude Code documenta".

Qué cubre

"Por defecto, la auditoría cubre tus archivos CLAUDE.md, CLAUDE.local.md y AGENTS.md, además de las reglas, skills, comandos, subagents y estilos de salida bajo .claude/ y ~/.claude/."

Para auditar un solo archivo o carpeta, pasa su ruta. El ejemplo de Anthropic es /doctor prompt-audit .claude/skills/deploy.

Qué cambia

Nada, hasta que tú lo pidas. "Recibes un informe de hallazgos con ediciones propuestas, y nada en tus archivos cambia hasta que le pidas a Claude que las aplique".

Requisitos

La auditoría "se ejecuta a través de la skill integrada /claude-api". No está disponible si esa skill está desactivada en skillOverrides o con disableBundledSkills, y requiere Claude Code v2.1.283 o posterior.

Las skills tienen un costo de contexto propio. La documentación de skills de Anthropic dice: "Cada skill en la lista de skills se suma a tu contexto en cada turno, independientemente de si Claude la usa alguna vez".

/skill-doctor es el informe para eso. Anthropic dice que muestra "cuánto cuesta cada una de tus skills y con qué frecuencia se usa, para que puedas decidir cuáles desactivar".

Lo que incluye el informe:

• Skills en tu sesión que no sean las integradas (bundled) o de empresa.
• Una marca en las skills "que nunca han sido invocadas", indicando dónde desactivarlas.
• Plugins que no has usado recientemente.

El consejo de Anthropic sobre por dónde empezar: "De las skills que te indica dónde desactivar, comienza con las que tengan el mayor costo de contexto".

En una sesión interactiva, el informe se abre en la pestaña Stats del gestor /plugin. Con -p, Claude Code lo imprime como texto. Requiere la v2.1.252 o posterior y la obtención de feature-flags. A través de Remote Control desde tu teléfono o navegador, no está disponible. Ejecútalo en la terminal de la máquina donde se está ejecutando la sesión.

• Algo parece roto o lento al iniciar: claude doctor en tu terminal, para diagnósticos de instalación de solo lectura.
• Las sesiones se llenan rápido o se ignoran instrucciones: /doctor para el chequeo completo, incluyendo recortes de CLAUDE.md.
• Las instrucciones podrían estar obsoletas o ser contradictorias: /doctor prompt-audit, para un informe sobre lo que has escrito.
• Has instalado muchas skills: /skill-doctor, para ver el costo de contexto y el uso de cada skill.

La propia regla del chequeo es la mejor guía: corta lo que Claude pueda derivar del código base, conserva "dificultades (pitfalls), fundamentos y convenciones que difieren de los valores predeterminados de las herramientas".

Las partes que conserva son las que el código no puede decirle a Claude: la razón por la que una prueba es inestable, el orden en que deben ejecutarse dos scripts, la convención que un revisor siempre pide. Esas son también las partes que importan fuera del CLAUDE.md de un repositorio, por ejemplo, cuando comienzas un nuevo proyecto con reglas similares o trabajas en otra herramienta.

Si el propio Claude guarda notas, estas viven en la auto memory, que tiene su propio índice y límites. Nuestra guía sobre qué es la auto memory de Claude Code explica en qué se diferencia de CLAUDE.md.

Ejecutar claude doctor y detenerse ahí. Solo revisa la instalación. Las revisiones de CLAUDE.md y extensiones están en /doctor.

Dividir CLAUDE.md en importaciones para ahorrar contexto. Los archivos importados se cargan con el archivo que los importa.

Borrar los fundamentos para bajar de 200 líneas. El chequeo conserva los fundamentos y las dificultades por una razón.

Aceptar todas las ediciones propuestas a la vez. Revisa cada una, ya que nada cambia hasta que lo pidas.

Mantener todas las skills instaladas. Cada skill listada se suma a tu contexto en cada turno.

Paso 1: Ejecuta el chequeo

Escribe /doctor en una sesión y lee los hallazgos de cada área antes de aprobar nada.

Paso 2: Audita lo que has escrito

Ejecuta /doctor prompt-audit y corrige primero las rutas obsoletas, los comandos obsoletos y las contradicciones.

Paso 3: Desactiva las skills que no uses

Ejecuta /skill-doctor y comienza con las skills no utilizadas que tengan el mayor costo de contexto.

Paso 4: Guarda los fundamentos que conserves

Copia las dificultades, razones y convenciones que conserves en un lugar donde puedas reutilizarlas más allá de este repositorio.

El chequeo es bueno para separar lo que Claude puede leer del código de lo que solo tú sabes. Vale la pena guardar el segundo grupo, como dificultades, razones y convenciones de equipo, donde puedas usarlo en más de un proyecto y más de una herramienta.

MemoryLake es una capa de memoria para ese tipo de conocimiento de proyecto, como convenciones, decisiones y las razones detrás de ellas, mantenida en un solo lugar por ti y disponible para los asistentes que conectes, como ChatGPT, Claude Code y Codex.

Tú mismo escribes las entradas, con tus propias palabras. No se lee, escribe ni borra nada de tus archivos CLAUDE.md, tus reglas, tus skills, tu auto memory, tu carpeta ~/.claude ni de ningún almacén de proveedores. El chequeo y prompt-audit funcionan de la manera que Anthropic describe, y tú sigues decidiendo qué ediciones aplicar.

Paso 1: Crea una clave API

Inicia sesión y genera una clave desde el panel de control. Guárdala fuera de tus repositorios, como cualquier otra credencial.

Paso 2: Sube tus primeras memorias

Comienza con lo que guardaste en el Paso 4 de la solución: las dificultades, razones y convenciones que el chequeo te indicó conservar. Un elemento por entrada.

Paso 3: Conecta tu IA y agentes

Conecta Claude Code y cualquier otro asistente que uses. Las mismas entradas estarán disponibles en cada proyecto y herramienta que conectes.

La primera diferencia es un CLAUDE.md más ligero por el que no tienes que preocuparte. Las razones que recortaste del contexto que siempre se carga siguen estando escritas.

La segunda es la reutilización entre proyectos. Las convenciones que sigues en todas partes no tienen que copiarse en cada repositorio.

La tercera es el mismo conocimiento en otras herramientas. Codex o ChatGPT también pueden recurrir a las entradas.

Usa /doctor, no solo claude doctor. Las revisiones de CLAUDE.md y extensiones ocurren en la sesión.

Mantén CLAUDE.md por debajo de 200 líneas. Los archivos más largos consumen más contexto y reducen la adherencia.

Conserva los fundamentos, corta lo derivable. Esa es la propia regla del chequeo.

Ejecuta prompt-audit después de cambios de modelo. Busca instrucciones escritas para modelos más antiguos.

Corrige las contradicciones primero. Claude puede elegir una de dos instrucciones en conflicto de forma arbitraria.

Poda las skills por costo. Comienza con las skills no utilizadas que cuestan más contexto.

Revisa antes de aplicar. Nada cambia hasta que tú lo pidas.

/doctor en Claude Code es un chequeo de configuración completo: analiza la salud de la instalación, extensiones, archivos CLAUDE.md, permisos y uso, y propone correcciones que aplica solo después de que confirmes. Para CLAUDE.md, elimina el contenido que Claude puede derivar del código base y conserva dificultades, fundamentos y convenciones. claude doctor en tu terminal es la revisión de instalación de solo lectura.

/doctor prompt-audit revisa tus archivos de instrucciones en busca de guías obsoletas, referencias caducas y contradicciones, y /skill-doctor muestra cuánto cuesta cada skill en contexto y con qué frecuencia se usa. Úsalos juntos para mantener ligero lo que se carga en cada sesión, y guarda el razonamiento que decidiste conservar en algún lugar donde puedas reutilizarlo.