Claude Code -käyttäjille

Claude aloittaa jokaisen istunnon sokkona.

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.

Aloita ilmaiseksi Lue Claude Code -asennusohje

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

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ä.

> 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.
Osoittimille kanonisiin dokumentteihin ja päätöslokeihin.

Anthropicin muistidokumentaatio 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. Sitä ei voi vastata dokumenttitiedostosta. Claude joko grep-ja-rukoilee tai pyytää sinua liittämään tiedostoja chattiin.

// kontekstiikkunoilla 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; agentit eivät maksa käyttäjäpaikoista.

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.

// workflow 01

Löydä oikea toteutus, ei testitynkää

You: "How does retry work in our payment client?"

Without Maguyva → Claude greps retry, finds 14 hits, picks one (often a test mock).
With Maguyva    → Maguyva returns the symbol definition, the call-sites, and the
                   file:line of the real implementation, ranked.

// workflow 02

Tarkista vaikutusalue ennen refaktorointia

You: "What calls normalizePhoneNumber?"

Maguyva returns: 7 call-sites across 4 packages, including one in a Python service
that imports it via the gRPC stub. Claude proposes the change with the migration
list inline, not after CI goes red.

// workflow 03

Varmenna agentti ennen diffin hyväksymistä

Claude: "I edited src/auth/session.ts:142 to fix the token refresh."

Ask Maguyva: "Show me session.ts:130-160 and anything that imports session."

Maguyva returns the live file slice + 3 importers. The diff is now grounded
against real lines, not Claude’s recollection from token #11,000.

Asennus Claude Code -työkalussa

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

// step 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ä.

// step 02

Asenna Maguyva-laajennus kohteeseen 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
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.