Schritt 1 von 4Wissen
CLAUDE.md aufsetzen
Der erste Schritt für jeden Claude-Code-Workflow: eine klare CLAUDE.md, die dem Agent Kontext gibt. Für unser Review-Projekt definieren wir Build-Befehle, Code-Style-Regeln und Review-Standards.
Erstelle eine CLAUDE.md im Projektstamm:
# Review Workflow Projekt
## Build & Test
- `npm test` für Tests
- `npm run lint` für Linting
## Code Style
- TypeScript strict mode
- Prettier für Formatierung
- ESLint mit empfohlenen Regeln
## Review-Regeln
- Jeder PR braucht mindestens Tests
- Keine TODO-Kommentare in main
- Sicherheitsrelevante Änderungen brauchen zweites Review
- Maximale Funktionslänge: 50 Zeilen
Claude Code liest CLAUDE.md bei jedem Start. Wenn du Review-Standards hier definierst, kennt der Review-Agent automatisch die Regeln deines Teams -- ohne dass du sie jedes Mal im Prompt wiederholen musst.
.claude/ Verzeichnisstruktur
Unser Workflow braucht eine durchdachte Verzeichnisstruktur. Hier ist der vollständige Aufbau:
.claude/
├── CLAUDE.md # Lokale Ergänzungen (git-ignoriert)
├── settings.json # Hooks und Berechtigungen
├── skills/
│ └── review/
│ └── SKILL.md # Review-Skill-Definition
├── agents/
│ └── code-reviewer.md # Spezialisierter Review-Agent
└── hooks/
└── pre-commit-check.sh
Die CLAUDE.md im Projektstamm wird ins Repository committet und gilt für alle Teammitglieder. Dateien unter .claude/ können sowohl projektweite (committete) als auch lokale (git-ignorierte) Konfigurationen enthalten. Sensible Daten wie API-Keys gehören nie ins Repository.
MCP-Server anbinden
Für den Zugriff auf GitHub-PRs binden wir den GitHub MCP-Server ein. Erstelle eine .mcp.json im Projektstamm:
{
"mcpServers": {
"github": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
Damit kann Claude Code direkt auf GitHub-Daten zugreifen: PRs lesen, Diffs analysieren und Review-Kommentare schreiben.
Schritt 2 von 4Verstehen
Agent-Definition erstellen
Der Kern unseres Workflows ist ein spezialisierter Code-Review-Agent. Erstelle die Datei .claude/agents/code-reviewer.md:
---
name: code-reviewer
description: Reviews code changes for quality and best practices
tools: Read, Grep, Glob, Bash
model: sonnet
maxTurns: 30
---
Du bist ein erfahrener Code-Reviewer. Deine Aufgabe ist es, Code-Änderungen
systematisch zu prüfen.
## Prüfkriterien
1. **Bugs** -- Logikfehler, fehlende Fehlerbehandlung, Race Conditions
2. **Security** -- SQL Injection, XSS, unsichere Dependencies, hartcodierte Secrets
3. **Performance** -- Unnötige Schleifen, fehlende Indizes, Speicherlecks
4. **Lesbarkeit** -- Benennung, Kommentare, Funktionslänge, DRY-Prinzip
## Ausgabeformat
Gib dein Feedback in diesem Format:
### [CRITICAL/WARNING/INFO] Titel
**Datei:** `pfad/zur/datei.ts:zeile`
**Problem:** Beschreibung
**Vorschlag:** Lösung
Beachte die wichtigsten Konfigurationsoptionen:
- model: sonnet -- Sonnet bietet die beste Balance aus Qualität und Kosten für Code-Reviews. Für besonders kritische Reviews kannst du auf Opus wechseln.
- maxTurns: 30 -- Begrenzt die Anzahl der Iterationen, um Endlosschleifen und unkontrollierte Kosten zu vermeiden.
- tools -- Der Agent bekommt nur die Tools, die er für Reviews braucht: Dateien lesen, Code durchsuchen und Shell-Befehle ausführen.
Für Standard-Reviews reicht Sonnet völlig aus. Reserviere Opus für sicherheitsrelevante Änderungen oder architektonische Entscheidungen. Haiku eignet sich für schnelle Syntax-Checks und Formatting-Prüfungen.
Schritt 3 von 4Anwenden
Erstelle jetzt die Verzeichnisstruktur in deinem Projekt:
mkdir -p .claude/skills/review
mkdir -p .claude/agents
mkdir -p .claude/hooks
Lege dann die drei Dateien an: CLAUDE.md im Projektstamm, .mcp.json für den GitHub MCP-Server und .claude/agents/code-reviewer.md für den Review-Agent. Im nächsten Abschnitt verbinden wir alles mit Skills und Hooks.
Schritt 4 von 4Reflektieren
Das Setup ist die Grundlage für alles Weitere. Eine gute CLAUDE.md bedeutet, dass der Agent deine Regeln kennt. Eine klare Agent-Definition sorgt für konsistente Reviews. Und die MCP-Anbindung gibt dem Agent Zugriff auf die Daten, die er braucht. Nimm dir Zeit für diesen Schritt -- ein solides Fundament macht den Rest einfacher.