# Claude aloittaa jokaisen istunnon sokkona.

Canonical source: https://maguyva.ai/fi/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` kertoo Claudelle, miten käyttäytyä. Se ei kerro Claudelle, mitä reposi sisältää. Maguyva indeksoi koodikannan ja tarjoaa sen takaisin MCP:n yli, joten Claude muokkaa kuin olisi jo lukenut koodin.

> Käytä CLAUDE.md:tä käytökseen. Käytä Maguyva-palvelua ajantasaisiin koodikannan faktoihin.

## CLAUDE.md on hyvä käytäntö. Käytä sitä.

```text
> cat CLAUDE.md
# project conventions, commands, scoped rules
```

Pysyvät ohjeet kuuluvat tiedostoon `CLAUDE.md`. Se on oikea paikka:

- Build-, testi- ja lint-komennoille, joita agentin tulisi ajaa.
- Koodityylisäännöille ja nimeämiskonventioille.
- “Tee aina X / älä koskaan tee Y” -kaiteille, jotka on rajattu hakemistoon.
- Viittauksille kanonisiin dokumentteihin ja päätöslokeihin.

Anthropicin [muistidokumentaatio](https://code.claude.com/docs/en/memory) kuvaa tämän hyvin. Pidä se tiiviinä. Rajaa se. Committaa se.

Mutta `CLAUDE.md`-tiedostoa ei ole koskaan tarkoitettu kartaksi koodikannastasi.

## Missä CLAUDE.md lakkaa riittämästä

Neljä vikaantumistapaa, joita pelkkä markdown ei korjaa.

### // tiedosto ei ole koodikanta

Kertominen Claudelle *miten käyttäytyä* ei kerro sille, *mitä on olemassa*. Ensimmäinen muokkaus tuntemattomassa repossa on arvaus tiedostopoluista, funktioiden nimistä ja kutsupaikoista. CLAUDE.md ei voi listata jokaista symbolia, eikä sen pitäisikään.

### // dokumentit vanhenevat, koodi ei

`CLAUDE.md`-lohko, joka kuvaa autentikointivuotasi, on oikein, kunnes joku refaktoroi autentikoinnin. Koodi on nyt totuuden lähde ja dokumentit ovat itsevarmasti väärässä. Claude lukee väärän.

### // riippuvuudet eivät ole markdownissa

“Mikä hajoaa, jos muutan tätä funktiota?” on graafikysymys. Siihen ei voi vastata dokumenttitiedoston perusteella. Claude joko grep-ja-rukoilee tai pyytää sinua liittämään tiedostoja chattiin.

### // konteksti-ikkunoilla on budjetti

CLAUDE.md:n täyttäminen kunnes Claude “tietää tarpeeksi” syö tokeneita, joiden pitäisi maksaa päättelystä. Muutaman kilotavun jälkeen vaihdat vastausten laadun kontekstimäärään.

## Maguyva on kerros, jota CLAUDE.md ei kata

Etä-MCP-palvelin, joka antaa Claude Code -työkalulle:

- **Semanttinen, AST-, graafi- ja tekstihaku**: indeksoidun reposi yli, palautettuna tiedostopolkuineen ja rivinumeroineen.
- **Riippuvuus-, tyyppi- ja kutsupaikkahaut**: kysymykset, joihin graafi vastaa ja dokumenttitiedosto ei.
- **Haaratietoiset tulokset**: joten Claude näkee sen koodiversion, jota se oikeasti muokkaa.
- **Työtilahinnoittelu**: ei per käyttäjäpaikka. Indeksoi 1 repo tai 50; agenteista ei veloiteta käyttäjäpaikkamaksuja.

> CLAUDE.md kertoo Claudelle, *miten käyttäytyä*.
> Maguyva antaa Claudelle *kysyttävän kartan koodista*.

## Kolme työnkulkua

Numeroituja, koodilohkopainotteisia. Kysymyksiä, joita jo kysyt Claudelta, ankkuroituna oikeisiin riveihin.

### 01. Löydä oikea toteutus, ei testitynkää

```text
Sinä: "Miten uudelleenyritykset toimivat maksujen asiakaskoodissamme?"

Ilman Maguyvaa → Claude greppaa retry, löytää 14 osumaa ja valitsee yhden (usein testimockin).
Maguyvan kanssa    → Maguyva palauttaa symbolin määritelmän, kutsupaikat ja
                   file:line-tiedot oikeasta toteutuksesta, järjestettyinä.
```

### 02. Tarkista vaikutusalue ennen refaktorointia

```text
Sinä: "Mikä kutsuu normalizePhoneNumber-funktiota?"

Maguyva palauttaa: 7 kutsupaikkaa 4 paketissa, joista yksi Python-palvelussa,
joka tuo sen gRPC-tyngän kautta. Claude ehdottaa muutosta migraatioluetteloineen
suoraan vastauksessa, ei vasta kun CI muuttuu punaiseksi.
```

### 03. Varmenna agentti ennen diffin hyväksymistä

```text
Claude: "Muokkasin kohtaa src/auth/session.ts:142 korjatakseni tokenin uusimisen."

Kysy Maguyvalta: "Näytä session.ts:130-160 ja kaikki kohteet, jotka tuovat session-moduulin."

Maguyva palauttaa ajantasaisen tiedostokatkelman + 3 tuovaa kohdetta. Diffi perustuu nyt
todellisiin riveihin, ei Clauden muistikuvaan tokenista #11,000.
```

## Asennus Claude Code -työkalussa

Kolme vaihetta. Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

### 01. Indeksoi repo osoitteessa maguyva.ai

Valitse yksi, jonka tunnet hyvin, jotta voit varmistaa vastaukset. Free-taso kattaa 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä.

### 02. Asenna Maguyva-laajennus kohteeseen 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. Kysy yksi kysymys, jonka vastauksen jo tiedät

Aloita yhdestä reposta ja yhdestä todennettavasta kysymyksestä, älä koko yrityksestäsi. Jos vastaus täsmää siihen, mitä sanoisit, olet valmis.

Täydelliset ohjeet löytyvät [Maguyva-palvelun dokumentaatiosta](https://maguyva.ai/fi/docs).

## Indeksoi yksi repo, jonka jo tunnet.

Testaa yksi kysymys, jonka vastauksen voit tarkistaa. Siinä on koko käyttöönotto.