# Claude startet jede Session blind.

Canonical source: https://maguyva.ai/de/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` 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.

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

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

```text
> 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](https://code.claude.com/docs/en/memory) 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 sucht entweder mit grep und hofft auf das Beste 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 beantworten kann, eine Doc-Datei aber nicht.
- **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; Agents 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.

### 01. Die echte Implementierung finden, nicht den Test-Stub

```text
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.
```

### 02. Auswirkungsradius prüfen, bevor du refactorst

```text
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.
```

### 03. Den Agent verifizieren, bevor du den Diff akzeptierst

```text
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 importierende Module. 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 Kreditkarte.

### 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.

### 02. Das Maguyva-Plugin in Claude Code installieren

```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. 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.

Vollständige Anleitung findest du in [den Docs von Maguyva](https://maguyva.ai/de/docs).

## Indexiere ein Repo, das du schon kennst.

Teste eine Frage, deren Antwort du überprüfen kannst. Das ist das ganze Onboarding.