Pour les utilisateurs de Claude Code

Claude démarre chaque session à l'aveugle.

CLAUDE.md dit à Claude comment se comporter. Il ne lui dit pas ce qu'il y a dans votre dépôt. Maguyva indexe le dépôt et le restitue via MCP, pour que Claude modifie comme s'il avait déjà lu le code.

Commencer gratuitement Voir la configuration Claude Code

Palier Free : 3 dépôts, Jusqu'à 50 000 lignes de dépôt indexées, sans carte.

Utilisez CLAUDE.md pour le comportement. Utilisez Maguyva pour les faits à jour sur le dépôt.

CLAUDE.md est une bonne pratique. Utilisez-la.

> cat CLAUDE.md
# conventions du projet, commandes, règles ciblées

Les instructions permanentes ont leur place dans CLAUDE.md. C'est le bon endroit pour :

Les commandes de build, test et lint que l'agent doit lancer.
Les règles de style de code et les conventions de nommage.
Les garde-fous « toujours faire X / ne jamais faire Y » limités à un répertoire.
Des pointeurs vers la doc canonique et les journaux de décisions.

La doc mémoire d'Anthropic décrit bien tout ça. Restez concis. Délimitez la portée. Commitez-le.

Mais CLAUDE.md n'a jamais été pensé comme une carte de votre dépôt.

Où CLAUDE.md cesse de suffire

Quatre modes d'échec que le markdown seul ne peut pas réparer.

// le fichier n'est pas le dépôt

Dire à Claude comment se comporter ne lui dit pas ce qui existe. La première modification sur un dépôt inconnu est une supposition sur les chemins de fichiers, les noms de fonctions et les points d'appel. CLAUDE.md ne peut pas lister chaque symbole, et vous ne le voudriez pas.

// la doc périme, le code non

Un bloc CLAUDE.md décrivant votre flux d'auth est juste jusqu'à ce que quelqu'un refactorise l'auth. Le code fait maintenant foi et la doc a tort avec assurance. Claude lit la mauvaise version.

// les dépendances ne sont pas dans le markdown

« Qu'est-ce qui casse si je change cette fonction ? » est une question de graphe. Un fichier de doc ne peut pas y répondre. Claude fait soit un grep-et-prie, soit vous demande de coller des fichiers dans le chat.

// les fenêtres de contexte ont un budget

Gaver CLAUDE.md jusqu'à ce que Claude « en sache assez » consomme des tokens qui devraient financer le raisonnement. Au-delà de quelques Ko, vous échangez la qualité des réponses contre du volume de contexte.

Maguyva est la couche que CLAUDE.md ne couvre pas

Un serveur MCP distant qui donne à Claude Code :

Recherche sémantique, AST, par graphe et textuelle sur votre dépôt indexé, renvoyée avec chemins de fichiers et numéros de ligne.
Recherches de dépendances, de types et de points d'appel les questions auxquelles un graphe répond et qu'un fichier de doc ne peut pas.
Résultats conscients des branches pour que Claude voie la version du code qu'il est réellement en train de modifier.
Tarification par espace de travail pas par siège. Indexez 1 dépôt ou 50 ; les agents ne paient pas de siège.

CLAUDE.md dit à Claude comment se comporter.
Maguyva donne à Claude une carte interrogeable du code.

Trois workflows

Numérotés, riches en blocs de code. Les questions que vous posez déjà à Claude, ancrées dans de vraies lignes.

// workflow 01

Trouver la vraie implémentation, pas le stub de test

Vous : "Comment fonctionne le retry dans notre client de paiement ?"

Sans Maguyva → Claude grep retry, trouve 14 résultats, en choisit un (souvent un mock de test).
Avec Maguyva    → Maguyva renvoie la définition du symbole, les points d'appel, et le
                   fichier:ligne de l'implémentation réelle, classés.

// workflow 02

Vérifier le rayon d'impact avant de refactoriser

Vous : "Qui appelle normalizePhoneNumber ?"

Maguyva renvoie : 7 points d'appel dans 4 paquets, dont un dans un service Python
qui l'importe via le stub gRPC. Claude propose le changement avec la liste de
migration en ligne, pas après que la CI passe au rouge.

// workflow 03

Vérifier l'agent avant d'accepter le diff

Claude : "J'ai modifié src/auth/session.ts:142 pour corriger le rafraîchissement du token."

Demandez à Maguyva : "Montre-moi session.ts:130-160 et tout ce qui importe session."

Maguyva renvoie l'extrait de fichier en direct + 3 importeurs. Le diff est maintenant ancré
dans de vraies lignes, pas dans le souvenir de Claude depuis le token n°11 000.

Configuration dans Claude Code

Trois étapes. Palier Free : 3 dépôts, Jusqu'à 50 000 lignes de dépôt indexées, sans carte.

// step 01
Indexez un dépôt sur maguyva.ai
Choisissez-en un que vous connaissez bien pour pouvoir vérifier les réponses. Le palier Free couvre 3 dépôts, Jusqu'à 50 000 lignes de dépôt indexées.

// step 02

Installez le plugin Maguyva dans 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
Posez une question dont vous connaissez déjà la réponse
Commencez par un dépôt et une question vérifiable, pas par toute votre entreprise. Si la réponse correspond à ce que vous diriez, c'est bon.