CLAUDE.md después de Opus 5: por qué las instrucciones largas ahora se interponen en el camino de Claude

Encontrarás información sobre cómo trabajar con Ailoot en la documentación.

¿Qué cambió en Claude después del lanzamiento de Opus 5?#

Opus 5 salió el 24 de julio de 2026 e inmediatamente se convirtió en el modelo predeterminado de Claude Code. El modelo en sí —su precio, benchmarks y modos de esfuerzo— se trata en detalle en una guía aparte, «¿Deberías pasarte a Claude Opus 5?». Este artículo trata de otra cosa: el lanzamiento del modelo también cambió la forma de hablarle eficazmente.

Anthropic publicó un análisis en el blog de Claude. Su idea principal es la siguiente:

La frase clave es «limitar demasiado». Cuando los modelos eran más débiles, necesitaban un andamiaje: haz esto, no hagas aquello, aquí tienes un ejemplo, repítelo una vez más. Opus 5 ya no necesita ese andamiaje y, lo que es peor, puede empezar a estorbarle. Anthropic expresa el nuevo principio de forma sencilla: deja que Claude use su propio criterio.

¿Qué significa eso en la práctica para ti?

• Tu CLAUDE.md es el mismo tipo de prompt del sistema, pero para tu proyecto. Si Anthropic redujo el suyo en un 80 %, probablemente el tuyo también esté demasiado cargado.
• Las listas largas de reglas ya no garantizan que se cumplan. Al contrario: cuantas más líneas haya, menos atentamente las seguirá el modelo (más abajo veremos cifras de la documentación).
• Han aparecido mecanismos nuevos —la memoria automática y los skills— que asumen parte del trabajo que antes tenías que especificar manualmente en CLAUDE.md.

La parte más importante del trabajo ocurre antes del prompt: en lo que introduces en el contexto del modelo antes de la primera solicitud. La actualización de Opus 5 es, en esencia, la confirmación oficial de Anthropic de esa misma idea. Esta vez, sin embargo, viene acompañada de cifras concretas y herramientas nuevas. Las veremos una por una.

¿Por qué una CLAUDE.md larga se interpone ahora en el camino?#

Así es como funciona. CLAUDE.md es un archivo de reglas que Claude lee al comienzo de cada sesión. Una guía aparte, «Cómo configurar CLAUDE.md», explica cómo crear una desde cero; este artículo trata de lo contrario: qué eliminar de ella ahora. Todo lo que escribes ahí entra en el contexto antes de tu primera solicitud y permanece allí durante toda la conversación. El contexto no es infinito, y cada línea de reglas adicional ocupa espacio que podría dedicarse a tu tarea.

La documentación de Claude Code lo dice sin rodeos:

El segundo punto importa más que el primero: los archivos largos reducen el seguimiento de instrucciones. El modelo presta menos atención. Es una trampa en la que cae casi todo principiante. La lógica parece irrefutable: quiero que Claude me escuche, así que escribiré más reglas. En la práctica, ocurre lo contrario. Cuanto más larga es la lista, más se dispersa la atención del modelo y más a menudo se salta una regla.

Así ha cambiado el enfoque:

También hay un segundo problema: las contradicciones. A medida que un archivo crece, casi inevitablemente acumula reglas que entran en conflicto. En un lugar dice «escribe siempre pruebas» y en otro, «no toques la carpeta de pruebas». La documentación advierte que, si dos reglas se contradicen, Claude puede elegir cualquiera de ellas al azar. En otras palabras, un archivo demasiado extenso hace que el comportamiento del modelo sea menos predecible.

Una regla sencilla: CLAUDE.md es una nota breve sobre lo que Claude no puede deducir por sí mismo. Todo lo demás solo ocupa su atención.

¿Qué debes conservar en CLAUDE.md y qué debes eliminar?#

La documentación establece un criterio claro para decidir si una regla merece estar en CLAUDE.md. Añádela si:

1. Claude cometió el mismo error por segunda vez.
2. Una comprobación del código detectó algo que el modelo debería haber sabido sobre este proyecto.
3. Estás escribiendo la misma corrección en el chat por segunda vez.
4. Una persona nueva del equipo necesitaría el mismo contexto para evitar estropear el proyecto.

El principio general es conservar los problemas específicos del proyecto y eliminar lo evidente. Claude Code incluso tiene una comprobación integrada, claude doctor, que sugiere limpiar una CLAUDE.md demasiado extensa. Elimina detalles que el modelo puede deducir de la base de código —estructura de carpetas, lista de dependencias, descripción general de la arquitectura— y conserva problemas, justificaciones y convenciones que difieren de los valores predeterminados.

La segunda regla importante es la precisión. Las formulaciones vagas no funcionan. Compara:

