Best Practices für Claude Code

• Damit Befehle sicher ausgeführt werden, ohne dass Sie jeden einzeln genehmigen, starten neue Terminal- und VS Code-Sitzungen im Auto-Modus, in dem ein Klassifikator alles Riskante prüft, bevor es ausgeführt wird.
• Damit Ihre Hauptkonversation fokussiert bleibt, während unabhängige Arbeit parallel erledigt wird, delegiert Claude an Subagenten und meldet sich nur, wenn es nötig ist.
• Damit eine lange Sitzung weiterläuft, ohne dass Sie sich darum kümmern müssen, wird Ihre Konversation automatisch komprimiert, bevor sich das Kontextfenster füllt.

• Ein Deploy-Prozess, der nur im Kopf einer Person existiert
• Eine Datei, die niemals gelesen werden darf
• Eine Prüfung, die bestanden sein muss, bevor etwas als erledigt gilt
• Ein Budget, das Sie einhalten müssen

• Claude hat etwas anderes gebaut, als Sie im Sinn hatten, oder muss zu Beginn jeder Sitzung dieselbe Tatsache neu herausfinden. Ihm fehlen Informationen, die es durch Lesen des Repos nicht bekommen kann. Siehe Sagen Sie Claude, was es nicht sehen kann.
• Claude sagte, es sei fertig, und das stimmte nicht ganz, meist weil es keine Möglichkeit hatte, die eigene Arbeit zu prüfen. Siehe Geben Sie Claude eine Prüfung zum Ausführen.
• Claude hat etwas getan, das in diesem Repo niemals passieren darf, oder einen Schritt übersprungen, der immer passieren muss. Ein Prompt allein kann keines von beidem garantieren. Siehe Setzen Sie die Regeln durch, die keine Ausnahmen haben dürfen.
• Claude hat es richtig gemacht, aber es hat mehr Zeit, Token oder Berechtigungsabfragen gekostet, als die Aufgabe wert war. Siehe Ändern Sie eine Standardeinstellung.

Deterministische und nicht deterministische Anweisungen

1. Nicht deterministisch: Sie schreiben die Anweisung, und Claude (das Modell) liest sie. Das kann Ihr Prompt, CLAUDE.md oder ein Skill sein. Das Modell entscheidet dann, was es mit dieser Information macht. Es folgt Ihren Anweisungen in der Regel, und aktuelle Modelle verstehen Ihre Absicht auch ohne viel Kontext gut, aber es gibt keine Garantie, dass es Ihren Anweisungen folgt. Es kann trotzdem entscheiden, Dinge nicht zu tun oder andere Dinge zu tun.
2. Deterministisch: Sie konfigurieren die Anweisung, und Claude Code (der Harness) muss sie ausführen. Das kann ein Hook, eine deny-Regel oder eine verwaltete Einstellung sein. Claude Code wendet dies jedes Mal an, unabhängig davon, was das Modell entschieden hat.

• Den generierten Client in src/gen/ nie bearbeiten
• Nach dem Erstellen einer Datei immer das Lizenz-Header-Skript ausführen

Sagen Sie Claude, was es nicht sehen kann

• Eine Entscheidung, die Ihr Team in einem Meeting getroffen hat
• Ein Deploy-Prozess, der nur im Kopf einer Person existiert
• Die Umgebungsvariable, die Ihre Integrationstests benötigen

1. Könnte es das durch Lesen des Codes finden?
2. Würde es tatsächlich nachsehen?

Schreiben Sie einen spezifischen Prompt

• Eine Datei: Geben Sie @ und den Pfad ein, um den Dateiinhalt in Ihre Nachricht aufzunehmen.
• Ein Bild: Fügen Sie den Screenshot des Designs oder des Fehlers in den Prompt ein.
• Befehlsausgabe: Leiten Sie sie aus Ihrer Shell mit cat error.log | claude -p "what's going on here" weiter.

build the settings page from the mockup. be ambitious: empty and error states, the save flow wired up, keyboard navigation, not just the layout

Brainstormen Sie zuerst mit Claude

I want to add rate limiting to the public API but haven't thought it through yet. Interview me until you could write the spec, then write it to SPEC.md.

Halten Sie CLAUDE.md kurz

