SpyBara
Go Premium

best-practices.md 2026-06-09 06:34 UTC to 2026-06-10 23:57 UTC

130 added, 37 removed.

2026
Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

Best Practices für Claude Code

Tipps und Muster, um das Beste aus Claude Code herauszuholen – von der Konfiguration Ihrer Umgebung bis zur Skalierung über parallele Sessions.

Claude Code ist eine agentengesteuerte Coding-Umgebung. Im Gegensatz zu einem Chatbot, der Fragen beantwortet und wartet, kann Claude Code Ihre Dateien lesen, Befehle ausführen, Änderungen vornehmen und autonom Probleme lösen, während Sie zuschauen, umleiten oder sich ganz zurückziehen.

Dies ändert Ihre Arbeitsweise. Anstatt Code selbst zu schreiben und Claude zur Überprüfung zu bitten, beschreiben Sie, was Sie möchten, und Claude findet heraus, wie es zu bauen ist. Claude erkundet, plant und implementiert.

Aber diese Autonomie bringt immer noch eine Lernkurve mit sich. Claude arbeitet innerhalb bestimmter Einschränkungen, die Sie verstehen müssen.

Dieser Leitfaden behandelt Muster, die sich in den internen Teams von Anthropic und bei Ingenieuren, die Claude Code in verschiedenen Codebases, Sprachen und Umgebungen nutzen, als wirksam erwiesen haben. Informationen zur Funktionsweise der agentengesteuerten Schleife finden Sie unter How Claude Code works.

Die meisten Best Practices basieren auf einer Einschränkung: Claudes Kontextfenster füllt sich schnell, und die Leistung verschlechtert sich, wenn es sich füllt.

Claudes Kontextfenster enthält Ihre gesamte Konversation, einschließlich jeder Nachricht, jeder Datei, die Claude liest, und jeder Befehlsausgabe. Dies kann sich jedoch schnell füllen. Eine einzelne Debugging-Sitzung oder Codebase-Erkundung könnte Zehntausende von Tokens generieren und verbrauchen.

Dies ist wichtig, da die LLM-Leistung abnimmt, wenn sich der Kontext füllt. Wenn das Kontextfenster voll wird, könnte Claude anfangen, frühere Anweisungen zu „vergessen" oder mehr Fehler zu machen. Das Kontextfenster ist die wichtigste Ressource, die verwaltet werden muss. Um zu sehen, wie sich eine Session in der Praxis füllt, schauen Sie sich eine interaktive Anleitung an, was beim Start geladen wird und was jedes Datei-Lesen kostet. Verfolgen Sie die Kontextnutzung kontinuierlich mit einer benutzerdefinierten Statuszeile, und siehe Token-Nutzung reduzieren für Strategien zur Reduzierung der Token-Nutzung.

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

Claude stoppt, wenn die Arbeit erledigt aussieht. Ohne eine Überprüfung, die er ausführen kann, ist „sieht erledigt aus" das einzige verfügbare Signal, und Sie werden zur Überprüfungsschleife: jeder Fehler wartet darauf, dass Sie ihn bemerken. Geben Sie Claude etwas, das ein Bestanden oder Fehlgeschlagen erzeugt, und die Schleife schließt sich von selbst. Claude führt die Arbeit aus, führt die Überprüfung aus, liest das Ergebnis und iteriert, bis die Überprüfung bestanden ist.

Die Überprüfung ist alles, das ein Signal zurückgibt, das Claude im Gespräch lesen kann: eine Test-Suite, ein Build-Exit-Code, ein Linter, ein Skript, das die Ausgabe mit einem Fixture vergleicht, oder ein Browser-Screenshot, der mit einem Design verglichen wird.

