Best Practices für Claude Code

​

Geben Sie Claude eine Möglichkeit, seine Arbeit zu überprüfen

• In einer Eingabeaufforderung: Bitten Sie Claude, die Überprüfung auszuführen und in derselben Nachricht zu iterieren, wie in der Tabelle oben.
• Über eine Sitzung: Legen Sie die Überprüfung als /goal-Bedingung fest. Ein separater Evaluator überprüft sie nach jedem Zug erneut und Claude arbeitet weiter, bis sie erfüllt ist.
• Als deterministisches Gate: Ein Stop-Hook führt Ihre Überprüfung als Skript aus und blockiert das Ende des Zugs, bis er bestanden ist. Claude Code überschreibt den Hook und beendet den Zug nach 8 aufeinanderfolgenden Blockierungen.
• Durch eine zweite Meinung: Ein Überprüfungs-Subagent oder ein dynamischer Workflow, der seine eigenen Erkenntnisse überprüft, lässt ein frisches Modell versuchen, das Ergebnis zu widerlegen, sodass der Agent, der die Arbeit verrichtet, nicht derjenige ist, der sie bewertet.

​

Erkunden Sie zuerst, dann planen Sie, dann codieren Sie

read /src/auth and understand how we handle sessions and login.
also look at how we manage environment variables for secrets.

I want to add Google OAuth. What files need to change?
What's the session flow? Create a plan.

implement the OAuth flow from your plan. write tests for the
callback handler, run the test suite and fix any failures.

commit with a descriptive message and open a PR

​

Geben Sie spezifischen Kontext in Ihren Prompts an

​

Geben Sie umfangreiche Inhalte an

• Verweisen Sie auf Dateien mit @ anstatt zu beschreiben, wo Code lebt. Claude liest die Datei, bevor er antwortet.
• Fügen Sie Bilder direkt ein. Kopieren/fügen Sie Bilder ein oder ziehen Sie sie in den Prompt.
• Geben Sie URLs für Dokumentation und API-Referenzen an. Verwenden Sie /permissions, um häufig verwendete Domains auf die Whitelist zu setzen.
• Leiten Sie Daten weiter, indem Sie cat error.log | claude ausführen, um Dateiinhalte direkt zu senden.
• Lassen Sie Claude abrufen, was es braucht. Sagen Sie Claude, dass es Kontext selbst mit Bash-Befehlen, MCP-Tools oder durch Lesen von Dateien abrufen soll.

​

Konfigurieren Sie Ihre Umgebung

​

Schreiben Sie eine effektive CLAUDE.md

# Code style
- Use ES modules (import/export) syntax, not CommonJS (require)
- Destructure imports when possible (eg. import { foo } from 'bar')

# Workflow
- Be sure to typecheck when you're done making a series of code changes
- Prefer running single tests, and not the whole test suite, for performance

See @README.md for project overview and @package.json for available npm commands.

# Additional Instructions
- Git workflow: @docs/git-instructions.md
- Personal overrides: @~/.claude/my-project-instructions.md

• Home-Ordner (~/.claude/CLAUDE.md): gilt für alle Claude-Sessions
• Projekt-Root (./CLAUDE.md): überprüfen Sie in Git, um mit Ihrem Team zu teilen
• Projekt-Root (./CLAUDE.local.md): persönliche projektspezifische Notizen; fügen Sie diese Datei zu Ihrer .gitignore hinzu, damit sie nicht mit Ihrem Team geteilt wird
• Übergeordnete Verzeichnisse: nützlich für Monorepos, bei denen sowohl root/CLAUDE.md als auch root/foo/CLAUDE.md automatisch eingezogen werden
• Untergeordnete Verzeichnisse: Claude zieht untergeordnete CLAUDE.md-Dateien bei Bedarf ein, wenn mit Dateien in diesen Verzeichnissen gearbeitet wird

​

Konfigurieren Sie Berechtigungen

• Auto Mode: ein separates Klassifizierer-Modell überprüft Befehle und blockiert nur das, was riskant aussieht: Scope-Eskalation, unbekannte Infrastruktur oder feindselige-Inhalts-getriebene Aktionen. Am besten, wenn Sie der allgemeinen Richtung einer Aufgabe vertrauen, aber nicht jeden Schritt durchklicken möchten
• Berechtigungs-Whitelists: erlauben Sie spezifische Tools, die Sie kennen und die sicher sind, wie npm run lint oder git commit
• Sandboxing: aktivieren Sie Isolation auf Betriebssystemebene, die Dateisystem- und Netzwerkzugriff einschränkt und Claude ermöglicht, freier innerhalb definierter Grenzen zu arbeiten

