Claude Code w tmux lub screen: powiadomienia z odłączonej sesji

01Podłączony: przepuść powiadomienia przez tmux

tmux stoi między Claude Code a twoim terminalem i domyślnie połyka sekwencje escape, których Claude Code używa do powiadomień desktopowych. Poradnik Anthropic o terminalu podaje ten blok do ~/.tmux.conf:

set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

Zastosuj go w działającym serwerze:

tmux source-file ~/.tmux.conf

allow-passthrough przepuszcza powiadomienia i informacje o postępie do zewnętrznego terminala. Pozostałe linie naprawiają Shift+Enter dla nowych linii. Dzięki temu terminale, które pokazują powiadomienia Claude Code poza tmux (Ghostty, Kitty i iTerm2 z włączonymi alertami), pokażą je też w tmux.

To samo dotyczy hooków, które zwracają terminalSequence. Według dokumentacji hooków Anthropic Claude Code sam wypisuje te sekwencje, co działa w tmux i GNU screen. Przykłady znajdziesz w poradnikach dla macOS, Linux i SSH.

02Podłączony, ale w innym oknie: użyj dzwonka

Jeśli Claude Code działa w jednym oknie tmux, a ty pracujesz w innym, dzwonek to prosty sygnał. Każ Claude Code zawsze go wysyłać:

{
  "preferredNotifChannel": "terminal_bell"
}

Potem skonfiguruj reakcję tmux w ~/.tmux.conf:

setw -g monitor-bell on
set -g bell-action other
set -g visual-bell off

monitor-bell (domyślnie włączone) oznacza okno, w którym zadzwonił dzwonek, a tmux zaznacza je w pasku statusu znakiem !. bell-action other przekazuje dzwonki z okien innych niż to, na które patrzysz, do twojego terminala, żeby mógł zapiszczeć lub podskoczyć. Użyj any, żeby objąć też bieżące okno. Ustawienie visual-bell na on pokazuje komunikat w tmux zamiast przekazywać dzwonek dalej.

03Pokaż, która sesja cię potrzebuje

Przy kilku działających sesjach powiadomienie „Claude cię potrzebuje” niewiele mówi. Hook działa w środowisku panelu, więc może zapytać tmux o nazwę sesji i okna. Ten przykład dla Linux pokazuje je w powiadomieniu desktopowym:

#!/bin/bash
msg=$(jq -r '.message // "Claude Code needs your attention"')
where=""
if [ -n "$TMUX_PANE" ]; then
  where=$(tmux display-message -p -t "$TMUX_PANE" '#S:#W')
fi
notify-send "Claude Code ${where}" "$msg"

Zapisz go jako ~/.claude/hooks/notify-tmux.sh, wykonaj na nim chmod +x i użyj jako komendy hooka Notification lub Stop. #S to nazwa sesji, a #W nazwa okna; nazywaj sesje przez tmux new -s api-refactor, a powiadomienie powie ci, dokąd iść. Zamień notify-send na komendę dla swojej platformy albo na push. Więcej sposobów rozróżniania sesji znajdziesz w poradniku o wielu sesjach.

04Odłączony: potrzebujesz pusha

Odłączanie to sedno tmux: odpalasz długie zadanie, odłączasz się i idziesz. Claude Code pracuje dalej w odłączonej sesji. Ale nie ma już terminala, który pokazałby sekwencję escape czy dzwonek, a jeśli serwer tmux został uruchomiony przez SSH, komenda powiadomienia desktopowego też może nie mieć dokąd trafić.

Hooka, który wysyła żądanie sieciowe, nie obchodzi, czy ktoś jest podłączony. Zadziała dowolna usługa push. Poradnik o ntfy oraz poradnik o Telegram, Slack i Discord zawierają hooki do wklejenia. Informują, że coś się stało, ale nie mogą odpowiedzieć Claude, więc prośba o uprawnienie i tak czeka, aż podłączysz się ponownie przez tmux attach -t api-refactor.

05Gdzie pasuje Claude Code Notifier

Claude Code Notifier to niezależne narzędzie (tworzone przez TouchTap, nie przez Anthropic) oparte na hookach Claude Code. Jego darmowe narzędzie wiersza poleceń, ccn, działa na Macu, Windows i Linux. Ponieważ podpina się pod Claude Code, a nie pod terminal, działa tak samo w tmux, screen czy zwykłej powłoce, podłączonej lub odłączonej:

curl -fsSL https://claudecodenotifier.com/install.sh | sh

Na komputerze stacjonarnym pokazuje powiadomienie desktopowe, gdy Claude skończy, potrzebuje uprawnienia lub zadaje pytanie. Po sparowaniu telefonu te same zdarzenia przychodzą jako push przez szyfrowany relay TouchTap, z każdej maszyny, na której działa ccn, także z serwera, z którym łączysz się przez SSH.

Telefon zapełnia lukę, którą zostawia odłączona sesja. Gdy pojawi się prośba o uprawnienie, możesz z telefonu zezwolić raz, zezwolić na sesję albo odmówić, a Claude kontynuuje bez ponownego podłączania. Możesz wybrać odpowiedź, gdy Claude zada pytanie, i wysłać kolejne polecenie zaraz po tym, jak Claude skończy. Jeśli pisałeś w ciągu ostatnich 30 sekund, nic nie czeka na telefon i terminal pyta jak zwykle. Jeśli cię nie ma, terminal czeka na odpowiedź z telefonu do wybranego limitu (hold_ceiling_seconds) i przestaje czekać, gdy tylko dotkniesz klawiatury.

Zobacz parowanie telefonu, odchodzenie od długich zadań i stronę ccn. Aplikacje na telefon wymagają subskrypcji lub zakupu dożywotniego; zobacz cennik.

06GNU screen

screen działa tu podobnie jak tmux. Według dokumentacji hooków Anthropic wyjście terminalSequence z hooków działa w screen, a screen pokazuje komunikat, gdy okno, na które nie patrzysz, zadzwoni dzwonkiem. Odłączone sesje screen mają ten sam problem co odłączony tmux: nic nie jest na ekranie, więc użyj pusha.

07FAQ