Strategie Vorher Nachher
Überprüfungskriterien bereitstellen „implementiere eine Funktion, die E-Mail-Adressen validiert" „schreibe eine validateEmail-Funktion. Beispiel-Testfälle: user@example.com ist wahr, invalid ist falsch, user@.com ist falsch. führe die Tests nach der Implementierung aus"
UI-Änderungen visuell überprüfen „mache das Dashboard besser aussehen" „[Screenshot einfügen] implementiere dieses Design. mache einen Screenshot des Ergebnisses und vergleiche ihn mit dem Original. liste Unterschiede auf und behebe sie"
Grundursachen beheben, nicht Symptome „der Build schlägt fehl" „der Build schlägt mit diesem Fehler fehl: [Fehler einfügen]. behebe ihn und überprüfe, dass der Build erfolgreich ist. behebe die Grundursache, unterdrücke den Fehler nicht"

Sobald die Überprüfung vorhanden ist, entscheiden Sie, wie streng sie den Stopp kontrolliert:

  • 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.

Jeder Schritt tauscht Setup gegen Aufmerksamkeit. Die Eingabeaufforderungsversion funktioniert heute bei jeder Aufgabe. Die /goal- und Stop-Hook-Versionen sind das, was einen unbeaufsichtigten Lauf ermöglicht, um korrekt zu beenden, ohne dass Sie eingreifen müssen.

Lassen Sie Claude Belege zeigen, anstatt Erfolg zu behaupten: die Testausgabe, der Befehl, den es ausgeführt hat, und was er zurückgegeben hat, oder ein Screenshot des Ergebnisses. Die Überprüfung von Belegen ist schneller als die erneute Ausführung der Überprüfung selbst, und es funktioniert für Sitzungen, die Sie nicht beobachtet haben.

Erkunden Sie zuerst, dann planen Sie, dann codieren Sie

Wenn Claude direkt zum Codieren springt, kann dies zu Code führen, der das falsche Problem löst. Verwenden Sie Plan Mode, um Erkundung von Ausführung zu trennen.

Der empfohlene Workflow hat vier Phasen:

1

Erkunden

Geben Sie Plan Mode ein. Claude liest Dateien und beantwortet Fragen, ohne Änderungen vorzunehmen.

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

Planen

Bitten Sie Claude, einen detaillierten Implementierungsplan zu erstellen.

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

Drücken Sie Ctrl+G, um den Plan in Ihrem Texteditor zur direkten Bearbeitung zu öffnen, bevor Claude fortfährt.

3

Implementieren

Wechseln Sie aus Plan Mode und lassen Sie Claude codieren, wobei Sie gegen seinen Plan überprüfen.

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

Commit

Bitten Sie Claude, mit einer aussagekräftigen Nachricht zu committen und einen PR zu erstellen.

commit with a descriptive message and open a PR

Geben Sie spezifischen Kontext in Ihren Prompts an

Claude kann Absichten ableiten, aber er kann nicht Ihre Gedanken lesen. Verweisen Sie auf spezifische Dateien, erwähnen Sie Einschränkungen und zeigen Sie auf Beispielmuster.

Strategie Vorher Nachher
Begrenzen Sie die Aufgabe. Geben Sie an, welche Datei, welches Szenario und Testpräferenzen. „füge Tests für foo.py hinzu" „schreibe einen Test für foo.py, der den Edge Case abdeckt, in dem der Benutzer abgemeldet ist. vermeide Mocks."
Zeigen Sie auf Quellen. Leiten Sie Claude zur Quelle, die eine Frage beantworten kann. „warum hat ExecutionFactory eine so seltsame API?" „schaue dir die Git-Historie von ExecutionFactory an und fasse zusammen, wie seine API entstanden ist"
Verweisen Sie auf vorhandene Muster. Zeigen Sie Claude Muster in Ihrer Codebase. „füge ein Calendar-Widget hinzu" „schaue dir an, wie vorhandene Widgets auf der Startseite implementiert sind, um die Muster zu verstehen. HotDogWidget.php ist ein gutes Beispiel. folge dem Muster, um ein neues Calendar-Widget zu implementieren, das dem Benutzer ermöglicht, einen Monat auszuwählen und vorwärts/rückwärts zu blättern, um ein Jahr auszuwählen. baue von Grund auf ohne Bibliotheken außer denen, die bereits in der Codebase verwendet werden."
Beschreiben Sie das Symptom. Geben Sie das Symptom, den wahrscheinlichen Ort und an, wie „behoben" aussieht. „behebe den Login-Bug" „Benutzer berichten, dass Login nach Session-Timeout fehlschlägt. überprüfe den Auth-Flow in src/auth/, besonders Token-Refresh. schreibe einen fehlgeschlagenen Test, der das Problem reproduziert, dann behebe es"

