# Claude zaczyna każdą sesję na ślepo.

Canonical source: https://maguyva.ai/pl/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` mówi Claude, jak się zachowywać. Nie mówi Claude, co jest w Twoim repo. Maguyva indeksuje bazę kodu i udostępnia ją z powrotem przez MCP, więc Claude edytuje tak, jakby już przeczytał kod.

> Użyj CLAUDE.md do określenia zasad działania. Użyj Maguyva do uzyskania aktualnych faktów o kodzie.

## CLAUDE.md to dobra praktyka. Korzystaj z niej.

```text
> cat CLAUDE.md
# konwencje projektu, komendy, reguły ograniczone zakresem
```

Trwałe instrukcje należą do `CLAUDE.md`. To dobre miejsce na:

- Komendy budowania, testów i lintowania, które powinien uruchamiać agent.
- Reguły stylu kodu i konwencje nazewnictwa.
- Zabezpieczenia typu “zawsze rób X / nigdy nie rób Y” ograniczone do katalogu.
- Odnośniki do kanonicznej dokumentacji i logów decyzji.

[Dokumentacja pamięci](https://code.claude.com/docs/en/memory) Anthropic dobrze to opisuje. Trzymaj to zwięźle. Ogranicz zakres. Commituj.

Ale `CLAUDE.md` nigdy nie miał być mapą Twojej bazy kodu.

## Gdzie CLAUDE.md przestaje wystarczać

Cztery tryby awarii, których sam markdown nie naprawi.

### // plik to nie baza kodu

Powiedzenie Claude *jak się zachowywać* nie mówi mu, *co istnieje*. Pierwsza edycja w nieznanym repo to zgadywanie ścieżek plików, nazw funkcji i miejsc wywołań. CLAUDE.md nie może wymienić każdego symbolu i wcale byś tego nie chciał.

### // dokumentacja się starzeje, kod nie

Blok `CLAUDE.md` opisujący Twój przepływ autoryzacji jest poprawny, dopóki ktoś nie zrefaktoryzuje auth. Kod jest teraz źródłem prawdy, a dokumentacja jest pewna siebie i błędna. Claude czyta tę złą.

### // zależności nie są w markdownie

„Co się zepsuje, jeśli zmienię tę funkcję?” to pytanie grafowe. Nie da się na nie odpowiedzieć na podstawie pliku dokumentacji. Claude albo grep-uje i się modli, albo prosi Cię o wklejenie plików do czatu.

### // okna kontekstu mają budżet

Upychanie CLAUDE.md, aż Claude „wie wystarczająco dużo”, zjada tokeny, które powinny opłacać wnioskowanie. Powyżej kilku KB zamieniasz jakość odpowiedzi na objętość kontekstu.

## Maguyva to warstwa, której CLAUDE.md nie obejmuje

Zdalny serwer MCP, który daje Claude Code:

- **Wyszukiwanie semantyczne, AST, grafowe i tekstowe**: po Twoim zaindeksowanym repo, zwracane ze ścieżkami plików i numerami linii.
- **Wyszukiwanie zależności, typów i miejsc wywołań**: pytania, na które odpowie graf, a nie plik dokumentacji.
- **Wyniki uwzględniające gałąź**: dzięki czemu Claude widzi wersję kodu, którą faktycznie edytuje.
- **Cennik za workspace**: nie za użytkownika. Zaindeksuj 1 repo albo 50; bez osobnych opłat za każdego agenta.

> CLAUDE.md mówi Claude *jak się zachowywać*.
> Maguyva daje Claude *przeszukiwalną mapę kodu*.

## Trzy przepływy pracy

Ponumerowane, z dużą ilością bloków kodu. Pytania, które już zadajesz Claude, ugruntowane na rzeczywistych liniach.

### 01. Znajdź prawdziwą implementację, nie atrapę testową

```text
Ty: "Jak działa retry w naszym kliencie płatności?"

Bez Maguyva → Claude grep-uje retry, znajduje 14 trafień, wybiera jedno (często atrapę testową).
Z Maguyva    → Maguyva zwraca definicję symbolu, miejsca wywołań oraz
                   file:line prawdziwej implementacji, uszeregowane.
```

### 02. Sprawdź zasięg wpływu, zanim zrefaktoryzujesz

```text
Ty: "Co wywołuje normalizePhoneNumber?"

Maguyva zwraca: 7 miejsc wywołań w 4 pakietach, w tym jedno w usłudze Python,
która importuje ją przez stub gRPC. Claude proponuje zmianę z listą migracji
od razu, a nie po tym, jak CI zaświeci na czerwono.
```

### 03. Zweryfikuj agenta, zanim zaakceptujesz diff

```text
Claude: "Zedytowałem src/auth/session.ts:142, żeby naprawić odświeżanie tokenu."

Zapytaj Maguyva: "Pokaż mi session.ts:130-160 i wszystko, co importuje session."

Maguyva zwraca aktualny fragment pliku + 3 pliki importujące ten kod. Diff jest teraz ugruntowany
na rzeczywistych liniach, a nie na pamięci Claude z tokenu #11 000.
```

## Konfiguracja w Claude Code

Trzy kroki. Plan Free: 3 repozytoria, Do 50 tys. zindeksowanych linii repo, bez karty kredytowej.

### 01. Zaindeksuj repo na maguyva.ai

Wybierz takie, które dobrze znasz, żeby móc zweryfikować odpowiedzi. Plan Free obejmuje 3 repozytoria, Do 50 tys. zindeksowanych linii repo.

### 02. Zainstaluj wtyczkę Maguyva w 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. Zadaj jedno pytanie, na które już znasz odpowiedź

Zacznij od jednego repo i jednego sprawdzalnego pytania, nie od całej firmy. Jeśli odpowiedź zgadza się z tym, co byś powiedział, jesteś gotowy.

Pełne instrukcje znajdziesz w [dokumentacji Maguyva](https://maguyva.ai/pl/docs).

## Zaindeksuj jedno repo, które już znasz.

Sprawdź jedno pytanie, którego odpowiedź możesz zweryfikować. To całe wdrożenie.