Voor Claude Code-gebruikers

Claude begint elke sessie blind.

CLAUDE.md vertelt Claude hoe het zich moet gedragen. Het vertelt Claude niet wat er in je repo staat. Maguyva indexeert de codebase en levert die terug via MCP, zodat Claude bewerkt alsof het de code al heeft gelezen.

Start gratis Lees de Claude Code-setup

Free tier: 3 repositories, Tot 50K geïndexeerde repo-regels, geen kaart nodig.

Gebruik CLAUDE.md voor gedrag. Gebruik Maguyva voor actuele codebasefeiten.

CLAUDE.md is een best practice. Gebruik het.

> cat CLAUDE.md
# projectconventies, commando's, afgebakende regels

Blijvende instructies horen thuis in CLAUDE.md. Dat is de juiste plek voor:

Build-, test- en lintcommando's die de agent moet draaien.
Codestijlregels en naamgevingsconventies.
“Doe altijd X / doe nooit Y”-regels, afgebakend per directory.
Verwijzingen naar de canonieke docs en decision logs.

De geheugendocs van Anthropic beschrijven dit goed. Houd het beknopt. Bepaal de scope. Commit het.

Maar CLAUDE.md was nooit bedoeld als kaart van je codebase.

Waar CLAUDE.md niet meer volstaat

Vier faalmodi die markdown alleen niet kan oplossen.

// het bestand is niet de codebase

Claude vertellen hoe het zich moet gedragen vertelt het niet wat er bestaat. De eerste wijziging in een onbekende repo is een gok naar bestandspaden, functienamen en call sites. CLAUDE.md kan niet elk symbool opsommen, en dat zou je ook niet willen.

// docs verouderen, code niet

Een CLAUDE.md-blok dat je auth-flow beschrijft, klopt tot iemand auth refactort. De code is nu de source of truth, en de docs zijn zelfverzekerd fout. Claude leest de verkeerde.

// dependencies staan niet in markdown

“Wat breekt er als ik deze functie verander?” is een graafvraag. Die kan niet worden beantwoord door een docbestand. Claude grept-en-hoopt, of vraagt je om bestanden in de chat te plakken.

// contextvensters hebben een budget

CLAUDE.md volstoppen tot Claude “genoeg weet” eet tokens op die eigenlijk voor redeneren zouden moeten betalen. Voorbij een paar KB ruil je antwoordkwaliteit in voor contextvolume.

Maguyva is de laag die CLAUDE.md niet dekt

Een remote MCP-server die Claude Code het volgende geeft:

Semantic, AST, graph en text search over je geïndexeerde repo, teruggegeven met bestandspaden en regelnummers.
Dependency-, type- en call-site-lookups de vragen die een graph wél beantwoordt en een docbestand niet.
Branch-aware resultaten zodat Claude de versie van de code ziet die het daadwerkelijk bewerkt.
Workspace-prijzen niet per seat. Indexeer 1 repo of 50; agents betalen geen seats.

CLAUDE.md vertelt Claude hoe het zich moet gedragen.
Maguyva geeft Claude een doorzoekbare kaart van de code.

Drie workflows

Genummerd, met veel codeblokken. De vragen die je Claude al stelt, gefundeerd op echte regels.

// workflow 01

Vind de echte implementatie, niet de test-stub

Jij: "Hoe werkt retry in onze payment client?"

Zonder Maguyva → Claude grept retry, vindt 14 hits, kiest er één (vaak een test-mock).
Met Maguyva    → Maguyva geeft de symbooldefinitie, de call-sites en de
                   file:line van de echte implementatie terug, gerankt.

// workflow 02

Check de impactradius voordat je refactort

Jij: "Wat roept normalizePhoneNumber aan?"

Maguyva geeft terug: 7 call-sites in 4 packages, waaronder één in een Python-service
die hem via de gRPC-stub importeert. Claude stelt de wijziging voor met de migratielijst
inline, niet nadat CI rood kleurt.

// workflow 03

Verifieer de agent voordat je de diff accepteert

Claude: "Ik heb src/auth/session.ts:142 bewerkt om de token refresh te fixen."

Vraag Maguyva: "Laat me session.ts:130-160 zien en alles wat session importeert."

Maguyva geeft de live bestandsslice + 3 importers terug. De diff is nu gefundeerd
op echte regels, niet op het geheugen van Claude vanaf token #11.000.

Setup in Claude Code

Drie stappen. Free tier: 3 repositories, Tot 50K geïndexeerde repo-regels, geen kaart nodig.

// step 01
Indexeer een repo op maguyva.ai
Kies er een die je goed kent, zodat je de antwoorden kunt verifiëren. Free tier dekt 3 repositories, Tot 50K geïndexeerde repo-regels.

// step 02

Installeer de Maguyva-plugin in 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
Stel één vraag waarvan je het antwoord al weet
Begin met één repo en één verifieerbare vraag, niet met je hele bedrijf. Als het antwoord klopt met wat jij zou zeggen, zit je goed.