Vage Prompts können nützlich sein, wenn Sie erkunden und Kurskorrektionen vornehmen können. Ein Prompt wie „was würdest du in dieser Datei verbessern?" kann Dinge an die Oberfläche bringen, an die Sie nicht gedacht hätten zu fragen.

Geben Sie umfangreiche Inhalte an

Sie können Claude auf mehrere Arten umfangreiche Daten bereitstellen:

  • 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

Ein paar Einrichtungsschritte machen Claude Code über alle Ihre Sessions hinweg erheblich effektiver. Einen vollständigen Überblick über Erweiterungsfunktionen und wann Sie jede verwenden sollten, finden Sie unter Extend Claude Code.

Schreiben Sie eine effektive CLAUDE.md

CLAUDE.md ist eine spezielle Datei, die Claude zu Beginn jeder Konversation liest. Fügen Sie Bash-Befehle, Code-Stil und Workflow-Regeln ein. Dies gibt Claude persistenten Kontext, den es nicht aus Code allein ableiten kann.

Der /init-Befehl analysiert Ihre Codebase, um Build-Systeme, Test-Frameworks und Code-Muster zu erkennen, und gibt Ihnen eine solide Grundlage zum Verfeinern.

Es gibt kein erforderliches Format für CLAUDE.md-Dateien, aber halten Sie es kurz und für Menschen lesbar. Zum Beispiel:

# 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

CLAUDE.md wird jede Session geladen, also fügen Sie nur Dinge ein, die weit verbreitet gelten. Für Domänenwissen oder Workflows, die nur manchmal relevant sind, verwenden Sie stattdessen skills. Claude lädt sie bei Bedarf, ohne jede Konversation zu überlasten.

Halten Sie es prägnant. Fragen Sie sich für jede Zeile: „Würde das Entfernen dieser Zeile dazu führen, dass Claude Fehler macht?" Wenn nicht, streichen Sie es. Überladene CLAUDE.md-Dateien führen dazu, dass Claude Ihre tatsächlichen Anweisungen ignoriert!

✅ Einschließen ❌ Ausschließen
Bash-Befehle, die Claude nicht erraten kann Alles, was Claude durch Lesen von Code herausfinden kann
Code-Stil-Regeln, die von Standardwerten abweichen Standard-Sprachkonventionen, die Claude bereits kennt
Test-Anweisungen und bevorzugte Test-Runner Detaillierte API-Dokumentation (verlinken Sie stattdessen auf Docs)
Repository-Etikette (Branch-Naming, PR-Konventionen) Informationen, die sich häufig ändern
Architektonische Entscheidungen, die für Ihr Projekt spezifisch sind Lange Erklärungen oder Tutorials
Entwicklungsumgebungs-Eigenheiten (erforderliche Umgebungsvariablen) Datei-für-Datei-Beschreibungen der Codebase
Häufige Fallstricke oder nicht offensichtliche Verhaltensweisen Selbstverständliche Praktiken wie „schreibe sauberen Code"

Wenn Claude etwas tut, das Sie nicht möchten, obwohl es eine Regel dagegen gibt, ist die Datei wahrscheinlich zu lang und die Regel geht verloren. Wenn Claude Fragen stellt, die in CLAUDE.md beantwortet werden, könnte die Formulierung mehrdeutig sein. Behandeln Sie CLAUDE.md wie Code: überprüfen Sie es, wenn etwas schiefgeht, bereinigen Sie es regelmäßig, und testen Sie Änderungen, indem Sie beobachten, ob sich Claudes Verhalten tatsächlich ändert.

