Para usuarios de Claude Code

Claude empieza cada sesión a ciegas.

CLAUDE.md le dice a Claude cómo comportarse. No le dice a Claude qué hay en tu repo. Maguyva indexa la base de código y la pone a disposición vía MCP, así Claude edita como si ya hubiera leído el código.

Empieza gratis Leer la configuración de Claude Code

Nivel Free: 3 repositorios, Hasta 50 mil líneas de repo indexadas, sin tarjeta.

Usa CLAUDE.md para el comportamiento. Usa Maguyva para los hechos actuales de la base de código.

CLAUDE.md es una buena práctica. Úsalo.

> cat CLAUDE.md
# convenciones del proyecto, comandos, reglas acotadas

Las instrucciones persistentes van en CLAUDE.md. Es el lugar correcto para:

Comandos de build, test y lint que el agente debería ejecutar.
Reglas de estilo de código y convenciones de nomenclatura.
Reglas de “siempre haz X / nunca hagas Y” acotadas a un directorio.
Referencias a los docs canónicos y registros de decisiones.

Los docs de memoria de Anthropic describen esto bien. Mantenlo conciso. Acótalo. Guárdalo en un commit.

Pero CLAUDE.md nunca fue pensado para ser un mapa de tu base de código.

Dónde CLAUDE.md deja de ser suficiente

Cuatro modos de falla que el markdown solo no puede arreglar.

// el archivo no es la base de código

Decirle a Claude cómo comportarse no le dice qué existe. La primera edición en un repo desconocido es una adivinanza sobre rutas de archivo, nombres de función y puntos de llamada. CLAUDE.md no puede listar cada símbolo, y tampoco querrías que lo hiciera.

// los docs se desactualizan, el código no

Un bloque de CLAUDE.md que describe tu flujo de auth está bien hasta que alguien refactoriza el auth. El código es ahora la fuente de verdad y los docs afirman con total seguridad información errónea. Claude lee el equivocado.

// las dependencias no están en markdown

“¿Qué se rompe si cambio esta función?” es una pregunta de grafo. No se puede responder desde un archivo de docs. Claude hace grep-y-reza, o te pide que pegues archivos en el chat.

// las ventanas de contexto tienen presupuesto

Rellenar CLAUDE.md hasta que Claude “sepa lo suficiente” consume tokens que deberían pagar por el razonamiento. Pasadas unas pocas KB, cambias calidad de respuesta por volumen de contexto.

Maguyva es la capa que CLAUDE.md no cubre

Un servidor MCP remoto que le da a Claude Code:

Búsqueda semántica, de AST, de grafo y de texto sobre tu repo indexado, devuelta con rutas de archivo y números de línea.
Búsquedas de dependencias, tipos y puntos de llamada las preguntas que un grafo responde y un archivo de docs no puede.
Resultados que tienen en cuenta la rama así Claude ve la versión del código que realmente está editando.
Precios por espacio de trabajo no por usuario. Indexa 1 repo o 50; los agentes no generan cargos por usuario.

CLAUDE.md le dice a Claude cómo comportarse.
Maguyva le da a Claude un mapa consultable del código.

Tres flujos de trabajo

Numerados, con muchos bloques de código. Las preguntas que ya le haces a Claude, fundamentadas en líneas reales.

// workflow 01

Encuentra la implementación real, no el stub de prueba

Tú: "¿Cómo funciona el retry en nuestro cliente de pagos?"

Sin Maguyva → Claude hace grep de retry, encuentra 14 resultados, elige uno (a menudo un mock de prueba).
Con Maguyva    → Maguyva devuelve la definición del símbolo, los puntos de llamada, y el
                   file:line de la implementación real, ordenados.

// workflow 02

Revisa el radio de impacto antes de refactorizar

Tú: "¿Qué llama a normalizePhoneNumber?"

Maguyva devuelve: 7 puntos de llamada en 4 paquetes, incluyendo uno en un servicio de Python
que lo importa vía el stub de gRPC. Claude propone el cambio con la lista de migración
inline, no después de que el CI se ponga en rojo.

// workflow 03

Verifica al agente antes de aceptar el diff

Claude: "Edité src/auth/session.ts:142 para arreglar el refresh del token."

Pregúntale a Maguyva: "Muéstrame session.ts:130-160 y todo lo que importa session."

Maguyva devuelve el fragmento actual del archivo + 3 módulos que lo importan. El diff ahora está fundamentado
en líneas reales, no en el recuerdo de Claude desde el token #11.000.

Configuración en Claude Code

Tres pasos. Nivel Free: 3 repositorios, Hasta 50 mil líneas de repo indexadas, sin tarjeta.

// step 01

Indexa un repo en maguyva.ai

Elige uno que conozcas bien para poder verificar las respuestas. El nivel Free cubre 3 repositorios, Hasta 50 mil líneas de repo indexadas.

// step 02

Instala el plugin de Maguyva en Claude Code

/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

# the plugin reads your key from the environment
export MAGUYVA_API_KEY=mgv_xxxx

// step 03

Haz una pregunta cuya respuesta ya conozcas

Empieza con un repo y una pregunta verificable, no con toda tu empresa. Si la respuesta coincide con lo que dirías, ya estás listo.

// el archivo no es la base de código

// los docs se desactualizan, el código no

// las dependencias no están en markdown

// las ventanas de contexto tienen presupuesto

Encuentra la implementación real, no el stub de prueba

Revisa el radio de impacto antes de refactorizar

Verifica al agente antes de aceptar el diff

Indexa un repo en maguyva.ai

Instala el plugin de Maguyva en Claude Code

Haz una pregunta cuya respuesta ya conozcas

Indexa un repo que ya conozcas.

Sigue leyendo