← Artículos

Ingeniería de contexto en Claude Code: menos reglas

· 6 min de lectura

La ingeniería de contexto en Claude Code cambió: Anthropic borró más del 80% del system prompt de la herramienta para los modelos Claude 5 y no midió pérdida en sus evaluaciones de código. Con esta generación, cada regla de más compite contra el criterio del modelo. Quita reglas ultraespecíficas, instrucciones repetidas y ejemplos prescriptivos; conserva el propósito del proyecto y las trampas reales.

Anthropic borró más del 80% del system prompt de Claude Code y, en sus propias evaluaciones de código, no encontró ninguna pérdida. Ocho de cada diez líneas de instrucciones fuera y la herramienta programa igual de bien.

Eso rompe la lógica con la que casi todos configuramos nuestros agentes: cuando el agente falla, el instinto es agregar otra regla, y otra, y otra más. Con esta generación de modelos, cada regla de más lo está frenando.

Qué borró Anthropic exactamente

El 24 de julio de 2026, el mismo día que salió Opus 5, Anthropic publicó en el blog de Claude el artículo «The new rules of context engineering for Claude 5 generation models», firmado por Thariq Shihipar, del equipo de Claude Code.

Contexto de treinta segundos: el system prompt es el manual interno que una herramienta como Claude Code le pasa al modelo antes de cada conversación. Cómo comportarse, qué hacer, qué evitar. Ese manual llevaba años engordando, porque cada vez que algo salía mal alguien agregaba una regla encima de la anterior.

Para los modelos de la generación Claude 5 —Opus 5 y Fable 5— el equipo hizo lo contrario: quitó más del 80% de ese manual y el resultado en sus evaluaciones fue cero pérdida medible en las pruebas de código. La explicación del propio artículo es que muchas de esas restricciones eran salvavidas para el comportamiento de modelos anteriores. Un modelo más capaz trae criterio propio, y una instrucción redundante compite contra ese criterio en lugar de ayudarlo.

Las tres categorías de reglas que ya no ayudan

1. Reglas ultraespecíficas

El ejemplo que da el artículo duele verlo, porque es del system prompt viejo de Claude Code: «Never write multi-paragraph docstrings or multi-line comment blocks — one short line max». Nunca escribas docstrings de varios párrafos.

Piénsalo un segundo. Un día, un docstring largo molestó a alguien, y esa molestia de un martes cualquiera se volvió ley eterna. El modelo carga esa regla en cada tarea, incluso cuando un docstring largo era justo lo que ese código necesitaba.

Seguro tienes las tuyas: nunca uses tal librería, jamás pases de 80 caracteres. Toda regla que nació de un mal día y no de un patrón que se repite es candidata a irse. Si empieza con «nunca» o con «siempre» y describe un detalle microscópico, sospecha.

2. Instrucciones repetidas

Repetir una orden tres veces no la hace más fuerte: hace el manual más largo y el contexto más ruidoso. El caso que documenta Anthropic es la duplicación entre el system prompt y las descripciones de herramientas, que los modelos anteriores necesitaban para que la instrucción no se perdiera en un contexto largo. Con la generación Claude 5, esa duplicación se puede eliminar.

En tu proyecto se ve así: escribiste «responde siempre en español» en el propósito, lo repetiste en las reglas y lo volviste a poner en el checklist del final. Deja una sola versión, la más clara, en el lugar más visible, y borra las otras dos.

3. Ejemplos prescriptivos

Esta es la que más cuesta soltar. La cita del artículo es directa: dar ejemplos «actually constrains them to a certain exploration space», los limita a un espacio de exploración concreto, porque el modelo es más imaginativo que los ejemplos que le damos.

Cuando le muestras el ejemplo perfecto de cómo quieres la respuesta, el modelo deja de pensar y empieza a copiar. Tu techo se convierte en su techo.

Qué pones en su lugar: intención, no órdenes

El reemplazo es guía contextual. En vez de dictar órdenes cerradas, describes la intención y dejas que el modelo aplique criterio.

El propio artículo enseña el cambio con una línea. Donde antes había una lista de reglas de formato, ahora dice: «write code that reads like the surrounding code: match its comment density, naming, and idiom». Escribe código que se lea como el de alrededor, con su densidad de comentarios, sus nombres y sus modismos.

Esa frase sola cubre indentación, nombres y estilo de comentarios, porque apunta al contexto real del proyecto y no a una lista congelada. La prueba rápida para convertir tus reglas: si tu regla responde a «cómo exactamente», reescríbela para que responda a «para qué».

Cómo limpiar tu CLAUDE.md en tres pasos