• Wie Arbeit in diesem Repo bestätigt wird: die genauen Test-, Typecheck- und Lint-Befehle und wie eine einzelne Testdatei ausgeführt wird
• Stellen, an denen der Code irreführend ist: ein altes Muster, das überall vorkommt, das neuer Code aber nicht kopieren darf, oder ein Verzeichnis, das ungenutzt aussieht, es aber nicht ist
• Entscheidungen, die nicht im Repo stehen: auf welchen Fehler-Helper sich das Team geeinigt hat, wie Deploys funktionieren, was ein Migrations-Review braucht
• Alles, was Sie bereits zweimal korrigieren mussten

# Commands
- Install: pnpm install
- Run one test file: pnpm vitest run path/to/file.test.ts
- Typecheck: pnpm tsc --noEmit

# Conventions
- Use the error helpers in src/lib/errors.ts, never throw raw strings
- src/legacy/ is still live but don't copy its patterns into new code

# Gotchas
- Integration tests need DATABASE_URL set, see .env.example

• /init erzeugt eine erste Version aus Ihrer Codebasis. Danach besteht die Arbeit meist im Entfernen von Zeilen. Der Memory-Leitfaden empfiehlt, unter 200 zu bleiben.
• /doctor schlägt Kürzungen für alles vor, was Claude bereits aus dem Code erschließen kann.
• /doctor prompt-audit kennzeichnet Anweisungen, die für ältere Modelle geschrieben wurden, auf nicht mehr vorhandene Dateien verweisen oder einander widersprechen.

Beschränken Sie Regeln auf einen Teil der Codebasis

---
paths:
  - "src/api/**/*.ts"
---
- Validate request bodies with the zod schemas in src/api/schemas/, don't hand-roll checks
- Every new endpoint needs an entry in openapi.yaml, CI fails without it

Legen Sie Team-Abläufe in Skills ab

---
name: release
description: Cut a new release. Bumps the version, writes the changelog entry, tags it and pushes the tag so CI can publish.
disable-model-invocation: true
---
1. Make sure you're on main with a clean tree. If not, stop and ask.
2. Run `pnpm changeset version` and commit the result.
3. Summarize the PRs merged since the last tag into CHANGELOG.md, one line each, user-facing changes only.
4. Tag `v<new version>` and push the tag. CI publishes from there, never publish from your machine.

Verbinden Sie die Tools, die Claude braucht

claude mcp add --transport http notion https://mcp.notion.com/mcp

Geben Sie Claude eine Prüfung zum Ausführen

• Eine Testdatei
• Der Exit-Code eines Builds
• Ein Linter
• Ein Skript, das die Ausgabe per Diff mit einem Fixture vergleicht
• Ein Browser-Screenshot neben dem Mockup

• Im Prompt: run the auth tests after, and keep going until they pass. Claude entscheidet selbst, wann es zufrieden ist. Das funktioniert heute für jede Aufgabe, ohne Einrichtung.
• Als Ziel: /goal all tests in tests/auth pass and lint is clean legt eine Bedingung fest, die ein separates Modell nach jedem Turn anhand der Konversation prüft, und Claude arbeitet weiter, bis sie erfüllt ist. In der Sitzung selbst brauchen Sie das selten. Wichtig ist es bei langen Hintergrundläufen, in denen Claude einen Turn manchmal mit einer Fortschrittszusammenfassung beendet, obwohl noch Punkte offen sind, und das Ziel es zurückschickt.
• Als Stop-Hook: Ein Stop-Hook führt Ihr Skript aus, wann immer Claude versucht, seinen Turn zu beenden, und schickt Claude zurück an die Arbeit, wenn das Skript mit Code 2 endet. Dies wird von Claude Code (dem Harness) durchgesetzt, sodass der Turn erst endet, wenn der Typecheck besteht oder das Blockierungslimit erreicht ist. Es gibt ein Beispiel weiter unten.
• Durch jemanden, der den Code nicht geschrieben hat: Im Terminal prüft /code-review den Diff in einem neuen Subagenten, der Ihre Konversation nie gesehen hat. Er lässt sich nicht von der Argumentation beeinflussen, die den Code hervorgebracht hat.

Prüfen Sie anhand Ihrer Spezifikation

use a subagent to review the rate limiter diff against SPEC.md, check every requirement is implemented and the listed edge cases have tests, report gaps that affect correctness and skip style

Setzen Sie die Prüfung mit einem Stop-Hook durch

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "pnpm tsc --noEmit 1>&2 || exit 2" }
        ]
      }
    ]
  }
}

