Pro uživatele Claude Code

Claude začíná každou session naslepo.

CLAUDE.md říká Claude, jak se má chovat. Neříká Claude, co je v tvém repozitáři. Maguyva indexuje codebase a vrací ji přes MCP, takže Claude edituje, jako by už kód přečetl.

Začít zdarma Přečti si nastavení pro Claude Code

Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez karty.

CLAUDE.md používej pro chování. Maguyva používej pro aktuální fakta o codebase.

CLAUDE.md je osvědčený postup. Používej ho.

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

Trvalé instrukce patří do CLAUDE.md. Je to správné místo pro:

Build, test a lint příkazy, které má agent spouštět.
Pravidla stylu kódu a konvence pojmenování.
Pravidla typu „vždy dělej X / nikdy nedělej Y“, omezená na konkrétní adresář.
Odkazy na kanonickou dokumentaci a záznamy rozhodnutí.

Anthropic to dobře popisuje ve svých dokumentech o paměti. Drž to stručné. Ohranič to. Commitni to.

Ale CLAUDE.md nikdy neměl být mapou tvé codebase.

Kde CLAUDE.md přestává stačit

Čtyři selhání, která samotný markdown nevyřeší.

// soubor není codebase

Říct Claude, jak se má chovat, mu neřekne, co existuje. První edit v neznámém repozitáři je odhad cest k souborům, názvů funkcí a míst volání. CLAUDE.md nemůže vypsat každý symbol, a ani bys to nechtěl.

// dokumentace zastarává, kód ne

Blok v CLAUDE.md popisující tvůj auth flow je správný, dokud někdo auth nerefaktoruje. Kód je teď zdrojem pravdy a dokumentace je sebejistě špatná. Claude čte tu špatnou.

// závislosti nejsou v markdownu

„Co se rozbije, když změním tuhle funkci?“ je grafová otázka. Nedá se zodpovědět dokumentem. Claude buď grepuje a doufá, nebo tě požádá, abys vložil soubory do chatu.

// kontextová okna mají rozpočet

Cpát do CLAUDE.md, dokud Claude „neví dost“, žere tokeny, které by měly platit za uvažování. Po pár KB měníš kvalitu odpovědí za objem kontextu.

Maguyva je vrstva, kterou CLAUDE.md nepokrývá

Vzdálený MCP server, který dává Claude Code:

Sémantické, AST, grafové a textové vyhledávání nad tvým indexovaným repozitářem, vrácené s cestami k souborům a čísly řádků.
Vyhledávání závislostí, typů a míst volání otázky, na které odpoví graf, a dokument ne.
Výsledky, které vnímají větve aby Claude viděl tu verzi kódu, kterou skutečně edituje.
Ceny podle workspace ne za seat. Indexuj 1 repozitář nebo 50; agenti neplatí za seats.

CLAUDE.md říká Claude jak se má chovat.
Maguyva dává Claude prohledávatelnou mapu kódu.

Tři workflow

Číslované, plné bloků kódu. Otázky, které Claude už kladeš, podložené skutečnými řádky.

// workflow 01

Najdi skutečnou implementaci, ne testovací stub

Ty: "Jak funguje retry v našem payment klientovi?"

Bez Maguyva → Claude grepuje retry, najde 14 zásahů, vybere jeden (často testovací mock).
S Maguyva    → Maguyva vrátí definici symbolu, místa volání a
                   file:line skutečné implementace, seřazené.

// workflow 02

Zkontroluj dosah dopadu, než refaktoruješ

Ty: "Co volá normalizePhoneNumber?"

Maguyva vrátí: 7 míst volání napříč 4 balíčky, včetně jednoho v Python službě,
která ho importuje přes gRPC stub. Claude navrhne změnu se seznamem migrace
přímo v textu, ne až po tom, co CI zčervená.

// workflow 03

Ověř agenta, než přijmeš diff

Claude: "Upravil jsem src/auth/session.ts:142, abych opravil obnovu tokenu."

Zeptej se Maguyva: "Ukaž mi session.ts:130-160 a všechno, co importuje session."

Maguyva vrátí živý výřez souboru + 3 importéry. Diff je teď podložený
skutečnými řádky, ne Claudovou vzpomínkou od tokenu #11 000.

Nastavení v Claude Code

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez karty.

// step 01
Indexuj repozitář na maguyva.ai
Vyber si repozitář, který dobře znáš, abys mohl ověřit odpovědi. Free tarif pokrývá 3 repozitáře, Až 50K zaindexovaných řádků repa.

// step 02

Nainstaluj plugin Maguyva v 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
Polož jednu otázku, jejíž odpověď už znáš
Začni jedním repozitářem a jednou ověřitelnou otázkou, ne celou firmou. Pokud odpověď sedí s tím, co bys řekl ty, máš vyhráno.