SpyBara
Go Premium

common-workflows.md 2026-05-02 18:14 UTC to 2026-05-04 22:58 UTC

1030 added, 0 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

Häufige Workflows

Schritt-für-Schritt-Anleitungen zum Erkunden von Codebases, Beheben von Fehlern, Refaktorierung, Testen und anderen alltäglichen Aufgaben mit Claude Code.

Diese Seite behandelt praktische Workflows für die alltägliche Entwicklung: Erkunden unbekannter Code, Debugging, Refaktorierung, Schreiben von Tests, Erstellen von PRs und Verwalten von Sitzungen. Jeder Abschnitt enthält Beispiel-Prompts, die Sie an Ihre eigenen Projekte anpassen können. Für übergeordnete Muster und Tipps siehe Best Practices.

Neue Codebases verstehen

Schnelle Codebase-Übersicht erhalten

Angenommen, Sie sind gerade einem neuen Projekt beigetreten und müssen dessen Struktur schnell verstehen.

1

Navigieren Sie zum Projektroot-Verzeichnis

cd /path/to/project 
2

Starten Sie Claude Code

claude 
3

Fragen Sie nach einer Übersicht auf hoher Ebene

give me an overview of this codebase
4

Tauchen Sie tiefer in spezifische Komponenten ein

explain the main architecture patterns used here
what are the key data models?
how is authentication handled?

Relevanten Code finden

Angenommen, Sie müssen Code finden, der sich auf eine bestimmte Funktion oder Funktionalität bezieht.

1

Bitten Sie Claude, relevante Dateien zu finden

find the files that handle user authentication
2

Erhalten Sie Kontext darüber, wie Komponenten zusammenwirken

how do these authentication files work together?
3

Verstehen Sie den Ausführungsfluss

trace the login process from front-end to database

Fehler effizient beheben

Angenommen, Sie sind auf eine Fehlermeldung gestoßen und müssen deren Quelle finden und beheben.

1

Teilen Sie den Fehler mit Claude

I'm seeing an error when I run npm test
2

Fragen Sie nach Behebungsempfehlungen

suggest a few ways to fix the @ts-ignore in user.ts
3

Wenden Sie die Behebung an

update user.ts to add the null check you suggested

Code refaktorieren

Angenommen, Sie müssen alten Code aktualisieren, um moderne Muster und Praktiken zu verwenden.

1

Identifizieren Sie Legacy-Code zur Refaktorierung

find deprecated API usage in our codebase
2

Erhalten Sie Refaktorierungsempfehlungen

suggest how to refactor utils.js to use modern JavaScript features
3

Wenden Sie die Änderungen sicher an

refactor utils.js to use ES2024 features while maintaining the same behavior
4

Überprüfen Sie die Refaktorierung

run tests for the refactored code

Spezialisierte Subagents verwenden

Angenommen, Sie möchten spezialisierte KI-Subagents verwenden, um bestimmte Aufgaben effektiver zu bewältigen.

1

Verfügbare Subagents anzeigen

/agents

Dies zeigt alle verfügbaren Subagents und ermöglicht es Ihnen, neue zu erstellen.

2

Subagents automatisch verwenden

Claude Code delegiert automatisch geeignete Aufgaben an spezialisierte Subagents:

review my recent code changes for security issues
run all tests and fix any failures
3

Fordern Sie explizit spezifische Subagents an

use the code-reviewer subagent to check the auth module
have the debugger subagent investigate why users can't log in
4

Erstellen Sie benutzerdefinierte Subagents für Ihren Workflow

/agents

Wählen Sie dann 'Create New subagent" und folgen Sie den Aufforderungen, um Folgendes zu definieren:

  • Eine eindeutige Kennung, die den Zweck des Subagent beschreibt (z. B. code-reviewer, api-designer).
  • Wann Claude diesen Agent verwenden sollte
  • Welche Tools er verwenden kann
  • Ein System-Prompt, der die Rolle und das Verhalten des Agents beschreibt

Plan Mode für sichere Code-Analyse verwenden

Plan Mode weist Claude an, einen Plan zu erstellen, indem die Codebase mit schreibgeschützten Operationen analysiert wird. Dies ist perfekt zum Erkunden von Codebases, Planen komplexer Änderungen oder sicheren Überprüfen von Code. Im Plan Mode verwendet Claude AskUserQuestion, um Anforderungen zu sammeln und Ihre Ziele zu klären, bevor ein Plan vorgeschlagen wird.