Sie können Anweisungen durch Hinzufügen von Betonung (z. B. „WICHTIG" oder „DU MUSST") abstimmen, um die Einhaltung zu verbessern. Überprüfen Sie CLAUDE.md in Git, damit Ihr Team beitragen kann. Die Datei nimmt im Laufe der Zeit an Wert zu.

CLAUDE.md-Dateien können zusätzliche Dateien mit der @path/to/import-Syntax importieren:

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

Sie können CLAUDE.md-Dateien an mehreren Orten platzieren:

  • 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

Standardmäßig fordert Claude Code Berechtigung für Aktionen an, die Ihr System ändern könnten: Dateischreibvorgänge, Bash-Befehle, MCP-Tools usw. Dies ist sicher, aber mühsam. Nach der zehnten Genehmigung überprüfen Sie nicht wirklich mehr, Sie klicken einfach durch. Es gibt drei Möglichkeiten, diese Unterbrechungen zu reduzieren:

  • 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

Lesen Sie mehr über Berechtigungsmodi, Berechtigungsregeln und Sandboxing.

Verwenden Sie CLI-Tools

CLI-Tools sind die kontexteffizienteste Möglichkeit, mit externen Diensten zu interagieren. Wenn Sie GitHub verwenden, installieren Sie die gh-CLI. Claude weiß, wie man sie zum Erstellen von Issues, Öffnen von Pull Requests und Lesen von Kommentaren verwendet. Ohne gh kann Claude immer noch die GitHub-API verwenden, aber unauthentifizierte Anfragen treffen oft auf Rate Limits.

Claude ist auch effektiv beim Erlernen von CLI-Tools, die er nicht bereits kennt. Versuchen Sie Prompts wie Use 'foo-cli-tool --help' to learn about foo tool, then use it to solve A, B, C.

Verbinden Sie MCP-Server

Mit MCP-Servern können Sie Claude bitten, Funktionen von Issue-Trackern zu implementieren, Datenbanken abzufragen, Überwachungsdaten zu analysieren, Designs von Figma zu integrieren und Workflows zu automatisieren.

Richten Sie Hooks ein

Hooks führen Skripte automatisch an bestimmten Punkten in Claudes Workflow aus. Im Gegensatz zu CLAUDE.md-Anweisungen, die beratend sind, sind Hooks deterministisch und garantieren, dass die Aktion stattfindet.

Claude kann Hooks für Sie schreiben. Versuchen Sie Prompts wie „Schreibe einen Hook, der eslint nach jeder Dateibearbeitung ausführt" oder „Schreibe einen Hook, der Schreibvorgänge in den Migrations-Ordner blockiert." Bearbeiten Sie .claude/settings.json direkt, um Hooks von Hand zu konfigurieren, und führen Sie /hooks aus, um zu durchsuchen, was konfiguriert ist.

Erstellen Sie Skills

Skills erweitern Claudes Wissen mit Informationen, die für Ihr Projekt, Team oder Ihre Domäne spezifisch sind. Claude wendet sie automatisch an, wenn relevant, oder Sie können sie direkt mit /skill-name aufrufen.

Erstellen Sie einen Skill, indem Sie ein Verzeichnis mit einer SKILL.md zu .claude/skills/ hinzufügen:

---
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/)

Skills können auch wiederverwendbare Workflows definieren, die Sie direkt aufrufen:

---
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

Führen Sie /fix-issue 1234 aus, um es aufzurufen. Verwenden Sie disable-model-invocation: true für Workflows mit Nebenwirkungen, die Sie manuell auslösen möchten.

Erstellen Sie benutzerdefinierte Subagents

Subagents laufen in ihrem eigenen Kontext mit ihrem eigenen Satz erlaubter Tools. Sie sind nützlich für Aufgaben, die viele Dateien lesen oder spezialisierte Aufmerksamkeit benötigen, ohne Ihre Hauptkonversation zu überlasten.

---
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.

Sagen Sie Claude explizit, dass es Subagents verwenden soll: „Verwende einen Subagent, um diesen Code auf Sicherheitsprobleme zu überprüfen."

Installieren Sie Plugins

