Claude Code Guide: Cross-Session-Messaging effizient nutzen

Cross-Session-Messaging ermöglicht den Datenaustausch zwischen unabhängigen KI-Instanzen auf derselben Maschine oder über Remote-Verbindungen. Damit informiert Claude andere Sitzungen über Code-Änderungen, beantwortet Rückfragen oder koordiniert den Status laufender Prozesse autonom. Das System ist ab Version 2.1.224 verfügbar und setzt macOS oder Linux voraus.

Funktionsweise der sitzungsübergreifenden Kommunikation

Diese Funktion schlägt eine Brücke zwischen isolierten Terminals. Sobald eine Instanz Informationen erlangt, die für andere Sitzungen relevant sind – etwa ein Breaking Change in einer API –, gibt Claude diese Erkenntnis weiter. Anstatt komplette Konversationsverläufe oder Dateien zu übertragen, werden gezielte Textnachrichten verschickt. Claude nutzt dafür die internen Werkzeuge ListAgents zur Identifizierung aktiver Instanzen und SendMessage für die Zustellung.

Die Übertragung geschieht diskret zwischen Tool-Aufrufen, um laufende Operationen nicht zu stören. Befindet sich die Ziel-Sitzung im Leerlauf, stößt die eingehende Nachricht automatisch einen neuen Arbeitsschritt an. Das bewährt sich besonders bei parallelen Worktrees: Wer in verschiedenen Verzeichnissen am selben Repository arbeitet, profitiert davon, dass Claude andere Instanzen über bereits eingespielte Änderungen (Lands) auf dem Laufenden hält. Auch Statusberichte von Migrationen oder Testläufen spiegeln sich so direkt in die aktive Hauptsitzung.

Voraussetzungen und Verfügbarkeit im Jahr 2026

Für den Betrieb müssen spezifische technische Rahmenbedingungen erfüllt sein. Da die Kommunikation auf lokalen Sockets basiert, bleibt sie vorerst auf macOS und Linux (inklusive WSL 2) beschränkt. Unter nativem Windows lässt sich das Feature derzeit nicht nutzen. Zudem existieren Einschränkungen bei Cloud-Providern: Infrastrukturen wie Amazon Bedrock, Google Cloud Agent Platform oder Microsoft Foundry unterstützen diese direkte Kopplung momentan nicht.

Feature	Status / Anforderung
Mindestversion	Claude Code v2.1.224
Betriebssysteme	macOS, Linux, WSL 2
Datenformat	Nur Plain Text
Limitierung	Max. 50 Nachrichten in der Warteschlange
Cloud-Sperre	Bedrock, Google Cloud, Azure Foundry

Falls Umgebungsvariablen wie CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC oder DO_NOT_TRACK aktiv sind, bleibt die Funktion abgeschaltet. Die Verfügbarkeit lässt sich in jeder Sitzung über den Befehl /list-agents oder den Alias /peers prüfen. Erscheint dort eine Liste der Agenten, steht der Austausch.

Steuerung und manuelle Interaktion

Claude versendet viele Hinweise eigenständig, doch der Austausch lässt sich auch manuell steuern. Anstatt technische Tool-Namen zu nutzen, genügt eine Anweisung in natürlicher Sprache. Claude formuliert die Nachricht an die Zielinstanz dann selbstständig. Das ist sinnvoll, um etwa Zusammenfassungen komplexer Refactorings an eine andere Teilsitzung zu delegieren.

Praxisbeispiele für manuelle Prompts:

• "Frage im anderen Terminal nach, ob die Datenbank-Migration durchgelaufen ist."
• "Informiere die Payments-Instanz über die neuen Feldnamen im User-Schema."

Jede Sitzung lässt sich über /rename oder das Flag --name eindeutig benennen. Ohne explizite Zuweisung generiert Claude Code Namen basierend auf dem Verzeichnis (z. B. myapp-3f). Bei der Nutzung mehrerer Geräte erlaubt Remote Control das Antworten auf Nachrichten via Web-Interface. Wichtig: Maschinenübergreifend kann Claude zwar auf Anfragen reagieren, aber keine neuen Konversationen von sich aus initiieren.

Sicherheitskontrollen und Inbound-Konfiguration

Die Architektur folgt strikten Sicherheitsvorgaben. Eine Nachricht einer anderen Sitzung wird niemals als menschliche Zustimmung gewertet. Erfordert eine Aktion in der Ziel-Sitzung erhöhte Rechte, ist weiterhin eine manuelle Bestätigung durch den Nutzer nötig. Zudem können externe Instanzen keine geschützten Konfigurationen wie die [CLAUDE.md](/skills/andrej-karpathy-skills-claude-md-guide) überschreiben.

Über die Einstellung crossSessionInbound wird festgelegt, wie eine Sitzung auf eingehende Daten reagiert:

1. accept: Nachrichten werden sofort zugestellt.
2. hold: Nachrichten werden geparkt und erfordern eine Freigabe per Dialogfenster.
3. refuse: Eingehende Nachrichten werden ohne Rückmeldung blockiert.

Administratoren haben die Möglichkeit, die Funktion global zu unterbinden, indem sie SendMessage und ListAgents in den Managed Settings sperren. Für maximale Isolation sorgt die Option isolatePeerMachines. Ist diese auf true gesetzt, muss jede Nachricht, die die lokale Maschine verlässt, einzeln genehmigt werden – selbst wenn der globale Modus auf bypassPermissions steht. Damit bleibt die Hoheit über den Informationsfluss im KI-Setup gewahrt.

Weitere Details zur technischen Implementierung finden sich in der Dokumentation unter code.claude.com.