Claude Code a escala: Cómo la búsqueda agéntica evita los modos de fallo de RAG en grandes bases de código

Claude Code se está ejecutando en producción en monorepositorios con millones de líneas, sistemas heredados de décadas de antigüedad (C, C++, C#, Java, PHP) y arquitecturas distribuidas con miles de desarrolladores. En lugar de depender de la recuperación basada en RAG — que falla porque los pipelines de incrustaciones no pueden mantenerse al día con equipos activos, devolviendo funciones renombradas hace dos semanas o módulos eliminados — Claude Code navega por los codebases como un ingeniero de software: recorre el sistema de archivos, lee archivos, usa grep y sigue referencias localmente sin necesidad de construir, mantener o cargar un índice centralizado a un servidor.

El arnés importa más que el modelo

El rendimiento de Claude Code está determinado menos por las pruebas de referencia del modelo y más por el arnés — cinco puntos de extensión que se complementan entre sí:

• Archivos CLAUDE.md — archivos de contexto cargados automáticamente al inicio de cada sesión: un archivo raíz para la visión general, archivos de subdirectorios para convenciones locales. Mantenerlos centrados en información ampliamente aplicable evita desperdiciar la ventana de contexto.
• Hooks — no detallados más allá de enumerarse como punto de extensión.
• Skills — no detallados más allá de enumerarse como punto de extensión.
• Plugins — no detallados más allá de enumerarse como punto de extensión.
• Servidores MCP — no detallados más allá de enumerarse como punto de extensión.

Dos capacidades adicionales — integraciones LSP y subagentes — completan la configuración. El artículo recomienda construir estas capas en el orden indicado, ya que cada capa se basa en la anterior.

Compensación: calidad del contexto inicial

La búsqueda agéntica funciona mejor cuando Claude tiene suficiente contexto inicial para saber dónde buscar. Pedirle que encuentre todas las instancias de un patrón vago en un codebase de mil millones de líneas alcanzará los límites de la ventana de contexto antes de comenzar a trabajar. Los equipos que invierten en la configuración del codebase a través de archivos CLAUDE.md obtienen mejores resultados.