Claude Code Einrichtung: Schutz vor Regressionen in der Entwicklung

Claude Code konfigurieren: Drei Schichten gegen Regressionen

Das riesige 1-Million-Token-Kontextfenster von Claude Code beseitigt Regressionen nicht wie durch Zauberhand. Entwickler sehen oft, wie KI-Agenten funktionierenden Code umschreiben, Tests löschen oder unerwünschte Abhängigkeiten hinzufügen. Für reibungslosen Betrieb ohne ständiges Aufpassen brauchen Sie ein mehrschichtiges Schutzsystem aus Konfigurationsdateien, Sub-Agenten und automatisierten Hooks.

CLAUDE.md als Verfassung Ihres Projekts

Die CLAUDE.md-Datei ist der Eckpfeiler der Claude-Code-Konfiguration. Sie wird zu Beginn jeder Sitzung neu geladen und bei der Kontextkomprimierung erhalten, sodass Sie nie mit veralteten Infos arbeiten. Ihre Hauptaufgabe? Unnachgiebige Regeln für den Code-Umgang durchzusetzen.

Wichtige Abschnitte in CLAUDE.md umfassen:

• Projektarchitektur mit detailliertem Tech-Stack
• Kritische Befehle zum Bauen, Testen und Linting
• Pflicht-Code-Regeln
• Workflow-Stil und Prozessrichtlinien
• Sub-Agenten-Liste für spezialisierte Aufgaben

Der Abschnitt zu kritischen Regeln legt direkte Verbote und Muss-Regeln fest:

• Niemals bestehende Tests löschen oder umschreiben, ohne explizite Anweisung
• Niemals Dateien ohne Bestätigung löschen
• Immer Tests nach Code-Änderungen ausführen
• Immer Git-Checkpoints vor großen Refactorings erstellen
• Eine Aufgabe nach der anderen bearbeiten – keine parallelen Änderungen
• Bei Unklarheiten nachfragen statt annehmen

Um Kontextfenster-Platz zu sparen, liegen detaillierte Regeln in modularen Dateien unter .claude/rules/. Diese werden nur bei passenden Dateitypen geladen – ein Segen für Sonnet- und Pro-Nutzer mit 200K-Token-Limit.

Sub-Agenten als isolierte Experten

Sub-Agenten arbeiten in eigenen Kontextfenstern und liefern nur Zusammenfassungen an die Hauptsitzung zurück. So können sie tief in den Codebase eintauchen, ohne den Primärkontext zu überladen. Jeder übernimmt eine strikte Funktion.

Planner-Agent durchsucht den Codebase und erstellt schrittweise Umsetzungspläne. Kernregel: Niemals Code schreiben – nur analysieren und planen. Er markiert Risiken, identifiziert betroffene Dateien und schlägt Teststrategien vor.

Tester-Agent schreibt und führt Tests aus. Er analysiert bestehende Testmuster Ihres Projekts und hält sich daran. Goldene Regel: Immer die komplette Testsuite laufen lassen, nicht nur neue Tests – Regressionen lauern gerne in alten.

Code-Reviewer-Agent prüft Änderungen auf Regressionen, Sicherheitslücken und Stilkonformität. Er überwacht Fehlerbehandlung, Lesbarkeit, Einhaltung des DRY-Prinzips und ausreichende Testabdeckung.

Sub-Agenten-Dateien landen in .claude/agents/ mit klaren Funktionsbeschreibungen, verfügbaren Tools und Regelsets. Ihre Haupt-CLAUDE.md sollte immer daran erinnern, sie zu nutzen.

Automatisierte Hooks als Sicherheitsbarrieren

Hooks in Claude Code lösen sich bei Lebenszyklus-Ereignissen aus und prüfen automatisch die Qualität. Konfigurieren Sie sie über .claude/settings.json in zwei Hauptvarianten.

PreToolUse-Hooks feuern vor Tool-Nutzung. Der Star blockiert Commits mit fehlschlagenden Tests. Python-Projekt-Beispiel:

{
  "matcher": "Bash(git commit*)",
  "hooks": [
    {
      "type": "command",
      "command": "python -m pytest tests/ -x --timeout=60 || (echo '{\"block\": true, \"message\": \"Tests fehlgeschlagen. Beheben vor Commit.\"}' 1>&2 && exit 2)",
      "timeout": 120
    }
  ]
}

PostToolUse-Hooks triggern nach Aktionen als sanfte Erinnerungen. Zum Beispiel: Nach jeder Dateiänderung an Tests erinnern.

Workflow optimieren

Effektiver Claude-Code-Einsatz erfordert disziplinierte Kontextverwaltung und Tool-Nutzung.

Kontextfenster-Management:

• Token-Verbrauch regelmäßig mit /cost prüfen
• Bei 200K-Token-Modellen /compact bei 60-70 % Füllung ausführen, Schlüsselinfos angeben
• Bei Opus' 1M Tokens lange Sitzungen überwachen
• Bei Themenwechsel /clear für Kontext löschen

Effort-Level: Opus 4.6 führte low, medium, high, max ein. /effort high für knifflige Architektur, /effort low für Quickfixes, um Tokens zu sparen.

Git-Strategie: Häufige Checkpoints vor großen Änderungen ermöglichen schnelle Rollbacks. Commit-Format: git commit -m "checkpoint: vor [Änderungsbeschreibung)".

MCP-Server erweitern Claude Code lokal. Beliebte Optionen:

• Playwright für Browser-Automatisierung
• GitHub für PRs und Issues

Verbundene MCPs mit /mcp prüfen.

Wichtige Erkenntnisse

• CLAUDE.md setzt strenge Regeln und lädt jede Sitzung neu
• Sub-Agenten isolieren Aufgaben und schonen Hauptkontext
• Hooks blockieren Commits mit kaputten Tests
• Kontextmanagement bleibt essenziell, auch bei 1M Tokens
• Git-Checkpoints für schnelle Rollbacks

— Editorial Team