# Claude starter hver økt blind.

Canonical source: https://maguyva.ai/nb/for-claude-code

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

`CLAUDE.md` forteller Claude hvordan den skal oppføre seg. Den forteller ikke Claude hva som er i repoet ditt. Maguyva indekserer kodebasen og gir den tilbake over MCP, slik at Claude redigerer som om den allerede har lest koden.

> Bruk CLAUDE.md for atferd. Bruk Maguyva for oppdaterte kodebasefakta.

## CLAUDE.md er beste praksis. Bruk den.

```text
> cat CLAUDE.md
# prosjektkonvensjoner, kommandoer, avgrensede regler
```

Vedvarende instruksjoner hører hjemme i `CLAUDE.md`. Det er riktig sted for:

- Bygge-, test- og lint-kommandoer agenten skal kjøre.
- Kodestilregler og navnekonvensjoner.
- “Gjør alltid X / aldri Y”-regler avgrenset til en mappe.
- Henvisninger til de kanoniske dokumentene og beslutningsloggene.

Anthropics [minnedokumentasjon](https://code.claude.com/docs/en/memory) beskriver dette godt. Hold det kortfattet. Avgrens det. Commit det.

Men `CLAUDE.md` var aldri ment å være et kart over kodebasen din.

## Hvor CLAUDE.md slutter å strekke til

Fire feilmoduser som markdown alene ikke kan løse.

### // filen er ikke kodebasen

Å fortelle Claude *hvordan den skal oppføre seg*, forteller den ikke *hva som finnes*. Den første endringen i et ukjent repo er en gjetning om filbaner, funksjonsnavn og kallsteder. CLAUDE.md kan ikke liste opp hvert symbol, og det ville du heller ikke ønsket.

### // dokumentasjon blir foreldet, kode blir ikke det

En `CLAUDE.md`-blokk som beskriver auth-flyten din, stemmer helt til noen refaktorerer auth. Koden er nå sannheten, og dokumentasjonen tar selvsikkert feil. Claude leser feil kilde.

### // avhengigheter finnes ikke i markdown

«Hva går i stykker hvis jeg endrer denne funksjonen?» er et grafspørsmål. Det kan ikke besvares av en dokumentfil. Claude må enten grep-og-håpe eller be deg lime inn filer i chatten.

### // kontekstvinduer har et budsjett

Å stappe CLAUDE.md til Claude «vet nok» spiser tokens som burde gå til resonnering. Forbi noen få KB bytter du bort svarkvalitet mot kontekstvolum.

## Maguyva er laget CLAUDE.md ikke dekker

En ekstern MCP-server som gir Claude Code:

- **Semantisk søk, AST-søk, grafsøk og tekstsøk**: over det indekserte repoet ditt, levert med filbaner og linjenumre.
- **Oppslag for avhengigheter, typer og kallsteder**: spørsmålene en graf kan svare på, og som en dokumentfil ikke kan.
- **Branch-bevisste resultater**: slik at Claude ser versjonen av koden den faktisk redigerer.
- **Prising per arbeidsområde**: ikke per bruker. Indekser 1 repo eller 50; agenter utløser ingen lisenskostnader.

> CLAUDE.md forteller Claude *hvordan den skal oppføre seg*.
> Maguyva gir Claude *et søkbart kart over koden*.

## Tre arbeidsflyter

Nummererte, tunge på kodeblokker. Spørsmålene du allerede stiller Claude, forankret i faktiske linjer.

### 01. Finn den faktiske implementasjonen, ikke test-stubben

```text
Du: "Hvordan fungerer retry i betalingsklienten vår?"

Uten Maguyva → Claude grepper retry, finner 14 treff, velger ett (ofte en test-mock).
Med Maguyva    → Maguyva returnerer symboldefinisjonen, kallstedene, og
                   fil:linje for den faktiske implementasjonen, rangert.
```

### 02. Sjekk påvirkningsradiusen før du refaktorerer

```text
Du: "Hvilken kode kaller normalizePhoneNumber?"

Maguyva returnerer: 7 kallsteder fordelt på 4 pakker, inkludert ett i en Python-tjeneste
som importerer den via gRPC-stubben. Claude foreslår endringen med migreringslisten
direkte i svaret, ikke etter at CI blir rødt.
```

### 03. Verifiser agenten før du godtar diffen

```text
Claude: "Jeg redigerte src/auth/session.ts:142 for å fikse token-fornyelsen."

Spør Maguyva: "Vis meg session.ts:130-160 og alt som importerer session."

Maguyva returnerer det oppdaterte filutdraget + 3 importører. Diffen er nå forankret
i faktiske linjer, ikke Claudes hukommelse fra token #11 000.
```

## Oppsett i Claude Code

Tre steg. Free-planen: 3 repoer, Opptil 50K indekserte kodelinjer, uten kredittkort.

### 01. Indekser et repo på maguyva.ai

Velg ett du kjenner godt, slik at du kan verifisere svarene. Free-planen dekker 3 repoer, Opptil 50K indekserte kodelinjer.

### 02. Installer Maguyva-pluginen i Claude Code

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

# the plugin reads your key from the environment
export MAGUYVA_API_KEY=mgv_xxxx
```

### 03. Still ett spørsmål du allerede vet svaret på

Start med ett repo og ett verifiserbart spørsmål, ikke hele selskapet ditt. Hvis svaret stemmer med det du selv ville sagt, er du klar.

Fullstendige instruksjoner finner du i [dokumentasjonen fra Maguyva](https://maguyva.ai/nb/docs).

## Indekser ett repo du allerede kjenner.

Test ett spørsmål du kan verifisere svaret på. Det er hele onboardingen.