Czego się nauczysz

Ten przewodnik przeprowadzi Cię przez każdą metodę zdalnego korzystania z Claude Code — od oficjalnej funkcji Remote Control od Anthropic po samodzielne konfiguracje SSH z wykorzystaniem tmux, mosh i Tailscale. Do końca lektury będziesz posiadać działające mobilne środowisko programistyczne, w którym możesz rozpocząć zadania na komputerze stacjonarnym, opuścić biuro i zachować pełną kontrolę ze swojego telefonu.

Claude Code Remote Control: Kompletny przewodnik na rok 2026

February 25, 2026 Anthropic udostępniło Remote Control — możliwość rozpoczęcia zadania programistycznego w terminalu, schowania laptopa do torby i zachowania pełnej kontroli z telefonu. Bez VPN, bez przekierowywania portów i bez narzędzi zewnętrznych. Source

Ale oficjalna funkcja to tylko część historii. Społeczność programistów zbudowała cały ekosystem mobilnych konfiguracji wokół Claude Code, od prostych tuneli SSH po wyrafinowane przepływy pracy z wieloma narzędziami, powiadomieniami push i wprowadzaniem głosowym. Ten przewodnik obejmuje je wszystkie.

Część 1: Oficjalne Remote Control

Co to jest

Remote Control to wbudowana funkcja Anthropic służąca do kontynuowania sesji Claude Code na różnych urządzeniach. Działa ona poprzez zarejestrowanie lokalnej instancji Claude Code w Anthropic API jako serwera, co pozwala autoryzowanym klientom (Twojemu telefonowi) na łączenie się i zdalne sterowanie sesją. Source

Jak to działa pod maską

Model bezpieczeństwa jest prosty i konserwatywny:

Twój komputer (Claude Code)          Anthropic API           Twój telefon (Aplikacja Claude)
        │                                │                          │
        ├──── Rejestracja sesji ─────────►│                          │
        │                                │                          │
        │◄─── Przypisanie URL sesji ─────┤                          │
        │                                │                          │
        │     Wyświetlenie kodu QR       │                          │
        │                                │◄─── Skanowanie QR / Auth ──┤
        │                                │                          │
        │◄─── Przesyłanie wiadomości ────┤─── Przesyłanie wiadomości ─►│
        │                                │                          │
        │     (Cały ruch przez TLS)      │                          │

Kluczowe właściwości bezpieczeństwa:

• Brak portów przychodzących — Twoja lokalna maszyna wykonuje wyłącznie wychodzące żądania HTTPS.
• Brak bezpośredniego połączenia — Twój telefon nigdy nie łączy się bezpośrednio z komputerem.
• Szyfrowanie TLS — cały ruch przepływa przez Anthropic API za pośrednictwem TLS.
• Zakres sesji — każda sesja Remote Control posiada unikalny adres URL, który wygasa.

Source

Kroki konfiguracji

Krok 1: Zaktualizuj Claude Code

Remote Control wymaga Claude Code v2.1.51 lub nowszej:

# Check your version
claude --version

# Update if needed
npm update -g @anthropic-ai/claude-code

Krok 2: Rozpocznij sesję

Zacznij normalnie pracować nad projektem:

cd ~/projects/my-app
claude

Krok 3: Włącz Remote Control

Wewnątrz sesji Claude Code uruchom:

/rc
# or
/remote-control

Spowoduje to uruchomienie serwera Remote Control. W terminalu wyświetli się:

Remote Control active
Session URL: https://code.claude.com/rc/abc123-def456
Press [space] to show QR code
Press [q] to stop Remote Control

Krok 4: Połącz się z telefonu

Dwie opcje:

1. Kod QR: Naciśnij spację w terminalu, aby wyświetlić kod QR. Otwórz aplikację Claude na telefonie i zeskanuj go.
2. URL: Skopiuj adres URL sesji i otwórz go w aplikacji Claude na telefonie.

Twój telefon ma teraz pełną kontrolę nad sesją Claude Code. Możesz wysyłać wiadomości, zatwierdzać zmiany w plikach i przeglądać wyniki — rozmowa pozostaje zsynchronizowana na wszystkich połączonych urządzeniach. Source