Wann Plan Mode verwendet werden sollte

  • Multi-Schritt-Implementierung: Wenn Ihre Funktion Änderungen an vielen Dateien erfordert
  • Code-Exploration: Wenn Sie die Codebase gründlich erforschen möchten, bevor Sie etwas ändern
  • Interaktive Entwicklung: Wenn Sie die Richtung mit Claude iterieren möchten

Wie Plan Mode verwendet wird

Aktivieren Sie Plan Mode während einer Sitzung

Sie können während einer Sitzung mit Shift+Tab in Plan Mode wechseln, um durch Berechtigungsmodi zu zyklisieren.

Wenn Sie sich im Normal Mode befinden, wechselt Shift+Tab zunächst in Auto-Accept Mode, angezeigt durch ⏵⏵ accept edits on am unteren Rand des Terminals. Ein nachfolgendes Shift+Tab wechselt in Plan Mode, angezeigt durch ⏸ plan mode on.

Starten Sie eine neue Sitzung im Plan Mode

Um eine neue Sitzung im Plan Mode zu starten, verwenden Sie das Flag --permission-mode plan:

claude --permission-mode plan

Führen Sie „Headless"-Abfragen im Plan Mode aus

Sie können auch eine Abfrage im Plan Mode direkt mit -p ausführen (d. h. im "Headless-Modus"):

claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"

Beispiel: Planen einer komplexen Refaktorierung

claude --permission-mode plan
I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.

Claude analysiert die aktuelle Implementierung und erstellt einen umfassenden Plan. Verfeinern Sie mit Folgefragen:

What about backward compatibility?
How should we handle database migration?

Wenn Sie einen Plan akzeptieren, benennt Claude die Sitzung automatisch basierend auf dem Plan-Inhalt. Der Name wird in der Prompt-Leiste und in der Sitzungsauswahl angezeigt. Wenn Sie bereits einen Namen mit --name oder /rename festgelegt haben, wird das Akzeptieren eines Plans diesen nicht überschreiben.

Konfigurieren Sie Plan Mode als Standard

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}

Weitere Konfigurationsoptionen finden Sie in der Einstellungsdokumentation.


Mit Tests arbeiten

Angenommen, Sie müssen Tests für nicht abgedeckten Code hinzufügen.

1

Identifizieren Sie nicht getesteten Code

find functions in NotificationsService.swift that are not covered by tests
2

Generieren Sie Test-Gerüste

add tests for the notification service
3

Fügen Sie aussagekräftige Testfälle hinzu

add test cases for edge conditions in the notification service
4

Führen Sie Tests aus und überprüfen Sie sie

run the new tests and fix any failures

Claude kann Tests generieren, die den vorhandenen Mustern und Konventionen Ihres Projekts entsprechen. Seien Sie beim Anfordern von Tests spezifisch darüber, welches Verhalten Sie überprüfen möchten. Claude untersucht Ihre vorhandenen Testdateien, um den Stil, die Frameworks und die Assertion-Muster zu entsprechen, die bereits verwendet werden.

Für umfassende Abdeckung bitten Sie Claude, Grenzfälle zu identifizieren, die Sie möglicherweise übersehen haben. Claude kann Ihre Code-Pfade analysieren und Tests für Fehlerbedingungen, Grenzwerte und unerwartete Eingaben vorschlagen, die leicht zu übersehen sind.


Pull Requests erstellen

