Mehrere Claude Code Sessions parallel verwalten

Für mehrere Claude Code Sessions öffnest du in jedem Paneflow-Pane einen unabhängigen Agenten und gibst ihm eine klar abgegrenzte Aufgabe. Verwende getrennte Git-Worktrees, wenn beide Sessions dasselbe Repository bearbeiten sollen. Paneflow hält Terminals, Aufgabenkontext und Aktivität sichtbar. Du entscheidest weiterhin, was jede Session ändern darf und wann ihr Ergebnis fertig ist.

Dieser Leitfaden beschreibt die Sitzungsverwaltung in Paneflow 0.17.4. Installiere Claude Code separat in der vorgesehenen Shell und melde dich dort an. Paneflow ist freie Software unter GPL-3.0-or-later; Zugang und Nutzung von Claude Code unterliegen dessen Anbieterbedingungen.

In der Seitenleiste bleiben Projektaufgaben, Branches und Status neben dem aktiven Claude Code Terminal sichtbar.

Unabhängige Sessions oder Subagents?

Unabhängige Sessions eignen sich für Aufgaben, die du direkt steuern möchtest: eine Unterhaltung für einen Bug, eine weitere für die Dokumentation, jeweils mit eigenem Terminal und bei Bedarf eigenem Checkout. Du liest jede Session und beantwortest ihre Rückfragen selbst.

Claude Code Subagents erledigen delegierte Arbeit innerhalb einer Session, nutzen ihren eigenen Kontext und geben Ergebnisse an die übergeordnete Unterhaltung zurück. Wähle dieses Modell, wenn eine Hauptunterhaltung eine abgegrenzte Untersuchung koordinieren soll. Zwei Paneflow-Panes erzeugen weder diese Delegationsbeziehung noch einen automatisch geteilten Gesprächsverlauf.

Für verschiedene Tools nutze den Leitfaden zu Claude Code und Codex parallel. Hier geht es um mehrere Claude Code Instanzen.

Jede Session bekommt eine überprüfbare Aufgabe

Beginne mit zwei unabhängigen Beiträgen zu einem bestehenden Projekt: Eine Session aktualisiert docs/setup.md, die andere ergänzt Randfalltests für einen bereits implementierten Parser. Hängen die Tests von einer noch laufenden Parser-Neuentwicklung ab, schließe diese zuerst ab.

Halte vor dem Start vier Punkte pro Aufgabe fest:

• Das gewünschte Ergebnis und die Dateien, die die Session bearbeiten darf.
• Dateien, die einer anderen Aufgabe gehören und unverändert bleiben müssen.
• Das bestehende Verhalten oder die Schnittstelle, auf die sie sich stützen kann.
• Die Prüfung, die das Ergebnis belegt, und Entscheidungen, die deine Rückmeldung brauchen.

Halte Projektanweisungen in jedem Checkout verfügbar. Eine neue Session übernimmt weder ungespeicherte Pläne noch Entscheidungen oder Gespräche einer anderen Session.

Gemeinsame Dateien oder eigener Worktree

Ein zweites Pane öffnet ein weiteres Terminal, isoliert aber keine Dateien. Erstelle für unabhängige Änderungen im selben Repository einen Branch mit aktiviertem Worktree im Formular New branch und öffne Claude Code dort. Wiederhole das für die andere Aufgabe vom vorgesehenen Ausgangsstand. Die Worktree-Referenz erklärt Erstellung, Wiederverwendung und Entfernung.

Worktrees sind optional. Eine reine Leseaufgabe kann einen bestehenden Checkout verwenden, sofern sich Dateien während der Untersuchung ändern dürfen. Zwei Sessions, die gemeinsame Dateien bearbeiten, brauchen explizite Koordination. Ein anderer Branchname im selben Checkout erzeugt keine zweite Kopie der Dateien.

Prüfe vor der Aufgabenvergabe in jedem Pane Verzeichnis, Branch und vorhandene Änderungen:

git rev-parse --show-toplevel
git branch --show-current
git status --short

Abhängigkeiten, Dev-Server-Ports, Datenbanken und Anbieterlimits musst du separat berücksichtigen. Ein Worktree trennt Arbeitsdateien, nicht Netzwerkzugriff oder laufende Dienste.

Die Session finden, die eine Antwort braucht

Öffne Settings > Agents und prüfe die Claude Code Integration. Install hooks aktiviert die Meldung von Lebenszyklusereignissen. Die Referenz zur Agentenaufsicht beschreibt Einrichtung und Verhalten ohne Hooks. Paneflow meldet Aktivität und Eingabeanforderungen anhand der verfügbaren Integration.

Wenn eine Session Aufmerksamkeit braucht, öffne ihr Terminal und lies die Anfrage, bevor du sie bestätigst. Prüfe nach einem abgeschlossenen Durchlauf das Ergebnis. Ein Fertig-Status meldet ein Agentenereignis, keine Abnahme der Implementierung und keine bestandene Testsuite. Wirkt der Status falsch, lies zuerst die Terminalausgabe, statt dieselbe Aufgabe erneut zu starten.

Begrenze die Zahl der Sessions auf das, was du prüfen kannst. Zusätzliche Prozesse helfen nur, wenn ihre Aufgaben unabhängig vorankommen und du ihre Ergebnisse integrieren kannst.

Änderungen prüfen und Kontext wiederfinden

Speichere Editorpuffer und prüfe Changes im Checkout der Aufgabe. Die Ansicht vergleicht vorgemerkte, nicht vorgemerkte und unversionierte Änderungen mit dessen HEAD. Bereits eingecheckte Branchänderungen brauchen eine eigene Prüfung. Kontrolliere die Aufgabenprüfung, integriere die geprüften Beiträge mit deinem üblichen Git-Workflow und prüfe den kombinierten Stand. Auch getrennte Worktrees können Merge-Konflikte verursachen.

Wähle Keep sessions running, um das Fenster zu schließen und laufende Terminals zu erhalten. Beim erneuten Öffnen werden sie verbunden, solange Host und Rechner weiterlaufen. Der Persistenzleitfaden erklärt Grenzen bei Herunterfahren und Ruhezustand. Ist der Prozess beendet, kann Sessions eine gespeicherte Claude Code Unterhaltung für das aktive Verzeichnis laden. Restart startet lediglich eine neue Shell.

Kann Paneflow mehrere Claude Code Sessions verwalten?

Ja. Paneflow führt unabhängige Claude Code Terminals aus, ordnet ihren Projektkontext und zeigt Aktivität über die verfügbare Integration an. Es führt ihre Modellkontexte nicht zusammen und ersetzt keine Prüfung der Ergebnisse.

Braucht jede Session einen Git-Worktree?

Nein. Verwende einen Worktree, wenn eine Aufgabe eigene Arbeitsdateien und einen eigenen Branch braucht. Sessions können einen gemeinsamen Checkout direkt lesen, sehen dabei aber möglicherweise Änderungen anderer Sessions.

Umgehen zusätzliche Sessions die Nutzungslimits von Claude Code?

Nein. Paneflow verändert weder Konto- noch Parallelitäts- oder Nutzungslimits des Anbieters. Reduziere die Parallelität, wenn Aufgaben um dasselbe Kontingent, Rechnerressourcen oder unfertige Ergebnisse konkurrieren.