Warum Standard-Prompting bei Claude Code nicht reicht
Claude Code ist kein Chatbot. Es liest Dateien, führt Befehle aus, macht Commits und startet andere Agents. Ein vager Prompt produziert vage — oder schlimmer: unerwartete — Aktionen.
Die gute Nachricht: Claude Code folgt klaren Instruktionen präziser als die meisten anderen Tools. Du musst nur wissen, wie.
Praxis-Tipp vor dem Start: Diese Techniken funktionieren sowohl in interaktiven Sessions als auch in CLAUDE.md-Dateien (für dauerhafte Regeln). Wir empfehlen, bewährte Prompts direkt in dein CLAUDE.md zu schreiben.
Die 12 Techniken
1
Kontext-First: Erkläre WARUM, nicht nur WAS
Grundprinzip
Claude Code trifft bessere Entscheidungen wenn es den Kontext kennt. "Was" zu erklären reicht nicht — erkläre auch "warum".
❌ Schwach
"Füge Error-Handling hinzu."
✅ Stark
"Füge Error-Handling für den Supabase-Auth-Call hinzu. Kontext: Dieser Endpoint wird von mobilen Clients aufgerufen die instabile Verbindungen haben. Zeige dem User einen verständlichen Fehler statt einer technischen Exception."
2
Output-Format explizit definieren
Output-Kontrolle
Sage Claude Code genau welches Format du erwartest. Ohne Angabe wählt der Agent sein eigenes Format — das selten deines ist.
Analysiere diese Fehlermeldung und antworte in diesem Format:
URSACHE: [1 Satz]
LÖSUNG: [max. 3 Schritte]
DATEIEN: [nur betroffene Dateien auflisten]
RISIKO: [niedrig/mittel/hoch]
3
Negative Constraints: Was der Agent NICHT tun soll
Grenzen setzen
Claude Code ist proaktiv — manchmal zu proaktiv. Explizite Verbote sind oft wichtiger als Erlaubnisse.
Refaktoriere die Authentifizierungs-Logik.
NICHT tun:
- Keine neuen Dependencies hinzufügen
- package.json nicht anfassen
- Tests nicht verändern
- Keine Commits — ich review zuerst
4
Schrittweise Ausführung mit Checkpoints
Kontrolle behalten
Bei komplexen Tasks: lass Claude Code nach jedem Schritt pausieren und bestätigen.
Migriere die Datenbank-Schema-Änderungen. Gehe so vor:
Schritt 1: Zeige mir die Migration-Datei die du erstellen würdest — führe sie NOCH NICHT aus.
→ Warte auf mein OK.
Schritt 2: Führe die Migration in der DEV-Datenbank aus.
→ Zeige mir das Ergebnis. Warte auf mein OK.
Schritt 3: Erst dann: PROD-Migration.
5
Rollen-Framing für domänenspezifisches Wissen
Qualität steigern
Claude Code übernimmt Experten-Perspektiven und passt seinen Output entsprechend an.
Du bist ein Senior Security Engineer mit Fokus auf Web-Application Security.
Review diesen Authentication-Code auf OWASP Top 10 Vulnerabilities.
Priorisiere nach Kritikalität: P0 (sofort fixen) → P1 (diese Woche) → P2 (nächste Iteration).
6
CLAUDE.md für dauerhafte Agent-Regeln
Skalierung
Alles was du mehr als 2x sagen musst, gehört in CLAUDE.md — nicht in jeden Prompt.
# CLAUDE.md — Beispiel-Regeln
## Code-Standards
- TypeScript strict mode immer aktiviert
- Keine any-Types — nie, auch nicht temporär
- Tests vor jedem Commit: npm test muss grün sein
## Verbotene Aktionen
- NIEMALS direkt in main pushen
- Keine force-pushes
- .env niemals committen
## Commit-Format
[typ] kurze Beschreibung (max 72 Zeichen)
7
Beispiel-basiertes Prompting (Few-Shot)
Konsistenz
Zeige dem Agent ein Beispiel des gewünschten Outputs — dann repliziert er das Muster zuverlässig.
Schreibe API-Dokumentation für alle Public Functions in diesem Format:
BEISPIEL (so soll es aussehen):
/**
* Authentifiziert einen User via JWT-Token.
* @param token - JWT aus dem Authorization Header
* @returns UserId wenn valide, null wenn abgelaufen/invalid
* @throws AuthError wenn Token malformed
*/
Jetzt mache das für alle Functions in: src/api/user.ts
8
Granularitätsstufe explizit angeben
Effizienz
Ohne Angabe wählt Claude Code eine mittlere Granularität — die oft nicht zu deinem Task passt.
Erkläre wie das Auth-System funktioniert.
[Für eine schnelle Übersicht:]
"Antworte in max. 5 Bulletpoints, keine Code-Details."
[Für ein tiefes Review:]
"Gehe durch jeden Auth-Schritt, zeige relevante Code-Stellen, erkläre potenzielle Security-Risiken."
9
Chain-of-Thought für komplexe Analysen
Denkqualität
Bei komplexen Problemen: fordere Claude Code auf, laut zu denken bevor es entscheidet.
Dieser Deployment-Fehler tritt intermittierend auf.
Bevor du eine Lösung vorschlägst:
1. Liste alle möglichen Ursachen auf (auch unwahrscheinliche)
2. Sortiere nach Wahrscheinlichkeit
3. Erkläre wie du jede Hypothese testen würdest
4. DANN: schlage den konkreten Fix vor
Fehler-Log: [paste log here]
10
Datei-Scope explizit einschränken
Kontrolle behalten
Claude Code liest und schreibt Dateien. Ohne Einschränkung exploriert es den gesamten Codebase — manchmal zu weit.
Finde alle Stellen wo wir direkte SQL-Queries statt des ORM verwenden.
Schau NUR in diesen Verzeichnissen:
- src/api/
- src/services/
Ignoriere:
- node_modules/
- tests/
- *.md Dateien
11
Konfidenz-Abfrage bei Unsicherheit
Qualitätssicherung
Claude Code antwortet standardmäßig ohne seine eigene Unsicherheit zu kommunizieren. Frage aktiv danach.
Analysiere ob diese Datenbankabfrage race conditions verursachen kann.
Antworte mit:
KONFIDENZ: [hoch/mittel/niedrig]
BEGRÜNDUNG: [warum diese Konfidenz?]
ANALYSE: [deine eigentliche Analyse]
Wenn Konfidenz niedrig: nenne was du zusätzlich brauchst um sicher zu sein.
12
Rollenwechsel für Peer-Review
Qualitätssicherung
Eine der mächtigsten Techniken: lass Claude Code seinen eigenen Output reviewen — aus einer anderen Perspektive.
Schritt 1 (als Entwickler):
"Implementiere die neue User-Registration."
[Nach dem Output:]
Schritt 2 (als Reviewer):
"Wechsle jetzt die Perspektive: Du bist ein Senior Developer der diesen Code reviewed.
Liste alle Probleme, Edge Cases und Sicherheitslücken.
Sei kritisch — als ob du das zum ersten Mal siehst."
Bonus: Prompt-Templates für häufige Tasks
Bug-Report Template
BUG: [kurze Beschreibung]
ERWARTETES VERHALTEN: [was sollte passieren]
TATSÄCHLICHES VERHALTEN: [was passiert]
REPRODUZIERBAR: [immer/manchmal/einmalig]
UMGEBUNG: [local/staging/prod]
RELEVANTE DATEIEN: [Pfade]
LOG: [relevante Logs hier]
Analysiere Root Cause. Schlage Fix vor. Zeige Testfall der den Fix verifiziert.
Code-Review Template
Review den folgenden Code-Change als Senior Developer.
Fokus: Korrektheit, Performance, Security, Maintainability.
Beantworte:
1. Gibt es Bugs? (mit Zeilen-Referenz)
2. Performance-Probleme? (messbar, nicht hypothetisch)
3. Security-Risiken? (OWASP relevanz?)
4. Was würdest du anders machen? (mit Begründung)
Rate 1-10: Wie production-ready ist dieser Code?
CODE: [code hier]
Zusammenfassung: Die wichtigsten Prinzipien
- Kontext vor Command: Erkläre immer WARUM
- Explizit ist besser als implizit: Format, Scope, Grenzen — alles sagen
- Negative Constraints genauso wichtig wie positive
- Checkpoints bei komplexen Tasks: Kontrolle behalten
- CLAUDE.md für alles was sich wiederholt
- Rollenwechsel für Peer-Review nutzen
Diese Techniken in der Praxis lernen
Im Claude Code Mastery Kurs gehen wir alle 12 Techniken durch — mit echten Workflows aus unserem AI-Unternehmen als Beispiele. 30+ CLAUDE.md Templates inklusive.
14 Tage kostenlos testen →