​

Verwenden Sie CLI-Tools

​

Verbinden Sie MCP-Server

​

Richten Sie Hooks ein

​

Erstellen Sie Skills

---
name: api-conventions
description: REST API design conventions for our services
---
# API Conventions
- Use kebab-case for URL paths
- Use camelCase for JSON properties
- Always include pagination for list endpoints
- Version APIs in the URL path (/v1/, /v2/)

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---
Analyze and fix the GitHub issue: $ARGUMENTS.

1. Use `gh issue view` to get the issue details
2. Understand the problem described in the issue
3. Search the codebase for relevant files
4. Implement the necessary changes to fix the issue
5. Write and run tests to verify the fix
6. Ensure code passes linting and type checking
7. Create a descriptive commit message
8. Push and create a PR

​

Erstellen Sie benutzerdefinierte Subagents

---
name: security-reviewer
description: Reviews code for security vulnerabilities
tools: Read, Grep, Glob, Bash
model: opus
---
You are a senior security engineer. Review code for:
- Injection vulnerabilities (SQL, XSS, command injection)
- Authentication and authorization flaws
- Secrets or credentials in code
- Insecure data handling

Provide specific line references and suggested fixes.

​

Installieren Sie Plugins

​

Kommunizieren Sie effektiv

​

Stellen Sie Codebase-Fragen

• Wie funktioniert Logging?
• Wie erstelle ich einen neuen API-Endpunkt?
• Was macht async move { ... } auf Zeile 134 von foo.rs?
• Welche Edge Cases behandelt CustomerOnboardingFlowImpl?
• Warum ruft dieser Code foo() anstelle von bar() auf Zeile 333 auf?

​

Lassen Sie Claude Sie interviewen

I want to build [brief description]. Interview me in detail using the AskUserQuestion tool.

Ask about technical implementation, UI/UX, edge cases, concerns, and tradeoffs. Don't ask obvious questions, dig into the hard parts I might not have considered.

Keep interviewing until we've covered everything, then write a complete spec to SPEC.md.

​

Verwalten Sie Ihre Session

​

Korrigieren Sie früh und oft

• Esc: stoppen Sie Claude mitten in einer Aktion mit der Esc-Taste. Der Kontext wird beibehalten, sodass Sie umleiten können.
• Esc + Esc oder /rewind: drücken Sie Esc zweimal oder führen Sie /rewind aus, um das Rewind-Menü zu öffnen und die vorherige Konversation und den Code-Status wiederherzustellen, oder fassen Sie eine ausgewählte Nachricht zusammen.
• "Undo that": lassen Sie Claude seine Änderungen rückgängig machen.
• /clear: setzen Sie den Kontext zwischen nicht verwandten Aufgaben zurück. Lange Sessions mit irrelevantem Kontext können die Leistung reduzieren.

​

Verwalten Sie den Kontext aggressiv

• Verwenden Sie /clear häufig zwischen Aufgaben, um das Kontextfenster vollständig zurückzusetzen
• Wenn die automatische Komprimierung ausgelöst wird, fasst Claude zusammen, was am wichtigsten ist, einschließlich Code-Muster, Dateizustände und wichtige Entscheidungen
• Für mehr Kontrolle führen Sie /compact <instructions> aus, wie /compact Focus on the API changes
• Um nur einen Teil der Konversation zu komprimieren, verwenden Sie Esc + Esc oder /rewind, wählen Sie einen Nachricht-Checkpoint und wählen Sie Summarize from here oder Summarize up to here. Das erste verdichtet Nachrichten von diesem Punkt an, während der frühere Kontext erhalten bleibt; das zweite verdichtet frühere Nachrichten, während neuere vollständig erhalten bleiben. Siehe Restore vs. summarize.
• Passen Sie das Komprimierungsverhalten in CLAUDE.md mit Anweisungen wie "When compacting, always preserve the full list of modified files and any test commands" an, um sicherzustellen, dass kritischer Kontext die Zusammenfassung überlebt
• Für schnelle Fragen, die nicht im Kontext bleiben müssen, verwenden Sie /btw. Die Antwort erscheint in einer verwerfbaren Überlagerung und gelangt niemals in die Konversationshistorie, sodass Sie ein Detail überprüfen können, ohne den Kontext zu vergrößern.