La diferencia es sencilla. El modelo puede interpretar «formatéalo bien» como quiera. «Usa una sangría de 2 espacios» se puede comprobar sin ambigüedades. Cada regla de CLAUDE.md debería ser algo que puedas verificar y constatar, tanto si se ha cumplido como si no.

Y, en tercer lugar, elimina lo evidente. Si escribes «escribe código limpio» o «sigue las mejores prácticas» en CLAUDE.md, eso es ruido. El modelo ya lo sabe, y esa línea ocupa espacio y dispersa su atención. Anthropic desaconseja expresamente dedicar contexto a cosas obvias.

¿Dónde debes trasladar las reglas que no encajan en CLAUDE.md?#

Aquí es donde entra en juego la herramienta más infravalorada. Antes todas las instrucciones tenían que quedarse en CLAUDE.md; ahora los procedimientos largos tienen un lugar propio: los skills. Una guía aparte, «Cómo elegir skills de Claude Code», explica cómo elegir los adecuados sin añadir demasiados.

La diferencia es fundamental. CLAUDE.md se carga entera al comienzo de cada sesión. Un skill no. La documentación lo explica así:

Esto se llama divulgación progresiva: cargar información según se necesita. La idea es proporcionar contexto al modelo por partes y en el momento adecuado. Anthropic trasladó sus instrucciones detalladas —por ejemplo, las instrucciones para revisar código— a los skills y las eliminó del prompt del sistema.

El criterio para trasladar algo a un skill es sencillo: una sección de CLAUDE.md ha pasado de ser un dato a ser un procedimiento. Una nota de una línea, «las compilaciones se ejecutan con npm run build», es un dato y pertenece a CLAUDE.md. Diez pasos sobre «cómo publicamos el proyecto» son un procedimiento y pertenecen a un skill.

Un principio práctico: delega cualquier cosa que hagas más de un par de veces. Explica una vez cómo preparas, por ejemplo, un informe semanal para un cliente, convierte esa explicación en un skill y no tendrás que volver a explicarlo. El skill queda ahí sin ocupar contexto y puedes invocarlo por su nombre con un comando como /otchet.

Conviene trasladar a skills lo siguiente:

• Procedimientos de varios pasos (publicar, preparar un informe, hacer comprobaciones previas a una versión).
• Instrucciones largas que se necesitan rara vez, pero completas cuando hacen falta.
• Cualquier cosa que copies de un chat a otro por segunda o tercera vez.

También existe una opción intermedia: reglas específicas para una carpeta. Si una instrucción solo importa para una parte del proyecto, puedes ponerla en .claude/rules/ y vincularla a los archivos pertinentes. Así se carga solo cuando Claude trabaja con esos archivos, en vez de permanecer siempre en el contexto.

¿Qué es la memoria automática y por qué usarla en 2026?#

El segundo mecanismo nuevo que aligera CLAUDE.md es la memoria automática. La idea es que ahora Claude recuerda no solo lo que escribiste, sino también lo que él mismo detectó. Una guía aparte, «Claude Memory o CLAUDE.md», explica en qué se diferencia su funcionamiento del de CLAUDE.md.

La diferencia entre los dos tipos de memoria:

Así funciona: mientras trabaja en tu tarea, Claude detecta detalles útiles —qué comando ejecuta la compilación, dónde se atascó la depuración, qué le pediste que hiciera de otra manera— y los guarda en sus notas. Los recupera en la siguiente sesión. Importante: guarda la información de forma selectiva y conserva únicamente lo que considera útil para el futuro.

Las notas están en una carpeta independiente para cada proyecto, con un archivo de índice llamado MEMORY.md. Puedes verlas y editarlas con el comando /memory. Son archivos de texto normales, así que puedes leerlos, editarlos o eliminarlos en cualquier momento.

En la práctica, esto significa que Claude ahora registra algunas cosas que antes tú añadías a CLAUDE.md después de cada error. Así, tu archivo de reglas queda todavía más corto, y eso es bueno.

¿Por qué Opus 5 discute tus instrucciones?#

Esto también tiene una cara menos favorable.

Un modelo al que se permite ejercer su criterio, por definición, a veces discrepará de una orden rígida si encuentra una opción mejor en el contexto.

Esto es lo que significa para ti si te has actualizado a Opus 5 y algo va mal:

1. Vuelve a revisar tus skills y plugins antiguos. Las configuraciones creadas para modelos anteriores pueden entrar en conflicto con la nueva lógica. Conviene volver a probar algo que antes funcionaba como un reloj.
2. Elimina las formulaciones más rígidas. Los modelos de quinta generación responden peor a órdenes como «nunca hagas X, haz siempre solo Y» que a formulaciones flexibles que expliquen por qué.
3. Presta atención a los casos en que el modelo se detiene demasiado pronto. A veces, esto indica que una instrucción se contradice o choca con una regla de una CLAUDE.md demasiado extensa.

