El comando /doctor, escrito dentro de una sesión de Claude Code, deduplica tu CLAUDE.md local contra el del repositorio, poda el contenido que Claude podría deducir del propio código y migra a skills la guía que no hace falta cargar siempre. Requiere la versión 2.1.206 o posterior. El comando sugiere los cambios: la decisión final es tuya.
Si tu archivo de instrucciones creció hasta las doscientas líneas, no hace falta que decidas a mano qué sobra. Claude Code trae un comando que lo poda por ti y te deja la decisión final.
Se llama `/doctor` y hay una confusión que conviene quitarse de encima antes de empezar, porque a mí me costó un rato.
Son dos cosas distintas con el mismo nombre.
`claude doctor`, escrito en tu terminal como comando suelto, revisa la salud de tu instalación. Lo corres y te devuelve algo así: versión, plataforma, ruta de instalación, si las auto-actualizaciones están activas, y un `No installation issues found` al final. Útil cuando algo va raro. Pero no toca tus instrucciones.
`/doctor`, escrito dentro de una sesión de Claude Code, es el chequeo completo. La documentación lo describe como un setup checkup que diagnostica problemas y puede arreglarlos, y ahí es donde está lo que te interesa.
Esa diferencia explica por qué mucha gente lo corre, ve cuatro líneas sobre su versión y concluye que el comando no hace nada.
La documentación oficial lo dice en una frase, y merece leerse entera porque son tres operaciones distintas:
> *"Deduplicates local `CLAUDE.md` files against checked-in ones, trims checked-in `CLAUDE.md` files by cutting content Claude could derive from the codebase, and migrates the always-loaded guidance that remains into skills and nested `CLAUDE.md` files that load on demand."*
Traducido a lo que verás:
Un requisito concreto antes de que te frustres: el chequeo de poda del CLAUDE.md necesita Claude Code v2.1.206 o posterior. Si tu versión es anterior, el comando corre pero esa parte no aparece. Compruébalo con `claude --version`.
1. Actualiza y comprueba la versión.
```
claude --version
```
Si te sale algo por debajo de 2.1.206, actualiza antes de seguir.
2. Abre Claude Code en la carpeta del proyecto.
No en tu carpeta de usuario: en el proyecto cuyo CLAUDE.md quieres limpiar. El comando trabaja contra el código que tiene delante, así que el repositorio importa.
3. Guarda una copia del archivo actual.
```
cp CLAUDE.md CLAUDE.md.bak
```
Diez segundos que te ahorran el arrepentimiento. Vas a comparar dentro de una semana.
4. Corre el comando dentro de la sesión.
```
/doctor
```
Ojo con el verbo: el comando sugiere y propone cambios, y la decisión final es tuya. No te va a dejar el archivo irreconocible a tus espaldas.
5. Cruza sus sugerencias con las tres categorías.
Esta parte es tuya y es la que sube la calidad del resultado. De lo que te proponga quitar, acepta sin pensarlo mucho lo que caiga en estas tres:
6. Borra por tandas, no de golpe.
Quita un grupo, corre una tarea real del proyecto, comprueba que el resultado sigue siendo el que quieres. Después el siguiente grupo.
7. Repite hasta que quede propósito breve más trampas.
El objetivo no es un número de líneas. Es que el archivo quede con dos cosas: para qué sirve el repositorio, y lo que el modelo no puede deducir mirándolo.
`/doctor` no es el único que toca esta zona, y saber qué hace cada uno te ahorra trabajo:
Porque no es una manía de orden: es el mismo movimiento que hizo Anthropic con su propia herramienta.
En su post sobre context engineering para la generación Claude 5 cuentan que eliminaron *"over 80% of Claude Code's system prompt for models like Claude Opus 5 and Claude Fable 5 with no measurable loss on our coding evaluations"*. Más del ochenta por ciento fuera, sin pérdida medible en sus evaluaciones de código.
La recomendación que dan para tu archivo es la misma que aplica el comando: mantenlo ligero, describe brevemente para qué sirve el repositorio y gasta la mayor parte en los *gotchas* del código.
Tres avisos antes de que lo corras.
Sugiere, no decide. Revisa cada propuesta. El comando no conoce las trampas que tú aprendiste a golpes, y esas son justamente las líneas que hay que defender.
Esto está pensado para la generación Claude 5. El propio post de Anthropic reconoce que los modelos anteriores a veces necesitaban instrucciones repetidas. Si trabajas con uno viejo, tus reglas largas todavía te están sirviendo.
El "sin pérdida medible" es de sus evaluaciones internas de código. No es una garantía para tu proyecto. Por eso la tanda y la prueba real del paso 6 no son opcionales: son la manera de comprobarlo en tu caso concreto.