¿Qué es CLAUDE.md y para qué sirve?

CLAUDE.md es un fichero de texto que Claude lee automáticamente al inicio de cada sesión. Contiene instrucciones persistentes: tu stack tecnológico, convenciones de código, preferencias de estilo, reglas del proyecto. Es la manera de no tener que repetir el mismo contexto en cada sesión.

¿Cuándo debo usar /clear vs /compact?

/clear reinicia completamente el contexto — como abrir una nueva sesión. /compact intenta resumir el historial para liberar tokens sin perder el hilo. La recomendación del Nivel 3 es preferir /clear: un contexto limpio y deliberado produce mejores resultados que un resumen degradado de una conversación larga.

¿Por qué el rendimiento cae después de ~100K tokens?

Los modelos de lenguaje tienen dificultades para mantener atención uniforme a lo largo de contextos muy largos — especialmente en la información del «medio» de la ventana. A partir de cierto punto, añadir más texto no añade más comprensión: añade ruido. Esta degradación es la razón por la que reiniciar estratégicamente el contexto mejora la calidad.

¿Cómo sé qué incluir en CLAUDE.md y qué dejar fuera?

Incluye solo lo que Claude necesita saber en TODOS los prompts de ese proyecto — no lo que necesita para una tarea específica. El criterio es: ¿cambiaría el output si Claude no supiera esto? Si la respuesta es sí para la mayoría de tareas, entra. Si es solo relevante para casos edge, no entra.

Nivel 3 — El Ingeniero de Contexto

13 de marzo de 2026

Mentalidad: «No eres un programador — eres un curador»

El Nivel 3 es donde la mayoría de practicantes de Claude Code se separan del 50% restante. El insight central es este: la calidad del output no depende de lo que pides — depende de qué información tiene Claude cuando lo pide.

Tu trabajo ya no es solo escribir prompts. Es decidir qué entra en el contexto, qué sale, y cuándo reiniciar. Eres un curador de información, no un escritor de comandos.

Dónde estás ahora

Escribes y mantienes ficheros CLAUDE.md lean — no bloqueados
Piensas deliberadamente sobre qué ve Claude vs. qué no
Usas /clear entre tareas para reiniciar la ventana de contexto
Monitorizas el uso de tokens activamente
Sabes cuándo menos información produce mejores resultados

Habilidades a dominar

Gestión de la ventana de contexto — la habilidad #1 en este nivel
Claude tiene un presupuesto de 200K tokens
El rendimiento degrada significativamente más allá de ~100K tokens (50–60%) — la «zona muerta»
Usa /context para ver el uso en cualquier momento
Usa /clear para reiniciar (preferible a /compact)
CLAUDE.md lean — no inflado. Menos es más
Ejemplos few-shot en lugar de instrucciones largas
Contexto correcto en el momento correcto — quirúrgico, no exhaustivo

La trampa: El CLAUDE.md inflado

Un estudio de ETH Zurich encontró que los ficheros de contexto generados por LLMs hacían a los agentes PEORES en 5 de 8 configuraciones y aumentaban el coste de inferencia en más del 20%. Más contexto no equivale a mejor output.

Claude necesita algo de contexto, no todo el contexto. La diferencia entre «suficiente» y «demasiado» es donde se juega la calidad. Un CLAUDE.md de 50 líneas bien elegidas supera a uno de 500 líneas acumuladas sin criterio. Dominar esta distinción te pone en el top 50% de practicantes de Claude Code a nivel global.

Cómo pasar al Nivel 4

El desbloqueo llega cuando te das cuenta de que necesitas capacidades que Claude no tiene de forma nativa. Para conectar Claude a tu base de datos, probar tu UI o hacer push a GitHub, necesitas herramientas externas. Eso es el Nivel 4.

Próximos pasos

La ingeniería de contexto es la habilidad menos enseñada y más impactante del ecosistema de IA. Si quieres que tu equipo la desarrolle, podemos trabajarla con proyectos reales.

Preguntas frecuentes

¿Qué es CLAUDE.md y para qué sirve?: CLAUDE.md es un fichero de texto que Claude lee automáticamente al inicio de cada sesión. Contiene instrucciones persistentes: tu stack tecnológico, convenciones de código, preferencias de estilo, reglas del proyecto. Es la manera de no tener que repetir el mismo contexto en cada sesión.
¿Cuándo debo usar /clear vs /compact?: /clear reinicia completamente el contexto — como abrir una nueva sesión. /compact intenta resumir el historial para liberar tokens sin perder el hilo. La recomendación del Nivel 3 es preferir /clear: un contexto limpio y deliberado produce mejores resultados que un resumen degradado de una conversación larga.
¿Por qué el rendimiento cae después de ~100K tokens?: Los modelos de lenguaje tienen dificultades para mantener atención uniforme a lo largo de contextos muy largos — especialmente en la información del «medio» de la ventana. A partir de cierto punto, añadir más texto no añade más comprensión: añade ruido. Esta degradación es la razón por la que reiniciar estratégicamente el contexto mejora la calidad.
¿Cómo sé qué incluir en CLAUDE.md y qué dejar fuera?: Incluye solo lo que Claude necesita saber en TODOS los prompts de ese proyecto — no lo que necesita para una tarea específica. El criterio es: ¿cambiaría el output si Claude no supiera esto? Si la respuesta es sí para la mayoría de tareas, entra. Si es solo relevante para casos edge, no entra.