Parallele Claude-Code-Sitzungen: Isolation und Handoffs
Ein praktisches Muster für zwei unabhängige Claude-Code-Aufgaben mit Worktrees, fokussierten Tests und sicherem Handoff.
Inhalt
Parallele Claude-Code-Sitzungen: Isolation und Handoffs
Parallele Sitzungen helfen nur bei getrennten Aufgaben. Gehören zwei Änderungen in dieselbe Datei, bekommt diese Datei einen Owner und die Arbeit wird sequenziert. Für einen separaten API-Workflow erklärt der BetterToken-Claude-Code-Guide die Nutzung des eigenen API Key; BetterToken ist kein Claude.ai-Abo und kein Shared Account.
Aufgaben und Dateien zuordnen
| Aufgabe | Erlaubter Bereich | Fertig wenn |
|---|---|---|
Leeres amount | parser/, tests/import/ | Test liefert Validierungsfehler |
--dry-run | cmd/, tests/cli/ | Plan wird gezeigt, keine Daten geschrieben |
Gemeinsame Dateien sind ein Stoppsignal, keine Einladung zur stillen Scope-Erweiterung.
Worktrees isolieren
Prüfen Sie zuerst unbekannte Änderungen, ohne sie zu verstecken oder zu löschen:
git status --short
git worktree add ../project-fix-empty-amount -b fix/empty-amount
git worktree add ../project-cli-dry-run -b feat/cli-dry-runStarten Sie Claude Code in jedem Verzeichnis. Worktree trennt Dateien und Branches, die Sitzung trennt Kontext; keines von beidem löst einen Dateikonflikt.
Präzise Prompts geben
Nennen Sie erlaubte Ordner, verbotenes Verhalten und Test. Beispiel: „Arbeite nur in parser/ und tests/import/; ändere das CSV-Format nicht; reproduziere den Fehler, mache die kleinste Korrektur und melde die Test-Command.“ Benötigt die Session einen fremden gemeinsamen Pfad, stoppt sie und dokumentiert den Blocker.
Handoff als Vertrag
Task: empty amount returns validation error
Worktree / branch: ../project-fix-empty-amount / fix/empty-amount
Changed: parser/amount.ts, tests/import/empty-amount.test.ts
Verified: npm test -- tests/import/empty-amount.test.ts
Not verified: full integration suite
Next: review diff before mergeÜbergeben Sie Zustand und überprüfbare Befehle, nicht den Chatverlauf.
Verifikation und Rollback
git status --short
git diff --check
npm test -- tests/import/empty-amount.test.tsDie nächste Session wechselt ins Worktree, prüft die Dateien und wiederholt genau diesen Befehl. Fehlt der Nachweis oder ist er rot, bleibt die Änderung unbestätigt; stellen Sie die Änderung zurück oder geben Sie sie an den Owner zurück.
Konflikte und Berechtigungen
Bei Überschneidung liest ein Owner beide Diffs, überträgt die gewünschte zweite Änderung und führt beide fokussierten Tests aus. Geben Sie einer Session keine pauschale Erlaubnis, außerhalb ihres Bereichs zu schreiben. API Keys, Cookies, .env-Werte, personenbezogene Daten und vollständige sensible Logs gehören nicht in Handoff oder Commit.
CTA und Quellen
Konfigurieren Sie bei Bedarf nur den eigenen Key nach dem aktuellen BetterToken-Guide und reichen Sie Credentials über das normale Secret-Verfahren weiter.