Sie können Pull Requests erstellen, indem Sie Claude direkt fragen („create a pr for my changes"), oder Claude Schritt für Schritt führen:

1

Fassen Sie Ihre Änderungen zusammen

summarize the changes I've made to the authentication module
2

Generieren Sie einen Pull Request

create a pr
3

Überprüfen und verfeinern Sie

enhance the PR description with more context about the security improvements

Wenn Sie einen PR mit gh pr create erstellen, wird die Sitzung automatisch mit diesem PR verknüpft. Sie können sie später mit claude --from-pr <number> fortsetzen.

Dokumentation verwalten

Angenommen, Sie müssen Dokumentation für Ihren Code hinzufügen oder aktualisieren.

1

Identifizieren Sie nicht dokumentierten Code

find functions without proper JSDoc comments in the auth module
2

Generieren Sie Dokumentation

add JSDoc comments to the undocumented functions in auth.js
3

Überprüfen und verbessern Sie

improve the generated documentation with more context and examples
4

Überprüfen Sie die Dokumentation

check if the documentation follows our project standards

Mit Notizen und Nicht-Code-Ordnern arbeiten

Claude Code funktioniert in jedem Verzeichnis. Führen Sie es in einem Notiz-Vault, einem Dokumentationsordner oder einer beliebigen Sammlung von Markdown-Dateien aus, um Inhalte auf die gleiche Weise zu suchen, zu bearbeiten und zu reorganisieren wie Code.

Das Verzeichnis .claude/ und CLAUDE.md befinden sich neben den Konfigurationsverzeichnissen anderer Tools ohne Konflikte. Claude liest Dateien bei jedem Tool-Aufruf neu, daher sieht es Änderungen, die Sie in einer anderen Anwendung vornehmen, beim nächsten Lesen dieser Datei.


Mit Bildern arbeiten

Angenommen, Sie müssen mit Bildern in Ihrer Codebase arbeiten und möchten Claudes Hilfe bei der Analyse von Bildinhalten.

1

Fügen Sie ein Bild zum Gespräch hinzu

Sie können eine dieser Methoden verwenden:

  1. Ziehen Sie ein Bild per Drag & Drop in das Claude Code-Fenster
  2. Kopieren Sie ein Bild und fügen Sie es in die CLI mit Strg+V ein (verwenden Sie nicht Cmd+V)
  3. Geben Sie Claude einen Bildpfad an. Z. B. „Analyze this image: /path/to/your/image.png"
2

Bitten Sie Claude, das Bild zu analysieren

What does this image show?
Describe the UI elements in this screenshot
Are there any problematic elements in this diagram?
3

Verwenden Sie Bilder für Kontext

Here's a screenshot of the error. What's causing it?
This is our current database schema. How should we modify it for the new feature?
4

Erhalten Sie Code-Vorschläge aus visuellem Inhalt

Generate CSS to match this design mockup
What HTML structure would recreate this component?

Dateien und Verzeichnisse referenzieren

Verwenden Sie @, um schnell Dateien oder Verzeichnisse einzubeziehen, ohne auf Claude zu warten, um sie zu lesen.

1

Referenzieren Sie eine einzelne Datei

Explain the logic in @src/utils/auth.js

Dies fügt den vollständigen Inhalt der Datei in das Gespräch ein.

2

Referenzieren Sie ein Verzeichnis

What's the structure of @src/components?

Dies bietet eine Verzeichnisauflistung mit Dateiinformationen.

3

Referenzieren Sie MCP-Ressourcen

Show me the data from @github:repos/owner/repo/issues

Dies ruft Daten von verbundenen MCP-Servern im Format @server:resource ab. Weitere Details finden Sie unter MCP-Ressourcen.


Verwenden Sie erweitertes Denken (Thinking Mode)

Erweitertes Denken ist standardmäßig aktiviert und gibt Claude Platz, um komplexe Probleme Schritt für Schritt zu durchdenken, bevor er antwortet. Dieses Denken ist im ausführlichen Modus sichtbar, den Sie mit Ctrl+O umschalten können. Während des erweiterten Denkens zeigt der Spinner Inline-Fortschrittshinweise wie „still thinking" und „almost done thinking" an, um zu zeigen, dass Claude aktiv arbeitet.

Darüber hinaus verwenden Modelle, die Effort unterstützen, adaptives Denken: Anstelle eines festen Thinking-Token-Budgets entscheidet das Modell dynamisch, ob und wie viel es denken soll, basierend auf Ihrer Effort-Level-Einstellung und der anstehenden Aufgabe. Adaptives Denken ermöglicht es Claude, schneller auf Routine-Prompts zu reagieren und tieferes Denken für Schritte zu reservieren, die davon profitieren.

Erweitertes Denken ist besonders wertvoll für komplexe architektonische Entscheidungen, schwierige Fehler, mehrstufige Implementierungsplanung und Bewertung von Kompromissen zwischen verschiedenen Ansätzen.

Konfigurieren Sie Thinking Mode

Thinking ist standardmäßig aktiviert, aber Sie können es anpassen oder deaktivieren.

Bereich Wie man konfiguriert Details
Effort Level Führen Sie /effort aus, passen Sie in /model an, oder setzen Sie CLAUDE_CODE_EFFORT_LEVEL Steuern Sie die Thinking-Tiefe auf unterstützten Modellen
ultrathink Schlüsselwort Fügen Sie „ultrathink" irgendwo in Ihrem Prompt ein Fügt eine In-Context-Anweisung hinzu, die das Modell anweist, mehr auf diesem Turn zu denken. Ändert nicht die Effort-Ebene selbst; siehe Effort Level anpassen dafür
Toggle-Verknüpfung Drücken Sie Option+T (macOS) oder Alt+T (Windows/Linux) Schalten Sie Thinking für die aktuelle Sitzung ein/aus (alle Modelle). Kann Terminal-Konfiguration erfordern, um Option-Tasten-Verknüpfungen zu aktivieren
Globaler Standard Verwenden Sie /config, um Thinking Mode umzuschalten Setzt Ihren Standard über alle Projekte (alle Modelle).
Gespeichert als alwaysThinkingEnabled in ~/.claude/settings.json
Token-Budget begrenzen Setzen Sie die Umgebungsvariable MAX_THINKING_TOKENS Begrenzen Sie das Thinking-Budget auf eine bestimmte Anzahl von Tokens. Auf Modellen mit adaptivem Denken gilt nur 0, es sei denn, adaptives Denken ist deaktiviert. Beispiel: export MAX_THINKING_TOKENS=10000

Um Claudes Thinking-Prozess anzuzeigen, drücken Sie Ctrl+O, um den ausführlichen Modus umzuschalten und das interne Denken als grauer kursiver Text angezeigt zu sehen.

Wie erweitertes Denken funktioniert

Erweitertes Denken steuert, wie viel internes Denken Claude vor der Antwort durchführt. Mehr Denken bietet mehr Platz, um Lösungen zu erkunden, Grenzfälle zu analysieren und Fehler selbst zu korrigieren.

Auf Modellen, die Effort unterstützen, verwendet Thinking adaptives Denken: Das Modell weist Thinking-Tokens dynamisch basierend auf dem Effort Level zu, den Sie auswählen. Dies ist die empfohlene Methode, um den Kompromiss zwischen Geschwindigkeit und Reasoning-Tiefe zu optimieren. Wenn Sie möchten, dass Claude mehr oder weniger denkt, als Ihr Effort Level sonst erzeugen würde, können Sie dies auch direkt in Ihrem Prompt oder in CLAUDE.md sagen.

Bei älteren Modellen verwendet Thinking ein festes Token-Budget, das aus Ihrer Output-Zuteilung gezogen wird. Das Budget variiert je nach Modell; siehe MAX_THINKING_TOKENS für Obergrenzen pro Modell. Sie können das Budget mit dieser Umgebungsvariable begrenzen oder Thinking vollständig über /config oder den Option+T/Alt+T-Toggle deaktivieren.

Auf Modellen mit adaptivem Denken gilt MAX_THINKING_TOKENS nur, wenn es auf 0 gesetzt ist, um Thinking zu deaktivieren, oder wenn CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 das Modell auf das feste Budget zurückversetzt. CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING gilt nur für Opus 4.6 und Sonnet 4.6. Opus 4.7 verwendet immer adaptives Denken und unterstützt kein festes Thinking-Budget. Siehe Umgebungsvariablen.


Vorherige Gespräche fortsetzen

Wenn Sie Claude Code starten, können Sie eine vorherige Sitzung fortsetzen:

  • claude --continue setzt das neueste Gespräch im aktuellen Verzeichnis fort
  • claude --resume öffnet eine Gesprächsauswahl oder setzt nach Name fort
  • claude --from-pr 123 setzt Sitzungen fort, die mit einem bestimmten Pull Request verknüpft sind

Verwenden Sie innerhalb einer aktiven Sitzung /resume, um zu einem anderen Gespräch zu wechseln.

Wenn die ausgewählte Sitzung alt und groß genug ist, dass das erneute Lesen einen wesentlichen Teil Ihrer Nutzungslimits verbrauchen würde, bieten --resume, --continue und /resume an, statt des vollständigen Transkripts von einer Zusammenfassung aus fortzufahren. Diese Eingabeaufforderung ist nicht auf Amazon Bedrock, Google Cloud Vertex AI oder Microsoft Foundry verfügbar.

Sitzungen werden pro Projektverzeichnis gespeichert. Standardmäßig zeigt die /resume-Auswahl interaktive Sitzungen aus dem aktuellen Worktree mit Tastaturkürzeln, um die Liste auf andere Worktrees oder Projekte zu erweitern, zu suchen, in der Vorschau anzuzeigen und umzubenennen. Siehe Verwenden Sie die Sitzungsauswahl unten für die vollständige Tastaturkürzel-Referenz.

Wenn Sie eine Sitzung aus einem anderen Worktree desselben Repositorys auswählen, setzt Claude Code sie direkt fort, ohne dass Sie zuerst das Verzeichnis wechseln müssen. Wenn Sie eine Sitzung aus einem nicht verwandten Projekt auswählen, wird ein cd- und Resume-Befehl stattdessen in Ihre Zwischenablage kopiert.

Das Fortsetzen nach Name wird über das aktuelle Repository und seine Worktrees aufgelöst. Sowohl claude --resume <name> als auch /resume <name> suchen nach einer genauen Übereinstimmung und setzen sie direkt fort, auch wenn die Sitzung in einem anderen Worktree lebt.

Wenn der Name mehrdeutig ist, öffnet claude --resume <name> die Auswahl mit dem Namen als vorgefülltem Suchbegriff. /resume <name> aus einer aktiven Sitzung meldet stattdessen einen Fehler, also führen Sie /resume ohne Argument aus, um die Auswahl zu öffnen und auszuwählen.

Sitzungen, die von claude -p oder SDK-Aufrufen erstellt wurden, werden nicht in der Auswahl angezeigt, aber Sie können eine trotzdem fortsetzen, indem Sie ihre Sitzungs-ID direkt an claude --resume <session-id> übergeben.

Benennen Sie Ihre Sitzungen

Geben Sie Sitzungen beschreibende Namen, um sie später zu finden. Dies ist eine Best Practice, wenn Sie an mehreren Aufgaben oder Funktionen arbeiten.

1

Benennen Sie die Sitzung

Benennen Sie eine Sitzung beim Start mit -n:

claude -n auth-refactor

Oder verwenden Sie /rename während einer Sitzung, was auch den Namen in der Prompt-Leiste anzeigt:

/rename auth-refactor

Sie können jede Sitzung auch aus der Auswahl umbenennen: Führen Sie /resume aus, navigieren Sie zu einer Sitzung, und drücken Sie Ctrl+R.

2

Später nach Name fortsetzen

Aus der Befehlszeile:

claude --resume auth-refactor

Oder innerhalb einer aktiven Sitzung:

/resume auth-refactor

Verwenden Sie die Sitzungsauswahl

Der Befehl /resume (oder claude --resume ohne Argumente) öffnet eine interaktive Sitzungsauswahl mit diesen Funktionen:

Tastaturkürzel in der Auswahl:

Verknüpfung Aktion
/ Navigieren Sie zwischen Sitzungen
/ Erweitern oder reduzieren Sie gruppierte Sitzungen
Enter Wählen Sie die hervorgehobene Sitzung aus und setzen Sie sie fort
Space Zeigen Sie eine Vorschau des Sitzungsinhalts an. Ctrl+V funktioniert auch auf Terminals, die es nicht als Einfügen erfassen
Ctrl+R Benennen Sie die hervorgehobene Sitzung um
/ oder ein beliebiges druckbares Zeichen außer Space Geben Sie den Suchmodus ein und filtern Sie Sitzungen
Ctrl+A Zeigen Sie Sitzungen aus allen Projekten auf diesem Computer an. Drücken Sie erneut, um zum aktuellen Repository zurückzukehren
Ctrl+W Zeigen Sie Sitzungen aus allen Worktrees des aktuellen Repositorys an. Drücken Sie erneut, um zum aktuellen Worktree zurückzukehren. Wird nur in Multi-Worktree-Repositorys angezeigt
Ctrl+B Filtern Sie zu Sitzungen aus Ihrem aktuellen Git-Branch. Drücken Sie erneut, um Sitzungen aus allen Branches anzuzeigen
Esc Beenden Sie die Auswahl oder den Suchmodus

Sitzungsorganisation:

Die Auswahl zeigt Sitzungen mit hilfreichen Metadaten an:

  • Sitzungsname, falls festgelegt, ansonsten die Gesprächszusammenfassung oder der erste Benutzer-Prompt
  • Verstrichene Zeit seit letzter Aktivität
  • Nachrichtenanzahl
  • Git-Branch (falls zutreffend)
  • Projektpfad, angezeigt nach Erweiterung auf alle Projekte mit Ctrl+A

Verzweigte Sitzungen (erstellt mit /branch, /rewind oder --fork-session) werden unter ihrer Root-Sitzung gruppiert, was es einfacher macht, verwandte Gespräche zu finden.


Führen Sie parallele Claude Code-Sitzungen mit Git Worktrees aus

Wenn Sie an mehreren Aufgaben gleichzeitig arbeiten, benötigt jede Claude-Sitzung ihre eigene Kopie der Codebase, damit Änderungen nicht kollidieren. Git Worktrees lösen dies, indem sie separate Arbeitsverzeichnisse erstellen, die jeweils ihre eigenen Dateien und Branches haben, während sie die gleiche Repository-Historie und Remote-Verbindungen teilen. Dies bedeutet, dass Sie Claude an einer Funktion in einem Worktree arbeiten lassen können, während Sie einen Fehler in einem anderen beheben, ohne dass eine Sitzung die andere beeinträchtigt.

Verwenden Sie das Flag --worktree (-w), um einen isolierten Worktree zu erstellen und Claude darin zu starten. Der Wert, den Sie übergeben, wird zum Worktree-Verzeichnisnamen und Branch-Namen:

# Starten Sie Claude in einem Worktree namens „feature-auth"
# Erstellt .claude/worktrees/feature-auth/ mit einem neuen Branch
claude --worktree feature-auth

# Starten Sie eine weitere Sitzung in einem separaten Worktree
claude --worktree bugfix-123

Wenn Sie den Namen weglassen, generiert Claude automatisch einen zufälligen:

# Generiert automatisch einen Namen wie „bright-running-fox"
claude --worktree

Worktrees werden unter <repo>/.claude/worktrees/<name> erstellt und verzweigen sich vom Standard-Remote-Branch, auf den origin/HEAD zeigt. Der Worktree-Branch wird worktree-<name> genannt.

Der Basis-Branch ist nicht über ein Claude Code-Flag oder eine Einstellung konfigurierbar. origin/HEAD ist eine Referenz, die in Ihrem lokalen .git-Verzeichnis gespeichert ist und die Git einmal beim Klonen gesetzt hat. Wenn sich der Standard-Branch des Repositorys später auf GitHub oder GitLab ändert, zeigt Ihre lokale origin/HEAD weiterhin auf den alten, und Worktrees verzweigen sich von dort. Um Ihre lokale Referenz mit dem, was der Remote derzeit als Standard betrachtet, neu zu synchronisieren:

git remote set-head origin -a

Dies ist ein Standard-Git-Befehl, der nur Ihr lokales .git-Verzeichnis aktualisiert. Nichts auf dem Remote-Server ändert sich. Wenn Sie möchten, dass Worktrees sich von einem bestimmten Branch aus verzweigen, anstatt vom Standard des Remote, setzen Sie ihn explizit mit git remote set-head origin your-branch-name.

Für vollständige Kontrolle über die Erstellung von Worktrees, einschließlich der Auswahl einer anderen Basis pro Aufruf, konfigurieren Sie einen WorktreeCreate Hook. Der Hook ersetzt Claudes Standard-git worktree-Logik vollständig, sodass Sie von jedem Ref abrufen und verzweigen können, den Sie benötigen.

Sie können auch Claude während einer Sitzung bitten, „in einem Worktree zu arbeiten" oder „einen Worktree zu starten", und er erstellt automatisch einen.

Subagent Worktrees

Subagents können auch Worktree-Isolation verwenden, um parallel ohne Konflikte zu arbeiten. Bitten Sie Claude, „Worktrees für Ihre Agents zu verwenden" oder konfigurieren Sie es in einem benutzerdefinierten Subagent, indem Sie isolation: worktree zum Frontmatter des Agents hinzufügen. Jeder Subagent erhält seinen eigenen Worktree, der automatisch bereinigt wird, wenn der Subagent ohne Änderungen beendet wird.

Worktree-Bereinigung

Wenn Sie eine Worktree-Sitzung beenden, handhabt Claude die Bereinigung basierend darauf, ob Sie Änderungen vorgenommen haben:

  • Keine Änderungen: Der Worktree und sein Branch werden automatisch entfernt
  • Änderungen oder Commits vorhanden: Claude fragt Sie, ob Sie den Worktree behalten oder entfernen möchten. Das Behalten bewahrt das Verzeichnis und den Branch, damit Sie später zurückkehren können. Das Entfernen löscht das Worktree-Verzeichnis und seinen Branch und verwirft alle nicht committeten Änderungen und Commits

Subagent-Worktrees, die durch einen Absturz oder einen unterbrochenen parallelen Lauf verwaist sind, werden beim Start automatisch entfernt, sobald sie älter als Ihre cleanupPeriodDays-Einstellung sind, vorausgesetzt, sie haben keine nicht committeten Änderungen, keine nicht verfolgten Dateien und keine nicht gepushten Commits. Worktrees, die Sie mit --worktree erstellen, werden durch diese Bereinigung nie entfernt.

Um Worktrees außerhalb einer Claude-Sitzung zu bereinigen, verwenden Sie manuelle Worktree-Verwaltung.

Kopieren Sie gitignorierte Dateien zu Worktrees

Git Worktrees sind frische Checkouts, daher enthalten sie keine nicht verfolgten Dateien wie .env oder .env.local aus Ihrem Haupt-Repository. Um diese Dateien automatisch zu kopieren, wenn Claude einen Worktree erstellt, fügen Sie eine .worktreeinclude-Datei zu Ihrem Projektroot hinzu.

Die Datei verwendet .gitignore-Syntax, um aufzulisten, welche Dateien kopiert werden sollen. Nur Dateien, die einem Muster entsprechen und auch gitignoriert sind, werden kopiert, daher werden verfolgte Dateien niemals dupliziert.

.env
.env.local
config/secrets.json

Dies gilt für Worktrees, die mit --worktree, Subagent-Worktrees und parallele Sitzungen in der Desktop-App erstellt werden.

Verwalten Sie Worktrees manuell

Für mehr Kontrolle über den Worktree-Speicherort und die Branch-Konfiguration erstellen Sie Worktrees direkt mit Git. Dies ist nützlich, wenn Sie einen bestimmten vorhandenen Branch auschecken oder den Worktree außerhalb des Repositorys platzieren müssen.

# Erstellen Sie einen Worktree mit einem neuen Branch
git worktree add ../project-feature-a -b feature-a

# Erstellen Sie einen Worktree mit einem vorhandenen Branch
git worktree add ../project-bugfix bugfix-123

# Starten Sie Claude im Worktree
cd ../project-feature-a && claude

# Bereinigen Sie, wenn Sie fertig sind
git worktree list
git worktree remove ../project-feature-a

Weitere Informationen finden Sie in der offiziellen Git Worktree-Dokumentation.

Nicht-Git-Versionskontrolle

Worktree-Isolation funktioniert standardmäßig mit Git. Für andere Versionskontrollsysteme wie SVN, Perforce oder Mercurial konfigurieren Sie WorktreeCreate und WorktreeRemove Hooks, um benutzerdefinierte Worktree-Erstellungs- und Bereinigungslogik bereitzustellen. Wenn konfiguriert, ersetzen diese Hooks das Standard-Git-Verhalten, wenn Sie --worktree verwenden, daher wird .worktreeinclude nicht verarbeitet. Kopieren Sie alle lokalen Konfigurationsdateien stattdessen in Ihrem Hook-Skript.

Für automatisierte Koordination paralleler Sitzungen mit gemeinsamen Aufgaben und Messaging siehe Agent Teams.


Erhalten Sie Benachrichtigungen, wenn Claude Ihre Aufmerksamkeit benötigt

Wenn Sie eine lange laufende Aufgabe starten und zu einem anderen Fenster wechseln, können Sie Desktop-Benachrichtigungen einrichten, damit Sie wissen, wenn Claude fertig ist oder Ihre Eingabe benötigt. Dies verwendet das Notification Hook-Ereignis, das immer dann ausgelöst wird, wenn Claude auf Berechtigung wartet, untätig ist und bereit für einen neuen Prompt ist, oder die Authentifizierung abgeschlossen ist.

1

Fügen Sie den Hook zu Ihren Einstellungen hinzu

Öffnen Sie ~/.claude/settings.json und fügen Sie einen Notification Hook hinzu, der den nativen Benachrichtigungsbefehl Ihrer Plattform aufruft:

{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
}
]
}
]
}
}

