CLAUDE.md
CLAUDE.md es un archivo Markdown de instrucciones permanentes que Claude Code carga al iniciar cada sesión y cuyo contenido forma parte de todas sus peticiones.
Contiene lo que el agente debe saber sin que se lo repitas: comandos de compilación y pruebas, convenciones, decisiones de arquitectura y cosas que debe evitar. Claude Code lee el archivo del proyecto (./CLAUDE.md o ./.claude/CLAUDE.md), el personal (~/.claude/CLAUDE.md) y las políticas de la organización. Concatena los archivos; uno no sustituye a otro. Los de subdirectorios se cargan cuando Claude lee algo allí.
Es fácil subestimar el coste. El archivo entra como mensaje después del prompt de sistema y cada petición vuelve a enviar todo el contexto. Cada línea se paga en todos los turnos: menos mientras dura la caché de prompts y a precio completo o superior cuando hay que reconstruirla. Una sección útil una vez al mes se factura en cada petición de cada sesión.
La documentación de Anthropic recomienda menos de 200 líneas por archivo, a septiembre de 2026: los archivos largos ocupan más contexto y se siguen peor. Separarlo mediante importaciones @path ordena el contenido, pero no ahorra tokens, porque también se cargan al inicio. Las instrucciones específicas de un flujo pueden ir a skills o reglas por ruta, que se cargan cuando hacen falta. Claude Code elimina los comentarios HTML de bloque antes de enviarlos al modelo.
El CLAUDE.md de la raíz sobrevive a /compact: Claude Code lo vuelve a leer del disco. Una edición durante la sesión no surte efecto hasta /clear, /compact o un reinicio. /context muestra qué archivos de memoria se han cargado.