Zum Hauptinhalt springen

Claude Code für ein echtes Repository anpassen

Fortgeschritten
What you'll learn
  • Einen frischen Checkout in etwa 20 Minuten in ein abgestimmtes Claude-Code-Setup verwandeln
  • Verstehen, WARUM jede der vier Anpassungen ihren Platz verdient — CLAUDE.md, Berechtigungen, ein Hook, ein Command
  • Berechtigungsregeln schreiben, die Unterbrechungen bei sicheren Aktionen reduzieren und riskante hart stoppen
  • Jedes Teil überprüfen, statt anzunehmen, dass es funktioniert hat

Lass uns einen frischen Checkout in ein Claude-Code-Setup verwandeln, das dein Projekt kennt und deine Regeln respektiert — in etwa 20 Minuten. Wir verknüpfen die Kernfunktionen samt Begründung für jede einzelne.

Der Endzustand​

Schritt 1 — CLAUDE.md erzeugen und eindampfen​

Führe /init aus, um einen Entwurf für CLAUDE.md zu erstellen, und kürze ihn dann auf das, was wirklich stimmt: Stack, wie man baut/testet/lintet, echte Konventionen und Leitplanken („vor dem Abschluss Tests ausführen", „/generated nicht anfassen"). Warum: Es ist die wirkungsvollste Anpassung — Claude liest sie in jeder Sitzung.

Hol dir eine Startvorlage aus den CLAUDE.md-Vorlagen.

Schritt 2 — Berechtigungen setzen​

Lege eine .claude/settings.json an (Referenz), die sichere, sich wiederholende Befehle vorab erlaubt und gefährliche verweigert:

{
  "permissions": {
    "allow": ["Read", "Bash(npm run test:*)", "Bash(npm run lint)", "Bash(git diff:*)"],
    "ask": ["Write", "Bash(npm install:*)"],
    "deny": ["Read(./.env)", "Bash(git push --force:*)"]
  }
}

Warum: weniger Unterbrechungen bei sicheren Aktionen, harte Stopps bei riskanten. Siehe Berechtigungen.

Schritt 3 — Einen Formatierungs-Hook hinzufügen​

Nach jeder Bearbeitung automatisch formatieren (Hooks):

{ "hooks": { "PostToolUse": [ { "matcher": "Edit|Write",
  "hooks": [ { "type": "command", "command": "f=$(jq -r '.tool_input.file_path'); npx prettier --write \"$f\" 2>/dev/null || true" } ] } ] } }

Warum: konsistente Formatierung, garantiert — kein „bitte dran denken".

Schritt 4 — Einen /commit-Command hinzufügen​

Kopiere das /commit-Rezept aus der Slash-Command-Bibliothek nach .claude/commands/. Warum: ein Wort für einen wiederholbaren Workflow.

Schritt 5 — Den Plan-Modus für die erste echte Aufgabe nutzen​

Gib ein echtes Ziel im Plan-Modus vor, prüfe den Plan und lass ihn dann ausführen. Warum: Vertrauen aufbauen, indem man Denken vom Handeln trennt.

Überprüfen, ob es funktioniert hat​

Nimm nichts an — prüfe jedes Teil einzeln. Jeder Test isoliert eine Anpassung, sodass ein Fehlschlag dir genau sagt, welche Datei zu reparieren ist.

Guided walkthrough1 of 4
  1. Starte eine NEUE Sitzung und gib eine normale Aufgabe. Claude sollte deine Konventionen unaufgefordert berücksichtigen, ohne dass du sie einfügst.

Die erste echte Aufgabe im Plan-Modus starten

Add pagination to the users list endpoint. Plan it first — I want to review before you touch anything.
Key takeaways
  • CLAUDE.md ist die wirkungsvollste Anpassung, weil Claude sie in jeder Sitzung liest — erzeuge sie mit /init und kürze sie dann auf das, was tatsächlich stimmt
  • Berechtigungen sind ein zweiseitiges Werkzeug: sichere, sich wiederholende Befehle vorab erlauben, um Unterbrechungen zu reduzieren, und gefährliche verweigern, um harte Stopps zu bekommen
  • Ein Hook macht Formatierung garantiert statt "bitte dran denken" — vom Harness erzwungenes Verhalten schlägt im Prompt erbetenes Verhalten
  • Ein Slash-Command macht aus einem wiederholbaren Workflow ein einziges Wort
  • Der Plan-Modus trennt Denken vom Handeln — so baut man Vertrauen auf, bevor man mehr Autonomie abgibt
  • Überprüfe jede Anpassung mit einem eigenen Test, damit ein Fehlschlag auf genau eine Datei zeigt

Teste dich selbst

0/3
  1. Warum gilt CLAUDE.md als die wirkungsvollste Anpassung?
  2. Du willst, dass Auto-Formatierung garantiert ist und nicht bloß erbeten. Welcher Mechanismus ist der richtige?
  3. Warum stehen in der Beispiel-settings.json manche Befehle unter "allow" und andere unter "ask"?

Weiter​