Plugins bündeln Skills, Hooks, Subagents und MCP-Server in eine einzelne installierbare Einheit aus der Community und von Anthropic. Wenn Sie mit einer typisierten Sprache arbeiten, installieren Sie ein Code-Intelligence-Plugin, um Claude präzise Symbol-Navigation und automatische Fehlererkennung nach Bearbeitungen zu geben.

Anleitungen zur Auswahl zwischen Skills, Subagents, Hooks und MCP finden Sie unter Extend Claude Code.

Kommunizieren Sie effektiv

Die Art und Weise, wie Sie mit Claude Code kommunizieren, hat einen großen Einfluss auf die Qualität der Ergebnisse.

Stellen Sie Codebase-Fragen

Wenn Sie sich in eine neue Codebase einarbeiten, verwenden Sie Claude Code zum Lernen und Erkunden. Sie können Claude die gleichen Fragen stellen, die Sie einem anderen Engineer stellen würden:

  • 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?

Die Verwendung von Claude Code auf diese Weise ist ein effektiver Onboarding-Workflow, der die Einarbeitungszeit verbessert und die Belastung anderer Engineers reduziert. Keine spezielle Prompt-Formulierung erforderlich: stellen Sie Fragen direkt.

Lassen Sie Claude Sie interviewen

Claude stellt Fragen zu Dingen, die Sie möglicherweise noch nicht berücksichtigt haben, einschließlich technischer Implementierung, UI/UX, Edge Cases und Tradeoffs.

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.

Sobald die Spezifikation fertig ist, starten Sie eine neue Session, um sie auszuführen. Die neue Session hat einen sauberen Kontext, der sich vollständig auf die Implementierung konzentriert, und Sie haben eine geschriebene Spezifikation zum Referenzieren.

Die nützlichsten Spezifikationen sind in sich geschlossen: Sie benennen die beteiligten Dateien und Schnittstellen, geben an, was außerhalb des Geltungsbereichs liegt, und enden mit einem End-to-End-Verifizierungsschritt, der beweist, dass die Funktion funktioniert. Die Zeit, die Sie für eine präzise Spezifikation aufwenden, zahlt sich mehr aus als die Zeit, die Sie damit verbringen, die Implementierung zu beobachten.

Verwalten Sie Ihre Session

Konversationen sind persistent und reversibel. Nutzen Sie dies zu Ihrem Vorteil!

Korrigieren Sie früh und oft

Die besten Ergebnisse kommen aus engen Feedback-Schleifen. Obwohl Claude gelegentlich Probleme beim ersten Versuch perfekt löst, führt eine schnelle Korrektur im Allgemeinen zu besseren Lösungen schneller.

  • 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.

Wenn Sie Claude mehr als zweimal bei demselben Problem in einer Session korrigiert haben, ist der Kontext mit fehlgeschlagenen Ansätzen überladen. Führen Sie /clear aus und beginnen Sie mit einem spezifischeren Prompt, der das Gelernte einbezieht. Eine saubere Session mit einem besseren Prompt übertrifft fast immer eine lange Session mit angesammelten Korrektionen.

Verwalten Sie den Kontext aggressiv

Claude Code komprimiert automatisch die Konversationshistorie, wenn Sie sich den Kontextlimits nähern, was wichtigen Code und Entscheidungen bewahrt und Platz freimacht.

Während langer Sessions kann sich Claudes Kontextfenster mit irrelevanten Konversationen, Dateiinhalten und Befehlen füllen. Dies kann die Leistung reduzieren und Claude manchmal ablenken.

  • 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

Da der Kontext Ihre grundlegende Einschränkung ist, sind Subagents eines der mächtigsten verfügbaren Tools. Wenn Claude eine Codebase erforscht, liest er viele Dateien, die alle Ihren Kontext verbrauchen. Subagents laufen in separaten Kontextfenstern und berichten Zusammenfassungen zurück:

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

Der Subagent erkundet die Codebase, liest relevante Dateien und berichtet Erkenntnisse zurück, alles ohne Ihre Hauptkonversation zu überlasten.

Sie können Subagents auch zur Überprüfung verwenden, nachdem Claude etwas implementiert hat:

