Zum Inhalt springen

Projekt-Setup

  • Claude Code · Modul 09
  • Lektion 2 von 4 · danach Quellen und Quiz

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
Hinweis
Warum Review-Regeln in CLAUDE.md?

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
Achtung
Projektweite vs. lokale Konfiguration

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.

Frage · Selbstcheck
Wo wird die MCP-Server-Konfiguration für ein Projekt gespeichert?

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.
Tipp
Modellwahl nach Aufgabe

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.