Co se naučíte
Tento průvodce vás provede každou metodou používání Claude Code na dálku — od oficiální funkce Remote Control od Anthropic až po DIY SSH nastavení s tmux, mosh a Tailscale. Na konci budete mít funkční mobilní kódovací setup, kde můžete spustit úkoly na svém desktopu, odejít z kanceláře a udržet si plnou kontrolu ze svého telefonu.
Claude Code Remote Control: Kompletní průvodce pro rok 2026
February 25, 2026, Anthropic vydal Remote Control — možnost spustit úkol kódování ve vašem terminálu, dát notebook do tašky a udržet si plnou kontrolu ze svého telefonu. Není vyžadována žádná VPN, žádné přesměrování portů ani nástroje třetích stran. Source
Ale oficiální funkce je jen částí příběhu. Komunita vývojářů vybudovala celý ekosystém mobilních kódovacích setupů kolem Claude Code, od jednoduchých SSH tunelů až po sofistikované workflow s více nástroji, push notifikacemi a hlasovým vstupem. Tento průvodce pokrývá všechny z nich.
Část 1: Oficiální Remote Control
Co to je
Remote Control je vestavěná funkce Anthropic pro pokračování v relacích Claude Code napříč zařízeními. Funguje tak, že se vaše lokální instance Claude Code zaregistruje u Anthropic API jako server a poté umožní autorizovaným klientům (vašemu telefonu) se připojit a ovládat relaci na dálku. Source
Jak to funguje pod kapotou
Bezpečnostní model je přímočarý a konzervativní:
Your Desktop (Claude Code) Anthropic API Your Phone (Claude App)
│ │ │
├──── Register session ──────────►│ │
│ │ │
│◄─── Assign session URL ────────┤ │
│ │ │
│ Display QR code │ │
│ │◄──── Scan QR / Auth ─────┤
│ │ │
│◄─── Route messages ────────────┤──── Route messages ─────►│
│ │ │
│ (All traffic over TLS) │ │
Klíčové bezpečnostní vlastnosti:
- Žádné příchozí porty — váš lokální stroj vytváří pouze odchozí HTTPS požadavky
- Žádné přímé připojení — váš telefon se nikdy nepřipojuje přímo k vašemu desktopu
- TLS šifrování — veškerý provoz proudí přes Anthropic API přes TLS
- Rozsah relace — každá relace Remote Control má unikátní URL, která vyprší
Kroky nastavení
Krok 1: Aktualizace Claude Code
Remote Control vyžaduje Claude Code v2.1.51 nebo novější:
# Check your version
claude --version
# Update if needed
npm update -g @anthropic-ai/claude-code
Krok 2: Spuštění relace
Začněte pracovat na svém projektu normálně:
cd ~/projects/my-app
claude
Krok 3: Povolení Remote Control
V rámci vaší relace Claude Code spusťte:
/rc
# or
/remote-control
Tím se spustí server Remote Control. Váš terminál zobrazí:
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: Připojení z telefonu
Dvě možnosti:
- QR kód: Stiskněte mezerník ve svém terminálu pro zobrazení QR kódu. Otevřete aplikaci Claude na svém telefonu a naskenujte jej.
- URL: Zkopírujte URL relace a otevřete ji v aplikaci Claude na svém telefonu.
Váš telefon má nyní plnou kontrolu nad relací Claude Code. Můžete posílat zprávy, schvalovat změny souborů a kontrolovat výstup — konverzace zůstává synchronizovaná napříč všemi připojenými zařízeními. Source
Povolení Remote Control ve výchozím nastavení
Pokud používáte Remote Control často, povolte jej pro všechny relace:
/mobile
Tím se zobrazí QR kód pro instalaci aplikace Claude, pokud ji ještě nemáte, a přepne se nastavení "Enable Remote Control for all sessions" na true. Jakmile je toto povoleno, každá relace Claude Code se automaticky spustí v režimu Remote Control. Source
Požadavky na plán
| Plan | Price | Remote Control |
|---|---|---|
| Free | $0 | Nedostupné |
| Pro | $20/month | Dostupné |
| Max | $100–200/month | Dostupné |
| Team | Custom | Dostupné |
| Enterprise | Custom | Dostupné |
Omezení Remote Control
- Vyžaduje aplikaci Claude — nemůžete použít běžný prohlížeč; je vyžadována mobilní aplikace Claude
- Závislost na Anthropic — veškerý provoz směřuje přes servery Anthropic; pokud jejich API nefunguje, Remote Control nefunguje
- Žádná podpora offline — obě zařízení musí mít připojení k internetu
- Časový limit relace — neaktivní relace nakonec vyprší
- Jediný poskytovatel — funguje pouze s modely Claude, nikoli pokud používáte OpenCode nebo jiné nástroje pro více poskytovatelů
Část 2: SSH + tmux + mosh (DIY přístup)
Pro vývojáře, kteří chtějí plnou kontrolu nad terminálem, podporu více poskytovatelů nebo pracují v nespolehlivých sítích, je přístup založený na SSH robustnější. Jak napsal vývojář Harper Reed: "Při vymýšlení, jak používat Claude Code na telefonu, byla zřejmá odpověď připojit se přes ssh do počítače z telefonu a spustit claude." Source
Proč tři nástroje?
Potřebujete dva různé typy odolnosti:
- mosh řeší nestabilní mobilní připojení — přechody z WiFi na mobilní data, hluchá místa, uspání telefonu
- tmux řeší perzistenci relace — udržuje relaci Claude Code aktivní, i když se váš telefon zcela odpojí
Společně činí mobilní vývoj skutečně proveditelným. Source
Nastavení stacku
Krok 1: Instalace Tailscale (soukromá síť)
Tailscale vytvoří soukromou síť WireGuard mezi vašimi zařízeními. Žádné přesměrování portů, žádná konfigurace routeru, žádná pravidla firewallu.
Na vašem desktopu:
# macOS
brew install tailscale
# Linux
curl -fsSL https://tailscale.com/install.sh | sh
# Start Tailscale
sudo tailscale up
Na vašem telefonu:
- Nainstalujte aplikaci Tailscale z obchodu s aplikacemi
- Přihlaste se stejným účtem
- Obě zařízení jsou nyní ve stejné soukromé síti
Váš desktop získá Tailscale IP (něco jako 100.64.x.x), na kterou se váš telefon může přímo připojit, bez ohledu na to, na jaké WiFi nebo mobilní síti se kterékoliv zařízení nachází. Source
Krok 2: Instalace tmux (perzistence relace)
tmux udržuje vaše terminálové relace aktivní nezávisle na vašem SSH připojení. Když se váš telefon odpojí (zámek obrazovky, přepnutí sítě, vybitá baterie), relace tmux běží dál.
# macOS
brew install tmux
# Ubuntu/Debian
sudo apt install tmux
Vytvořte konfiguraci tmux optimalizovanou pro mobilní použití:
# ~/.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: Instalace mosh (odolnost připojení)
mosh (Mobile Shell) používá UDP místo TCP, což plynule zvládá síťové přechody. Když váš telefon přepne z WiFi na mobilní data nebo projde tunelem, mosh se automaticky znovu připojí.
Na vašem desktopu:
# macOS
brew install mosh
# Ubuntu/Debian
sudo apt install mosh
Na vašem telefonu:
- iOS: Nainstalujte Blink Shell nebo Termius — oba podporují mosh nativně
- Android: Nainstalujte JuiceSSH nebo Termux s balíčkem mosh
Krok 4: Připojení a spuštění Claude Code
Z SSH klienta vašeho telefonu:
# 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
Nyní máte relaci Claude Code, která:
- Přežije přepínání sítí (mosh)
- Přežije odpojení telefonu (tmux)
- Je přístupná z jakéhokoli zařízení ve vaší síti Tailscale
- Funguje s jakýmkoli poskytovatelem AI, nejen s Claude
Opětovné připojení po odpojení
Když telefon později vezmete do ruky:
# 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
Vaše relace Claude Code je přesně tam, kde jste ji nechali — stejná konverzace, stejný pracovní adresář, stejné čekající změny.
Část 3: Push notifikace s ntfy
Problém s nastavením Remote Control i SSH: musíte neustále kontrolovat telefon, abyste zjistili, zda Claude Code dokončil svůj úkol. Řešením jsou push notifikace.
Co je ntfy?
ntfy je jednoduchá, open-source služba pro push notifikace. Můžete ji hostovat sami pro zachování soukromí nebo použít veřejnou instanci na ntfy.sh. Source
Samostatně hostované ntfy s Tailscale
Pro maximální soukromí spusťte ntfy na svém desktopu a přistupujte k němu přes 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
Protože váš telefon i desktop jsou ve stejné síti Tailscale, váš telefon se k ntfy dostane na adrese http://100.64.x.x:8090. Žádná data neopustí vaši soukromou síť.
Konfigurace Claude Code hooků
Hooky Claude Code vám umožňují spouštět vlastní příkazy, když nastanou určité události. Nastavte hook pro odeslání notifikace, když Claude Code vyžaduje vstup:
// ~/.claude/settings.json
{
"hooks": {
"notification": {
"command": "curl -s -d 'Claude Code needs your attention' http://100.64.x.x:8090/claude-code",
"event": "stop"
}
}
}
Nastavení mobilní aplikace ntfy
- Nainstalujte aplikaci ntfy do svého telefonu (iOS nebo Android)
- Přidejte odběr tématu
claude-codena vašem samostatně hostovaném serveru (http://100.64.x.x:8090/claude-code) - Povolte push notifikace pro toto téma
Nyní kdykoli se Claude Code zastaví a potřebuje vstup — ať už dokončil úkol, narazil na chybu nebo potřebuje schválení — dostanete na telefon push notifikaci. Není třeba mít otevřený terminál nebo ho neustále kontrolovat.
Pokročilé nastavení notifikací
Pro notifikace bohatší na kontext můžete zahrnout poslední zprávu 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
Část 4: Happy Coder (Bezplatná open-source alternativa)
Happy Coder je bezplatný, open-source nástroj, který poskytuje webové rozhraní pro vzdálené ovládání Claude Code, s vestavěnými push notifikacemi a hlasovým vstupem. Source
Klíčové funkce
- Zdarma a open-source — není vyžadováno žádné předplatné nad rámec vašeho plánu Claude Code
- Push notifikace — vestavěný systém notifikací, není potřeba nastavení ntfy
- Hlasový vstup — mluvte příkazy místo psaní na malé obrazovce
- Podpora více agentů — funguje s Codex společně s Claude Code
- Webové rozhraní — funguje v jakémkoli mobilním prohlížeči, není nutná instalace aplikace
Nastavení
# 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 poskytuje mobilně optimalizované webové rozhraní, které zobrazuje vaši konverzaci s Claude Code, umožňuje posílat zprávy a ukazuje změny v souborech — vše prostřednictvím vašeho prohlížeče.
Část 5: Porovnání kompletních nastavení
Matice porovnání metod
| Funkce | Remote Control | SSH + tmux + mosh | Happy Coder |
|---|---|---|---|
| Složitost nastavení | Minimální (1 příkaz) | Střední (30 min) | Snadná (5 min) |
| Cena | Zahrnuto v plánu | Zdarma (Tailscale free tier) | Zdarma |
| Odolnost sítě | Střední | Vynikající (mosh) | Střední |
| Perzistence relace | Dobrá | Vynikající (tmux) | Dobrá |
| Push notifikace | Ne | S nastavením ntfy | Vestavěné |
| Hlasový vstup | Ne | Ne | Ano |
| Více poskytovatelů | Pouze Claude | Jakýkoli poskytovatel | Claude + Codex |
| Možnost offline | Ne | Částečná (tmux přetrvává) | Ne |
| Plný přístup k terminálu | Ne (pouze chat) | Ano | Ne (pouze chat) |
| Nutná aplikace v telefonu | Aplikace Claude | SSH klient | Prohlížeč |
Doporučené nastavení podle případu použití
Příležitostný uživatel (občasná kontrola úkolů): → Remote Control. Jeden příkaz, jedno naskenování QR kódu a hotovo.
Denní mobilní kodér (časté kódování z telefonu): → SSH + tmux + mosh + ntfy. Maximální odolnost a kontrola.
Vedoucí týmu (sledování více relací): → Happy Coder. Webové rozhraní, podpora více agentů, vestavěné notifikace.
Vývojář využívající více poskytovatelů (používá Claude, Codex a lokální modely): → SSH + tmux + mosh. Funguje s jakýmkoli nástrojem, který běží v terminálu.
Část 6: Pokročilé konfigurace
Spouštění více relací Claude Code
S tmux můžete spustit více relací Claude Code paralelně a přepínat mezi 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
Nastavení na headless Linux VM
Pro týmy, které chtějí dedikované vzdálené vývojové prostředí, funguje Claude Code Remote Control na headless Linux VM přes 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
Poté naskenujte QR kód ze svého telefonu. To vám poskytne výkonné cloudové vývojové prostředí ovládané výhradně z mobilu.
Kombinace Remote Control s SSH
Pro maximální flexibilitu můžete použít obě metody společně:
- SSH + tmux pro perzistenci relace a plný přístup k terminálu
- Remote Control v rámci relace tmux pro mobilně přívětivé chatovací rozhraní
# 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
Nyní máte:
- tmux udržující relaci aktivní
- mosh udržující SSH připojení stabilní
- Remote Control poskytující vyladěné mobilní rozhraní
- Plný přístup k terminálu, když ho potřebujete
Část 7: Vývoj aplikací na cestách
Mobilní vývojový workflow
Kombinace Claude Code + vzdálený přístup zásadně mění to, kdy a kde můžete být produktivní. Praktický workflow:
- Ranní dojíždění: Zkontrolujte výsledky noční CI na svém telefonu, spusťte opravné úkoly přes Remote Control
- Obědová pauza: Sledujte pokrok prostřednictvím ntfy notifikací, schvalujte nebo přesměrovávejte změny
- Večer: Vezměte si notebook a relace tmux je přesně tam, kde jste ji nechali
Kdy dává mobilní kódování smysl
Mobilní kódování přes Claude Code se nejlépe hodí pro:
- Iniciaci úkolů — popište, co chcete vytvořit, a nechte Claude Code pracovat, zatímco jste pryč
- Code review — čtěte diffy a schvalujte změny ze svého telefonu
- Třídění chyb — zkoumejte problémy a nasměrujte Claude Code na opravy
- Sledování pokroku — kontrolujte dlouhotrvající úkoly
Méně se hodí pro:
- Komplexní debugging — malé obrazovky činí čtení stack traců bolestivým
- Vizuální práci — úpravy CSS a rozvržení vyžadují plnou obrazovku
- Rozsáhlý refactoring — chcete si prohlédnout rozsáhlé změny na pořádném monitoru
Budování s ZBuild odkudkoli
Pro vývojáře, kteří chtějí vytvářet a iterovat aplikace na cestách, platformy jako ZBuild doplňují workflow vzdáleného Claude Code. ZBuild poskytuje vizuální nástroj pro tvorbu aplikací, který funguje dobře na tabletech a lze jej spárovat s Claude Code pro složitější backendovou logiku — což vám dává plnohodnotnou schopnost full-stack vývoje, která nevyžaduje desktopovou pracovní stanici.
Část 8: Řešení problémů
Běžné problémy a opravy
Problém: "Remote Control not available on your plan" Oprava: Ověřte, zda máte tarif Pro, Max, Team nebo Enterprise. Bezplatná úroveň Remote Control nepodporuje.
Problém: QR kód nelze naskenovat Oprava: Ujistěte se, že je vaše aplikace Claude aktualizována na nejnovější verzi. Zkuste použít URL relace přímo místo skenování.
Problém: mosh připojení vypadává a znovu se nepřipojuje
Oprava: Ověřte, zda na vašem desktopu běží mosh-server (which mosh-server). Zkontrolujte, zda je Tailscale připojen na obou zařízeních. Pokud nepoužíváte Tailscale, ujistěte se, že jsou otevřené UDP porty 60000-61000.
Problém: relace tmux po opětovném připojení zobrazuje prázdnou obrazovku
Oprava: Místo vytváření nové relace spusťte tmux attach -t claude. Pokud relace skončila, zkontrolujte, zda Claude Code nespadl, prohlédnutím ~/.claude/logs/.
Problém: notifikace ntfy nepřicházejí
Oprava: Ověřte, zda server ntfy běží (curl http://100.64.x.x:8090/health). Zkontrolujte, zda URL odběru v aplikaci ntfy odpovídá adrese vašeho serveru. Ujistěte se, že je připojení Tailscale ve vašem telefonu aktivní.
Problém: relace Claude Code vypršela, zatímco byl telefon odpojen Oprava: To se stává u Remote Control po delší neaktivitě. Pro relace, které musí trvat hodiny, použijte nastavení založené na tmux. Relace tmux přežijí neomezeně dlouho bez ohledu na připojení klientů.
Problém: psaní na mobilu je pomalé Oprava: Použijte hlasový vstup (Happy Coder) nebo pište krátké a úkolově orientované zprávy. Alternativně si připravte prompty v aplikaci pro poznámky a vložte je do terminálu.
Část 9: Bezpečnostní aspekty
Bezpečnost Remote Control
- Veškerý provoz je šifrován přes TLS prostřednictvím Anthropic API
- URL relací jsou unikátní a po použití vyprší
- Na vašem stroji se neotevírají žádné příchozí porty
- Vaše přihlašovací údaje a soubory nikdy neopustí váš stroj (přenáší se pouze textový výstup Claude Code)
Osvědčené postupy pro bezpečnost SSH
Při vystavení SSH pro mobilní přístup:
# 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
Bezpečnost Tailscale
Mesh síť Tailscale založená na WireGuard poskytuje:
- End-to-end šifrování mezi zařízeními
- Žádné směrování dat přes servery Tailscale (přímá spojení)
- MagicDNS pro snadné rozlišení názvů hostitelů
- Seznamy řízení přístupu (ACL) pro týmová nastavení
Závěr
Používání Claude Code na dálku v roce 2026 sahá od naprosto jednoduchého (jeden příkaz /rc) až po plně přizpůsobené (SSH + tmux + mosh + ntfy + Tailscale). Správné nastavení závisí na vašem workflow:
- Remote Control pro rychlé mobilní kontroly s nulovým nastavením
- SSH stack pro vývojáře, kteří žijí v terminálu a potřebují maximální odolnost
- Happy Coder pro bezplatnou, funkcemi nabitou střední cestu
Praktický dopad je významný. Vývoj již není vázán na sezení u stolu s otevřeným notebookem. Můžete spustit úkol, odejít a zůstat u kontroly. Ať už stavíte vedlejší projekt, spravujete kódovou základnu týmu nebo prototypujete aplikaci s ZBuild, mobilní přístup k Claude Code znamená, že váš vývojový workflow následuje vás, nikoli naopak.
Zdroje
- 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