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

Canonical source: https://maguyva.ai/cs/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` říká Claude, jak se má chovat. Neříká Claude, co je ve vašem repozitáři. Maguyva indexuje codebase a vrací ji přes MCP, takže Claude edituje, jako by už kód přečetl.

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

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

```text
> cat CLAUDE.md
# konvence projektu, příkazy, pravidla s vymezenou působností
```

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](https://code.claude.com/docs/en/memory). Držte to stručné. Ohraničte to. Commitněte to.

Ale `CLAUDE.md` nikdy neměl být mapou vaší 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 byste to nechtěli.

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

Blok v `CLAUDE.md` popisující váš 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 vás požádá, abyste vložili soubory do chatu.

### // kontextová okna mají rozpočet

Přidávat obsah do CLAUDE.md, dokud Claude „neví dost“, žere tokeny, které by měly platit za uvažování. Po pár KB měníte 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 vaší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é zohledňují větev**: aby Claude viděl tu verzi kódu, kterou skutečně edituje.
- **Ceny podle pracovního prostoru**: ne podle počtu uživatelů. Indexujte 1 repozitář nebo 50; za agenty se neúčtují samostatné licenční poplatky.

> 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ž kladete, podložené skutečnými řádky.

### 01. Najděte skutečnou implementaci, ne testovací stub

```text
Vy: "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é.
```

### 02. Zkontrolujte rozsah dopadu, než refaktorujete

```text
Vy: "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á.
```

### 03. Ověřte agenta, než přijmete diff

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

Zeptejte 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 kreditní karty.

### 01. Indexujte repozitář na maguyva.ai

Vyberte si repozitář, který dobře znáte, abyste mohli ověřit odpovědi. Free tarif pokrývá 3 repozitáře, Až 50K zaindexovaných řádků repa.

### 02. Nainstalujte plugin Maguyva v 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. Položte jednu otázku, jejíž odpověď už znáte

Začněte jedním repozitářem a jednou ověřitelnou otázkou, ne celou firmou. Pokud odpověď sedí s tím, co byste řekli vy, máte vyhráno.

Kompletní návod najdete v [dokumentaci Maguyva](https://maguyva.ai/cs/docs).

## Indexujte jeden repozitář, který už znáte.

Otestujte jednu otázku, jejíž odpověď dokážete ověřit. To je celý onboarding.