Spring til indhold

Til Claude Code-brugere

Claude starter hver session blind.

CLAUDE.md fortæller Claude, hvordan den skal opføre sig. Den fortæller ikke Claude, hvad der er i dit repo. Maguyva indekserer kodebasen og leverer den tilbage over MCP, så Claude retter, som om den allerede har læst koden.

Free-niveau: 3 repos, Op til 50K indekserede repo-linjer, intet kort.

Brug CLAUDE.md til adfærd. Brug Maguyva til aktuelle kodebasefakta.

CLAUDE.md er best practice. Brug den.

> cat CLAUDE.md
# projektkonventioner, kommandoer, afgrænsede regler

Vedvarende instruktioner hører hjemme i CLAUDE.md. Det er det rette sted til:

  • Build-, test- og lint-kommandoer, agenten bør køre.
  • Kodestilsregler og navngivningskonventioner.
  • “Gør altid X / gør aldrig Y”-sikkerhedsregler afgrænset til en mappe.
  • Henvisninger til den kanoniske dokumentation og beslutningslogge.

Anthropics hukommelsesdokumentation beskriver det her godt. Hold den kortfattet. Afgræns den. Commit den.

Men CLAUDE.md var aldrig tænkt som et kort over din kodebase.

Hvor CLAUDE.md holder op med at være nok

Fire svigttilstande, som markdown alene ikke kan løse.

// filen er ikke kodebasen

At fortælle Claude hvordan den skal opføre sig fortæller den ikke hvad der findes. Den første rettelse på et ukendt repo er et gæt på filstier, funktionsnavne og kaldesteder. CLAUDE.md kan ikke opremse hvert symbol, og det ville du heller ikke ønske.

// dokumentation bliver forældet, kode gør ikke

En CLAUDE.md-blok, der beskriver dit auth-flow, er korrekt, indtil nogen refaktorerer auth. Koden er nu den eneste sandhed, og dokumentationen er selvsikkert forkert. Claude læser den forkerte.

// afhængigheder findes ikke i markdown

“Hvad går i stykker, hvis jeg ændrer denne funktion?” er et grafspørgsmål. Det kan ikke besvares af en dokumentfil. Claude enten grep'er-og-håber eller beder dig indsætte filer i chatten.

// kontekstvinduer har et budget

At proppe CLAUDE.md indtil Claude “ved nok” æder tokens, der burde betale for ræsonnement. Ud over et par KB bytter du svarkvalitet for kontekstvolumen.

Maguyva er laget, CLAUDE.md ikke dækker

En ekstern MCP-server, der giver Claude Code:

  • Semantisk, AST-, graf- og tekstsøgning over dit indekserede repo, leveret med filstier og linjenumre.
  • Opslag på afhængigheder, typer og kaldesteder de spørgsmål en graf kan besvare, og en dokumentfil ikke kan.
  • Branch-bevidste resultater så Claude ser den version af koden, den rent faktisk retter.
  • Prissætning pr. arbejdsområde ikke pr. bruger. Indekser 1 repo eller 50; agenter betaler ikke for brugerpladser.

CLAUDE.md fortæller Claude hvordan den skal opføre sig.

Maguyva giver Claude et søgbart kort over koden.

Tre workflows

Nummereret, tungt på kodeblokke. De spørgsmål, du allerede stiller Claude, forankret i rigtige linjer.

// workflow 01

Find den rigtige implementering, ikke teststubben

Dig: "Hvordan virker retry i vores betalingsklient?"

Uden Maguyva → Claude grep'er retry, finder 14 træf, vælger ét (ofte en test-mock).
Med Maguyva    → Maguyva returnerer symboldefinitionen, kaldestederne og
                   fil:linje for den rigtige implementering, rangeret.

// workflow 02

Tjek blast radius, før du refaktorerer

Dig: "Hvad kalder normalizePhoneNumber?"

Maguyva returnerer: 7 kaldesteder på tværs af 4 pakker, inklusive ét i en Python-service,
der importerer den via gRPC-stubben. Claude foreslår ændringen med migreringslisten
direkte i svaret — ikke efter CI bliver rød.

// workflow 03

Verificer agenten, før du accepterer diffen

Claude: "Jeg rettede src/auth/session.ts:142 for at fikse token-fornyelsen."

Spørg Maguyva: "Vis mig session.ts:130-160 og alt, der importerer session."

Maguyva returnerer den aktuelle fil-udskæring + 3 importører. Diffen er nu forankret
i rigtige linjer — ikke Claudes erindring fra token #11.000.

Opsætning i Claude Code

Tre trin. Free-niveau: 3 repos, Op til 50K indekserede repo-linjer, intet kort.

  1. // step 01

    Indekser et repo på maguyva.ai

    Vælg ét, du kender godt, så du kan verificere svarene. Free-niveau dækker 3 repos, Op til 50K indekserede repo-linjer.

  2. // step 02

    Installer 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

    Stil ét spørgsmål, du allerede kender svaret på

    Start med ét repo og ét verificerbart spørgsmål, ikke hele din virksomhed. Hvis svaret matcher det, du ville sige, er du klar.