Domyślne włączanie Remote Control

Jeśli często korzystasz z Remote Control, włącz go dla wszystkich sesji:

/mobile

Spowoduje to wyświetlenie kodu QR do instalacji aplikacji Claude (jeśli jeszcze jej nie masz) i przełączy ustawienie „Enable Remote Control for all sessions” na true. Po włączeniu każda sesja Claude Code automatycznie uruchamia się w trybie Remote Control. Source

Wymagania planu

Source

Ograniczenia Remote Control

• Wymaga aplikacji Claude — nie można używać zwykłej przeglądarki; wymagana jest aplikacja mobilna Claude.
• Zależność od Anthropic — cały ruch przechodzi przez serwery Anthropic; jeśli ich API nie działa, Remote Control również nie będzie działać.
• Brak obsługi offline — oba urządzenia muszą mieć połączenie z Internetem.
• Limit czasu sesji — nieaktywne sesje ostatecznie wygasają.
• Pojedynczy dostawca — działa tylko z modelami Claude, a nie w przypadku korzystania z OpenCode lub innych narzędzi obsługujących wielu dostawców.

Część 2: SSH + tmux + mosh (Podejście DIY)

Dla programistów, którzy chcą pełnej kontroli nad terminalem, wsparcia dla wielu dostawców lub pracują w niestabilnych sieciach, podejście oparte na SSH jest bardziej solidne. Jak napisał programista Harper Reed: „Zastanawiając się, jak używać Claude Code na telefonie, oczywistą odpowiedzią było połączenie się przez ssh z komputerem z telefonu i uruchomienie claude”. Source

Dlaczego trzy narzędzia?

Potrzebujesz dwóch różnych rodzajów odporności:

• mosh obsługuje niestabilne połączenie mobilne — przejścia między WiFi a siecią komórkową, martwe strefy, uśpienie telefonu.
• tmux obsługuje trwałość sesji — utrzymuje sesję Claude Code przy życiu, nawet gdy telefon całkowicie się rozłączy.

Razem sprawiają, że programowanie mobilne staje się realne. Source

Konfiguracja stosu

Krok 1: Zainstaluj Tailscale (Prywatna sieć)

Tailscale tworzy prywatną sieć WireGuard mesh pomiędzy Twoimi urządzeniami. Bez przekierowywania portów, bez konfiguracji routera, bez reguł zapory ogniowej.

Na komputerze stacjonarnym:

# macOS
brew install tailscale

# Linux
curl -fsSL https://tailscale.com/install.sh | sh

# Start Tailscale
sudo tailscale up

Na telefonie:

• Zainstaluj aplikację Tailscale ze sklepu z aplikacjami.
• Zaloguj się na to samo konto.
• Oba urządzenia są teraz w tej samej prywatnej sieci.

Twój komputer otrzyma adres IP Tailscale (coś w rodzaju 100.64.x.x), do którego Twój telefon może dotrzeć bezpośrednio, niezależnie od tego, w jakiej sieci WiFi lub komórkowej znajdują się urządzenia. Source

Krok 2: Zainstaluj tmux (Trwałość sesji)

tmux utrzymuje sesje terminala przy życiu niezależnie od połączenia SSH. Gdy telefon się rozłączy (blokada ekranu, zmiana sieci, rozładowana bateria), sesja tmux nadal działa.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

Utwórz konfigurację tmux zoptymalizowaną pod kątem urządzeń mobilnych:

# ~/.tmux.conf

# Increase scrollback buffer
set -g history-limit 50000

# Enable mouse support (useful on mobile)
set -g mouse on

# Reduce escape-time for responsive mobile input
set -sg escape-time 10

# Status bar with useful info
set -g status-right '#H | %H:%M'

# Larger status bar for mobile readability
set -g status-style 'bg=colour235 fg=colour136'

Krok 3: Zainstaluj mosh (Odporność połączenia)

