Eine benannte Sitzung in Claude Code ist ein Arbeitsfenster mit einem eigenen Namen, unter dem eine andere Sitzung es ansprechen kann. Drei Kundenprojekte liegen dann in drei getrennten Ordnern, und statt zwischen den Fenstern zu kopieren, fragt eines beim anderen nach. Die Einrichtung kostet einen Durchgang pro Projekt: Name setzen, im richtigen Ordner starten, ein Merkblatt hinterlegen, einmal gegenprüfen.
Warum kosten drei offene Kundenfenster so viel Zeit?
Montags dasselbe Bild. Drei Fenster offen, in jedem ein Kunde. Du erklärst im ersten, was du im zweiten vor zehn Minuten schon erklärt hast. Du kopierst eine Anzeige aus dem einen Verlauf in den anderen. Nach einer Stunde hast du nichts gebaut, du hast Sachen von links nach rechts getragen.
Das ist kein persönliches Ordnungsproblem. In einer Befragung der Werkzeug-Anbieter JetBrains und GitKraken unter über 1.000 Entwicklerinnen und Entwicklern weltweit landete zu häufiger Kontextwechsel bei Mehrfachauswahl mit 36 Prozent auf Platz 1 der genannten Bremsen im täglichen Arbeitsfluss (heise online, März 2024). Der Grund im Werkzeug ist banal: Jede Sitzung kannte bisher nur ihren eigenen Ordner. Also warst du die Verbindung zwischen den Projekten, und jede Information ging durch deine Zwischenablage.
Was ist ein Zuruf zwischen zwei Claude-Code-Sitzungen?
Ein Zuruf ist eine Nachricht, die eine Sitzung an eine andere schickt, adressiert über deren Namen. Claude Code nutzt dafür zwei Werkzeuge: ListAgents findet die erreichbaren Sitzungen, SendMessage stellt die Nachricht an eine davon zu (Anthropic-Dokumentation). Was rübergeht, ist reiner Text, nie der Verlauf und nie Dateien. Die angesprochene Sitzung liest in ihrem eigenen Ordner nach und antwortet.
In der Praxis heißt das: Du schreibst in deiner Content-Sitzung einen normalen deutschen Satz. „Frag Kunde Nord, welche Anzeigentexte dort zuletzt gelaufen sind." Die Antwort erscheint bei dir in Content. Kein zweites Fenster, kein Erklären von vorn.
Zwei Voraussetzungen nennt die Dokumentation ausdrücklich. Claude Code ab Version 2.1.224 auf macOS und Linux, ab 2.1.234 auf nativem Windows. Auf Drittanbieter-Zugängen wie Amazon Bedrock, Google Cloud und Microsoft Foundry ist die Funktion eingeschränkt, der genaue Stand hängt an deiner Version. Ob deine Sitzung sie hat, beantwortet /list-agents.
Wie benenne ich eine Sitzung in Claude Code?
Schreib die drei Namen auf, bevor du irgendetwas startest. Kurz, eindeutig, ohne Nummern: „Kunde Nord", „Kunde Süd", „Content". Der Name ist keine Deko, er ist die Adresse, unter der du diese Sitzung von überall ansprichst. Ein Name wie „Projekt 2" funktioniert technisch und fällt dir in drei Wochen nicht mehr ein.
cd ~/kunden/nord
claude -n "Kunde Nord"Läuft die Sitzung schon, tippst du stattdessen /rename Kunde Nord hinein. Beides ergibt dasselbe: Eine Sitzung hört auf den Namen, den du per --name oder /rename gesetzt hast. Siehst du ihn nicht im Fenster, ist er nicht gesetzt, und dann geht später kein Zuruf an diese Sitzung durch. Falls Claude Code bei dir noch gar nicht läuft, führt Landingpage mit Claude Code bauen durch Installation und Kontoverbindung.
Warum darf ich einen Namen nur einmal vergeben?
Weil die zweite Sitzung den Namen gar nicht bekommt. Startest oder benennst du eine Sitzung auf einen Namen, den eine andere laufende Sitzung auf demselben Rechner schon trägt, lässt Claude Code den Namen bei der ersten und benennt deine in eine Variante mit zweiteiligem Zusatz um, etwa kunde-nord-graceful-unicorn (Sessions-Dokumentation). Dein Zuruf landet danach im alten Fenster, nicht im neuen. Nichts geht kaputt, und trotzdem ist alles falsch. Das ist die unangenehmste Fehlerart überhaupt.
Drei Namen, drei Fenster, keine Doppelung. /list-agents zeigt zu jeder lokalen Sitzung auch ihren Arbeitsordner, damit du gleich benannte Fenster auseinanderhältst.
Wie trenne ich drei Kundenprojekte sauber in Ordner?
Ein Projekt, ein Ordner, alle drei auf derselben Ebene. Kein Ordner liegt in einem anderen drin. Liegt Süd innerhalb von Nord, kann die Nord-Sitzung in Süd hineinschreiben, ohne dass es jemand merkt.
~/kunden/nord
~/kunden/sued
~/contentStarte jede Sitzung im Projektordner, nie eine Ebene darüber. Das ist der häufigste Einrichtungsfehler. Du startest bequem in ~/kunden statt in ~/kunden/nord, weil du von dort beide erreichst. Damit sieht deine Nord-Sitzung auch alle Dateien von Süd, sie wird sie lesen, weil sie da sind, und irgendwann eine davon anfassen. Das Arbeitsverzeichnis ist der Pfad, in dem du gerade arbeitest, und für jeden Verweis ohne vollständigen Pfad wird immer das Arbeitsverzeichnis als Basis angenommen. Der Startordner ist die erste Wand, aber nicht die einzige: Mit --add-dir, einer gespeicherten Freigabe oder erlaubtem Bash-Zugriff greift eine Sitzung auch außerhalb, und die Memory-Suche steigt planmäßig durch die Elternordner. Wer Kundendaten wirklich trennen will, prüft je Projekt mit /permissions, was die Sitzung darf, und gibt keiner Sitzung Zugriff auf den gemeinsamen Überordner.
Dann leg in jeden Ordner eine Textdatei namens CLAUDE.md. Claude Code liest sie beim Start jeder Sitzung von allein und geht dafür den Verzeichnisbaum vom Arbeitsverzeichnis aus nach oben (Memory-Dokumentation). Vier Zeilen reichen: wie die Sitzung heißt · wer der Kunde ist und was er verkauft · was in diesem Ordner liegt · welche Ordner tabu sind. Das ist der Teil, der das zweimalige Erklären beendet. Wie weit derselbe Aufbau trägt, wenn Skills, Hooks und Subagents dazukommen, steht im Agent Dev Kit für Claude Code.
Wie teste ich, ob ein Zuruf wirklich ankommt?
Stell eine Frage, die die fragende Sitzung nicht selbst beantworten kann. Das ist der ganze Trick am Test. Fragst du in Content nach etwas, das in Content sowieso liegt, bekommst du eine schöne Antwort und weißt nichts. Nimm eine Angabe, die es nur bei Kunde Nord gibt.
Danach prüfst du die Antwort einmal gegen den Ordner. Beim ersten Mal, und nur beim ersten Mal. Du testest nicht die Formulierung, du testest, ob überhaupt ein Zuruf stattgefunden hat. Stimmt es, ist die Verbindung bewiesen. Stimmt es nicht, ist fast immer der Name schuld.
Warum funktioniert ein Zuruf als Frage, aber nicht als Auftrag?
Weil ein Zuruf Auskunft holt und keine Erlaubnis mitträgt. Claude Code sagt der empfangenden Sitzung ausdrücklich, dass die Nachricht aus einer anderen Sitzung kommt und nicht von dir. Sie zählt nie als deine Zustimmung, sie kann keine offene Freigabe beantworten, und die empfangende Sitzung soll auf Zuruf weder Berechtigungen noch die CLAUDE.md ändern. Was eine Freigabe braucht, fragt sie weiter bei dir nach.
Das ist keine Schwäche, das ist die Sicherung. Sonst könnte ein Fenster ungefragt in einem fremden Kundenkonto arbeiten. Also „hol", „nenn", „vergleich". Nicht „änder das dort drüben".
Wie hole ich die drei Sitzungen am nächsten Tag zurück?
cd ~/kunden/nord
claude --resume--resume ohne Zusatz öffnet die Liste der gespeicherten Sitzungen, und dort steht dein Name. Schreibst du den Namen direkt dahinter und er passt genau, nimmt Claude Code die Sitzung sofort. Passt er auf mehrere, öffnet sich die Liste mit dem Namen als Suchbegriff. Genau deshalb lohnt der Name: Ohne ihn stehen dort Zeitstempel und automatisch erzeugte Titel, und eine namenlose Sitzung findest du morgen nicht wieder. Dann erzählst du alles noch einmal.
Warum nicht einfach eine Sitzung für alle drei Ordner?
Das geht, und es funktioniert etwa zwei Wochen. Danach kippt es aus zwei Gründen. Der erste ist praktisch: Eine Sitzung mit drei Kundenordnern trägt drei Kundenkontexte gleichzeitig und hat keinen Weg, sicher zu entscheiden, welcher gerade gemeint ist. Beim Lesen fällt das nicht auf, beim Schreiben schon.
Der zweite wiegt schwerer. Alles, was du über Kunde Nord besprichst, liegt dann im selben Verlauf wie Kunde Süd. Bei zwei eigenen Projekten ist das unordentlich. Bei zwei fremden Kunden ist es etwas, das du nicht erklären willst.
Der ehrliche Preis der Trennung: drei Fenster statt einem und drei Namen im Kopf. Dafür fragt jedes Fenster beim anderen nach, statt dass du dazwischen läufst. Bei mir nimmt dieser Aufbau rund 11 Stunden Handarbeit pro Woche ab, und ein guter Teil davon war genau dieses Hin- und Herkopieren. Wie das bei Werbekonten aussieht, steht in Meta Ads automatisieren mit Claude Code.
Im PDF liegt das Ganze als Einrichtungsblatt zum Ausdrucken. Die zehn Punkte in der Reihenfolge zum Abarbeiten, die Umbau-Reihenfolge für den Fall, dass schon drei Fenster offen sind und du nicht alles neu aufsetzen willst, und ein ausfüllbares Blatt für alle drei Projekte mit Feldern für Name, Ordner, Häkchen pro Schritt und deinen ersten Testzuruf. Trag unten deine E-Mail ein, dann bekommst du es sofort als Download.