Aquí tienes la traducción al español, manteniendo toda la estructura, el formato y los elementos técnicos.
Anteriormente he escrito sobre la mejor manera de promptear la nueva generación de modelos Claude 5 y trabajar con ellos de forma iterativa para descubrir lo que quieres construir.
Pero cuando envías un mensaje a Claude, el prompt es solo una pequeña parte del contexto que recibe. Gran parte de tu contexto se ensambla a partir de tu system prompt, Skills, archivos CLAUDE.md, memoria y otras fuentes. A esto lo llamamos ingeniería de contexto, y tiene un gran impacto en los resultados que generas al usar Claude Code o al construir tus propios agentes.
A diferencia de un prompt, el contexto se usa de manera general en muchas solicitudes, por lo que no puede ser tan específico. ¿Cómo construyes estos prompts y directrices generales para Claude, especialmente cuando no sabes cuál podría ser el prompt de un usuario?
Esto puede ser sorprendentemente difícil a medida que las capacidades de Claude evolucionan. Recientemente, notamos un gran salto en la forma en que prompteamos a la generación más nueva de modelos Claude. Eliminamos más del 80 % del system prompt de Claude Code para modelos como Claude Opus 5 y Claude Fable 5 sin pérdida medible en nuestras evaluaciones de codificación.
Esto es lo que hemos aprendido sobre cómo promptear a esta nueva clase de modelos, y cómo puedes utilizarlo para actualizar tu ingeniería de contexto. Hemos incluido estas mejores prácticas en claude doctor; usa el comando /doctor en Claude Code para ajustar correctamente tus Skills y archivos CLAUDE.md.
Liberando a Claude
En general, descubrimos que estábamos sobre‑restringiendo a Claude Code, tanto a través de nuestro system prompt como en nuestros archivos CLAUDE.md y Skills.
Por ejemplo, cuando leemos transcripciones de nuestro propio uso interno de Claude Code, vemos varios mensajes contradictorios en una sola solicitud, como «deja la documentación según corresponda» o «NO agregues comentarios», mientras que nuestro system prompt, Skills y las solicitudes de los usuarios chocan entre sí.
Generalmente, Claude puede interpretar la intención del usuario para llegar a la respuesta correcta, pero debe pensar con más cuidado sobre estos mensajes superpuestos y contradictorios antes de decidir qué hacer.
Y aunque estas restricciones alguna vez fueron necesarias para evitar los peores escenarios, desde entonces hemos descubierto que podemos eliminar muchas de ellas y dejar que el modelo use el contexto circundante y su criterio en su lugar.
Además, Claude Code ahora tiene muchas más herramientas. Claude solía depender de CLAUDE.md como fuente de memoria, información y directrices. Ahora tenemos memoria, artifacts y Skills, que Claude puede usar para crear nuevas formas de cargar y compartir contexto entre sesiones.
Antes y ahora
Había una serie de prácticas recomendadas anteriores de ingeniería de contexto que se habían convertido en mitos. Entre ellas:
**
**Antes: Darle reglas a Claude
Ahora: Dejar que Claude use su criterio**
**Cuando lanzamos Claude Code por primera vez, necesitábamos asegurarnos de que Claude evitara los peores escenarios, como eliminar archivos. Esto significaba que dábamos directrices particularmente estrictas que podrían no ser siempre ciertas. Por ejemplo, en el system prompt solíamos decir:
En código: por defecto, no escribas comentarios. Nunca escribas docstrings de varios párrafos o bloques de comentarios de varias líneas — máximo una línea corta. No crees documentos de planificación, decisión o análisis a menos que el usuario los solicite — trabaja a partir del contexto de la conversación, no de archivos intermedios.
Pero para un cierto subconjunto de prompts, esta directriz sería incorrecta. En el caso de la documentación, el usuario puede tener sus propias preferencias, o partes específicas de código muy complejo podrían necesitar bloques de comentarios de varias líneas.
Aún así, sin estas barreras de seguridad para modelos más antiguos, los comentarios que Claude escribía serían incorrectos en muchos casos y teníamos que aceptar esta compensación. Pero los modelos más nuevos tienen mejor criterio y pueden manejar estas decisiones bien sin reglas explícitas.
En el nuevo system prompt decimos: Escribe código que se lea como el código circundante: iguala su densidad de comentarios, nomenclatura y modismo.
**Antes: Dar ejemplos a Claude
Ahora: Diseñar interfaces**
**La regla número uno para el uso de herramientas era dar ejemplos a Claude sobre cómo usarlas. Con nuestros modelos más nuevos, hemos descubierto que dar ejemplos en realidad los restringe a un cierto espacio de exploración.
En lugar de usar ejemplos, piensa más en el diseño de tus herramientas, scripts y archivos: ¿qué parámetros tiene Claude y cómo pueden ser más expresivos?
Por ejemplo, en el ejemplo de la herramienta Todo, simplemente listar el estado como una enumeración entre pending, in_progress y completed, le da una pista a Claude sobre cómo usarla. La instrucción de mantener un elemento in_progress ayuda a definir el comportamiento solicitado.
**Antes: Ponerlo todo al frente
Ahora: Usar revelación progresiva**
Debido a que Claude Code se centraba en la codificación, nuestro system prompt incluía información detallada sobre cómo hacer revisión y verificación de código. No siempre eran necesarias, pero cuando lo eran, era información crucial.
Desde entonces, Claude Code se ha vuelto muy competente en el uso de la revelación progresiva: cargar el contexto adecuado en el momento adecuado. Por ejemplo, movimos la verificación y la revisión de código a sus propios Skills que Claude Code podía llamar selectivamente.
Pero la revelación progresiva no es solo para Skills, también la usamos para herramientas. Algunas de nuestras herramientas son de «carga diferida», lo que significa que el agente debe buscar sus definiciones completas usando ToolSearch antes de usarlas. Esto nos permite tener más herramientas (como nuestras herramientas de tareas) que no ocupan contexto hasta que se necesitan.
Lo mismo se puede aplicar a tus propios archivos CLAUDE.md y Skill.md. Un mito común es que quieras hacer de estos un repositorio central para cada práctica conocida con la que podrías encontrarte, porque Claude no la encontraría de otra manera. En su lugar, considera tener un árbol de archivos que se puedan cargar en el momento adecuado.
**Antes: Repetirte
Ahora: Descripciones simples de herramientas**
Los modelos anteriores de Claude a veces necesitaban instrucciones repetidas o eran más propensos a escuchar las instrucciones al final de su ventana de contexto que al principio. Esto significaba que nuestro system prompt a veces tenía referencias a herramientas en el system prompt principal, así como instrucciones en la descripción de la herramienta.
Descubrimos que podíamos eliminar estos ejemplos repetidos y poner instrucciones sobre cómo usar las herramientas en las descripciones de las herramientas en lugar de en el system prompt.
**Antes: Memoria en archivos CLAUDE.md
Ahora: Memoria automática**
Solíamos animar a los usuarios a guardar cosas en la memoria de Claude usando el atajo # para escribir automáticamente en su CLAUDE.md. En cambio, ahora Claude guarda automáticamente recuerdos que son relevantes para el trabajo y para ti.
**Antes: Especificaciones simples
Ahora: Referencias ricas**
En el modo de planificación, Claude Code ha dependido en gran medida de archivos markdown con planes. Almacenar estos archivos como planes ayudaba a Claude a referirse a ellos cuando era necesario. Otra práctica recomendada similar era almacenar especificaciones en el código base para que Claude las consultara mientras trabajaba en proyectos más largos.
Pero hemos descubierto que Claude puede manejar referencias cada vez más complicadas. En lugar de simples archivos markdown, Claude puede referenciar artifacts HTML creados por nuestra nueva funcionalidad de artifacts.
También puedes darle a Claude referencias en forma de código. Una especificación puede ser también un conjunto de pruebas detallado, o una función en un código base diferente que Claude pueda portar.
Las rúbricas son otra forma de referencias. Las rúbricas permiten a Claude intentar verificar tu criterio en un campo particular (por ejemplo, ¿cómo se ve un buen diseño de API?) usando flujos de trabajo dinámicos y poniendo en marcha agentes verificadores con esas rúbricas.
Aplicando esto a tu contexto
Reuniendo todo esto, ¿cómo se ve cuando ensamblas tu contexto?
System Prompt
Un system prompt está fuertemente ligado al contexto del producto. Le dice a Claude en qué producto está operando y qué está haciendo. Para Claude Code, probablemente nunca modifiques esto, pero si estás construyendo tu propio harness de agente, aquí es donde deberías invertir mucho tiempo.
CLAUDE.md
Mantén tu CLAUDE.md ligero y describe brevemente para qué es tu repositorio, pero gasta la mayoría de los tokens en los gotchas dentro del código base. Por ejemplo, puedes organizar tu código para mantener los tipos en un solo archivo monolítico y en ningún otro lugar. Evita afirmar lo «obvio» que Claude debería saber mirando tu sistema de archivos o tu repositorio.
Usa revelación progresiva para más detalles; por ejemplo, si tienes varias instrucciones únicas sobre cómo verificar tu trabajo, crea un Skill de verificación y refiérelo desde tu CLAUDE.md.
Skills
Piensa en los Skills como guías ligeras para que Claude encuentre información cuando sea necesario. Evita hacerlos demasiado restrictivos, excepto en áreas muy importantes.
Para Skills largos, intenta usar la revelación progresiva tanto como sea posible: divídelo en muchos archivos y sepáralos.
Es mejor cuando los Skills codifican opiniones, conocimientos o mejores prácticas particulares para ti, tu equipo o producto.
References
Puedes mencionar archivos con @ para incluirlos como referencias. Las referencias permiten a Claude consultar información detallada sobre el plan actual.
Esto puede ser en archivos de especificaciones, mockups, o incluso bases de código completas. Generalmente, debes preferir archivos que estén en código, ya que proporcionan instrucciones claras y de alta fidelidad a Claude en un lenguaje que conoce muy bien. Por ejemplo, un mockup HTML de un diseño generalmente producirá mejores resultados que una descripción del diseño o una captura de pantalla.
Intenta simplificar
En tu system prompt, Skills y archivos CLAUDE.md, es posible que necesites simplificar tal como lo hicimos nosotros. Lanzamos un nuevo comando llamado claude doctor, que te ayudará a hacer esto automáticamente también. Para más detalles sobre cómo promptear modelos más avanzados específicamente, consulta nuestra guía de campo de Fable.