mosh (Mobile Shell) używa protokołu UDP zamiast TCP, co pozwala na płynną obsługę zmian sieci. Gdy telefon przełącza się z WiFi na sieć komórkową lub przejeżdża przez tunel, mosh automatycznie wznawia połączenie.

Na komputerze stacjonarnym:

# macOS
brew install mosh

# Ubuntu/Debian
sudo apt install mosh

Na telefonie:

• iOS: Zainstaluj Blink Shell lub Termius — oba natywnie obsługują mosh.
• Android: Zainstaluj JuiceSSH lub Termux z pakietem mosh.

Krok 4: Połącz się i uruchom Claude Code

Z klienta SSH na telefonie:

# Connect via mosh through Tailscale
mosh user@100.64.x.x

# Start or attach to a tmux session
tmux new-session -s claude
# or if session already exists:
tmux attach -t claude

# Launch Claude Code
cd ~/projects/my-app
claude

Teraz masz sesję Claude Code, która:

• Przetrwa zmiany sieci (mosh).
• Przetrwa rozłączenia telefonu (tmux).
• Jest dostępna z każdego urządzenia w sieci Tailscale.
• Współpracuje z każdym dostawcą AI, nie tylko z Claude.

Ponowne łączenie po rozłączeniu

Gdy później sięgniesz po telefon:

# mosh will auto-reconnect if the session is still alive
# If mosh session died, start a new one:
mosh user@100.64.x.x

# Reattach to your tmux session
tmux attach -t claude

Twoja sesja Claude Code jest dokładnie w tym samym miejscu, w którym została przerwana — ta sama rozmowa, ten sam katalog roboczy, te same oczekujące zmiany.

Część 3: Powiadomienia push z ntfy

Problemem zarówno Remote Control, jak i konfiguracji SSH jest to, że musisz ciągle sprawdzać telefon, aby dowiedzieć się, czy Claude Code zakończył zadanie. Rozwiązaniem są powiadomienia push.

Co to jest ntfy?

ntfy to prosta usługa powiadomień push typu open-source. Możesz ją hostować samodzielnie dla zachowania prywatności lub korzystać z publicznej instancji pod adresem ntfy.sh. Source

Samodzielnie hostowane ntfy z Tailscale

Dla maksymalnej prywatności uruchom ntfy na swoim komputerze stacjonarnym i uzyskuj do niego dostęp przez Tailscale:

# Install ntfy
brew install ntfy  # macOS
# or
sudo apt install ntfy  # Linux

# Start ntfy server (it listens on port 80 by default)
ntfy serve --listen-http :8090

Ponieważ Twój telefon i komputer znajdują się w tej samej sieci Tailscale, Twój telefon może połączyć się z ntfy pod adresem http://100.64.x.x:8090. Żadne dane nie opuszczają Twojej prywatnej sieci.

Konfiguracja hooków Claude Code

Hooki Claude Code pozwalają na wyzwalanie niestandardowych poleceń w przypadku wystąpienia określonych zdarzeń. Skonfiguruj hook, aby wysyłać powiadomienie, gdy Claude Code wymaga interakcji:

// ~/.claude/settings.json
{
  "hooks": {
    "notification": {
      "command": "curl -s -d 'Claude Code needs your attention' http://100.64.x.x:8090/claude-code",
      "event": "stop"
    }
  }
}

Source

Konfiguracja aplikacji mobilnej ntfy