Setzen Sie die Regeln durch, die keine Ausnahmen haben dürfen

Erzwingen Sie Schritte mit Hooks

• Ein Shell-Befehl (der übliche Fall)
• Ein POST an einen HTTP-Endpunkt
• Ein Tool-Aufruf auf einem Ihrer MCP-Server
• Ein prompt- oder agent-Hook, bei dem ein Modell entscheidet

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }
        ]
      }
    ]
  }
}

Beschränken Sie den Zugriff mit Berechtigungsregeln und der Sandbox

{
  "permissions": {
    "allow": ["Bash(pnpm tsc --noEmit)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)", "Read(./.env.local)", "Read(./secrets/**)"]
  }
}

• Die Read-Regel erfasst cat .env durchaus, weil Claude Code die gängigen Befehle zum Lesen von Dateien erkennt.
• Sie erfasst kein Skript, das die Datei öffnet.
• Eine WebFetch-deny-Regel für eine Domain bewirkt nichts gegen curl an dieselbe Domain, es sei denn, die Sandbox ist aktiv.

Legen Sie fest, für wen eine Regel gilt

• .claude/settings.local.json und ~/.claude/settings.json gehören nur Ihnen. Wenn Sie für einen Befehl Yes, and don’t ask again auswählen, speichert Claude Code diese Regel in der lokalen Datei.
• .claude/settings.json und die Hooks darin gehören zum Repo. Sobald Sie sie committen, gelten sie für alle, die im Repo arbeiten. Die deny-Regeln darin gelten sofort. Die allow-Regeln greifen erst, wenn die jeweilige Person den Vertrauensdialog für diesen Ordner akzeptiert, und das Workspace-Vertrauen entscheidet auch, wann die Hooks auf ihrem Rechner ausgeführt werden.
• Verwaltete Einstellungen gehören der Organisation. Sie stammen aus der Admin-Konsole, aus MDM oder aus einer managed-settings.json-Datei, und keine persönliche Einstellungsdatei kann sie überschreiben. Damit sind sie der einzige Ort für die Richtlinien eines Sicherheitsteams. Wenn Sie diejenige Person sind, die sie festlegt, siehe Claude Code für Ihre Organisation einrichten.

Ändern Sie eine Standardeinstellung

• Interaktive Terminal- und VS Code-Sitzungen starten im Auto-Modus.
• Auf den meisten Plänen und bei den meisten Anbietern läuft Claude Opus 5.5 mit mittlerem Effort.
• Claude delegiert Arbeit an Subagenten, wenn es einen Grund dafür sieht.
• Die Konversation wird komprimiert, wenn sie wächst.

Ändern Sie den Berechtigungsmodus

• Manual-Modus: Sie genehmigen jede Bearbeitung und jeden Befehl, der nicht nur lesend ist, selbst. Sicher, aber nach der zehnten Abfrage genehmigen Sie, ohne zu lesen, und nichts geht voran, während Sie nicht an der Tastatur sind.
• bypassPermissions: genehmigt alles, was Ihre deny- und ask-Regeln nicht abdecken. Das ist nur in einem Wegwerf-Container sinnvoll.

• curl | bash
• Production-Deployments und Migrationen
• Force-Pushes über die Arbeit anderer
• Sensible Daten, die an externe Endpunkte gesendet werden
• Aktionen, die eher von Inhalten gesteuert wirken, die Claude gelesen hat, als von Ihnen

{
  "autoMode": {
    "environment": [
      "$defaults",
      "Source control: github.com/example-org and every repo under it",
      "Trusted internal domains: *.internal.example.com"
    ],
    "allow": [
      "$defaults",
      "Deploying to the staging namespace is fine, it's isolated from production and resets nightly"
    ]
  }
}

Ändern Sie Modell und Effort

