Hoppa till innehåll

För Claude Code-användare

Claude börjar varje session blind.

CLAUDE.md talar om för Claude hur den ska uppträda. Den talar inte om vad som finns i ditt repo. Maguyva indexerar kodbasen och levererar den tillbaka via MCP, så att Claude redigerar som om den redan läst koden.

Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kort.

Använd CLAUDE.md för beteende. Använd Maguyva för aktuella kodbasfakta.

CLAUDE.md är en god praxis. Använd den.

> cat CLAUDE.md
# projektkonventioner, kommandon, avgränsade regler

Beständiga instruktioner hör hemma i CLAUDE.md. Det är rätt plats för:

  • Bygg-, test- och lintkommandon som agenten ska köra.
  • Kodstilsregler och namngivningskonventioner.
  • “Gör alltid X / gör aldrig Y”-regler avgränsade till en katalog.
  • Hänvisningar till de kanoniska dokumenten och beslutsloggarna.

Anthropics minnesdokumentation beskriver det här väl. Håll det kortfattat. Avgränsa det. Committa det.

Men CLAUDE.md var aldrig tänkt att vara en karta över din kodbas.

Var CLAUDE.md slutar räcka till

Fyra sätt det brister på som markdown ensamt inte kan lösa.

// filen är inte kodbasen

Att tala om för Claude hur den ska uppträda talar inte om vad som finns. Den första ändringen i ett okänt repo blir en gissning om filsökvägar, funktionsnamn och anropsplatser. CLAUDE.md kan inte lista varje symbol, och det vill du inte heller att den ska.

// dokumentation blir föråldrad, koden inte

Ett CLAUDE.md-block som beskriver ditt autentiseringsflöde stämmer tills någon refaktorerar autentiseringen. Koden är nu sanningen och dokumentationen är övertygande fel. Claude läser fel version.

// beroenden finns inte i markdown

”Vad går sönder om jag ändrar den här funktionen?” är en graffråga. Den kan inte besvaras av en dokumentationsfil. Claude tvingas antingen grep:a och hoppas eller be dig klistra in filer i chatten.

// kontextfönster har en budget

Att stoppa CLAUDE.md full tills Claude ”kan tillräckligt” äter upp tokens som borde gå till resonemang. Efter några KB byter du bort svarskvalitet mot kontextvolym.

Maguyva är lagret som CLAUDE.md inte täcker

En fjärransluten MCP-server som ger Claude Code:

  • Semantisk, AST-baserad, graf- och textsökning över ditt indexerade repo, returnerad med filsökvägar och radnummer.
  • Uppslag för beroenden, typer och anropsplatser de frågor som en graf kan besvara och en dokumentationsfil inte kan.
  • Grenmedvetna resultat så att Claude ser den version av koden den faktiskt redigerar.
  • Prissättning per arbetsyta inte per plats. Indexera 1 repo eller 50; agenter betalar inte för platser.

CLAUDE.md talar om för Claude hur den ska uppträda.

Maguyva ger Claude en sökbar karta över koden.

Tre arbetsflöden

Numrerat, tungt på kodblock. Frågorna du redan ställer till Claude, förankrade i verkliga rader.

// workflow 01

Hitta den verkliga implementationen, inte teststubben

Du: "Hur fungerar retry i vår betalningsklient?"

Utan Maguyva → Claude grep:ar retry, hittar 14 träffar, väljer en (ofta en testmock).
Med Maguyva    → Maguyva returnerar symboldefinitionen, anropsplatserna och
                   fil:rad för den verkliga implementationen, rankade.

// workflow 02

Kontrollera påverkansradien innan du refaktorerar

Du: "Vad anropar normalizePhoneNumber?"

Maguyva returnerar: 7 anropsplatser i 4 paket, inklusive en i en Python-tjänst
som importerar den via gRPC-stubben. Claude föreslår ändringen med migreringslistan
direkt i svaret, inte efter att CI blivit röd.

// workflow 03

Verifiera agenten innan du accepterar diffen

Claude: "Jag ändrade src/auth/session.ts:142 för att fixa tokenuppdateringen."

Fråga Maguyva: "Visa mig session.ts:130-160 och allt som importerar session."

Maguyva returnerar det levande filutdraget + 3 importerare. Diffen är nu förankrad
i verkliga rader, inte i vad Claude minns från token nummer 11 000.

Installation i Claude Code

Tre steg. Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kort.

  1. // step 01

    Indexera ett repo på maguyva.ai

    Välj en du känner väl så att du kan verifiera svaren. Free-nivån täcker 3 repositorier, Upp till 50K indexerade repo-rader.

  2. // step 02

    Installera Maguyva-pluginet i 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
  3. // step 03

    Ställ en fråga vars svar du redan känner till

    Börja med ett repo och en verifierbar fråga, inte hela ditt företag. Om svaret stämmer med vad du själv skulle säga är du redo.