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 el codebase y lo sirve de vuelta 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 del codebase.

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.
Guardrails de “siempre haz X / nunca hagas Y” acotados 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. Commitealo.

Pero CLAUDE.md nunca fue pensado para ser un mapa de tu codebase.

Dónde CLAUDE.md deja de ser suficiente

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

// el archivo no es el codebase

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 están confiadamente equivocados. 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 conscientes de branch así Claude ve la versión del código que realmente está editando.
Precios por workspace no por asiento. Indexa 1 repo o 50; los agentes no pagan asientos.

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 de archivo en vivo + 3 importadores. 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/claude-code-plugin
/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.