Ir al contenido
Mastering Claude

Inicio / Una instalación estructurada

Una instalación estructurada8 minApplication

Tus consignas envejecen con los modelos

Una consigna escrita para paliar un defecto de un modelo antiguo se queda en el archivo cuando el modelo cambia y se convierte en ruido que sigue leyendo, y /doctor prompt-audit localiza esas consignas para que se revisen una por una.

Una regla de CLAUDE.md, la descripción de una skill o un comando personalizado nace a menudo de un defecto observado en un modelo concreto. El modelo cambia de generación, la regla se queda en su sitio y nadie la relee mientras no provoque un error.

Un ejemplo documentado

La guía oficial de migración a Claude Opus 5.5 da uno. Algunos equipos habían añadido una consigna para obtener puntos de situación durante las tareas largas, del tipo «después de cada serie de tres llamadas a herramientas, resume tu progreso». Desde Claude Opus 4.7, el modelo da por sí mismo puntos de situación más regulares, y la guía aconseja probar a retirar ese andamiaje. La consigna no es falsa: se ha vuelto inútil, y el modelo sigue leyéndola en cada sesión. En Claude Opus 5.5, esos puntos de situación llegan además en bloques de reflexión, como detalla la lección sobre el paso a Opus 5.5.

Lo que una frase de CLAUDE.md no regula

El esfuerzo de reflexión obedece a la misma lógica. En Claude Code, su nivel se ajusta con /effort, con la opción --effort al arrancar, con la variable CLAUDE_CODE_EFFORT_LEVEL o con la clave effortLevel de los ajustes. Una frase de CLAUDE.md que pide reflexionar más orienta al modelo dentro del nivel elegido, no cambia ese nivel. Las expresiones think o think hard pasan como texto ordinario, siendo ultrathink la palabra clave reconocida, como detalla la lección sobre los gestos rápidos del terminal.

Un ajuste envejece como una consigna. Una clave effortLevel puesta en el primer nivel de los ajustes de usuario sigue aplicándose a Claude Opus 5, a Claude Fable 5.1 y a los modelos anteriores, pero no cuenta para Claude Opus 5.5, que arranca en medium mientras no se haya elegido ningún nivel para él con /effort, con la opción --effort, con la variable CLAUDE_CODE_EFFORT_LEVEL o con la clave effortLevel propia de ese modelo en modelSettings. La misma clave effortLevel puesta en el primer nivel de los ajustes de proyecto o de los ajustes gestionados se aplica, en cambio, a todos los modelos sin excepción.

El comando que localiza esas consignas

Desde la versión 2.1.283 de Claude Code, publicada el 25 de septiembre de 2026, /doctor prompt-audit, accesible también como /checkup prompt-audit, relee los archivos CLAUDE.md, CLAUDE.local.md y AGENTS.md, así como las reglas, skills, comandos, subagentes y estilos de salida guardados bajo .claude/ y ~/.claude/. Busca las consignas escritas para modelos antiguos, las referencias a archivos o comandos que no existen y los archivos que se contradicen. La página de comandos le admite una ruta como argumento.

/doctor prompt-audit
/doctor prompt-audit .claude

El informe enumera sus hallazgos y propone modificaciones, y nada cambia en tus archivos mientras no pidas aplicarlas. El registro de la versión precisa que las rutas y comandos caducados, y los archivos que se contradicen, pasan a la cabeza del informe, y que las palabras clave de reflexión documentadas por Claude Code se conservan. Un hallazgo señala un riesgo de caducidad, no un error probado: cada consigna se relee frente a la documentación actual del modelo al que se llama antes de retirarla o conservarla. El archivo AGENTS.md entra en la misma auditoría.

Figure 1

Una consigna de puntos de situación, antes y después de la revisión

Escrita para un modelo anterior a Claude Opus 4.7
## Tareas largas
Después de cada serie de tres llamadas a herramientas,
resume tu progreso en dos líneas.
Después de una prueba sin la consigna
## Tareas largas
(consigna de puntos de situación retirada tras una
prueba: el modelo los da por sí mismo)
A la izquierda, una sección de CLAUDE.md escrita para un modelo anterior a Claude Opus 4.7; a la derecha, la misma sección después de una prueba sin la consigna.
Calíbralo tú mismo

Un equipo lanza /doctor prompt-audit en su repositorio, en la versión 2.1.283 de Claude Code. El informe señala una regla del archivo CLAUDE.md que pide un resumen de progreso después de cada serie de tres llamadas a herramientas, la vincula a una consigna escrita para modelos antiguos y propone suprimirla. El equipo lee el informe y cierra la sesión.

Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.

Lo que hay que recordar
  • Una consigna nacida del defecto de un modelo sobrevive al cambio de modelo y sigue leyéndose en cada sesión, aunque se haya vuelto inútil.
  • La guía de migración aconseja probar a retirar las consignas que forzaban puntos de situación, pues el modelo los da por sí mismo desde Claude Opus 4.7.
  • En Claude Code, el nivel de esfuerzo se ajusta fuera de CLAUDE.md, y una frase de instrucción orienta al modelo sin desplazar ese nivel.
  • Una clave effortLevel de primer nivel en los ajustes de usuario queda sin efecto en Claude Opus 5.5.
  • La auditoría propone modificaciones y no aplica ninguna sin una petición explícita.
Hazlo ahora

Lanza /doctor prompt-audit en tu proyecto, elige un solo hallazgo que apunte a una consigna escrita para un modelo antiguo, busca en la documentación del modelo al que llamas el comportamiento que esa consigna suponía y decide después conservarla o retirarla antes de pedir cualquier aplicación.

Verificar en la fuente

Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.