Jak uruchomić Claude Code na telefonie przez SSH
Claude Code działa w sesji tmux na serwerze VPS, a telefon służy jedynie jako terminal. Konfiguracja SSH, mosh oraz odpowiednia aplikacja zapewniają stabilną pracę.
Claude Code z telefonu: jak to działa w praktyce
Niniejszy przewodnik wykorzystuje aplikację terminala na telefonie. Claude Code działa na serwerze VPS (virtual private server), wewnątrz sesji tmux, która pozostaje otwarta. Telefon nawiązuje połączenie SSH (secure shell) z tą sesją na czas korzystania z niej. Zamknięcie aplikacji nie przerywa pracy agenta, ponieważ proces nie jest uruchomiony na telefonie.
Claude Code oferuje również funkcję Remote Control: uruchomienie /remote-control wewnątrz sesji pozwala na korzystanie z niej przez aplikację mobilną Claude lub przeglądarkę, podczas gdy proces pozostaje na serwerze. Wymagana jest subskrypcja Claude; funkcja nie działa z kluczem API.
Ten podział stanowi fundament projektu. System operacyjny telefonu wstrzymuje aplikację kilka sekund po przełączeniu się na inną, więc każde długotrwałe zadanie uruchomione bezpośrednio na telefonie zostałoby przerwane. Telefon otrzymuje również nowy adres sieciowy przy każdym przejściu z sieci Wi-Fi na dane mobilne. Oba problemy znikają, gdy proces działa na serwerze, a telefon służy jedynie do wyświetlania interfejsu.
Na serwerze wymagane są cztery elementy: tmux do utrzymania sesji, klucze SSH do autoryzacji, mosh do obsługi zmian sieciowych oraz sam Claude Code. Po stronie telefonu wystarczy aplikacja terminala z dostępnym rzędem klawiszy funkcyjnych.
Wymagania na serwerze VPS
Niewielka instancja z systemem Ubuntu 24.04 jest wystarczająca do obsługi SSH oraz tmux. Claude Code wymaga jednak większych zasobów. Oficjalne wymagania na listopad 2026 to Ubuntu 20.04 lub nowsze na procesorze x64 lub ARM64 oraz co najmniej 4 GB pamięci RAM. Claude Code wymaga również płatnego konta Claude (Pro, Max, Ultra, Team lub Enterprise), konta w konsoli z dostępem do API lub dostępu przez wspieranego dostawcę chmurowego, takiego jak Amazon Bedrock, ponieważ darmowy plan Claude.ai nie obejmuje tej funkcjonalności.
Skonfiguruj serwer dla zwykłego użytkownika z uprawnieniami sudo, nie jako root. Jeśli serwer jest nowy, najpierw wykonaj pierwsze dziesięć minut na nowym VPS, ponieważ zmiany w SSH opisane w dalszej części poradnika są łatwiejsze do wprowadzenia, gdy użytkownik i firewall już istnieją.
sudo apt update && sudo apt install -y tmux mosh
curl -fsSL https://claude.ai/install.sh | bash
claude --versionInstalator umieszcza plik binarny w ~/.local/bin/claude, a claude --version wyświetla linię podobną do 2.1.211 (Claude Code). Jeśli wyświetli command not found, oznacza to, że ten katalog nie znajduje się jeszcze w Twoim PATH: wyloguj się, zaloguj ponownie, a następnie sprawdź za pomocą command -v claude. claude doctor wyświetla diagnostykę instalacji i ustawień bez uruchamiania sesji.
Zaloguj się teraz raz z laptopa, zanim zaczniesz polegać na telefonie. Uruchom claude w katalogu projektu i postępuj zgodnie z monitami logowania. Procedura wymaga otwarcia adresu URL w przeglądarce i wprowadzenia kodu w terminalu, a przełączanie się między dwiema aplikacjami na ekranie telefonu jest nieefektywne. Wykonaj to raz na pełnowymiarowej klawiaturze, a poświadczenia pozostaną na serwerze.
Uruchamianie Claude Code wewnątrz tmux, aby uniknąć przerwania procesu przy zerwaniu połączenia
tmux new -s claude
cd ~/projects/api
claudeOdłącz się za pomocą Ctrl-b, a następnie d. tmux wyświetli [detached (from session claude)] i przywróci dostęp do powłoki. Teraz można zamknąć aplikację, stracić zasięg lub schować telefon. Panel będzie nadal działał.
tmux ls
tmux attach -t claudetmux ls wyświetla jedną linię na sesję, na przykład claude: 1 windows (created Thu Jul 30 09:14:02 2026). tmux attach -t claude przywraca sesję dokładnie w miejscu, w którym została przerwana, włącznie z niedokończoną edycją.
Działa to, ponieważ tmux uruchamia własny proces serwera, a powłoka oraz Claude Code są procesami potomnymi tego serwera, a nie sshd. Gdy połączenie SSH zostaje zakończone, jądro wysyła sygnał SIGHUP do procesów powiązanych z tym połączeniem, a serwer tmux nie znajduje się wśród nich. Bez tmux, ta sama blokada ekranu, która przerywa połączenie, zatrzymuje Claude Code w trakcie wywołania narzędzia. Uruchamianie Claude Code na VPS wewnątrz tmux zawiera bardziej szczegółowe informacje na temat układu sesji.
Uruchamiaj tmux na serwerze, nigdy na telefonie. Wpisanie tmux wewnątrz sesji, do której jesteś już podłączony, wyświetli sessions should be nested with care, unset $TMUX to force, a wymuszenie tego spowoduje konflikt dwóch klawiszy prefiksu.
Automatyczne dołączanie przy każdym logowaniu
Wpisywanie komendy dołączania na klawiaturze ekranowej jest uciążliwe. Umieść poniższy kod na końcu pliku ~/.profile na serwerze:
if command -v tmux >/dev/null 2>&1 && [ -z "$TMUX" ] && [ -t 1 ]; then
exec tmux new-session -A -s claude
fiKomenda new-session -A -s claude dołącza do sesji o nazwie claude, jeśli ta istnieje, lub tworzy ją, jeśli nie istnieje, dzięki czemu jedna instrukcja obsługuje oba przypadki. exec zastępuje powłokę logowania przez tmux, więc wyjście z tmux zamyka połączenie zamiast pozostawiać użytkownika w pustym wierszu poleceń. Gdy potrzebna jest zwykła powłoka, pomiń ten plik za pomocą: ssh you@server -t "bash --noprofile".
Umieść ten kod w ~/.profile, a nie w ~/.bashrc. Bash odczytuje również ~/.bashrc dla nieinteraktywnych poleceń SSH, ale zabezpieczenie [ -t 1 ] powyżej zapobiega uruchomieniu tmux podczas przesyłania plików. Niezabezpieczone komendy startowe, które wypisują dane na wyjście, powodują błędy protokołów przesyłu, takie jak Received message too long. Plik ~/.profile jest wykonywany tylko dla powłok logowania, co odpowiada interaktywnej sesji SSH.
W ~/.profile Ubuntu dodaje również ~/.local/bin do PATH. Jeśli claude działa poprawnie zaraz po zalogowaniu, ale powłoka wewnątrz tmux zwraca command not found, przyczyną jest kolejność wykonywania skryptów. Dlatego należy uruchamiać tmux z powłoki logowania, jak pokazano powyżej, zamiast ze skryptu, który pomija profil.
iOS: Termius lub Blink Shell
Obie aplikacje obsługują SSH oraz mosh i przechowują klucze wewnątrz aplikacji. Różnica polega na interfejsie.
Blink Shell jest sterowany za pomocą poleceń. W wierszu poleceń wpisuje się ssh you@server lub mosh you@server, używając tej samej składni co w terminalu desktopowym. Ustawienia otwiera się wpisując config, a sekcja Keys służy do generowania pary kluczy.
Termius jest sterowany za pomocą formularzy. Należy wypełnić wpis hosta, a następnie włączyć ustawienie Use Mosh w konfiguracji danego hosta. Termius dostarcza własną implementację mosh i wspiera wersję mosh 1.3.0 oraz nowsze, więc na serwerze nadal musi być zainstalowany pakiet mosh.
W obu przypadkach klucz należy wygenerować wewnątrz aplikacji; nigdy nie należy kopiować istniejącego klucza prywatnego na telefon. Aplikacja wyświetla część publiczną klucza, czyli pojedynczą linię, którą należy dodać do ~/.ssh/authorized_keys na serwerze. Klucze SSH dla poszczególnych urządzeń i sposób ich unieważniania opisuje nazewnictwo oraz procedurę unieważniania, co w przypadku telefonu jest istotniejsze niż w przypadku laptopa.
Należy włączyć w aplikacji terminala własną blokadę biometryczną lub kod dostępu. Bez tego odblokowany telefon stanowi otwartą powłokę do serwera przez cały czas, gdy ekran pozostaje aktywny.
Android: Termux
pkg upgrade
pkg install openssh mosh
ssh-keygen -t ed25519 -C "pixel"
cat ~/.ssh/id_ed25519.pubTermux zawiera pakiety OpenSSH oraz mosh w swoim repozytorium, dzięki czemu ssh, ssh-keygen oraz mosh działają w sposób typowy dla systemów desktopowych. Należy dodać wyświetlony klucz publiczny do pliku ~/.ssh/authorized_keys na serwerze, a następnie nawiązać połączenie za pomocą mosh you@server.
Ekranowa klawiatura systemu Android nie posiada klawiszy Esc oraz Ctrl, które są niezbędne do pracy z Claude Code. Termux umożliwia wyświetlenie własnego paska klawiszy. W tym celu należy dodać poniższą linię do pliku ~/.termux/termux.properties:
extra-keys = [['ESC','|','/','HOME','UP','END','PGUP'],['TAB','CTRL','ALT','LEFT','DOWN','RIGHT','PGDN']]Następnie należy wykonać termux-reload-settings, co spowoduje wyświetlenie paska nad klawiaturą. To samo polecenie przeładowania konfiguracji wczytuje czcionkę o stałej szerokości znaków (TrueType), umieszczoną w lokalizacji ~/.termux/font.ttf.
System Android może zatrzymać proces Termux działający w tle, jednak w tym przypadku skutkuje to jedynie koniecznością ponownego połączenia. Sesja oraz agent pozostają aktywne na serwerze.
Dlaczego terminal zawiesza się po wyjściu z zasięgu Wi-Fi i co naprawia mosh?
Połączenie SSH to połączenie TCP (transmission control protocol), które jest identyfikowane przez oba adresy oraz oba porty. Wyjście poza zasięg Wi-Fi powoduje, że telefon otrzymuje nowy adres z sieci komórkowej, przez co stare połączenie przestaje być rozpoznawane przez obie strony. Żaden mechanizm nie informuje o tym fakcie. Terminal po prostu przestaje odpowiadać, dopóki protokół TCP nie przerwie połączenia, po czym ssh wyświetla client_loop: send disconnect: Broken pipe. Aby natychmiast przerwać zawieszoną sesję, należy nacisnąć Enter, następnie ~, a na końcu ..
mosh (mobile shell) eliminuje ten problem. Narzędzie używa SSH jednorazowo do zalogowania się i uruchomienia procesu mosh-server, odczytuje port UDP (user datagram protocol) wybrany przez serwer i zamyka połączenie SSH. Następnie obie strony wymieniają datagramy UDP uwierzytelnione wspólnym kluczem sesji, dzięki czemu sesja jest identyfikowana za pomocą tego klucza, a nie adresu IP. Zmiana adresu nie przerywa połączenia. mosh dodatkowo lokalnie wyświetla wpisywane znaki i odświeża ekran, gdy stan serwera różni się od lokalnego, co zapewnia płynność działania przy wolnych łączach mobilnych.
mosh korzysta z portów UDP z zakresu od 60000 do 61000, dlatego należy odblokować ten zakres:
sudo ufw allow 60000:61000/udp
sudo ufw statusOtwieranie portów za pomocą ufw zawiera pozostałe informacje dotyczące zapory sieciowej. Jeśli dostawca oferuje zewnętrzną zaporę sieciową w panelu sterowania, należy dodać ten sam zakres również tam, ponieważ reguła ufw nie wpływa na filtry działające przed maszyną.
Występują dwa typowe problemy z mosh. Logowanie, które kończy się sukcesem, a następnie zawiesza z komunikatem Nothing received from server on UDP port 60001., oznacza, że mosh-server zostało uruchomione, ale klient nie może połączyć się z serwerem na danym porcie UDP. Zazwyczaj oznacza to, że zapora sieciowa między telefonem a serwerem blokuje ruch UDP w zakresie mosh. Błąd informujący, że mosh-server nie został znaleziony, oznacza, że pakiet nie jest zainstalowany na serwerze lub nie znajduje się w PATH użytkownika. Należy go zainstalować lub wskazać bezpośrednio za pomocą mosh --server=/usr/bin/mosh-server you@server.
Jeśli locale użytkownika na serwerze nie jest ustawione na UTF-8, mosh-server podejmuje próbę użycia ustawień locale dostarczonych przez klienta i sprawdza ponownie. Narzędzie odmawia uruchomienia tylko wtedy, gdy również ta próba nie zapewnia UTF-8, zgłaszając mosh-server needs a UTF-8 native locale to run.. W takim przypadku należy najpierw naprawić locale na serwerze.
locale
sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8Obie strony wymagają locale UTF-8, a mosh-server dodatkowo stosuje ustawienia locale przesyłane przez klienta. Jeśli błąd nadal występuje po naprawie na serwerze, należy ustawić LANG na wartość UTF-8 również w aplikacji terminala na telefonie, co zgodnie z FAQ mosh mosh-client może być konieczne.
Istnieją dwie funkcje, których mosh nie obsługuje. Zgodnie z plikiem README, mosh nie wspiera przekierowania X ani nieinteraktywnych zastosowań SSH, w tym przekierowania portów, dlatego podgląd aplikacji webowej uruchomionej przez Claude Code nadal wymaga użycia standardowego ssh -L 8080:127.0.0.1:8080 you@server. Narzędzie synchronizuje tylko widoczny obszar ekranu, więc nie posiada własnego bufora przewijania. To ograniczenie nie stanowi problemu, ponieważ bufor zapewnia tmux: Ctrl-b, a następnie [ uruchamia tryb kopiowania, przewijanie odbywa się za pomocą myszy lub klawiszy strzałek, a q kończy działanie.
Dostosowanie ekranu telefonu do pracy
Cztery linie w ~/.tmux.conf na serwerze wykonują większość pracy:
set -g mouse on
set -g status-position top
set -g default-terminal "tmux-256color"
set -g history-limit 20000mouse on zamienia przeciągnięcie dotykiem na przewijanie, a stuknięcie na wybór panelu lub okna, co zastępuje większość niewygodnych w wpisywaniu klawiszy prefiksu. status-position top przesuwa linię statusu tmux z dolnej krawędzi, gdzie jest zasłaniana przez klawiaturę ekranową i pasek sugestii. default-terminal przypina nazwę terminala, którą tmux zgłasza do Claude Code. Bez tej linii tmux zgłasza nazwę wybraną podczas kompilacji. Skrypt konfiguracyjny tmux 3.4 zaczyna od screen, następnie testuje screen-256color, tmux oraz tmux-256color w tej kolejności, a nieudany test pozostawia poprzedni wybór. Kompilacja, która nie znalazła wpisu terminfo tmux-256color, kończy się zatem użyciem tmux, screen-256color lub zwykłego screen, co może skutkować gorszym wyświetlaniem kolorów i ramek niż to konieczne.
Opanuj cztery klawisze, a reszta będzie wygodna.
Escprzerywa Claude w trakcie odpowiedzi i zachowuje wykonaną pracę, więc jest to klawisz, który powinien znajdować się najbliżej kciuka.Ctrl+Crównież przerywa działającą operację. W stanie bezczynności pierwsze naciśnięcie czyści wpis, a drugie zamyka Claude Code, jest to więc bardziej radykalne narzędzie.Escnaciśnięty dwukrotnie czyści szkic zapytania, a przy pustym wierszu otwiera menu przewijania.- W przypadku wieloliniowego zapytania wpisz
\, a następnie Enter. Ta forma działa w każdym terminalu. Shift+Enter jest natywnie obsługiwany tylko w krótkiej liście terminali desktopowych, do której klienci mobilni nie należą.
Unikaj dzielenia paneli. Telefon w orientacji pionowej ma około 40 kolumn szerokości, więc podział poziomy (Ctrl-b %, panele obok siebie) pozostawia 20 kolumn na panel, co powoduje, że każdy diff staje się nieczytelny przez zawijanie wierszy. Podział pionowy (Ctrl-b ") zachowuje pełną szerokość, ale układa panele jeden na drugim, co zmniejsza o połowę liczbę linii widocznych nad klawiaturą ekranową. Używaj okien tmux: Ctrl-b c tworzy nowe okno, a Ctrl-b n przechodzi do następnego. Jeśli w drugim oknie uruchomiona jest osobna sesja Claude Code, obie sesje mogą bezpośrednio przekazywać sobie pracę, zamiast ręcznego kopiowania tekstu między oknami na ekranie dotykowym. Obróć telefon do orientacji poziomej, gdy musisz poprawnie odczytać diff.
Ilość tekstu wyświetlanego na ekranie warto ustawić świadomie, ponieważ styl wyjściowy edytuje prompt systemowy dla każdej odpowiedzi, a bardziej zwięzły styl oznacza mniej ekranów do przewijania na telefonie.
Długa sesja na małym ekranie to głównie problem kontekstu, dlatego zarządzanie oknem kontekstu Claude Code warto przeczytać przed próbą wykonania całodniowej pracy z pociągu.
Zabezpieczenie: tylko klucze, bez haseł
Telefon przechowuje teraz klucz do maszyny, która edytuje kod i wykonuje polecenia. Wyłącz uwierzytelnianie hasłem. Plik typu drop-in jest bezpieczniejszy niż bezpośrednia edycja sshd_config, ponieważ sshd_config w systemie Ubuntu zawiera na początku /etc/ssh/sshd_config.d/*.conf, a używana jest pierwsza znaleziona wartość ustawienia.
sudo tee /etc/ssh/sshd_config.d/00-phone.conf >/dev/null <<'EOF'
PasswordAuthentication no
KbdInteractiveAuthentication no
PubkeyAuthentication yes
PermitRootLogin no
EOF
sudo sshd -t && sudo systemctl reload sshPliki drop-in są odczytywane w kolejności nazw plików. Sprawdź sudo sshd -T pod kątem passwordauthentication no, kbdinteractiveauthentication no, pubkeyauthentication yes oraz permitrootlogin no; wcześniejszy plik ustawiający jedną z tych wartości ma pierwszeństwo i wymaga poprawy w tym miejscu.
sshd -t analizuje konfigurację i nie wyświetla niczego, jeśli jest ona poprawna. Pominięcie tego kroku sprawi, że jeden błąd w pisowni spowoduje niepowodzenie sshd przy przeładowaniu. Pozostaw aktywną bieżącą sesję i przetestuj połączenie z drugiego terminala przed zamknięciem czegokolwiek, ponieważ błędny klucz skutkuje Permission denied (publickey)., a przy wyłączonych hasłach nie ma możliwości powrotu. Ścieżką odzyskiwania jest w takim przypadku konsola dostawcy. Jeśli testowe połączenie nie powiedzie się, połącz się ponownie za pomocą ssh -v i rozwiąż problem, dopóki pierwsza sesja pozostaje otwarta, ponieważ ten jeden komunikat o błędzie obejmuje pięć różnych usterek, a szczegółowe wyjście wskaże, która z nich występuje.
Nadaj każdemu urządzeniu własny klucz. Utrata telefonu oznacza wtedy usunięcie jednej linii z ~/.ssh/authorized_keys, a laptop nadal działa. Współdzielony klucz oznacza konieczność zmiany klucza na każdym posiadanym urządzeniu.
Jeśli przenosisz SSH na inny port w Ubuntu 24.04, pamiętaj, że proces nasłuchujący należy do ssh.socket. Generator systemd tworzy to gniazdo na podstawie linii Port w konfiguracji SSH, więc nie potrzebujesz nadpisania ListenStream, ale sam restart ssh pozostawi serwer nasłuchujący na porcie 22. Umieść linię Port w pliku drop-in, zezwól na nowy port w ufw, a następnie uruchom sudo systemctl daemon-reload, a po nim sudo systemctl restart ssh.socket. Hardening SSH on a VPS omawia to oraz pozostałe aspekty powierzchni ataku.
fail2ban for SSH dodaje niewiele bezpieczeństwa po wyłączeniu haseł, ponieważ odgadnięte hasło i tak nie może zostać zaakceptowane. Zapewnia natomiast czystsze logi, co ułatwia zauważenie rzeczywistej próby logowania.
Silniejszą opcją jest utrzymywanie SSH poza publicznym Internetem. Umieść serwer za samodzielnie hostowanym VPN WireGuard, uruchamiaj tunel na telefonie na żądanie i skonfiguruj sshd z ListenAddress tylko na interfejsie tunelu. mosh działa przez tunel, ponieważ obie strony korzystają z UDP. Uwaga: tunel dodaje narzut pakietowy, więc jeśli duże transfery zwalniają, obniż MTU (maximum transmission unit) w konfiguracji WireGuard na telefonie.
Ostatnia uwaga dotycząca pracy w ten sposób. Z poziomu telefonu zatwierdzasz monity o uprawnienia na ekranie wyświetlającym jednocześnie tylko kilka linii różnic (diff). Jest to powód, by zachować zabezpieczenia, a nie je wyłączać. Sprawdź również, w jakim trybie uprawnień uruchamiają się sesje, ponieważ tryb auto jest teraz domyślnym trybem startowym dla interaktywnych sesji terminalowych w Claude Code v2.1.283 i wprowadza on edycje plików w katalogu roboczym bez pytania o zgodę. Running Claude Code safely on a VPS omawia limity użytkownika i katalogów, które warto ustawić, zanim głównym sposobem dostępu stanie się ekran dotykowy.
Gdy po ponownym podłączeniu wystąpi problem
Wyświetlenie tmux attach printing no server running on /tmp/tmux-1000/default oznacza, że tmux nie znalazł serwera na tym gnieździe. Zazwyczaj serwer nie istnieje, co prawie zawsze oznacza, że maszyna została zrestartowana. Sprawdź to za pomocą uptime. Jeśli serwer nie został zrestartowany, a pgrep tmux nadal pokazuje działający serwer, nie oznacza to automatycznie, że plik gniazda został usunięty, ponieważ flagi -L oraz -S pozwalają serwerowi nasłuchiwać na innym gnieździe. Jeśli tmux został uruchomiony z jedną z nich, należy przekazać tę samą flagę do tmux attach. Jeśli gniazdo faktycznie zostało przypadkowo usunięte, pkill -USR1 tmux wymusza na serwerze jego odtworzenie, co według dokumentacji tmux kończy się niepowodzeniem, jeśli brakuje któregokolwiek z katalogów nadrzędnych. Aktualizacje jądra pochodzące z automatycznych aktualizacji bezpieczeństwa wymagają restartu, aby weszły w życie, jednak unattended-upgrades wykonuje restart automatycznie tylko wtedy, gdy Unattended-Upgrade::Automatic-Reboot jest włączone; wartością domyślną jest false. Zrestartowana maszyna nie posiada sesji tmux, więc każde uruchomienie Claude Code należy traktować jako proces, który można zrestartować.
can't find session: claude to inny przypadek. Serwer tmux działa, ale sesja o tej nazwie nie istnieje. tmux ls pokazuje, jakie sesje są dostępne.
Jeśli po podłączeniu widoczny jest zwykły znak zachęty powłoki w miejscu, gdzie powinien być Claude Code, oznacza to, że proces zakończył się bez zamykania sesji. Należy sprawdzić dmesg -T | tail pod kątem wpisu takiego jak Out of memory: Killed process 4821 (claude), co potwierdza zakończenie procesu przez mechanizm out-of-memory. Należy sprawdzić historię przewijania powłoki powyżej znaku zachęty w poszukiwaniu innych komunikatów o wyjściu.
Okno, które powraca w niewłaściwym rozmiarze, przycięte przy krawędzi lub z niewykorzystaną przestrzenią wokół, oznacza, że dwóch klientów jest podłączonych przy różnych rozmiarach ekranu. Domyślnie tmux 3.4 dopasowuje rozmiar okna do klienta z najnowszą aktywnością (window-size latest), więc laptop, wciąż podłączony z szerokością 200 kolumn, oraz telefon z szerokością 40 kolumn na zmianę zmieniają jego rozmiar. Należy odłączyć pozostałych klientów podczas podłączania: tmux attach -d -t claude.
FAQ
Czy mogę uruchomić Claude Code bezpośrednio na telefonie zamiast na VPS?
Interfejs CLI nie jest obsługiwany na systemach Android ani iOS. Obsługiwane platformy na listopad 2026 to macOS, Windows, Ubuntu 20.04 lub nowsze, Debian 10 lub nowsze oraz Alpine 3.19 lub nowsze, wymagające co najmniej 4 GB pamięci RAM. Systemy Android i iOS nie znajdują się na tej liście. Ponadto telefon usypia aplikacje i stale zmienia adres sieciowy, co uniemożliwia długotrwałe działanie agenta. Należy uruchomić narzędzie na serwerze, wykorzystując telefon jedynie jako wyświetlacz.
Czy sesja przetrwa zamknięcie aplikacji lub utratę sygnału?
Tak, za utrzymanie sesji odpowiadają dwa niezależne mechanizmy. tmux utrzymuje proces na serwerze, dzięki czemu nic nie zostaje przerwane po zakończeniu połączenia. mosh utrzymuje samo połączenie podczas zmiany adresu, więc przełączenie z Wi-Fi na dane mobilne nie wymaga ponownego logowania. W przypadku zwykłego SSH bez tmux, zerwanie połączenia wysyła sygnał SIGHUP, co powoduje zatrzymanie Claude Code w trakcie zadania.
Dlaczego mosh łączy się, ale nic nie wyświetla?
Logowanie, które kończy się sukcesem, a następnie zawiesza z Nothing received from server on UDP port 60001., oznacza, że klient nie może uzyskać dostępu do mosh-server na danym porcie UDP. Zazwyczaj oznacza to, że firewall blokuje zakres UDP od 60000 do 61000. Należy dodać ten zakres w ufw oraz w firewallu sieciowym dostawcy, który w większości paneli zarządzania stanowi oddzielną konfigurację. Jeśli mosh zgłasza, że nie znaleziono mosh-server, oznacza to, że na serwerze brakuje pakietu lub ścieżka logowania PATH go nie uwzględnia: należy zainstalować go za pomocą sudo apt install mosh lub użyć mosh --server=/usr/bin/mosh-server you@server.
Jak przerwać działanie Claude Code z klawiatury bez klawisza Esc?
Należy dodać pasek klawiszy funkcyjnych. Termux konfiguruje go za pomocą extra-keys w pliku ~/.termux/termux.properties, natomiast Termius i Blink oferują pasek, który można edytować w ustawieniach. Skrót Esc przerywa trwającą odpowiedź, zachowując już wykonaną pracę. Ctrl+C również przerywa działanie, jednak dwukrotne naciśnięcie tego klawisza w stanie bezczynności powoduje wyjście z Claude Code, dlatego w pierwszej kolejności należy korzystać z Esc.
Czy wystawienie SSH na świat jest wystarczająco bezpieczne?
Przy wyłączonym uwierzytelnianiu hasłem, jedynym skutecznym poświadczeniem jest klucz, który nigdy nie opuszcza urządzeń użytkownika. Jest to akceptowalne ryzyko w przypadku maszyny, którą można łatwo odtworzyć. Każde urządzenie powinno posiadać własny klucz, dzięki czemu w razie zgubienia telefonu wystarczy usunąć jedną linię w authorized_keys. Jeśli użytkownik woli nie wystawiać portu publicznie, należy umieścić serwer za WireGuard i skonfigurować sshd tak, aby nasłuchiwał na adresie tunelu.