Cómo reescribir CLAUDE.md para Opus 5: paso a paso#

Este es el proceso para trabajar con una CLAUDE.md heredada de modelos anteriores.

1. Ejecuta la comprobación integrada

   Escribe claude doctor en el proyecto. Te sugerirá qué eliminar del archivo demasiado extenso y qué conservar.

2. Elimina lo evidente

   Borra todas las líneas que Claude pueda deducir del propio código: estructura de carpetas, lista de bibliotecas y frases generales como «escribe código limpio».

3. Elimina las contradicciones

   Recorre el archivo de arriba abajo y busca reglas que entren en conflicto. Conserva una y elimina la que la contradice.

4. Traslada los procedimientos a skills

   Traslada a un skill independiente todo lo que haya pasado de ser un dato a una instrucción paso a paso. Deja en CLAUDE.md un enlace de una línea.

5. Haz que las reglas restantes sean específicas

   Reformula cada regla para que se pueda comprobar: «formatéalo bien» se convierte en «usa una sangría de 2 espacios».

6. Activa la memoria automática y comprueba la longitud

   Asegúrate de que la memoria automática funciona (/memory) y de que el archivo tiene menos de 200 líneas. Si no, todavía queda algo que trasladar.

Para no hacer la primera revisión a mano, pídele a Claude que se encargue. Aquí tienes un prompt que puedes usar como punto de partida: cópialo y pégalo en una sesión abierta en tu proyecto:

Lee mi CLAUDE.md y mi código. Tu tarea es hacer que CLAUDE.md sea más breve y útil para un modelo de quinta generación.

Revisa el archivo y divide todas las reglas en tres grupos:

CONSERVAR: dificultades específicas del proyecto y convenciones que no puedes deducir por tu cuenta del código.

ELIMINAR: cosas obvias que ya sabes y todo lo que se puede deducir del código.

TRASLADAR A UN SKILL: procedimientos de varios pasos que ahora están escritos en CLAUDE.md.

Para el grupo 1, reformula las reglas vagas para que sean concretas y verificables.
Encuentra las reglas que se contradicen y muéstralas por separado.
Devuelve una nueva versión de CLAUDE.md de menos de 200 líneas, además de una lista de lo que propones trasladar a skills.
No cambies ningún archivo hasta que te dé mi confirmación.

Fíjate en la última línea: «No cambies nada hasta que te dé mi confirmación». Con un modelo que ahora usa su propio criterio, esto es importante: pídele que te muestre primero un plan y deja la decisión en tus manos.

¿Por qué es más importante el contexto que el prompt?#

Si dejamos a un lado los detalles específicos de Opus 5 y miramos el panorama general, todo este análisis gira en torno a una idea: el contexto es más importante que el prompt. El trabajo más importante ocurre antes de la solicitud, cuando preparas el entorno en el que trabajará el modelo.

CLAUDE.md, los skills y la memoria automática son partes de una misma cosa: lo que Claude ve antes de tu primer mensaje. Puedes retocar la redacción de tu solicitud sin parar, pero si el contexto está mal organizado —una CLAUDE.md demasiado extensa, reglas contradictorias, ninguna estructura—, los resultados seguirán siendo incoherentes.

Una comprobación sencilla: sin un primer cerebro, un segundo cerebro no servirá de nada. En este artículo, «segundo cerebro» significa la estructura de conocimientos de un proyecto que el modelo lee con cada solicitud. Pero solo funciona cuando se apoya en una comprensión clara de la tarea por tu parte. Una herramienta amplifica tu pensamiento; ahí termina su función.

La actualización de Opus 5 hizo más evidente esta lógica. Anthropic demostró con su propio trabajo que, cuando el modelo es lo bastante inteligente, las reglas adicionales solo perjudican y la ventaja es de quien ha organizado el contexto con cuidado. Esta habilidad te acompañará con cada modelo futuro, ya sea Opus 6 o cualquier otro.

¿Por dónde deberías empezar ahora mismo?#

No lo dejes para «algún día». El primer paso más sencillo es abrir CLAUDE.md ahora mismo y preguntarte sinceramente sobre cada línea: ¿es una dificultad que Claude no puede deducir o algo evidente que añadí por si acaso? Todo lo del segundo grupo se puede eliminar.

Después, pasa el archivo por el prompt de la sección anterior, traslada los procedimientos largos a skills y comprueba que la memoria automática esté activada. Una tarde de trabajo y tu contexto se convertirá en una base concisa y precisa para el modelo.

Puedes aplicarlo en un proyecto real tuyo: CLAUDE.md, un segundo cerebro y skills para tus tareas.

Conoce Ailoot.