Anthropic ha presentado recientemente un cambio significativo en la forma en que Claude Code proporciona contexto a sus modelos más reciente...
Anthropic ha presentado recientemente un cambio significativo en la forma en que Claude Code proporciona contexto a sus modelos más recientes.
Para Claude Opus 5, Claude Fable 5 y otros modelos avanzados de Claude 5, la compañía afirma haber eliminado más del 80% del contenido de las instrucciones del sistema que anteriormente se utilizaba para guiar el funcionamiento correcto de los modelos antiguos. Anthropic también señala que esta simplificación no ha provocado una pérdida medible de rendimiento en sus evaluaciones de codificación.
Esto suena como una historia sencilla: los modelos más potentes necesitan menos reglas detalladas.
Sin embargo, un desarrollador independiente, Chen Cheng (@chenchengpro), ha capturado el contexto de salida generado por Claude Code para varias versiones del modelo y ha reportado una secuencia sorprendente:
| Modelo | Caracteres de instrucciones del sistema reportados |
|---|---|
| Claude Opus 4.7 | 15,225 |
| Claude Opus 4.8 | 4,467 |
| Claude Opus 5 | 7,694 |
Desde Opus 4.8 hasta Opus 5, el contenido de las instrucciones medidas aumentó aproximadamente un 72%.
A simple vista, la afirmación de Anthropic de "eliminar más del 80%" y el resultado del desarrollador de "aumento del 72%" parecen contradictorios.
No es así.
Estas dos cifras utilizan puntos de referencia diferentes y describen aspectos distintos del proceso de transformación de Claude Code. Anthropic describe el cambio de una arquitectura de instrucciones antigua y muy prescriptiva. El desarrollador, en cambio, compara Opus 5 con las instrucciones excepcionalmente compactas que usaba Opus 4.8 en una configuración de captura específica.
Claude Code ciertamente ha eliminado gran parte del antiguo marco de instrucciones. Posteriormente, Opus 5 ha recibido un conjunto nuevo y más reducido de restricciones específicas para gestionar comportamientos que se vuelven más prominentes a medida que aumenta la autonomía del modelo.
La explicación oficial de Anthropic comienza con un problema que muchos desarrolladores de agentes reconocerán: las instrucciones se acumulan.
Cuando los primeros modelos cometían repetidamente un error, el equipo de producto añadía una regla. Si escribía comentarios innecesarios, se añadía una regla sobre comentarios. Si creaba documentos de planificación innecesarios, se añadía una regla sobre documentación. Si usaba mal una herramienta, se añadían ejemplos de uso. Si no verificaba su trabajo, se añadía otra instrucción de verificación.
Con el tiempo, las instrucciones del sistema empezaron a parecerse a un manual de empleado redactado a base de incidentes puntuales.
Este enfoque ayudó a los primeros modelos, pero también introdujo nuevos problemas.
Claude Code no recibe una única instrucción. Su contexto de trabajo puede incluir:
CLAUDE.mdCuando varias capas de instrucciones se repiten o se contradicen ligeramente, el modelo debe emplear energía de razonamiento para decidir qué instrucción debe prevalecer.
Por ejemplo, una capa puede decir que añada documentación cuando sea apropiado, mientras que otra indica que no cree comentarios ni documentación a menos que se le solicite explícitamente. Luego, un archivo del proyecto podría añadir una tercera regla que cubra el mismo comportamiento.
El modelo podría llegar al resultado correcto, pero el contexto ya está haciendo trabajo innecesario antes de que la tarea de codificación haya comenzado.
Anthropic ofrece un ejemplo claro relacionado con comentarios y documentación.
La versión anterior de Claude Code utilizaba restricciones estrictas y detalladas para evitar comentarios de baja calidad y archivos de planificación innecesarios. Las instrucciones actualizadas son mucho más concisas: escribe código coherente con el estilo del proyecto circundante, incluyendo sus convenciones de nomenclatura, estilo idiomático y densidad de comentarios.
Este cambio traslada la base de la decisión de las reglas globales a la evidencia local.
El sistema ya no le dice a Claude que los comentarios siempre son indeseables, sino que le pide que examine cómo el código existente en el repositorio comunica la intención.
Este es el patrón más amplio detrás de la simplificación de las instrucciones:
Método antiguo:
Describir varios errores posibles y prohibirlos de antemano.
Nuevo método:
Proporcionar el rol del producto, herramientas, límites y pruebas relevantes,
y luego dejar que el modelo juzgue por sí mismo dentro de esas restricciones.
Anthropic informa que eliminar más del 80% del contenido de las instrucciones antiguas del sistema no ha provocado una disminución medible en los resultados de sus evaluaciones de codificación.
Este resultado no significa que las instrucciones ya no sean importantes. Significa que las instrucciones efectivas han cambiado.
El rediseño de Anthropic puede resumirse en varias transiciones de "antes y ahora".
| Patrón anterior | Nuevo patrón |
|---|---|
| Dar a Claude muchas reglas detalladas | Dejar que Claude juzgue según el contexto circundante |
| Enseñar herramientas con ejemplos repetitivos | Diseñar interfaces de herramientas claras y expresivas |
| Colocar todos los pasos operativos en el contexto inicial | Cargar instrucciones especializadas solo cuando sea necesario |
| Repetir las instrucciones de herramientas en varios lugares | Mantener cada instrucción en el nivel más adecuado |
| Describir la salida deseada con texto extenso | Proporcionar ejemplos de referencia ricos y ejecutables |
Estos cambios no solo se aplican a las instrucciones internas del sistema de Anthropic. También afectan a cómo los desarrolladores deben mantener CLAUDE.md, las habilidades, las herramientas y los marcos de agentes personalizados.
CLAUDE.md centrado en hechos específicos del proyectoEl archivo CLAUDE.md se carga al inicio de una sesión de Claude Code. Esto lo hace ideal para contener información del repositorio que Claude necesita conocer de forma continua.
Un buen contenido incluye:
Un contenido menos útil incluye:
La documentación actual de Claude Code sugiere mantener CLAUDE.md conciso y trasladar el material procedimental o de referencia denso a archivos de habilidades que se carguen bajo demanda.
Un archivo centralizado podría verse así:
# Guía del proyecto
- Todos los comandos de gestión de paquetes usan pnpm.
- Antes de informar que un cambio de código está completo, ejecuta `pnpm test` y `pnpm lint`.
- La API pública se define en `packages/sdk`; evita cambios disruptivos.
- Las migraciones de base de datos deben incluir un archivo de reversión correspondiente.
- No edites directamente los archivos generados en `src/generated`.
No es necesario explicar exhaustivamente el comportamiento general de la ingeniería de software.
Las habilidades empaquetan instrucciones reutilizables en archivos SKILL.md. Cuando se utiliza una habilidad, se carga su contenido completo, sin ocupar contexto en cada tarea no relacionada.
Esto hace que las habilidades sean más adecuadas para albergar flujos de trabajo como:
Una habilidad de revisión mínima podría estructurarse así:
description: Revisar las solicitudes de extracción para verificar corrección, regresiones y pruebas faltantes.
Este paso solo está disponible al iniciar la revisión, pero no añade carga a solicitudes que solo piden a Claude cambiar nombres de variables.
Es una divulgación progresiva: proporciona contexto adecuado en puntos clave.
Generalmente, cada instrucción debe existir en una sola ubicación autorizada.
Por ejemplo:
CLAUDE.md.Repetir la misma regla en cada nivel no necesariamente refuerza su efectividad, sino que puede aumentar el tamaño del contexto, introducir variaciones en la redacción y dificultar el mantenimiento posterior.
Antes de añadir otra instrucción, pregúntate:
Las guías tempranas de ingeniería de prompts solían recomendar proporcionar múltiples ejemplos de uso de herramientas.
Anthropic considera que los ejemplos pueden limitar a los modelos avanzados a seguir caminos demostrados. El modelo podría imitar la muestra en lugar de elegir parámetros o combinaciones de herramientas óptimos para la tarea actual.
Una herramienta bien diseñada debe comunicar su uso claramente a través de su interfaz:
Por ejemplo, el siguiente valor de enumeración:
{
"status": "pending | in_progress | completed"
}
Comunica las reglas de transición de estado válidas de forma más directa que párrafos extensos.
Incluye algunos ejemplos fijos.
Los ejemplos siguen siendo útiles cuando el formato o el comportamiento en los límites pueden ser ambiguos. Este cambio no es "nunca uses ejemplos", sino "no uses ejemplos para sustituir interfaces bien diseñadas."
Los modelos Claude más nuevos pueden trabajar directamente con referencias más ricas.
Los desarrolladores no necesitan describir cada requisito con texto; pueden proporcionar:
Una prueba ejecutable suele definir el éxito de forma más clara que varios párrafos de texto que dicen "la implementación debe ser correcta".
Esto transforma la ingeniería de contexto de escribir manuales extensos a diseñar mejores entornos de trabajo.
Después del anuncio de Anthropic de una reducción del 80%, el desarrollador Chen Cheng informó haber probado lo que Claude Code enviaba realmente para varios modelos Opus.
Redirigió la CLI a un servidor local y registró el contenido de las solicitudes salientes. Las cifras de caracteres que publicó son las siguientes:
Opus 4.7: 15,225 caracteres
Opus 4.8: 4,467 caracteres
Opus 5: 7,694 caracteres
Estas cifras muestran tres comparaciones diferentes:
| Comparación | Cambio aproximado |
|---|---|
| Opus 4.7 → Opus 4.8 | 70.7% más corto |
| Opus 4.8 → Opus 5 | 72.2% más largo |
| Opus 4.7 → Opus 5 | 49.5% más corto |
Por lo tanto, el prompt de Opus 5 capturado en esta ocasión es mucho más largo que el de Opus 4.8, pero aproximadamente la mitad de largo que el de Opus 4.7.
Se trata de caracteres, no de tokens. Además, representan solo una configuración de Claude Code capturada, no una especificación universal para cada solicitud.
Claude Code puede componer contexto dinámicamente según herramientas, configuración, funcionalidades y estado del producto. El contenido exacto transmitido puede variar según la versión y el entorno.
Una vez que se distinguen las diferentes líneas de base, esta aparente contradicción desaparece.
Anthropic afirma que eliminó más del 80% del contenido del prompt del sistema utilizado por el modelo avanzado Claude 5, en comparación con el diseño anterior rico en instrucciones.
Esta cifra se refiere a la cantidad de prompts heredados eliminados durante la transición a una arquitectura de ingeniería de contexto más moderna.
No afirma que cada solicitud de Opus 5 sea un 80% más corta en caracteres que cada solicitud de Opus 4.8.
La cifra del 72% compara la solicitud registrada de Opus 5 con la captura excepcionalmente pequeña de Opus 4.8.
Opus 4.8 parece ser el punto más bajo en esa comparación de tres modelos. Opus 5, en cambio, añadió orientación específica, mientras que su longitud total sigue siendo mucho menor que la ruta antigua de Opus 4.7.
Por lo tanto, ambas afirmaciones pueden coexistir:
Arquitectura de prompts antigua → Prompt del modelo avanzado:
Reducción general significativa.
Captura de Opus 4.8 → Captura de Opus 5:
Crecimiento parcial sobre la versión medida más pequeña.
La verificación del desarrollador también informó que la implementación de Claude Code contiene dos conjuntos de rutas de prompt.
Una función de enrutamiento selecciona el prompt heredado más detallado para identificadores de modelos más antiguos y el prompt simplificado para los modelos más nuevos.
Según la lógica informada, modelos como Opus antiguo, Sonnet, Haiku y la serie Claude 3 están en la ruta de prompt detallada, mientras que Opus 4.8, Opus 5, Fable 5 y otros modelos más nuevos utilizan la arquitectura más corta.
Este detalle de enrutamiento proviene de una verificación de terceros, no de la documentación oficial de arquitectura de Anthropic.
Sin embargo, coincide con la explicación pública de Anthropic: los modelos más fuertes pueden funcionar con marcos normativos más reducidos, mientras que los modelos más antiguos aún pueden necesitar restricciones explícitas que los modelos más nuevos pueden inferir del contexto.
Claude Opus 5 tiene una capacidad mucho mayor para el trabajo autónomo a largo plazo que las versiones anteriores de Opus.
Esta capacidad introduce comportamientos que son útiles en tareas grandes, pero costosos o distractores en tareas pequeñas.
Describe tu idea una vez y We0 AI puede generar un sitio de presentacion, paginas y CMS, y ayudarte a atraer clientes y trafico tras el lanzamiento.
Una generación completa de proyectos para registro gratuito
Lo mejor para probar un flujo de generación completo y ver rápidamente el primer borrador del proyecto.
La guía oficial de Opus 5 de Anthropic destaca varios aspectos que pueden requerir ajustes:
Según el análisis de diferencias de los desarrolladores informantes, ha surgido una gran cantidad de contenido nuevo en torno a la entrega de trabajo y el manejo de correcciones.
El texto privado exacto no debe considerarse como una especificación pública oficial, pero estas categorías son muy consistentes con la guía publicada de Opus 5 de Anthropic.
Para migraciones largas o revisiones de todo el repositorio, los informes de progreso son útiles.
Para cambios pequeños, las narraciones frecuentes aumentan la latencia y el consumo de tokens sin mejorar el código.
Una estrategia de agente útil necesita distinguir entre estos dos casos:
Informa del progreso en trabajos largos y de múltiples fases, cuando la actualización ayude al usuario a conocer el estado o a tomar decisiones.
No narres cada llamada de herramienta rutinaria.
El objetivo no es el silencio, sino una comunicación proporcionada.
Un agente de codificación avanzado, al completar el cambio solicitado, puede notar problemas relacionados.
A veces esta iniciativa es valiosa. Otras veces, puede convertir una solicitud simple en una refactorización extensa no aprobada por el usuario.
Para Opus 5, los límites de la tarea se vuelven más importantes precisamente porque el modelo es más capaz.
Es mejor encontrar trabajo adicional.
Una solicitud clara puede expresarse así:
Corrige el problema reportado y las pruebas directamente afectadas.
No refactorices módulos no relacionados ni expandas la API pública.
Las condiciones límite definen lo que significa "completado", sin necesidad de especificar cada paso de implementación.
Anthropic indica que Opus 5 es más propenso a usar subagentes que modelos anteriores.
Delegar tiene valor cuando el trabajo es realmente independiente y suficientemente grande para ser procesado en paralelo. Delegar es ineficiente cuando la tarea puede completarse directamente con unas pocas llamadas a herramientas.
La guía oficial sugiere proporcionar condiciones claras o límites deterministas.
Las instrucciones prácticas son las siguientes:
Utiliza subagentes solo para flujos de trabajo grandes e independientes.
No crees subagentes para repetir o verificar trabajo que puedas hacer directamente.
Mantén bajo el número de agentes concurrentes.
Esto controla el costo y el tiempo sin deshabilitar funciones útiles.
Opus 5 está diseñado para detectar y corregir muchos de sus propios errores.
Las instrucciones que piden repetidamente "revisa todo dos veces", "vuelve a verificar" o "revalida con otro agente" se superponen con el comportamiento innato del modelo.
Anthropic afirma que eliminar instrucciones de validación redundantes puede reducir el consumo de tokens inútiles sin disminuir la calidad.
La validación sigue siendo crucial, pero debe basarse en evidencia concreta:
Un patrón ineficiente es pedir reflexión abstracta adicional después de que las comprobaciones objetivas ya hayan pasado.
La guía oficial y las pruebas independientes apuntan a las mismas lecciones prácticas: el contexto debe organizarse en torno a la funcionalidad, no acumularse por preocupaciones.
Verifica todos los elementos que pueden influir en Claude:
CLAUDE.mdBusca instrucciones duplicadas, conflictivas, desactualizadas o demasiado amplias.
CLAUDE.mdElimina la información que Claude pueda obtener directamente de archivos fuente, manifiestos de paquetes o especificaciones estándar.
Conserva solo contenido de decisiones que de otro modo no serían visibles.
Si una parte describe una secuencia repetible en lugar de hechos fijos, conviértela en una habilidad.
Esto reduce el tamaño del contexto predeterminado y hace que los flujos de trabajo sean reutilizables.
No repitas las reglas de parámetros de una herramienta en el mensaje del sistema, CLAUDE.md y cada solicitud del usuario.
Proporciona a las herramientas una arquitectura bien expresada y descripciones precisas.
Siempre que sea posible, proporciona artefactos reales que definan el éxito.
Pruebas fallidas, prototipos, arquitecturas o salidas esperadas son más precisos que largas descripciones de "cómo debería verse el resultado".
Para tareas pequeñas, especifica claramente:
No intentes remediarlo restaurando un manual enorme y genérico.
Anthropic indica que las mejores prácticas actuales están integradas en el flujo de trabajo de Claude Code Doctor.
En el shell, ejecuta:
claude doctor
Dentro de Claude Code, ejecuta:
/doctor
El diagnóstico puede revisar la instalación, configuración, servidores MCP y uso del contexto. La versión actual también puede ayudar a identificar configuraciones de contexto demasiado grandes o inválidas.
Se deben revisar sus recomendaciones, no eliminar ciegamente las guías del proyecto.
# CLAUDE.md
Antes de editar, siempre revisa el repositorio.
Siempre escribe código limpio.
Siempre prueba cada cambio.
Nunca añadas comentarios innecesarios.
Nunca añadas archivos innecesarios.
Usa la herramienta de prueba exactamente como se muestra a continuación...
[Varias páginas de instrucciones de revisión, publicación, prueba y herramientas]
Este archivo contiene expectativas genéricas, procesos repetibles y documentación de herramientas con aplicabilidad variable según la tarea.
# CLAUDE.md
- Usa pnpm; este repositorio no soporta npm ni yarn.
- Se requiere compatibilidad de API pública bajo `packages/sdk`.
- Ejecuta `pnpm test` y `pnpm lint` antes de completar los cambios de código.
- Los pasos de publicación están en la habilidad `/release-check`.
- Los pasos de revisión de seguridad están en la habilidad `/security-review`.
El archivo más pequeño conserva la información específica del proyecto y delega los procesos condicionales a las habilidades.
De esto se trata realmente la reducción de instrucciones: menos instrucciones permanentes y un contexto mejor estructurado.
El número de caracteres en los informes es útil, pero no debe sobreinterpretarse.
No prueban que:
La longitud de las instrucciones es solo una variable.
La calidad de las instrucciones, el orden del contexto, el caché de mensajes, el diseño de herramientas, las habilidades, la evidencia del repositorio y la capacidad del modelo afectan los resultados.
Las instrucciones concisas pueden ser vagas; las más largas pueden ser precisas. El objetivo no es la cantidad mínima de caracteres, sino el contexto mínimo y confiable que proporcione al modelo la información y los límites necesarios.
A medida que los modelos mejoran, el diseño de instrucciones pasa de la microgestión a la gobernanza.
Los agentes más antiguos a menudo necesitaban descripciones detalladas de cada paso. Los agentes más fuertes pueden descubrir más métodos a partir de herramientas y evidencia.
Esto no elimina el papel humano. Cambia dónde el esfuerzo humano es más valioso.
Los constructores de agentes deben dedicar menos tiempo a enumerar cada comportamiento esperado y más a definir:
El modelo necesita menos consejos por cada acción, al mismo tiempo que requiere permisos más claros sobre lo que puede hacer, lo que debe demostrar y cuándo debe detenerse.
Anthropic ha declarado oficialmente que eliminó más del 80% del contenido del mensaje del sistema para Claude Opus 5 y modelos avanzados como Claude Fable 5.
La empresa también indicó que este cambio no provocó pérdidas medibles en su evaluación de codificación.
El 72% se calcula tomando como referencia Opus 4.8. En las capturas del desarrollador, el prompt de Opus 4.8 era excepcionalmente compacto, con solo 4.467 caracteres, mientras que Opus 5, tras recibir instrucciones adicionales más específicas, midió 7.694 caracteres.
No. Estos datos fueron reportados por un desarrollador independiente, quien redirigió la CLI de Claude Code a un servidor local e inspeccionó las solicitudes salientes. Anthropic no ha publicado estos recuentos de caracteres como totales fijos o estándar.
Sí, en las capturas reportadas. Aunque el prompt de Opus 5, con 7.694 caracteres, es más largo que el de Opus 4.8, sigue siendo aproximadamente un 49,5% más corto que el de Opus 4.7, que tenía 15.225 caracteres.
CLAUDE.md?Conserva hechos y reglas específicos del proyecto que el modelo no pueda inferir de forma fiable desde el repositorio. Traslada los flujos de trabajo largos y condicionales a las habilidades, y elimina instrucciones genéricas o redundantes.
Los detalles de las habilidades se cargan solo cuando se necesitan, en lugar de ocupar espacio en cada solicitud. Esto permite una divulgación progresiva y evita que sesiones no relacionadas lleven en su contexto predeterminado procesos de revisión, publicación o despliegue.
Necesita instrucciones diferentes. Anthropic recomienda controlar la verbosidad, las actualizaciones de progreso, el alcance de las tareas, la verificación excesiva, la generación de subagentes y la autocorrección cuando estos comportamientos añadan costes o tiempo innecesarios.
Ejecuta claude doctor en la shell, o /doctor dentro de Claude Code. Revisa también manualmente CLAUDE.md, las habilidades, las descripciones de herramientas y las instrucciones duplicadas, ya que el diagnóstico automático no puede determinar los requisitos específicos de cada proyecto.
SKILL.md, que se cargan bajo demanda.Corrección.
CLAUDE.md, habilidades, hooks, subagentes y controles relacionados.La reducción del 80% de Anthropic y el rebote del 72% reportado por los desarrolladores describen comparaciones diferentes. Claude Code eliminó una gran cantidad de instrucciones heredadas y altamente prescriptivas dirigidas a modelos antiguos. El prompt capturado de Opus 5 luego añadió instrucciones específicas en relación con la versión extremadamente compacta de Opus 4.8.
La longitud del prompt reportado de Opus 5 sigue siendo aproximadamente la mitad del prompt capturado de Opus 4.7. Sus nuevas instrucciones son consistentes con el comportamiento de Opus 5 señalado públicamente por Anthropic: más narración de progreso, mayor alcance de tareas, delegación más frecuente a subagentes, entregables más largos y autocorrección repetida.
Para los desarrolladores, la respuesta útil no es buscar el prompt más corto. Mantén CLAUDE.md enfocado, mueve los flujos de trabajo condicionales a las habilidades, elimina la redundancia, mejora las interfaces de las herramientas, proporciona referencias ejecutables y establece límites claros para el alcance, el costo y la finalización.
La nueva regla de ingeniería de contexto no es "di menos a cualquier costo", sino "carga solo las instrucciones que el modelo necesita, en el nivel que le corresponde".
Empieza con una sola frase y obtén un sitio completo en minutos.
