Dla użytkowników Claude Code

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

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.

Zacznij na Free Przeczytaj konfigurację dla Claude Code

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

Użyj CLAUDE.md dla zachowania. Użyj Maguyva dla aktualnych faktów o kodzie.

CLAUDE.md to dobra praktyka. Korzystaj z niej.

> 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 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 świadome brancha dzięki czemu Claude widzi wersję kodu, którą faktycznie edytuje.
Cennik za workspace nie za stanowisko. Zaindeksuj 1 repo albo 50; agenci nie płacą za stanowiska.

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.

// workflow 01

Znajdź prawdziwą implementację, nie atrapę testową

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.

// workflow 02

Sprawdź promień rażenia, zanim zrefaktoryzujesz

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.

// workflow 03

Zweryfikuj agenta, zanim zaakceptujesz diff

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 importerów. 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.

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

// step 02

Zainstaluj wtyczkę Maguyva w 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
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.