Wenn Ihre Einstellungsdatei bereits einen hooks-Schlüssel hat, führen Sie den Notification-Eintrag darin zusammen, anstatt ihn zu überschreiben. Sie können Claude auch bitten, den Hook für Sie zu schreiben, indem Sie beschreiben, was Sie in der CLI möchten.

2

Grenzen Sie den Matcher optional ein

Standardmäßig wird der Hook bei allen Benachrichtigungstypen ausgelöst. Um nur für bestimmte Ereignisse ausgelöst zu werden, setzen Sie das Feld matcher auf einen dieser Werte:

Matcher Wird ausgelöst, wenn
permission_prompt Claude benötigt Ihre Genehmigung für eine Tool-Nutzung
idle_prompt Claude ist fertig und wartet auf Ihren nächsten Prompt
auth_success Die Authentifizierung ist abgeschlossen
elicitation_dialog Ein MCP-Server öffnet ein Elicitierungsformular
elicitation_complete Ein MCP-Elicitierungsformular wird eingereicht oder verworfen
elicitation_response Eine MCP-Elicitierungsantwort wird an den Server zurückgesendet
3

Überprüfen Sie den Hook

Geben Sie /hooks ein und wählen Sie Notification aus, um zu bestätigen, dass der Hook angezeigt wird. Wenn Sie ihn auswählen, wird der Befehl angezeigt, der ausgeführt wird. Um ihn end-to-end zu testen, bitten Sie Claude, einen Befehl auszuführen, der Berechtigung erfordert, und wechseln Sie weg vom Terminal, oder bitten Sie Claude, direkt eine Benachrichtigung auszulösen.

