Optimizando CLAUDE.md para Reducir la Ansiedad de Contexto en Claude AI

Estrategias Clave de Optimización de CLAUDE.md

Basándose en un debate de Reddit que analiza la documentación de Anthropic, varias mejoras concretas pueden aumentar significativamente la efectividad de CLAUDE.md y reducir la ansiedad de contexto.

Estructura y Longitud del Archivo

• Mantén CLAUDE.md por debajo de 200 líneas. La guía de Anthropic indica que archivos más largos reducen la adherencia, haciendo que Claude omita reglas cuando hay demasiadas.
• Usa el directorio .claude/rules/ para dividir reglas en archivos separados enfocados en rutas de archivo específicas. Estas reglas solo se cargan cuando Claude toca archivos coincidentes, reduciendo el ruido de contexto.
• Separa reglas de comportamiento de la estructura del proyecto. CLAUDE.md debe manejar reglas de comportamiento, mientras que los detalles de arquitectura deben hacer referencia a documentos externos usando el formato @/ruta/a/arquitectura.md, que Claude carga al inicio sin inflar el archivo principal.
• Usa comentarios HTML como <!-- nota del mantenedor --> para notas humanas, que se eliminan antes de entrar en el contexto, proporcionando espacio libre para comunicación del equipo sin costar tokens.

Especificidad de las Instrucciones

• Haz que las instrucciones sean lo suficientemente específicas para verificar. "Usa sangría de 2 espacios" funciona efectivamente, mientras que instrucciones vagas como "Escribe código limpio" se ignoran, llevando a bucles de corrección que desperdician tokens.
• Un bucle de corrección puede fácilmente consumir 10-50 veces más tokens que la línea que lo habría prevenido.

Aprovechando la Memoria Automática

• Desde la versión 2.1.59, Claude guarda sus propias notas sobre comandos de compilación, patrones de depuración y preferencias del usuario.
• Verifica lo que Claude ya ha aprendido con /memory antes de añadir información redundante a CLAUDE.md.
• Deja de duplicar lo que la memoria automática ya maneja para evitar inflar innecesariamente el contexto.

Implementación

Para equipos sin un archivo CLAUDE.md, /init genera un punto de partida decente que puede refinarse desde allí. Dado que CLAUDE.md se carga en cada sesión de todos modos, no cuesta nada extra, mientras que instrucciones claras desde el principio previenen correcciones de ida y vuelta que consumen tokens significativos.