• Erhöhen Sie es mit /effort high oder /effort xhigh, wenn es darauf ankommt, Fälle zu erfassen, die leicht übersehen werden. Denken Sie an einen Fehler in Code, den Sie nicht geschrieben haben, einen instabilen Test oder eine Schemaänderung, bei der Claude jeden Leser der alten Struktur finden muss. Claude prüft dann mehr Edge Cases und verifiziert mehr von seiner Arbeit, bevor es antwortet. Dafür gehen die zusätzliche Zeit und die zusätzlichen Token drauf.
• Senken Sie es mit /effort low, wenn Sie schnell hin und her arbeiten und ohnehin jedes Ergebnis prüfen: Brainstorming, ein erster Entwurf, eine Umbenennung über ein paar Dateien. Claude liefert Ihnen schneller einen Ausgangspunkt, und da Sie jeden Schritt steuern, hätte die zusätzliche Überlegung außer der Wartezeit kaum etwas geändert.
• Heben Sie max für ein schwieriges Problem auf, das Claude ohne Sie durcharbeiten soll, etwa die Suche nach einer Sicherheitslücke. Bei gewöhnlichen Aufgaben neigt es dazu, zu viel nachzudenken, sodass Sie mehr für eine Antwort bezahlen, die womöglich nicht besser ist als mit high.
• Wenn nur die nächste Nachricht es braucht, etwa eine knifflige Frage mitten in ansonsten alltäglicher Arbeit, schreiben Sie ultrathink in diesen Prompt, statt die Einstellung zu ändern.

Wissen Sie, was Subagenten kosten

• Breite Suchen in der Codebasis gehen an den integrierten Explore-Agenten.
• Nebenaufgaben werden geforkt, solange der Fork-Modus aktiv ist (die Standardeinstellung).
• Die Subagenten, die es startet, laufen standardmäßig im Hintergrund, sodass Ihre Hauptkonversation weiterläuft.

• Unabhängige Arbeitspakete gleichzeitig ausführen, damit die gesamte Aufgabe schneller fertig ist
• Lange Ausgaben, etwa einen vollständigen Testlauf oder eine breite Suche, aus Ihrer Hauptkonversation heraushalten, wo sie sonst für den Rest der Sitzung mitgeschleppt würden
• Einen Reviewer bekommen, der nicht gesehen hat, wie der Code geschrieben wurde
• Einer Aufgabe weniger Tools geben, als die Hauptsitzung hat, etwa einem Reviewer, der lesen, aber nicht bearbeiten kann

• Setzen Sie model: haiku in der Definition eines Subagenten, wenn seine Arbeit einfach ist, etwa die Dateien zu sammeln, die ein Modul importieren, oder Links in der Dokumentation zu prüfen. Eine solche Aufgabe braucht nicht das größere Modell, und Haiku kostet pro Anfrage deutlich weniger.
• Bitten Sie um kurze Zusammenfassungen als Rückmeldung, damit zwanzig Ergebnisse Ihren Kontext nicht trotzdem füllen.
• Prüfen Sie mit /usage, welchen Anteil Ihrer Nutzung jeder Subagententyp ausmacht, damit Sie erkennen, welche ihre Kosten wert sind.
• Geben Sie einem benutzerdefinierten Subagenten in .claude/agents/ nur tools: Read, Grep, Glob. Dann ist er ein Reviewer, der nichts bearbeiten kann, und diese Einschränkung wird von Claude Code durchgesetzt, statt in einem Prompt erbeten zu werden.

---
name: reviewer
description: Reviews changed files against the spec they were built from. Use after implementing a feature, before opening the PR.
tools: Read, Grep, Glob
---
You're reviewing code you didn't write. Compare the changed files against the spec you're given,
check that every requirement is implemented and the listed edge cases have tests,
and report only the gaps that affect correctness. Skip style.

Halten Sie Kosten und Kontext gering

• /clear zwischen unzusammenhängenden Aufgaben. Es kostet nichts und sorgt dafür, dass die nächste Aufgabe nicht weiter für den Verlauf der vorherigen bezahlt. /clear oauth-migration benennt die Sitzung, die Sie verlassen, damit Sie später zu ihr zurückkehren können.
• /compact mit einem Fokus, etwa /compact keep the API changes and the test commands. In einer langen Sitzung ist /compact selbst eine große Anfrage, da es die gesamte Konversation liest, um sie zusammenzufassen, und das umso mehr, wenn der Cache abgelaufen ist.
• Behalten Sie Hintergrundarbeit im Blick: Ein /loop, die Prüfung eines Ziels nach jedem Turn und Claudes eigene Subagenten senden alle weiterhin Anfragen, während Sie nicht tippen.

Steuern Sie die Sitzung

