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
/memoryantes 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.
📖 Read the full source: r/ClaudeAI
👀 Ver también
Caminando y dictando con Claude Code: una configuración práctica
Un desarrollador comparte su configuración: camina 2-3 horas al día mientras dicta indicaciones a Claude Code mediante OpenAI Whisper, usando un control remoto o chats con compañeros de trabajo.
El uso de IA para generar tickets de proyecto antes de programar reduce la desviación del alcance.
Un desarrollador descubrió que pedir a la IA que genere tickets de proyecto detallados con tareas, subtareas, alcance y criterios de aceptación antes de escribir cualquier código redujo significativamente la expansión del alcance y las diferencias grandes en los cambios. Cada agente de IA solo recibe su subtarea específica, no el plan completo.
El grupo de límite de tasa OAuth no documentado de Anthropic requiere el mensaje del sistema Claude Code
Al usar tokens OAuth de Anthropic, la API dirige las solicitudes al grupo de límite de tasa de Claude Code según si tu prompt del sistema se identifica como Claude Code. Agregar "Eres Claude Code, la CLI oficial de Anthropic para Claude." a tu prompt del sistema resuelve misteriosos errores 429.
100K Líneas de Rust con IA: Contratos, Desarrollo Guiado por Especificaciones y Rendimiento
Cheng Huang construyó un motor multi-Paxos en Rust con agentes de IA, logrando 300K operaciones/seg. Técnicas clave: contratos de código escritos por IA, desarrollo ligero guiado por especificaciones y optimización agresiva.