use a subagent to review this code for edge cases

Rewind mit Checkpoints

Claude erstellt automatisch Snapshots von Dateien vor jeder Änderung, sodass ein Checkpoint diese wiederherstellen kann. Doppeltippen Sie auf Escape oder führen Sie /rewind aus, um das Rewind-Menü zu öffnen. Sie können nur Konversation wiederherstellen, nur Code wiederherstellen, beides wiederherstellen oder eine ausgewählte Nachricht zusammenfassen. Siehe Checkpointing für Details.

Anstatt jeden Schritt sorgfältig zu planen, können Sie Claude bitten, etwas Riskantes zu versuchen. Wenn es nicht funktioniert, rewind und versuchen Sie einen anderen Ansatz. Checkpoints bleiben über Sessions hinweg erhalten, sodass Sie Ihr Terminal schließen und später immer noch rewind können.

Setzen Sie Konversationen fort

Claude Code speichert Konversationen lokal, sodass Sie den Kontext nicht erneut erklären müssen, wenn sich eine Aufgabe über mehrere Sitzungen erstreckt. Führen Sie claude --continue aus, um die letzte Session fortzusetzen, oder claude --resume, um aus einer Liste auszuwählen. Geben Sie Sessions aussagekräftige Namen wie oauth-migration, damit Sie sie später finden können. Siehe Manage sessions für den vollständigen Satz von Resume-, Branch- und Benennungskontrollen.

Automatisieren und skalieren Sie

Sobald Sie mit einem Claude effektiv sind, multiplizieren Sie Ihre Ausgabe mit parallelen Sessions, nicht-interaktivem Modus und Fan-Out-Mustern.

Alles bisher geht von einem Menschen, einem Claude und einer Konversation aus. Aber Claude Code skaliert horizontal. Die Techniken in diesem Abschnitt zeigen, wie Sie mehr erreichen können.

Führen Sie nicht-interaktiven Modus aus

Mit claude -p "your prompt" können Sie Claude nicht-interaktiv ohne eine Session ausführen. Nicht-interaktiver Modus ist, wie Sie Claude in CI-Pipelines, Pre-Commit-Hooks oder jeden automatisierten Workflow integrieren. Die Ausgabeformate ermöglichen es Ihnen, Ergebnisse programmgesteuert zu analysieren: Klartext, JSON oder Streaming-JSON.

# 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

Wählen Sie den parallelen Ansatz, der zu dem Grad der Koordination passt, den Sie selbst durchführen möchten:

  • 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

Über die Parallelisierung von Arbeit hinaus ermöglichen mehrere Sessions qualitätsorientierte Workflows. Ein frischer Kontext verbessert die Code-Überprüfung, da Claude nicht durch Code, den es gerade geschrieben hat, voreingenommen ist.

Verwenden Sie beispielsweise ein Writer/Reviewer-Muster:

Session A (Writer) Session B (Reviewer)
Implement a rate limiter for our API endpoints
Review the rate limiter implementation in @src/middleware/rateLimiter.ts. Look for edge cases, race conditions, and consistency with our existing middleware patterns.
Here's the review feedback: [Session B output]. Address these issues.

Sie können etwas Ähnliches mit Tests tun: Lassen Sie einen Claude Tests schreiben, dann schreiben Sie einen anderen Code, um sie zu bestehen.

Fan Out über Dateien

Für große Migrationen oder Analysen können Sie Arbeit über viele parallele Claude-Aufrufe verteilen:

1

Generieren Sie eine Aufgabenliste

Lassen Sie Claude alle Dateien auflisten, die migriert werden müssen (z. B. list all 2,000 Python files that need migrating)

2

Schreiben Sie ein Skript, um die Liste zu durchlaufen

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
3

Testen Sie auf ein paar Dateien, dann führen Sie in großem Maßstab aus

Verfeinern Sie Ihren Prompt basierend auf dem, was bei den ersten 2-3 Dateien schiefgeht, dann führen Sie auf dem vollständigen Satz aus. Das --allowedTools-Flag beschränkt, was Claude tun kann, was wichtig ist, wenn Sie unbeaufsichtigt laufen.