• Esc stoppt Claude mitten in einer Aktion und behält alles bis zu diesem Punkt, sodass Sie umlenken können, ohne Arbeit zu verlieren.
• /rewind oder zweimal Esc bei leerem Prompt öffnet das Rewind-Menü, in dem Sie den Code, die Konversation oder beides auf einen früheren Prompt zurücksetzen. Dadurch ist es risikoarm, zuerst den mutigeren Ansatz auszuprobieren und zurückzuspulen, wenn er nicht funktioniert. Dasselbe Menü kann auch einen Teil der Konversation zusammenfassen, wenn dieser veraltet ist.
• /clear fängt neu an. Wenn Sie dasselbe zweimal korrigiert haben und es immer noch falsch ist, ergänzt eine dritte Korrektur vor allem eine Konversation, die bereits zwei fehlgeschlagene Versuche enthält, die Claude immer wieder liest. /clear plus ein neuer Prompt, der das Gelernte einbezieht, funktioniert fast jedes Mal besser.

Lassen Sie Claude ohne Sie arbeiten

1. Weiß es, wie „fertig“ aussieht? Eine Zielbedingung, eine Spezifikationsdatei oder ein fehlschlagender Test, den es grün machen muss.
2. Kann es seine eigene Arbeit prüfen? Die Test-Suite, ein Stop-Hook, irgendein Review-Schritt.
3. Was darf es anfassen? Berechtigungsregeln, dontAsk, die Sandbox, ein Worktree, der eine Branch, auf den es pushen darf.
4. Was stoppt es? --max-turns, --max-budget-usd, ein Ausgabenlimit.
5. Wohin geht das Ergebnis, und wer gibt es frei? Ein PR, ein Kommentar oder eine Zusammenfassung, und dann eine Person, die den Merge, das Deployment oder alles andere genehmigt, was sich nicht rückgängig machen lässt.

Führen Sie Claude aus einem Skript aus

• --bare überspringt Hooks, Skills, Plugins, MCP-Server und CLAUDE.md-Dateien, sowohl die des Repos als auch die des Rechners, sodass der Lauf überall dasselbe tut. Außerdem wird Ihre claude.ai-Anmeldung nie verwendet: Die Authentifizierung kommt aus ANTHROPIC_API_KEY, einem apiKeyHelper in der Datei, die Sie mit --settings übergeben, oder den Anmeldedaten Ihres Cloud-Anbieters.
• --append-system-prompt, --mcp-config und --settings übergeben explizit, was der Lauf tatsächlich braucht. Hooks, die Sie mit --settings übergeben, laufen unter --bare nicht, verwenden Sie --bare also nicht für einen Lauf, der sie benötigt.
• --allowedTools genehmigt seine Tools vorab, und --permission-mode dontAsk lehnt alles andere ab, das eine Abfrage ausgelöst hätte.
• --output-format json liefert Ihnen ein einzelnes Ergebnisobjekt zum Parsen, und stream-json mit --verbose streamt Ereignisse, während sie auftreten.

for file in $(cat files.txt); do
  claude --bare -p "Migrate $file to the new logger API and commit. Reply OK or FAIL." \
    --allowedTools "Read,Edit,Bash(git add *),Bash(git commit *)" \
    --permission-mode dontAsk \
    --max-turns 20
done

Starten Sie Läufe nach Zeitplan oder bei einem Ereignis

/loop 15m check CI on this branch, and if it's red pull the failing job's log, fix it and push

Führen Sie Sitzungen parallel aus

.env
.env.local
config/dev-credentials.json

• Wenn Sie eine unbenannte Worktree-Sitzung beenden, entfernt Claude Code den Worktree, sofern nichts darin ist. Bei einer benannten Sitzung oder einer mit Änderungen fragt es, was zu tun ist.
• Subagenten-Worktrees verschwinden, wenn der Subagent ohne Änderungen fertig wird.
• Zurückgebliebene Worktrees von Subagenten und Hintergrundsitzungen werden entfernt, sobald sie älter als cleanupPeriodDays sind und keine Arbeit enthalten.

Was Sie nicht mehr tun müssen

Verwandte Ressourcen

• Wie Claude Code funktioniert: die Schleife, die Tools und was beim Start geladen wird
• Das Kontextfenster erkunden: was in einer Sitzung Platz belegt und wann es geladen wird
• Claude Code erweitern: die Wahl zwischen Skills, Hooks, MCP, Subagenten und Plugins
• Einen Berechtigungsmodus wählen und Berechtigungen konfigurieren
• Kosten effektiv verwalten
• Claude Code programmatisch ausführen und Arbeit mit geplanten Cloud-Aufgaben automatisieren
• Für Teamleads und Admins: Claude Code für Ihre Organisation einrichten