Mehrere Claude Code-Sessions: erkennen, welche dich braucht

01Warum parallele Sessions schnell unübersichtlich werden

Zwei oder drei Claude Code-Sessions nebeneinander laufen zu lassen, ist inzwischen ganz normal: Eine fixt einen Bug, eine schreibt Tests, eine probiert ein Refactoring aus. Jede Session hält in ihrem eigenen Tempo an. Die Probleme sind immer dieselben:

• eine Benachrichtigung kommt, und du weißt nicht, aus welchem Terminal-Tab;
• eine Session wartet seit zwanzig Minuten auf einen Permission-Prompt, während du eine andere beobachtest;
• du antwortest im falschen Fenster.

Alle drei laufen auf Identifikation hinaus. Jede Meldung sollte sagen, woher sie kommt, und jede Antwort sollte an die Session zurückgehen, die gefragt hat.

02Trenn die Sessions zuerst sauber

Nutze Worktrees für dasselbe Repository

Zwei Sessions, die denselben Checkout bearbeiten, kommen sich gegenseitig in die Quere. Das --worktree-Flag von Claude Code (kurz -w) legt einen isolierten Git-Worktree an und startet die Session darin:

claude --worktree feature-auth
claude --worktree fix-login

Standardmäßig wird jeder Worktree unter .claude/worktrees/<name>/ im Repository-Root angelegt, auf einem neuen Branch namens worktree-<name>. Führ jeden Befehl in einem eigenen Terminal aus. Trag .claude/worktrees/ in deine .gitignore ein, damit die Worktrees nicht als untracked Files auftauchen.

Beim Beenden prüft Claude Code den Worktree. Ist er sauber und hast du die Session nie benannt, entfernt Claude Code Worktree und Branch; andernfalls fragt es, ob er behalten werden soll. Um später zu einem behaltenen Worktree zurückzukehren, führ den Befehl claude --worktree <name> --resume aus, der beim Beenden angezeigt wird. Wenn du Worktrees lieber selbst verwaltest, klappt auch git worktree add ../project-feature-a -b feature-a; starte claude dann in diesem Ordner.

Ein praktischer Nebeneffekt für Benachrichtigungen: Jede Session hat jetzt einen eigenen Ordnernamen wie feature-auth – genau das, was du in einer Meldung sehen willst.

Gib deinen Sessions Namen

Mit Namen findest du Sessions leicht wieder und kannst sie fortsetzen:

claude -n auth-refactor

In einer laufenden Session macht /rename auth-refactor dasselbe, und der Name erscheint in der Prompt-Leiste. Später bringt dich claude --resume auth-refactor direkt zurück. In der Session-Auswahl (claude --resume ohne Namen) erweitert Ctrl+W die Liste auf alle Worktrees des Repositorys.

03Pack das Projekt in jede selbstgebaute Benachrichtigung

Jeder Command-Hook bekommt auf Standard Input JSON mit Feldern, die bei allen Events vorhanden sind, darunter session_id, cwd, transcript_path und hook_event_name. In einer Worktree-Session ist cwd der Worktree-Root und folgt Claude, wenn es das Verzeichnis wechselt. Lies es in deinem Hook aus und nimm den letzten Teil des Pfads als Label.

Auf Mac und Linux speicherst du das als ~/.claude/hooks/notify-session.sh und machst es mit chmod +x ausführbar. Du brauchst dafür jq.

#!/bin/sh
input=$(cat)
project=$(basename "$(printf '%s' "$input" | jq -r '.cwd')")
event=$(printf '%s' "$input" | jq -r '.hook_event_name')

case "$event" in
  Stop) msg="Claude has finished" ;;
  *)    msg="Claude needs you" ;;
esac

notify-send "Claude Code: $project" "$msg"

Auf dem Mac ersetzt du die letzte Zeile durch eine osascript-Benachrichtigung, wie im macOS-Guide gezeigt. Unter Windows liest du dasselbe JSON in PowerShell mit ConvertFrom-Json ein; ein vollständiges Beispiel findest du im Windows-Guide.

Registriere es dann für die Events, die dich interessieren, in ~/.claude/settings.json:

{
  "hooks": {
    "Stop": [
      { "hooks": [{ "type": "command", "command": "~/.claude/hooks/notify-session.sh" }] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [{ "type": "command", "command": "~/.claude/hooks/notify-session.sh" }] }
    ]
  }
}

Zwei Hinweise zu Pfaden. Setze Variablen wie "$input" in Anführungszeichen, denn Ordnernamen können Leerzeichen enthalten. Und wenn du ein Skript über ${CLAUDE_PROJECT_DIR} referenzierst, denk daran, dass es auf den Ordner zeigt, in dem die Session gestartet wurde – auch nachdem Claude in einen Worktree gewechselt ist. Lies cwd aus dem Input, wenn du den aktuellen Ordner brauchst.

Wenn du mit tmux arbeitest, ist das Pane oder Window oft ein besseres Label als der Ordner. Der tmux-Guide zeigt, wie du das richtige Pane findest und dorthin wechselst.

04Der schwierige Teil: der richtigen Session antworten

Ein Alert mit Label sagt dir, welche Session dich braucht. Antworten musst du aber trotzdem im Terminal. Bei drei Sessions heißt das: den richtigen Tab finden, zum Prompt scrollen und tippen. Ein selbstgebauter Hook kann deine Antwort nicht so einfach zurückschicken, denn nur der Hook, der in dieser Session wartet, kann eine Entscheidung an Claude Code zurückgeben.

Genau diese Lücke schließt Claude Code Notifier. Es ist ein unabhängiges Tool, nicht von Anthropic. Das Kommandozeilentool ccn wird auf Mac, Windows und Linux als Claude Code-Hooks installiert, sodass jede Session, die du startest, abgedeckt ist – in jedem Terminal, ohne Setup pro Session. Jede Benachrichtigung enthält Name und Ordner des Projekts, sodass du auf deinem iPhone oder Android-Handy siehst, welche Session sie geschickt hat. Weil genau der Hook, der die Anfrage geschickt hat, auf deine Antwort wartet, landet eine Freigabe, eine Auswahl oder eine weitere Anweisung vom Handy in der Session, die gefragt hat.

Ein paar Details, die bei mehreren Sessions wichtig sind:

• Mehrere Computer. Ein Handy kann mit mehreren Computern gekoppelt werden und ein Computer mit mehreren Handys. ccn devices listet die mit diesem Computer gekoppelten Handys auf.
• Anwesenheit. Wenn du in den letzten 30 Sekunden getippt hast, wird nicht aufs Handy gewartet und das Terminal fragt wie gewohnt. Bist du weg, wartet die Session bis zu einer von dir gewählten Obergrenze (hold_ceiling_seconds) auf die Antwort vom Handy und hört sofort auf zu warten, sobald du die Tastatur berührst.
• Desktop-Benachrichtigungen ohne Handy. Bevor du ein Handy koppelst, zeigt ccn eine Desktop-Benachrichtigung auf dem Computer an, wenn eine Session fertig ist, eine Berechtigung braucht oder eine Frage stellt.

Wenn du immer nur eine Session gleichzeitig laufen lässt und am Schreibtisch sitzt, reicht dir wahrscheinlich ein Desktop-Alert mit Label. Der Vergleichs-Guide stellt die Optionen nebeneinander.

05FAQ