​

Verwenden Sie Subagents für Untersuchungen

Use subagents to investigate how our authentication system handles token
refresh, and whether we have any existing OAuth utilities I should reuse.

use a subagent to review this code for edge cases

​

Rewind mit Checkpoints

​

Setzen Sie Konversationen fort

​

Automatisieren und skalieren Sie

​

Führen Sie nicht-interaktiven Modus aus

# One-off queries
claude -p "Explain what this project does"

# Structured output for scripts
claude -p "List all API endpoints" --output-format json

# Streaming for real-time processing
claude -p "Analyze this log file" --output-format stream-json --verbose

​

Führen Sie mehrere Claude-Sessions aus

• Worktrees: Führen Sie separate CLI-Sessions in isolierten Git-Checkouts aus, damit Änderungen nicht kollidieren
• Desktop-App: Verwalten Sie mehrere lokale Sessions visuell, jede in ihrem eigenen Worktree
• Claude Code im Web: Führen Sie Sessions auf der von Anthropic verwalteten Cloud-Infrastruktur in isolierten VMs aus
• Agent Teams: Automatisierte Koordination mehrerer Sessions mit gemeinsamen Aufgaben, Messaging und einem Team Lead

​

Fan Out über Dateien

for file in $(cat files.txt); do
  claude -p "Migrate $file from React to Vue. Return OK or FAIL." \
    --allowedTools "Edit,Bash(git commit *)"
done

claude -p "<your prompt>" --output-format json | your_command

​

Führen Sie autonom mit Auto Mode aus

claude --permission-mode auto -p "fix all lint errors"

​

Fügen Sie einen gegnerischen Überprüfungsschritt hinzu

Use a subagent to review the rate limiter diff against PLAN.md. Check that
every requirement is implemented, the listed edge cases have tests, and
nothing outside the task's scope changed. Report gaps, not style preferences.

​

Vermeiden Sie häufige Fehlermuster

• Die Kitchen-Sink-Session. Sie beginnen mit einer Aufgabe, dann fragen Claude etwas Unverwandtes, dann gehen Sie zurück zur ersten Aufgabe. Der Kontext ist voll mit irrelevanten Informationen.

  Lösung: /clear zwischen nicht verwandten Aufgaben.

• Immer wieder korrigieren. Claude macht etwas falsch, Sie korrigieren es, es ist immer noch falsch, Sie korrigieren erneut. Der Kontext ist mit fehlgeschlagenen Ansätzen verschmutzt.

  Lösung: Nach zwei fehlgeschlagenen Korrektionen /clear und schreiben Sie einen besseren anfänglichen Prompt, der das Gelernte einbezieht.

• Die über-spezifizierte CLAUDE.md. Wenn Ihre CLAUDE.md zu lang ist, ignoriert Claude die Hälfte davon, weil wichtige Regeln in dem Lärm verloren gehen.

  Lösung: Rücksichtslos bereinigen. Wenn Claude etwas bereits ohne die Anweisung richtig macht, löschen Sie es oder konvertieren Sie es in einen Hook.

• Die Trust-then-Verify-Lücke. Claude produziert eine plausibel aussehende Implementierung, die Edge Cases nicht behandelt.

  Lösung: Geben Sie immer Überprüfung an (Tests, Skripte, Screenshots). Wenn Sie es nicht überprüfen können, versenden Sie es nicht.

• Die unendliche Erkundung. Sie bitten Claude, etwas zu „untersuchen”, ohne es zu begrenzen. Claude liest Hunderte von Dateien und füllt den Kontext.

  Lösung: Begrenzen Sie Untersuchungen eng oder verwenden Sie Subagents, damit die Erkundung Ihren Hauptkontext nicht verbraucht.

​

Entwickeln Sie Ihre Intuition

​

Verwandte Ressourcen

• How Claude Code works: die agentengesteuerte Schleife, Tools und Kontextverwaltung
• Extend Claude Code: Skills, Hooks, MCP, Subagents und Plugins
• Common workflows: Schritt-für-Schritt-Rezepte zum Debuggen, Testen, PRs und mehr
• CLAUDE.md: speichern Sie Projektkonventionen und persistenten Kontext