La receta que se desprende del artículo cabe en una frase: propósito breve del proyecto, más trampas reales del código. Anthropic recomienda gastar los tokens en los gotchas del repositorio y no en cosas que Claude puede descubrir leyéndolo.

  1. Marca, no borres. Abre el archivo y lee cada línea haciéndole una sola pregunta: ¿esto describe qué es el proyecto, o me protege de un error que de verdad pasó? Si no es ninguna de las dos, márcala y sigue.
  2. Agrupa lo marcado en las tres categorías de arriba. Vas a descubrir que la mayoría nacieron de un solo incidente que ya ni recuerdas.
  3. Borra por tanda, no línea por línea. Después de cada tanda, prueba tu agente con una tarea real del proyecto. Si nada se rompe, sigue con la siguiente.

Dónde va lo largo: Skills y revelación progresiva

¿Y las instrucciones largas que sí necesitas, las guías de procesos completos? Para eso están las Skills: minimanuales que Claude abre solo cuando los necesita. El nombre técnico es revelación progresiva. En vez de cargar todo el conocimiento en cada conversación, el modelo va al archivo correcto en el momento correcto.

Tu guía de despliegue, tu checklist de revisión, tu proceso de publicación: cada uno vive en su propia skill y el system prompt ni se entera hasta que hace falta. Y si una skill se te hizo larga, el artículo también lo resuelve: divídela en varios archivos en vez de dejar un bloque enorme. Tu CLAUDE.md adelgaza porque lo pesado se muda a skills bajo demanda.

Lo que no se borra nunca

El dato honesto va en dos partes, porque borrar de más es tan caro como no borrar nada.

El comando que hace la auditoría contigo

Anthropic no lanzó solo el principio: también un comando para aplicarlo. Dentro de una sesión de Claude Code escribes `/doctor` y revisa tu CLAUDE.md y tus skills, y te sugiere qué adelgazar. Ojo con el verbo: sugiere. No borra nada solo, la decisión final es tuya.

El flujo completo queda así:

  1. Corre `/doctor`.
  2. Cruza sus sugerencias con las tres categorías de este artículo.
  3. Borra por tanda.
  4. Prueba una tarea real.
  5. Repite hasta que tu manual quede en propósito breve más trampas reales.

Todo pasa en tu terminal, sin instalar nada aparte. Y esto va más allá de Claude Code: si estás construyendo cualquier agente sobre modelos de la generación Claude 5, la lógica es la misma. System prompt corto, intención en vez de órdenes y el conocimiento pesado en módulos que se abren bajo demanda. Da igual si tu agente escribe código, contesta correos o produce tu contenido.

El video de este artículo

Este tema lo desarmé en video, con el antes y el después de cada categoría y el paso a paso del comando en pantalla:

Claude Code: las nuevas reglas de Anthropic (guía 2026) — https://www.youtube.com/watch?v=Fgjj7lxiz2A

La habilidad ya viene dentro del modelo. Tu trabajo es quitarle los frenos, no ponerle más.

Preguntas frecuentes

¿Cuánto del system prompt de Claude Code borró Anthropic?
Más del 80%. El equipo de Claude Code quitó ocho de cada diez partes del manual interno que la herramienta le pasa al modelo, para las versiones que corren sobre Claude Opus 5 y Claude Fable 5, y no midió ninguna pérdida en sus evaluaciones internas de código.
¿Por qué más reglas empeoran el resultado con los modelos Claude 5?
Porque un modelo más capaz trae criterio propio y cada instrucción redundante compite contra ese criterio en lugar de ayudarlo. Muchas de las restricciones antiguas eran guardarraíles escritos para el comportamiento de modelos anteriores; hoy solo alargan el contexto y limitan al modelo sin darle información nueva.
¿Qué reglas debo quitar primero de mi CLAUDE.md?
Tres categorías. Las reglas ultraespecíficas que nacieron de un mal día concreto, las instrucciones repetidas en varios sitios del mismo manual y los ejemplos prescriptivos que le muestran al modelo la respuesta perfecta. Márcalas primero, agrúpalas por categoría y bórralas por tandas probando después de cada una.
¿Qué líneas de mis instrucciones no debería borrar nunca?
Las trampas reales de tu proyecto: el bug que volvió tres veces, la carpeta que no se toca, el comando que rompió producción. Esa es memoria institucional y sin ella el agente vuelve a tropezar con la piedra que tú ya pagaste. También conserva el propósito breve del repositorio.
¿Qué hace el comando /doctor de Claude Code?
Dentro de una sesión de Claude Code, revisa tu CLAUDE.md y tus skills y te sugiere qué adelgazar. Es importante el verbo: sugiere, no borra nada por su cuenta, así que la decisión final sigue siendo tuya y conviene probar el agente con una tarea real después de cada tanda.
¿Dónde pongo las instrucciones largas que sí necesito?
En Skills, minimanuales que Claude abre solo cuando hacen falta mediante revelación progresiva. Tu guía de despliegue o tu proceso de publicación viven cada uno en su propia skill y no ocupan contexto hasta que se usan. Si una skill se hace larga, divídela en varios archivos.

Fuentes

MÁQUINA IA

La comunidad donde dejas de usar IA y empiezas a dirigirla.

Entrar a la comunidad →