Für das vollständige Ereignisschema und die Benachrichtigungstypen siehe die Benachrichtigungsreferenz.


Verwenden Sie Claude als Unix-ähnliches Dienstprogramm

Fügen Sie Claude zu Ihrem Überprüfungsprozess hinzu

Angenommen, Sie möchten Claude Code als Linter oder Code-Reviewer verwenden.

Fügen Sie Claude zu Ihrem Build-Skript hinzu:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

Pipe in, Pipe out

Angenommen, Sie möchten Daten in Claude pipen und Daten in einem strukturierten Format zurückbekommen.

Pipen Sie Daten durch Claude:

cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

Steuern Sie das Ausgabeformat

Angenommen, Sie benötigen Claudes Ausgabe in einem bestimmten Format, besonders wenn Sie Claude Code in Skripte oder andere Tools integrieren.

1

Verwenden Sie Textformat (Standard)

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt

Dies gibt nur Claudes einfache Textantwort aus (Standardverhalten).

2

Verwenden Sie JSON-Format

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json

Dies gibt ein JSON-Array von Nachrichten mit Metadaten einschließlich Kosten und Dauer aus.

3

Verwenden Sie Streaming-JSON-Format

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json

Dies gibt eine Reihe von JSON-Objekten in Echtzeit aus, während Claude die Anfrage verarbeitet. Jede Nachricht ist ein gültiges JSON-Objekt, aber die gesamte Ausgabe ist kein gültiges JSON, wenn es verkettet wird.


