Mejores Prácticas de Gestión de Contexto

Estos son los patrones que hacen que las herramientas de gestión de contexto de Claude Code funcionen realmente para ti en un proyecto, desde el primer CLAUDE.md hasta una base de código de múltiples sesiones de larga duración.

Cómo Usar Esta Lista

• Trata las prácticas de CLAUDE.md como fundamentales: primero haz bien esas, ya que todo lo demás se basa en un archivo de memoria de proyecto sólido.
• Revisa las prácticas de @menciones e higiene de sesión como hábitos, no como configuraciones únicas.
• Las prácticas de anidación y auditoría son más importantes a medida que un proyecto crece: no las fuerces en un repositorio pequeño de una sola pila.
• Vuelve a esta lista cada vez que se una un nuevo miembro del equipo o la estructura de un proyecto cambie significativamente.

A - Fundamentos de CLAUDE.md

• Comienza con /init en lugar de un archivo en blanco. Deja que Claude Code redacte el primer borrador estructural (pila, diseño de carpetas, comandos existentes) para que solo tengas que escribir lo que no pudo inferir.
• Escribe las reglas como declaraciones concretas y verificables. "Usa zod para validar toda la entrada externa" es algo que se puede seguir; "escribe código limpio" no lo es: la especificidad es lo que hace que una regla se cumpla realmente.
• Asigna a las reglas estrictas su propia sección. Aísla los elementos no negociables genuinos ("nunca confirmes en main") de las convenciones generales para que sean imposibles de pasar por alto.
• Apunta las reglas a un archivo de ejemplo real cuando sea posible. Una convención emparejada con "ver src/repositories/OrderRepository.ts" es más fácil de aplicar correctamente que la misma regla expresada en abstracto.
• Respalda las reglas críticas con aplicación fuera del modelo también. CLAUDE.md es el contexto sobre el que razona el agente, no un sistema de permisos: empareja las reglas genuinamente críticas con una verificación de CI o protección de ramas.
• Mantenlo tan corto como sea posible sin dejar de ser específico. CLAUDE.md se carga en cada sesión; el relleno cuesta presupuesto de contexto repetidamente sin añadir orientación real.

B - Manteniendo CLAUDE.md Actualizado

• Vuelve a ejecutar /init cuando la estructura del proyecto haya cambiado significativamente. Actualiza el archivo basándose en el estado actual en lugar de duplicarlo, dándote una línea base estructural fresca para revisar.
• Compara CLAUDE.md después de cualquier regeneración o edición importante. Confirma que las reglas estrictas escritas a mano y las convenciones del equipo sobrevivieron a la actualización antes de continuar.
• Trata CLAUDE.md como un documento vivo, no como un paso de configuración único. Una regla obsoleta se confía como contexto actual por defecto, por lo que un archivo inexacto puede desorientar activamente al agente.
• Confirma los cambios de CLAUDE.md a través del mismo proceso de revisión que el código. Dado que es un archivo normal en el repositorio, los cambios en él deberían recibir el mismo escrutinio que cualquier otra convención compartida.

C - Usando @menciones Correctamente

• Menciona archivos que sepas que son relevantes, no archivos que podrías necesitar. Cada mención extrae el contenido completo del archivo al contexto: las menciones reflexivas son una fuente común y evitable de hinchazón.
• Prefiere la prosa a una mención cuando solo una parte de un archivo grande es importante. Describir la función o sección específica generalmente cuesta menos contexto que mencionar el archivo completo.
• Encadena un pequeño número de menciones específicas para tareas genuinamente mult-archivo. Unas pocas menciones precisas superan una descripción vaga de todo el código base cuando ya sabes qué archivos están involucrados.
• Deja que Claude Code busque cuando realmente no sepas dónde vive algo. Las menciones son para objetivos conocidos; las tareas exploratorias o de "encontrar dónde ocurre X" son para lo que sirve la búsqueda.

D - Gestionando la Ventana de Contexto

• Utiliza /compact cuando una tarea todavía está activa pero la conversación se ha alargado. Conserva la esencia mientras libera espacio, para que puedas mantener el impulso en el trabajo en curso.
• Utiliza /clear al cambiar a algo no relacionado. Arrastrar incluso una versión resumida de una tarea terminada o no relacionada solo añade ruido a la siguiente.
• Compacta de forma proactiva en lugar de esperar hasta que las cosas se sientan críticas. Una ejecución de /compact más temprano en una sesión larga tiende a producir un resumen más limpio y útil que una ejecutada bajo presión.
• Trata /clear como un hábito rutinario entre tareas, no solo como una medida de recuperación. Limpiar al terminar una tarea, de la misma manera que cerrarías una pestaña del navegador, mantiene las sesiones enfocadas por defecto.
• Vigila las fuentes habituales de hinchazón a medida que avanza una sesión. Archivos grandes leídos en su totalidad, una lista creciente de @menciones y la salida verbosa de herramientas son los culpables recurrentes que vale la pena notar antes de que se acumulen.

E - Escalando a Proyectos Más Grandes

• Pasa a archivos CLAUDE.md anidados una vez que las áreas divergen genuinamente. Un monorepo, una división clara entre backend y frontend, o un área de excepción heredada son señales de que un archivo raíz único está empezando a tener dificultades.
• Deja que los archivos anidados asuman el contexto del archivo raíz en lugar de repetirlo. Un CLAUDE.md anidado solo debe añadir lo que es específico de su propio alcance, no reexplicar las convenciones de todo el proyecto ya cubiertas por encima de él.
• Declara explícitamente las excepciones a las reglas raíz, no implícitamente. Si un subárbol rompe genuinamente una convención de todo el proyecto, dilo directamente en su archivo anidado, junto con el porqué; no dejes que el agente lo note por sí solo.
• Audita periódicamente en proyectos de larga duración o de uso intensivo. Comprueba los archivos grandes leídos repetidamente, el contenido obsoleto o sobredimensionado de CLAUDE.md y los hábitos de mención que se han ido acumulando con el tiempo, incluso sin un síntoma obvio.
• No anides ni dividas prematuramente. La primera solución para un archivo único hinchado suele ser recortarlo; la anidación es para contenido genuinamente específico del alcance, no solo para la longitud.

Preguntas Frecuentes

Relacionado

• Lo que CLAUDE.md Hace Realmente - el concepto fundamental detrás de las secciones A y B.
• Escribir un Archivo CLAUDE.md Que Realmente Se Siga - el patrón completo detrás de reglas concretas y verificables.
• Auditar Qué Está Consumiendo Tu Ventana de Contexto de Claude Code - el flujo de trabajo de auditoría detallado detrás de la sección E.
• Archivos CLAUDE.md Anidados y Cómo Funciona la Herencia de Alcance - la mecánica completa detrás de la guía de anidación de la sección E.
• Por Qué Existen /compact y /clear - el razonamiento detrás de la guía de reinicio de la sección D.

Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente: verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.