Für Claude Code-Nutzer

Claude startet jede Session blind.

CLAUDE.md sagt Claude, wie es sich verhalten soll. Es sagt Claude nicht, was in deinem Repo steckt. Maguyva indexiert die Codebase und liefert sie über MCP zurück, damit Claude editiert, als hätte es den Code bereits gelesen.

Kostenlos starten Setup für Claude Code lesen

Free-Stufe: 3 Repositories, Bis zu 50K indexierte Repo-Zeilen, keine Karte.

Nutz CLAUDE.md für Verhalten. Nutz Maguyva für aktuelle Codebase-Fakten.

CLAUDE.md ist eine bewährte Praxis. Nutz sie.

> cat CLAUDE.md
# Projektkonventionen, Befehle, geltungsbereichsbezogene Regeln

Dauerhafte Anweisungen gehören in CLAUDE.md. Das ist der richtige Ort für:

Build-, Test- und Lint-Befehle, die der Agent ausführen soll.
Coding-Style-Regeln und Namenskonventionen.
„Immer X / nie Y“-Guardrails, die auf ein Verzeichnis begrenzt sind.
Verweise auf die kanonischen Docs und Entscheidungsprotokolle.

Anthropics Memory-Docs beschreiben das gut. Halte es kompakt. Begrenze den Scope. Committe es.

Aber CLAUDE.md war nie als Karte deiner Codebase gedacht.

Wo CLAUDE.md aufhört zu genügen

Vier Fehlermodi, die Markdown allein nicht beheben kann.

// die datei ist nicht die codebase

Claude zu sagen, wie es sich verhalten soll, sagt ihm nicht, was existiert. Der erste Edit an einem unbekannten Repo ist eine Vermutung über Dateipfade, Funktionsnamen und Aufrufstellen. CLAUDE.md kann nicht jedes Symbol auflisten, und das sollte es auch nicht.

// docs veralten, code nicht

Ein CLAUDE.md-Block, der deinen Auth-Flow beschreibt, stimmt, bis jemand Auth refactort. Der Code ist jetzt die Quelle der Wahrheit, und die Docs liegen zuverlässig falsch. Claude liest die falschen.

// abhängigkeiten stehen nicht in markdown

„Was bricht, wenn ich diese Funktion ändere?“ ist eine Graph-Frage. Eine Doc-Datei kann sie nicht beantworten. Claude greift entweder grep-und-hofft oder bittet dich, Dateien in den Chat zu pasten.

// context windows haben ein budget

CLAUDE.md so lange aufzublähen, bis Claude „genug weiß“, frisst Tokens, die für Reasoning bezahlen sollten. Ab ein paar KB tauschst du Antwortqualität gegen Kontextvolumen.

Maguyva ist die Schicht, die CLAUDE.md nicht abdeckt

Ein Remote-MCP-Server, der Claude Code Folgendes gibt:

Semantische, AST-, Graph- und Textsuche über dein indexiertes Repo, geliefert mit Dateipfaden und Zeilennummern.
Abhängigkeits-, Typ- und Aufrufstellen-Lookups die Fragen, die ein Graph beantwortet und eine Doc-Datei nicht kann.
Branch-bewusste Ergebnisse damit Claude die Version des Codes sieht, die es gerade tatsächlich editiert.
Workspace-Preise nicht pro Seat. Indexiere 1 Repo oder 50; Agenten zahlen keine Seats.

CLAUDE.md sagt Claude, wie es sich verhalten soll.
Maguyva gibt Claude eine abfragbare Karte des Codes.

Drei Workflows

Nummeriert, code-block-lastig. Die Fragen, die du Claude schon stellst, verankert an echten Zeilen.

// workflow 01

Die echte Implementierung finden, nicht den Test-Stub

Du: "Wie funktioniert Retry in unserem Payment-Client?"

Ohne Maguyva → Claude greppt retry, findet 14 Treffer, wählt einen aus (oft einen Test-Mock).
Mit Maguyva    → Maguyva liefert die Symboldefinition, die Aufrufstellen und die
                   Datei:Zeile der echten Implementierung, sortiert.

// workflow 02

Auswirkungsradius prüfen, bevor du refactorst

Du: "Was ruft normalizePhoneNumber auf?"

Maguyva liefert: 7 Aufrufstellen über 4 Packages, darunter eine in einem Python-Service,
der sie über den gRPC-Stub importiert. Claude schlägt die Änderung mit der Migrationsliste
inline vor, nicht erst nachdem die CI rot wird.

// workflow 03

Den Agenten verifizieren, bevor du den Diff akzeptierst

Claude: "Ich habe src/auth/session.ts:142 editiert, um den Token-Refresh zu fixen."

Frag Maguyva: "Zeig mir session.ts:130-160 und alles, was session importiert."

Maguyva liefert den aktuellen Datei-Ausschnitt + 3 Importeure. Der Diff ist jetzt an
echten Zeilen verankert, nicht an Claudes Erinnerung von Token #11.000.

Einrichtung in Claude Code

Drei Schritte. Free-Stufe: 3 Repositories, Bis zu 50K indexierte Repo-Zeilen, keine Karte.

// step 01
Ein Repo auf maguyva.ai indexieren
Wähl eines, das du gut kennst, damit du die Antworten überprüfen kannst. Free-Stufe deckt 3 Repositories, Bis zu 50K indexierte Repo-Zeilen ab.

// step 02

Das Maguyva-Plugin in Claude Code installieren

/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
Eine Frage stellen, deren Antwort du schon kennst
Fang mit einem Repo und einer überprüfbaren Frage an, nicht mit deiner ganzen Firma. Wenn die Antwort mit dem übereinstimmt, was du sagen würdest, bist du startklar.