Führen Sie Claude nach einem Zeitplan aus

Angenommen, Sie möchten Claude automatisch eine Aufgabe auf wiederkehrender Basis ausführen, z. B. offene PRs jeden Morgen überprüfen, Abhängigkeiten wöchentlich prüfen oder über Nacht auf CI-Fehler überprüfen.

Wählen Sie eine Planungsoption basierend darauf, wo Sie die Aufgabe ausführen möchten:

Option Wo es ausgeführt wird Am besten für
Routines Von Anthropic verwaltete Infrastruktur Aufgaben, die auch dann ausgeführt werden sollten, wenn Ihr Computer ausgeschaltet ist. Können auch durch API-Aufrufe oder GitHub-Ereignisse zusätzlich zu einem Zeitplan ausgelöst werden. Konfigurieren Sie unter claude.ai/code/routines.
Desktop-geplante Aufgaben Ihr Computer, über die Desktop-App Aufgaben, die direkten Zugriff auf lokale Dateien, Tools oder nicht committete Änderungen benötigen.
GitHub Actions Ihre CI-Pipeline Aufgaben, die an Repository-Ereignisse wie geöffnete PRs gebunden sind, oder Cron-Zeitpläne, die neben Ihrer Workflow-Konfiguration leben sollten.
/loop Die aktuelle CLI-Sitzung Schnelle Abfragen während eine Sitzung offen ist. Aufgaben werden abgebrochen, wenn Sie beenden.

Fragen Sie Claude nach seinen Fähigkeiten

Claude hat integrierten Zugriff auf seine Dokumentation und kann Fragen zu seinen eigenen Funktionen und Einschränkungen beantworten.

Beispielfragen

can Claude Code create pull requests?
how does Claude Code handle permissions?
what skills are available?
how do I use MCP with Claude Code?
how do I configure Claude Code for Amazon Bedrock?
what are the limitations of Claude Code?

Nächste Schritte