Sie können Claude auch in vorhandene Daten-/Verarbeitungs-Pipelines integrieren:

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

Verwenden Sie --verbose zum Debuggen während der Entwicklung und schalten Sie es in der Produktion aus.

Führen Sie autonom mit Auto Mode aus

Für ununterbrochene Ausführung mit Hintergrund-Sicherheitsprüfungen verwenden Sie Auto Mode. Ein Klassifizierer-Modell überprüft Befehle vor ihrer Ausführung, blockiert Scope-Eskalation, unbekannte Infrastruktur und feindselige-Inhalts-getriebene Aktionen, während es Routinearbeit ohne Prompts durchlaufen lässt.

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

Für nicht-interaktive Läufe mit dem -p-Flag bricht Auto Mode ab, wenn der Klassifizierer Aktionen wiederholt blockiert, da es keinen Benutzer gibt, auf den man zurückfallen kann. Siehe wenn Auto Mode zurückfällt für Schwellenwerte.

Fügen Sie einen gegnerischen Überprüfungsschritt hinzu

Je länger Claude unbeaufsichtigt arbeitet, desto wichtiger wird eine unabhängige Überprüfung, bevor Sie die Arbeit als erledigt zählen. Ein Reviewer, der in einem frischen Subagenten-Kontext läuft, sieht nur den Diff und die Kriterien, die Sie ihm geben, nicht die Begründung, die die Änderung hervorgebracht hat, daher bewertet er das Ergebnis nach seinen eigenen Maßstäben.

Für eine Korrektheitsprüfung führen Sie die gebündelte /code-review Skill aus, die den aktuellen Diff auf Fehler in einem frischen Subagenten überprüft und Ergebnisse an die Session zurückgibt. Um den Diff stattdessen gegen Ihren Plan zu überprüfen, schreiben Sie den Überprüfungs-Prompt selbst. Nennen Sie die zu überprüfende Arbeit, den Plan, gegen den überprüft werden soll, und was als Ergebnis zählt:

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.

Da der Reviewer als Subagent läuft, erhält die implementierende Session die Lücken direkt und kann sie beheben und erneut überprüfen, ohne dass Sie Ergebnisse zwischen Fenstern kopieren müssen. Für längere autonome Läufe kann ein Agent Team diese Schleife über viele Aufgaben hinweg am Laufen halten, während Sie die aufgezeichneten Ergebnisse stichprobenartig überprüfen.

Vermeiden Sie häufige Fehlermuster

Dies sind häufige Fehler. Sie früh zu erkennen spart Zeit:

  • 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

Die Muster in diesem Leitfaden sind nicht in Stein gemeißelt. Sie sind Ausgangspunkte, die im Allgemeinen gut funktionieren, aber möglicherweise nicht optimal für jede Situation sind.

Manchmal sollten Sie den Kontext ansammeln lassen, weil Sie tief in einem komplexen Problem stecken und die Geschichte wertvoll ist. Manchmal sollten Sie die Planung überspringen und Claude es herausfinden lassen, weil die Aufgabe explorativ ist. Manchmal ist ein vager Prompt genau richtig, weil Sie sehen möchten, wie Claude das Problem interpretiert, bevor Sie es einschränken.

Achten Sie auf das, was funktioniert. Wenn Claude großartige Ausgabe produziert, bemerken Sie, was Sie getan haben: die Prompt-Struktur, den Kontext, den Sie bereitgestellt haben, den Modus, in dem Sie waren. Wenn Claude kämpft, fragen Sie warum. War der Kontext zu laut? Der Prompt zu vage? Die Aufgabe zu groß für einen Pass?

Im Laufe der Zeit werden Sie Intuition entwickeln, die kein Leitfaden erfassen kann. Sie werden wissen, wann Sie spezifisch und wann offen sein sollten, wann Sie planen und wann Sie erkunden sollten, wann Sie den Kontext löschen und wann Sie ihn ansammeln lassen sollten.