1. Zainstaluj aplikację ntfy na telefonie (iOS lub Android).
2. Dodaj subskrypcję do tematu claude-code na swoim serwerze (http://100.64.x.x:8090/claude-code).
3. Włącz powiadomienia push dla tego tematu.

Teraz za każdym razem, gdy Claude Code zatrzyma się i będzie wymagał Twojej reakcji — niezależnie od tego, czy zakończył zadanie, napotkał błąd, czy potrzebuje zatwierdzenia — otrzymasz powiadomienie push na telefon. Nie ma potrzeby utrzymywania otwartego terminala ani ciągłego sprawdzania.

Zaawansowana konfiguracja powiadomień

Aby uzyskać powiadomienia bogatsze w kontekst, możesz dołączyć ostatnią wiadomość z Claude Code:

#!/bin/bash
# ~/.claude/hooks/notify.sh

# Get the last few lines of Claude Code output
LAST_OUTPUT=$(tail -5 /tmp/claude-code-output.log 2>/dev/null || echo "Task completed")

# Send notification with context
curl -s \
  -H "Title: Claude Code" \
  -H "Priority: high" \
  -H "Tags: robot" \
  -d "$LAST_OUTPUT" \
  http://100.64.x.x:8090/claude-code

Source

Część 4: Happy Coder (Bezpłatna alternatywa open-source)

Happy Coder to bezpłatne narzędzie open-source, które zapewnia interfejs internetowy do zdalnego sterowania Claude Code, z wbudowanymi powiadomieniami push i wprowadzaniem głosowym. Source

Kluczowe funkcje

• Darmowe i open-source — brak wymaganej subskrypcji poza planem Claude Code.
• Powiadomienia push — wbudowany system powiadomień, brak konieczności konfiguracji ntfy.
• Wprowadzanie głosowe — wypowiadaj polecenia zamiast pisać na małym ekranie.
• Obsługa wielu agentów — współpracuje z Codex obok Claude Code.
• Dostęp przez przeglądarkę — działa w każdej przeglądarce mobilnej, bez konieczności instalowania aplikacji.

Konfiguracja

# Install Happy Coder
npm install -g happy-coder

# Start the server
happy-coder start --port 3000

# Access from your phone via Tailscale
# http://100.64.x.x:3000

Happy Coder zapewnia zoptymalizowany pod kątem urządzeń mobilnych interfejs webowy, który wyświetla rozmowę Claude Code, umożliwia wysyłanie wiadomości i pokazuje zmiany w plikach — wszystko za pośrednictwem przeglądarki.

Część 5: Porównanie kompletnych konfiguracji

Matryca porównawcza metod

Rekomendowana konfiguracja według przypadku użycia

Użytkownik okazjonalny (sprawdza zadania od czasu do czasu): → Remote Control. Jedno polecenie, jeden skan QR i gotowe.

Codzienny programista mobilny (często koduje z telefonu): → SSH + tmux + mosh + ntfy. Maksymalna odporność i kontrola.

Lider zespołu (monitoruje wiele sesji): → Happy Coder. Oparty na przeglądarce, obsługuje wielu agentów, wbudowane powiadomienia.

Programista korzystający z wielu dostawców (używa Claude, Codex i modeli lokalnych): → SSH + tmux + mosh. Działa z każdym narzędziem uruchamianym w terminalu.

Część 6: Zaawansowane konfiguracje

Uruchamianie wielu sesji Claude Code

Dzięki tmux możesz uruchamiać wiele sesji Claude Code równolegle i przełączać się między nimi:

# Create named sessions for different projects
tmux new-session -d -s project-api
tmux new-session -d -s project-frontend
tmux new-session -d -s project-tests

# In each session, navigate and start Claude Code
tmux send-keys -t project-api 'cd ~/projects/api && claude' C-m
tmux send-keys -t project-frontend 'cd ~/projects/frontend && claude' C-m
tmux send-keys -t project-tests 'cd ~/projects/tests && claude' C-m

# From your phone, switch between sessions
tmux switch-client -t project-api
tmux switch-client -t project-frontend

Konfiguracja na bezgłowym systemie Linux (Headless VM)

Dla zespołów, które chcą dedykowanego zdalnego środowiska programistycznego, Claude Code Remote Control działa na maszynach wirtualnych Linux bez interfejsu graficznego poprzez SSH + tmux. Source

# On your cloud VM (AWS, GCP, etc.)
# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Start in a tmux session
tmux new-session -s remote-claude

# Launch Claude Code
claude

# Start Remote Control
/rc

Następnie zeskanuj kod QR z telefonu. Daje to potężne, oparte na chmurze środowisko programistyczne sterowane w całości z urządzenia mobilnego.

Łączenie Remote Control z SSH

Możesz używać obu metod jednocześnie dla uzyskania maksymalnej elastyczności:

1. SSH + tmux dla trwałości sesji i pełnego dostępu do terminala.
2. Remote Control wewnątrz sesji tmux dla przyjaznego interfejsu czatu mobilnego.

# SSH into your machine
mosh user@100.64.x.x

# Attach to tmux
tmux attach -t claude

# Inside the session, Claude Code is running
# Enable Remote Control for phone access
/rc

Teraz masz:

• tmux utrzymujący sesję przy życiu.
• mosh zapewniający stabilne połączenie SSH.
• Remote Control dostarczający dopracowany interfejs mobilny.
• Pełny dostęp do terminala, gdy go potrzebujesz.

Część 7: Tworzenie aplikacji podczas przemieszczania się

Mobilny przepływ pracy programistycznej

Połączenie Claude Code + zdalny dostęp fundamentalnie zmienia to, kiedy i gdzie możesz być produktywny. Praktyczny przepływ pracy:

1. Poranny dojazd: Przejrzyj nocne wyniki CI na telefonie, zleć poprawki poprzez Remote Control.
2. Przerwa na lunch: Sprawdź postępy za pomocą powiadomień ntfy, zatwierdź lub skoryguj zmiany.
3. Wieczór: Otwórz laptopa, a sesja tmux będzie dokładnie w tym samym miejscu, w którym ją zostawiłeś.

Kiedy kodowanie mobilne ma sens

Kodowanie mobilne przez Claude Code najlepiej sprawdza się w przypadku:

• Inicjowania zadań — opisz, co chcesz zbudować, i pozwól Claude Code pracować, gdy Cię nie ma.
• Przeglądu kodu — czytaj różnice w plikach i zatwierdzaj zmiany z telefonu.
• Triage'u błędów — badaj problemy i nakieruj Claude Code na poprawki.
• Monitorowania postępów — sprawdzaj długo trwające zadania.

Mniej nadaje się do:

• Złożonego debugowania — małe ekrany sprawiają, że czytanie zrzutów stosu jest uciążliwe.
• Pracy wizualnej — poprawki CSS i układu wymagają pełnego ekranu.
• Refaktoryzacji na dużą skalę — obszerne zmiany lepiej przeglądać na właściwym monitorze.

Budowanie z ZBuild z dowolnego miejsca

Dla programistów, którzy chcą budować i iterować aplikacje będąc w ruchu, platformy takie jak ZBuild uzupełniają zdalny przepływ pracy Claude Code. ZBuild zapewnia wizualny kreator aplikacji, który dobrze działa na tabletach i może być sparowany z Claude Code w celu obsługi bardziej złożonej logiki backendowej — dając Ci możliwość programowania full-stack, która nie wymaga stacjonarnej stacji roboczej.

Część 8: Rozwiązywanie problemów

Typowe problemy i rozwiązania

Problem: „Remote Control not available on your plan” Rozwiązanie: Sprawdź, czy posiadasz plan Pro, Max, Team lub Enterprise. Warstwa Free nie obsługuje Remote Control.

Problem: Kod QR się nie skanuje Rozwiązanie: Upewnij się, że aplikacja Claude jest zaktualizowana do najnowszej wersji. Spróbuj użyć adresu URL sesji bezpośrednio zamiast skanowania.

Problem: Połączenie mosh zostaje zerwane i nie łączy się ponownie Rozwiązanie: Sprawdź, czy mosh-server działa na Twoim komputerze (which mosh-server). Upewnij się, że Tailscale jest połączony na obu urządzeniach. Jeśli nie używasz Tailscale, upewnij się, że porty UDP 60000-61000 są otwarte.

Problem: Sesja tmux pokazuje pusty ekran po ponownym połączeniu Rozwiązanie: Uruchom tmux attach -t claude zamiast tworzyć nową sesję. Jeśli sesja wygasła, sprawdź, czy Claude Code uległ awarii, przeglądając logi w ~/.claude/logs/.

Problem: Powiadomienia ntfy nie dochodzą Rozwiązanie: Sprawdź, czy serwer ntfy działa (curl http://100.64.x.x:8090/health). Upewnij się, że URL subskrypcji w aplikacji ntfy zgadza się z adresem serwera. Sprawdź, czy połączenie Tailscale w telefonie jest aktywne.

Problem: Sesja Claude Code wygasła, gdy telefon był rozłączony Rozwiązanie: Dzieje się tak z Remote Control po dłuższej bezczynności. Użyj konfiguracji opartej na tmux dla sesji, które muszą trwać wiele godzin. Sesje tmux trwają w nieskończoność, niezależnie od połączeń klientów.

Problem: Pisanie na telefonie jest powolne Rozwiązanie: Użyj wprowadzania głosowego (Happy Coder) lub twórz krótkie, zadaniowe komunikaty. Alternatywnie przygotuj prompty w aplikacji do notatek i wklej je do terminala.

Część 9: Kwestie bezpieczeństwa

Bezpieczeństwo Remote Control

• Cały ruch jest szyfrowany przez TLS za pośrednictwem Anthropic API.
• Adresy URL sesji są unikalne i wygasają po użyciu.
• Na Twoim komputerze nie są otwierane żadne porty przychodzące.
• Twoje dane uwierzytelniające i pliki nigdy nie opuszczają Twojej maszyny (przesyłany jest tylko wynik tekstowy Claude Code).

Najlepsze praktyki bezpieczeństwa SSH

Podczas udostępniania SSH dla dostępu mobilnego:

# Use key-based authentication only (disable password auth)
# In /etc/ssh/sshd_config:
PasswordAuthentication no
PubkeyAuthentication yes

# Restrict SSH to Tailscale interface only
ListenAddress 100.64.x.x

# Use a non-standard port
Port 2222

Bezpieczeństwo Tailscale

Sieć mesh Tailscale oparta na WireGuard zapewnia:

• Szyfrowanie end-to-end między urządzeniami.
• Brak przesyłania danych przez serwery Tailscale (połączenia bezpośrednie).
• MagicDNS dla łatwego rozwiązywania nazw hostów.
• Listy kontroli dostępu (ACLs) dla konfiguracji zespołowych.

Podsumowanie

Zdalne korzystanie z Claude Code w 2026 roku obejmuje zakres od banalnie prostego (jedno polecenie /rc) do w pełni dostosowanego (SSH + tmux + mosh + ntfy + Tailscale). Wybór konfiguracji zależy od Twojego stylu pracy:

• Remote Control do szybkich mobilnych kontroli bez konfiguracji.
• Stos SSH dla programistów, którzy żyją w terminalu i potrzebują maksymalnej odporności.
• Happy Coder jako darmowy, bogaty w funkcje złoty środek.

Praktyczny wpływ jest znaczący. Programowanie nie jest już nierozerwalnie związane z siedzeniem przy biurku z otwartym laptopem. Możesz rozpocząć zadanie, odejść i zachować kontrolę. Niezależnie od tego, czy budujesz projekt poboczny, zarządzasz kodem zespołu, czy tworzysz prototyp aplikacji z ZBuild, mobilny dostęp do Claude Code oznacza, że Twój przepływ pracy podąża za Tobą, a nie na odwrót.

Źródła

• Claude Code Remote Control Documentation — Anthropic
• Remote Claude Code: Programming Like the Early 2000s — Harper Reed
• Claude Code from the Beach: mosh, tmux, and ntfy — Rogs
• Claude Code Remote Control: Code From Your Phone — Medium
• Claude Code on Your Phone — Builder.io
• Perfect Claude Code Notifications with Tailscale and ntfy — Felipe Elias
• 3 Ways to Run Claude Code from Your Phone — Zilliz
• Run Claude Code from Your iPhone — Pete Sena / Medium
• Claude Code Remote Control Launch Analysis — Blockchain News
• Remote Control on Headless Linux VM — GitHub Issue #29479
• Claude Code Mobile Setup with tmux and Bitvise — GitHub Gist
• How to Use Claude Code on Your Phone — FelloAI
• Claude Code Mobile Setup — Sealos Blog