Ce vei învăța
Acest ghid vă prezintă fiecare metodă de utilizare a Claude Code de la distanță — de la funcția oficială Remote Control a Anthropic până la configurări DIY prin SSH cu tmux, mosh și Tailscale. Până la final, vei avea o configurație de coding mobilă funcțională, unde poți lansa sarcini pe desktop, poți părăsi biroul și poți păstra controlul complet de pe telefon.
Claude Code Remote Control: Ghidul complet 2026
Pe 25 februarie 2026, Anthropic a lansat Remote Control — capacitatea de a lansa o sarcină de coding în terminal, de a pune laptopul în geantă și de a păstra controlul complet de pe telefon. Fără VPN, fără port forwarding, fără instrumente third-party necesare. Sursă
Dar funcția oficială este doar o parte din poveste. Comunitatea de developeri a construit un întreg ecosistem de configurații de coding mobil în jurul Claude Code, variind de la simple tuneluri SSH până la fluxuri de lucru sofisticate multi-instrument cu notificări push și input vocal. Acest ghid le acoperă pe toate.
Partea 1: Remote Control oficial
Ce este
Remote Control este funcția integrată a Anthropic pentru continuarea sesiunilor Claude Code pe mai multe dispozitive. Funcționează prin înregistrarea instanței locale Claude Code la API-ul Anthropic ca server, permițând apoi clienților autorizați (telefonul tău) să se conecteze și să controleze sesiunea de la distanță. Sursă
Cum funcționează în detaliu
Modelul de securitate este simplu și conservator:
Desktopul tău (Claude Code) Anthropic API Telefonul tău (Claude App)
│ │ │
├──── Înregistrare sesiune ──────►│ │
│ │ │
│◄─── Alocare URL sesiune ───────┤ │
│ │ │
│ Afișare cod QR │ │
│ │◄── Scanare QR / Autentif. ┤
│ │ │
│◄─── Rutează mesaje ────────────┤──── Rutează mesaje ─────►│
│ │ │
│ (Tot traficul prin TLS) │ │
Proprietăți cheie de securitate:
- Fără porturi de intrare — mașina ta locală efectuează doar cereri HTTPS de ieșire
- Fără conexiune directă — telefonul tău nu se conectează niciodată direct la desktop
- Criptare TLS — tot traficul trece prin API-ul Anthropic prin TLS
- Limitat la sesiune — fiecare sesiune Remote Control are un URL unic care expiră
Pașii de configurare
Pasul 1: Actualizarea Claude Code
Remote Control necesită Claude Code v2.1.51 sau o versiune ulterioară:
# Verifică versiunea ta
claude --version
# Actualizează dacă este necesar
npm update -g @anthropic-ai/claude-code
Pasul 2: Pornirea unei sesiuni
Începe să lucrezi la proiectul tău în mod normal:
cd ~/projects/my-app
claude
Pasul 3: Activarea Remote Control
Din interiorul sesiunii tale Claude Code, rulează:
/rc
# sau
/remote-control
Aceasta pornește serverul Remote Control. Terminalul tău va afișa:
Remote Control active
Session URL: https://code.claude.com/rc/abc123-def456
Press [space] to show QR code
Press [q] to stop Remote Control
Pasul 4: Conectarea de pe telefon
Două opțiuni:
- Cod QR: Apasă tasta space în terminal pentru a afișa un cod QR. Deschide aplicația Claude pe telefon și scanează-l.
- URL: Copiază URL-ul sesiunii și deschide-l în aplicația Claude pe telefon.
Telefonul tău are acum control deplin asupra sesiunii Claude Code. Poți trimite mesaje, poți aproba modificări de fișiere și poți revizui rezultatele — conversația rămâne sincronizată pe toate dispozitivele conectate. Sursă
Activarea Remote Control implicit
Dacă folosești Remote Control frecvent, activează-l pentru toate sesiunile:
/mobile
Aceasta afișează un cod QR pentru instalarea aplicației Claude dacă nu o ai deja și comută setarea „Enable Remote Control for all sessions” pe true. Odată activată, fiecare sesiune Claude Code pornește automat în modul Remote Control. Sursă
Cerințele planului
| Plan | Preț | Remote Control |
|---|---|---|
| Free | $0 | Nu este disponibil |
| Pro | $20/month | Disponibil |
| Max | $100–200/month | Disponibil |
| Team | Personalizat | Disponibil |
| Enterprise | Personalizat | Disponibil |
Limitările Remote Control
- Necesită aplicația Claude — nu poți folosi un browser generic; este necesară aplicația mobilă Claude
- Dependența de Anthropic — tot traficul este rutat prin serverele Anthropic; dacă API-ul lor este căzut, Remote Control nu funcționează
- Fără suport offline — ambele dispozitive trebuie să aibă conectivitate la internet
- Timeout-ul sesiunii — sesiunile inactive expiră în cele din urmă
- Un singur furnizor — funcționează doar cu modelele Claude, nu și dacă folosești OpenCode sau alte instrumente multi-furnizor
Partea 2: SSH + tmux + mosh (Abordarea DIY)
Pentru developerii care doresc control complet asupra terminalului, suport multi-furnizor sau lucrează în rețele instabile, abordarea bazată pe SSH este mai robustă. După cum a scris developerul Harper Reed: „Când am căutat cum să folosesc Claude Code pe un telefon, răspunsul evident a fost să mă conectez prin ssh la un computer de pe un telefon și să rulez claude.” Sursă
De ce trei instrumente?
Ai nevoie de două tipuri diferite de reziliență:
- mosh gestionează conexiunea mobilă instabilă — tranzițiile de la WiFi la date mobile, zonele fără semnal, modul sleep al telefonului
- tmux gestionează persistența sesiunii — menține sesiunea Claude Code activă chiar și atunci când telefonul se deconectează complet
Împreună, acestea fac dezvoltarea pe mobil cu adevărat viabilă. Sursă
Configurarea pachetului
Pasul 1: Instalează Tailscale (Private Networking)
Tailscale creează o rețea privată mesh WireGuard între dispozitivele tale. Fără port forwarding, fără configurare de router, fără reguli de firewall.
Pe desktop:
# macOS
brew install tailscale
# Linux
curl -fsSL https://tailscale.com/install.sh | sh
# Pornește Tailscale
sudo tailscale up
Pe telefon:
- Instalează aplicația Tailscale din magazinul de aplicații
- Autentifică-te cu același cont
- Ambele dispozitive sunt acum pe aceeași rețea privată
Desktopul tău primește un IP Tailscale (ceva de genul 100.64.x.x) pe care telefonul tău îl poate accesa direct, indiferent de rețeaua WiFi sau mobilă pe care se află oricare dintre dispozitive. Sursă
Pasul 2: Instalează tmux (Persistența sesiunii)
tmux menține sesiunile de terminal active independent de conexiunea ta SSH. Când telefonul tău se deconectează (blocarea ecranului, schimbarea rețelei, descărcarea bateriei), sesiunea tmux continuă să ruleze.
# macOS
brew install tmux
# Ubuntu/Debian
sudo apt install tmux
Creează o configurație tmux optimizată pentru utilizarea pe mobil:
# ~/.tmux.conf
# Crește bufferul de scrollback
set -g history-limit 50000
# Activează suportul pentru mouse (util pe mobil)
set -g mouse on
# Reduce escape-time pentru un input mobil mai receptiv
set -sg escape-time 10
# Bara de status cu informații utile
set -g status-right '#H | %H:%M'
# Bara de status mai mare pentru lizibilitate pe mobil
set -g status-style 'bg=colour235 fg=colour136'
Pasul 3: Instalează mosh (Reziliența conexiunii)
mosh (Mobile Shell) folosește UDP în loc de TCP, ceea ce gestionează tranzițiile de rețea cu ușurință. Când telefonul tău trece de la WiFi la date mobile sau trece printr-un tunel, mosh se reconectează automat.
Pe desktop:
# macOS
brew install mosh
# Ubuntu/Debian
sudo apt install mosh
Pe telefon:
- iOS: Instalează Blink Shell sau Termius — ambele suportă mosh nativ
- Android: Instalează JuiceSSH sau Termux cu pachetul mosh
Pasul 4: Conectează-te și pornește Claude Code
Din clientul SSH de pe telefon:
# Conectează-te prin mosh prin Tailscale
mosh user@100.64.x.x
# Pornește sau atașează-te la o sesiune tmux
tmux new-session -s claude
# sau dacă sesiunea există deja:
tmux attach -t claude
# Lansează Claude Code
cd ~/projects/my-app
claude
Acum ai o sesiune Claude Code care:
- Supraviețuiește schimbărilor de rețea (mosh)
- Supraviețuiește deconectărilor telefonului (tmux)
- Este accesibilă de pe orice dispozitiv din rețeaua ta Tailscale
- Funcționează cu orice furnizor AI, nu doar cu Claude
Reconectarea după deconectare
Când folosești telefonul mai târziu:
# mosh se va reconecta automat dacă sesiunea este încă activă
# Dacă sesiunea mosh a murit, pornește una nouă:
mosh user@100.64.x.x
# Reatașează-te la sesiunea tmux
tmux attach -t claude
Sesiunea ta Claude Code este exact unde ai lăsat-o — aceeași conversație, același director de lucru, aceleași modificări în așteptare.
Partea 3: Notificări push cu ntfy
Problema atât cu Remote Control, cât și cu configurațiile SSH: trebuie să tot verifici telefonul pentru a vedea dacă Claude Code și-a terminat sarcina. Soluția o reprezintă notificările push.
Ce este ntfy?
ntfy este un serviciu de notificări push simplu, open-source. Îl poți găzdui singur pentru confidențialitate sau poți folosi instanța publică la ntfy.sh. Sursă
ntfy găzduit local cu Tailscale
Pentru confidențialitate maximă, rulează ntfy pe desktop și accesează-l prin Tailscale:
# Instalează ntfy
brew install ntfy # macOS
# sau
sudo apt install ntfy # Linux
# Pornește serverul ntfy (ascultă pe portul 80 implicit)
ntfy serve --listen-http :8090
Deoarece telefonul și desktopul tău sunt pe aceeași rețea Tailscale, telefonul tău poate accesa ntfy la http://100.64.x.x:8090. Nicio dată nu părăsește rețeaua ta privată.
Configurarea hook-urilor Claude Code
Hook-urile Claude Code îți permit să declanșezi comenzi personalizate atunci când apar anumite evenimente. Configurează un hook pentru a trimite o notificare atunci când Claude Code are nevoie de input:
// ~/.claude/settings.json
{
"hooks": {
"notification": {
"command": "curl -s -d 'Claude Code needs your attention' http://100.64.x.x:8090/claude-code",
"event": "stop"
}
}
}
Configurarea aplicației mobile ntfy
- Instalează aplicația ntfy pe telefon (iOS sau Android)
- Adaugă un abonament la topicul
claude-codepe serverul tău găzduit local (http://100.64.x.x:8090/claude-code) - Activează notificările push pentru acest topic
Acum, ori de câte ori Claude Code se oprește și are nevoie de input — fie că a terminat o sarcină, a întâmpinat o eroare sau are nevoie de aprobare — vei primi o notificare push pe telefon. Nu este nevoie să lași terminalul deschis sau să verifici constant.
Configurare avansată a notificărilor
Pentru notificări mai bogate în context, poți include ultimul mesaj de la Claude Code:
#!/bin/bash
# ~/.claude/hooks/notify.sh
# Obține ultimele rânduri din output-ul Claude Code
LAST_OUTPUT=$(tail -5 /tmp/claude-code-output.log 2>/dev/null || echo "Task completed")
# Trimite notificare cu context
curl -s \
-H "Title: Claude Code" \
-H "Priority: high" \
-H "Tags: robot" \
-d "$LAST_OUTPUT" \
http://100.64.x.x:8090/claude-code
Partea 4: Happy Coder (Alternativă gratuită Open-Source)
Happy Coder este un instrument gratuit, open-source, care oferă o interfață web pentru controlul Claude Code de la distanță, cu notificări push integrate și input vocal. Sursă
Funcții cheie
- Gratuit și open source — nu este necesar niciun abonament în afara planului tău Claude Code
- Notificări push — sistem de notificări integrat, nu este necesară configurarea ntfy
- Input vocal — rostește comenzile în loc să tastezi pe un ecran mic
- Suport multi-agent — funcționează cu Codex alături de Claude Code
- Bazat pe web — funcționează în orice browser mobil, nu este necesară instalarea unei aplicații
Configurare
# Instalează Happy Coder
npm install -g happy-coder
# Pornește serverul
happy-coder start --port 3000
# Accesează de pe telefon prin Tailscale
# http://100.64.x.x:3000
Happy Coder oferă o interfață web optimizată pentru mobil care afișează conversația Claude Code, îți permite să trimiți mesaje și arată modificările de fișiere — totul prin browser.
Partea 5: Comparația completă a configurărilor
Matricea de comparație a metodelor
| Funcție | Remote Control | SSH + tmux + mosh | Happy Coder |
|---|---|---|---|
| Complexitate configurare | Minimă (1 comandă) | Moderată (30 min) | Ușoară (5 min) |
| Cost | Inclus în plan | Gratuit (Tailscale free tier) | Gratuit |
| Reziliență rețea | Moderată | Excelentă (mosh) | Moderată |
| Persistență sesiune | Bună | Excelentă (tmux) | Bună |
| Notificări push | Nu | Cu configurare ntfy | Integrat |
| Input vocal | Nu | Nu | Da |
| Multi-furnizor | Doar Claude | Orice furnizor | Claude + Codex |
| Capacitate offline | Nu | Parțială (tmux persistă) | Nu |
| Acces terminal complet | Nu (doar chat) | Da | Nu (doar chat) |
| Aplicație telefon necesară | Aplicația Claude | Client SSH | Browser |
Configurare recomandată după cazul de utilizare
Utilizator ocazional (verifică sarcinile din când în când): → Remote Control. O comandă, o scanare QR, gata.
Coder mobil zilnic (scrie cod frecvent de pe telefon): → SSH + tmux + mosh + ntfy. Reziliență și control maxime.
Team lead (monitorizează mai multe sesiuni): → Happy Coder. Bazat pe web, suportă mai mulți agenți, notificări integrate.
Developer multi-furnizor (folosește Claude, Codex și modele locale): → SSH + tmux + mosh. Funcționează cu orice instrument care rulează într-un terminal.
Partea 6: Configurații avansate
Rularea mai multor sesiuni Claude Code
Cu tmux, poți rula mai multe sesiuni Claude Code în paralel și poți comuta între ele:
# Creează sesiuni denumite pentru proiecte diferite
tmux new-session -d -s project-api
tmux new-session -d -s project-frontend
tmux new-session -d -s project-tests
# În fiecare sesiune, navighează și pornește 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
# De pe telefon, comută între sesiuni
tmux switch-client -t project-api
Configurare VM Linux Headless
Pentru echipele care doresc un mediu de coding la distanță dedicat, Claude Code Remote Control funcționează pe VM-uri Linux headless prin SSH + tmux. Sursă
# Pe VM-ul tău în cloud (AWS, GCP, etc.)
# Instalează Claude Code
npm install -g @anthropic-ai/claude-code
# Pornește într-o sesiune tmux
tmux new-session -s remote-claude
# Lansează Claude Code
claude
# Pornește Remote Control
/rc
Apoi scanează codul QR de pe telefon. Aceasta îți oferă un mediu de dezvoltare puternic în cloud, controlat în întregime de pe mobil.
Combinarea Remote Control cu SSH
Poți folosi ambele metode împreună pentru flexibilitate maximă:
- SSH + tmux pentru persistența sesiunii și acces complet la terminal
- Remote Control în cadrul sesiunii tmux pentru interfața de chat prietenoasă cu mobilul
# Conectează-te prin SSH la mașina ta
mosh user@100.64.x.x
# Atașează-te la tmux
tmux attach -t claude
# În interiorul sesiunii, Claude Code rulează
# Activează Remote Control pentru acces de pe telefon
/rc
Acum ai:
- tmux care menține sesiunea activă
- mosh care menține conexiunea SSH stabilă
- Remote Control care oferă o interfață mobilă finisată
- Acces complet la terminal când ai nevoie de el
Partea 7: Construirea aplicațiilor în timp ce ești mobil
Fluxul de lucru pentru dezvoltare mobilă
Combinația dintre Claude Code + accesul la distanță schimbă fundamental când și unde poți fi productiv. Un flux de lucru practic:
- Naveta de dimineață: Revizuiești rezultatele CI de peste noapte pe telefon, lansezi sarcini de remediere prin Remote Control
- Pauza de prânz: Verifici progresul prin notificările ntfy, aprobi sau redirecționezi modificările
- Seara: Iei laptopul și sesiunea tmux este exact unde ai lăsat-o
Când are sens codingul pe mobil
Codingul mobil prin Claude Code este cel mai potrivit pentru:
- Inițierea sarcinilor — descrii ce vrei construit și lași Claude Code să lucreze cât timp ești plecat
- Code review — citești diff-uri și aprobi modificări de pe telefon
- Triajul bug-urilor — investighezi problemele și direcționezi Claude Code către remedieri
- Monitorizarea progresului — verifici sarcinile care rulează mult timp
Este mai puțin potrivit pentru:
- Debugging complex — ecranele mici fac citirea stack trace-urilor dureroasă
- Muncă vizuală — ajustările de CSS și layout au nevoie de un ecran complet
- Refactorizări la scară largă — vrei să revizuiești modificări extinse pe un monitor adecvat
Construirea cu ZBuild de oriunde
Pentru developerii care doresc să construiască și să itereze pe aplicații în timp ce sunt mobili, platforme precum ZBuild completează fluxul de lucru la distanță Claude Code. ZBuild oferă un builder de aplicații vizual care funcționează bine pe tablete și poate fi asociat cu Claude Code pentru o logică de backend mai complexă — oferindu-ți o capacitate de dezvoltare full-stack care nu necesită o stație de lucru desktop.
Partea 8: Depanare
Probleme comune și soluții
Problemă: "Remote Control not available on your plan" Soluție: Verifică dacă ești pe Pro, Max, Team sau Enterprise. Planul gratuit nu suportă Remote Control.
Problemă: Codul QR nu se scanează Soluție: Asigură-te că aplicația Claude este actualizată la ultima versiune. Încearcă URL-ul sesiunii direct în loc de scanare.
Problemă: Conexiunea mosh se întrerupe și nu se reconectează
Soluție: Verifică dacă mosh-server rulează pe desktop (which mosh-server). Verifică dacă Tailscale este conectat pe ambele dispozitive. Asigură-te că porturile UDP 60000-61000 sunt deschise dacă nu folosești Tailscale.
Problemă: Sesiunea tmux arată un ecran gol după reconectare
Soluție: Rulează tmux attach -t claude în loc să creezi o sesiune nouă. Dacă sesiunea a murit, verifică dacă Claude Code s-a prăbușit consultând ~/.claude/logs/.
Problemă: Notificările ntfy nu ajung
Soluție: Verifică dacă serverul ntfy rulează (curl http://100.64.x.x:8090/health). Verifică dacă URL-ul de abonare din aplicația ntfy corespunde cu adresa serverului tău. Asigură-te că conexiunea Tailscale a telefonului este activă.
Problemă: Sesiunea Claude Code a expirat în timp ce telefonul a fost deconectat Soluție: Acest lucru se întâmplă cu Remote Control după o inactivitate prelungită. Folosește o configurare bazată pe tmux pentru sesiuni care trebuie să persiste ore în șir. Sesiunile tmux supraviețuiesc pe termen nedefinit, indiferent de conexiunile clienților.
Problemă: Tastarea este lentă pe mobil Soluție: Folosește inputul vocal (Happy Coder) sau păstrează mesajele scurte și orientate spre sarcini. Alternativ, pregătește prompturile într-o aplicație de notițe și lipește-le în terminal.
Partea 9: Considerații de securitate
Securitatea Remote Control
- Tot traficul este criptat prin TLS prin API-ul Anthropic
- URL-urile sesiunilor sunt unice și expiră după utilizare
- Nu sunt deschise porturi de intrare pe mașina ta
- Credențialele și fișierele tale nu părăsesc niciodată mașina ta (se transmite doar output-ul text al Claude Code)
Bune practici de securitate SSH
Când expui SSH pentru acces mobil:
# Folosește doar autentificarea pe bază de cheie (dezactivează autentificarea prin parolă)
# În /etc/ssh/sshd_config:
PasswordAuthentication no
PubkeyAuthentication yes
# Restricționează SSH doar la interfața Tailscale
ListenAddress 100.64.x.x
# Folosește un port non-standard
Port 2222
Securitatea Tailscale
Rețeaua mesh bazată pe WireGuard a Tailscale oferă:
- Criptare end-to-end între dispozitive
- Nicio rutare de date prin serverele Tailscale (conexiuni directe)
- MagicDNS pentru rezoluția ușoară a numelor de gazdă
- Liste de control al accesului (ACL-uri) pentru configurări de echipă
Concluzie
Utilizarea Claude Code de la distanță în 2026 variază de la extrem de simplu (o comandă /rc) la complet personalizat (SSH + tmux + mosh + ntfy + Tailscale). Configurația corectă depinde de fluxul tău de lucru:
- Remote Control pentru verificări mobile rapide fără configurare
- Pachetul SSH pentru developerii care trăiesc în terminal și au nevoie de reziliență maximă
- Happy Coder pentru o cale de mijloc gratuită și bogată în funcții
Impactul practic este semnificativ. Dezvoltarea nu mai este legată de statul la un birou cu un laptop deschis. Poți începe o sarcină, poți pleca și poți păstra controlul. Indiferent dacă construiești un proiect personal, gestionezi baza de cod a unei echipe sau prototipezi o aplicație cu ZBuild, accesul mobil la Claude Code înseamnă că fluxul tău de dezvoltare te urmează pe tine, nu invers.
Surse
- 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