Mitä opit

Tämä opas ohjaa sinut jokaisen Claude Code -etäkäyttömenetelmän läpi — Anthropicin virallisesta Remote Control -ominaisuudesta itse tehtyihin SSH-asennuksiin tmuxin, moshin ja Tailscalen avulla. Lopussa sinulla on toimiva mobiiliohjelmointiympäristö, jossa voit käynnistää tehtäviä työpöydältäsi, poistua toimistolta ja säilyttää täyden hallinnan puhelimellasi.

Claude Code Remote Control: Täydellinen opas 2026

Helmikuun 25. päivänä 2026 Anthropic julkaisi Remote Control -ominaisuuden — mahdollisuuden käynnistää koodaustehtävä terminaalissasi, laittaa kannettava tietokone laukkuun ja säilyttää täysi hallinta puhelimestasi. VPN:ää, porttiohjausta tai kolmannen osapuolen työkaluja ei tarvita. Lähde

Mutta virallinen ominaisuus on vain osa tarinaa. Kehittäjäyhteisö on rakentanut kokonaisen mobiiliohjelmointiekosysteemin Claude Code ympärille, ulottuen yksinkertaisista SSH-tunneleista hienostuneisiin monen työkalun työnkulkuihin, joissa on push-ilmoitukset ja äänisyöttö. Tämä opas kattaa ne kaikki.

Osa 1: Virallinen Remote Control

Mikä se on

Remote Control on Anthropicin sisäänrakennettu ominaisuus Claude Code -istuntojen jatkamiseen eri laitteilla. Se toimii siten, että paikallinen Claude Code -instanssisi rekisteröityy Anthropic API -palveluun palvelimeksi, sallien sitten valtuutettujen asiakkaiden (puhelimesi) muodostaa yhteyden ja hallita istuntoa etänä. Lähde

Miten se toimii taustalla

Tietoturvamalli on suoraviivainen ja konservatiivinen:

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)     │                          │

Keskeiset suojausominaisuudet:

• Ei saapuvia portteja — paikallinen koneesi tekee vain ulospäin suuntautuvia HTTPS-pyyntöjä
• Ei suoraa yhteyttä — puhelimesi ei koskaan yhdistä suoraan työpöytääsi
• TLS-salaus — kaikki liikenne kulkee Anthropic API:n kautta TLS-suojattuna
• Istuntokohtainen — jokaisella Remote Control -istunnolla on yksilöllinen URL-osoite, joka vanhenee

Lähde

Asennusvaiheet

Vaihe 1: Päivitä Claude Code

Remote Control vaatii version Claude Code v2.1.51 tai uudemman:

# Check your version
claude --version

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

Vaihe 2: Aloita istunto

Aloita työskentely projektisi parissa normaalisti:

cd ~/projects/my-app
claude

Vaihe 3: Ota Remote Control käyttöön

Suorita Claude Code -istunnon sisältä:

/rc
# or
/remote-control

Tämä käynnistää Remote Control -palvelimen. Terminaalisi näyttää:

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

Vaihe 4: Yhdistä puhelimestasi

Kaksi vaihtoehtoa:

1. QR-koodi: Paina välilyöntiä terminaalissasi näyttääksesi QR-koodin. Avaa Claude-sovellus puhelimessasi ja skannaa se.
2. URL: Kopioi istunnon URL ja avaa se Claude-sovelluksessa puhelimellasi.

Puhelimellasi on nyt täysi hallinta Claude Code -istunnosta. Voit lähettää viestejä, hyväksyä tiedostomuutoksia ja tarkastella tulosteita — keskustelu pysyy synkronoituna kaikilla yhdistetyillä laitteilla. Lähde

Remote Controlin ottaminen käyttöön oletuksena

Jos käytät Remote Control -ominaisuutta usein, ota se käyttöön kaikille istunnoille:

/mobile

Tämä näyttää QR-koodin Claude-sovelluksen asentamista varten, jos et ole vielä tehnyt sitä, ja vaihtaa asetuksen "Enable Remote Control for all sessions" tilaan true. Kun se on päällä, jokainen Claude Code -istunto alkaa automaattisesti Remote Control -tilassa. Lähde

Tilauksien vaatimukset

Lähde

Remote Controlin rajoitukset

• Vaatii Claude-sovelluksen — et voi käyttää tavallista selainta; Claude-mobiilisovellus vaaditaan
• Anthropic-riippuvuus — kaikki liikenne reititetään Anthropicin palvelimien kautta; jos heidän API on alhaalla, Remote Control on alhaalla
• Ei offline-tukea — molemmilla laitteilla on oltava internetyhteys
• Istunnon aikakatkaisu — passiiviset istunnot vanhenevat lopulta
• Vain yksi tarjoaja — toimii vain Claude-malleilla, ei jos käytät OpenCodea tai muita usean tarjoajan työkaluja

Osa 2: SSH + tmux + mosh (Tee-se-itse-lähestymistapa)

Kehittäjille, jotka haluavat täyden terminaalin hallinnan, usean tarjoajan tuen tai työskentelevät epäluotettavissa verkoissa, SSH-pohjainen lähestymistapa on vankempi. Kuten kehittäjä Harper Reed kirjoitti: "Kun mietin, miten Claude Codea käytetään puhelimella, ilmeinen vastaus oli ottaa ssh-yhteys tietokoneeseen puhelimesta ja ajaa claude." Lähde

Miksi kolme työkalua?

Tarvitset kahdenlaista sietokykyä:

• mosh hoitaa epävakaan mobiiliyhteyden — vaihdot WiFi:n ja mobiiliverkon välillä, katvealueet, puhelimen lepotilan
• tmux hoitaa istunnon jatkuvuuden — pitää Claude Code -istunnon elossa, vaikka puhelimesi yhteys katkeaisi kokonaan

Yhdessä ne tekevät mobiilikehityksestä todella käyttökelpoista. Lähde

Ohjelmistopinon asennus

Vaihe 1: Asenna Tailscale (Yksityinen verkko)

Tailscale luo yksityisen WireGuard-verkon laitteidesi välille. Ei porttiohjausta, ei reitittimen konfigurointia, ei palomuurisääntöjä.

Työpöydälläsi:

# macOS
brew install tailscale

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

# Start Tailscale
sudo tailscale up

Puhelimessasi:

• Asenna Tailscale-sovellus sovelluskaupasta
• Kirjaudu sisään samalla tilillä
• Molemmat laitteet ovat nyt samassa yksityisessä verkossa

Työpöytäsi saa Tailscale IP -osoitteen (kuten 100.64.x.x), jonka puhelimesi tavoittaa suoraan riippumatta siitä, missä WiFi- tai mobiiliverkossa kumpikaan laite on. Lähde

Vaihe 2: Asenna tmux (Istunnon jatkuvuus)

tmux pitää terminaali-istuntosi elossa riippumatta SSH-yhteydestäsi. Kun puhelimesi yhteys katkeaa (näytön lukitus, verkon vaihto, akun loppuminen), tmux-istunto jatkaa toimintaansa.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

Luo mobiilikäyttöön optimoitu tmux-konfiguraatio:

# ~/.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'

Vaihe 3: Asenna mosh (Yhteyden sietokyky)

mosh (Mobile Shell) käyttää UDP:tä TCP:n sijaan, mikä käsittelee verkon muutokset sulavasti. Kun puhelimesi vaihtaa WiFi:stä mobiiliverkkoon tai kulkee tunnelin läpi, mosh yhdistää automaattisesti uudelleen.

Työpöydälläsi:

# macOS
brew install mosh

# Ubuntu/Debian
sudo apt install mosh

Puhelimessasi:

• iOS: Asenna Blink Shell tai Termius — molemmat tukevat moshia natiivisti
• Android: Asenna JuiceSSH tai Termux mosh-paketilla

Vaihe 4: Yhdistä ja käynnistä Claude Code

Puhelimesi SSH-asiakkaasta:

# 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

Nyt sinulla on Claude Code -istunto, joka:

• Kestää verkon vaihdot (mosh)
• Kestää puhelimen yhteyden katkeamiset (tmux)
• On käytettävissä miltä tahansa Tailscale-verkkosi laitteelta
• Toimii minkä tahansa AI-tarjoajan kanssa, ei vain Claude:n

Uudelleenyhdistäminen katkaisun jälkeen

Kun otat puhelimesi käyttöön myöhemmin:

# 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

Claude Code -istuntosi on täsmälleen siellä, mihin se jäi — sama keskustelu, sama työhakemisto, samat odottavat muutokset.

Osa 3: Push-ilmoitukset ntfy:n avulla

Sekä Remote Control- että SSH-asennusten ongelma on, että joudut tarkistamaan puhelintasi nähdäksesi, onko Claude Code saanut tehtävänsä valmiiksi. Ratkaisu on push-ilmoitukset.

Mikä on ntfy?

ntfy on yksinkertainen, avoimen lähdekoodin push-ilmoituspalvelu. Voit isännöidä sitä itse yksityisyyden vuoksi tai käyttää julkista instanssia osoitteessa ntfy.sh. Lähde

Itse isännöity ntfy Tailscalen kanssa

Maksimaalisen yksityisyyden saavuttamiseksi aja ntfy työpöydälläsi ja käytä sitä Tailscalen kautta:

# 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

Koska puhelimesi ja työpöytäsi ovat samassa Tailscale-verkossa, puhelimesi tavoittaa ntfy-palvelun osoitteessa http://100.64.x.x:8090. Mitään tietoja ei poistu yksityisestä verkostasi.

Claude Code -koukkujen (hooks) määrittäminen

Claude Code -koukut antavat sinun käynnistää mukautettuja komentoja tiettyjen tapahtumien tapahtuessa. Määritä koukku lähettämään ilmoitus, kun Claude Code tarvitsee syötettä:

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

Lähde

ntfy-mobiilisovelluksen asennus

1. Asenna ntfy-sovellus puhelimeesi (iOS tai Android)
2. Lisää tilaus aiheeseen claude-code itse isännöimälläsi palvelimella (http://100.64.x.x:8090/claude-code)
3. Ota push-ilmoitukset käyttöön kyseiselle aiheelle

Nyt aina kun Claude Code pysähtyy ja tarvitsee syötettä — oli se sitten saanut tehtävän valmiiksi, kohdannut virheen tai tarvinnut hyväksyntää — saat push-ilmoituksen puhelimeesi. Terminaalia ei tarvitse pitää auki tai tarkistaa jatkuvasti.

Edistyneet ilmoitusasetukset

Jos haluat sisältörikkaampia ilmoituksia, voit sisällyttää viimeisen viestin Claude Code:lta:

#!/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

Lähde

Osa 4: Happy Coder (Ilmainen avoimen lähdekoodin vaihtoehto)

Happy Coder on ilmainen, avoimen lähdekoodin työkalu, joka tarjoaa verkkopohjaisen käyttöliittymän Claude Code etähallintaan, sisältäen sisäänrakennetut push-ilmoitukset ja äänisyötön. Lähde

Keskeiset ominaisuudet

• Ilmainen ja avointa lähdekoodia — ei vaadi tilausta Claude Code -sopimuksesi lisäksi
• Push-ilmoitukset — sisäänrakennettu ilmoitusjärjestelmä, ntfy-asennusta ei tarvita
• Äänisyöttö — puhu komentoja pienen näytön kirjoittamisen sijaan
• Usean agentin tuki — toimii Codexin kanssa Claude Code:n rinnalla
• Verkkopohjainen — toimii millä tahansa mobiiliselaimella, sovellusasennusta ei vaadita

Asennus

# 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 tarjoaa mobiilioptimoidun verkkoliittymän, joka näyttää Claude Code -keskustelusi, antaa sinun lähettää viestejä ja näyttää tiedostomuutokset — kaikki selaimesi kautta.

Osa 5: Täydellinen asennusvertailu

Menetelmien vertailumatriisi

Suositeltu asennus käyttötarkoituksen mukaan

Satunnainen käyttäjä (tarkistaa tehtäviä silloin tällöin): → Remote Control. Yksi komento, yksi QR-skannaus, valmis.

Päivittäinen mobiilikoodaaja (koodaa usein puhelimella): → SSH + tmux + mosh + ntfy. Maksimaalinen sietokyky ja hallinta.

Tiiminvetäjä (valvoo useita istuntoja): → Happy Coder. Verkkopohjainen, tukee useita agentteja, sisäänrakennetut ilmoitukset.

Usean tarjoajan kehittäjä (käyttää Claudea, Codexia ja paikallisia malleja): → SSH + tmux + mosh. Toimii minkä tahansa työkalun kanssa, joka pyörii terminaalissa.

Osa 6: Edistyneet konfiguraatiot

Useiden Claude Code -istuntojen ajaminen

tmuxin avulla voit ajaa useita Claude Code -istuntoja rinnakkain ja vaihtaa niiden välillä:

# 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

Headless Linux VM -asennus

Tiimeille, jotka haluavat erillisen etäkoodausympäristön, Claude Code Remote Control toimii headless Linux VM -koneilla SSH + tmux -yhteyden kautta. Lähde

# 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

Skannaa sitten QR-koodi puhelimellasi. Tämä antaa sinulle tehokkaan pilvipohjaisen kehitysympäristön, jota hallitaan täysin mobiilisti.

Remote Controlin ja SSH:n yhdistäminen

Voit käyttää molempia menetelmiä yhdessä maksimaalisen joustavuuden saavuttamiseksi:

1. SSH + tmux istunnon jatkuvuuteen ja täyteen terminaalin hallintaan
2. Remote Control tmux-istunnon sisällä mobiiliystävällistä chat-liittymää varten

# 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

Nyt sinulla on:

• tmux pitämässä istunnon elossa
• mosh pitämässä SSH-yhteyden vakaana
• Remote Control tarjoamassa hiotun mobiilikäyttöliittymän
• Täysi terminaalin hallinta tarvittaessa

Osa 7: Sovellusten rakentaminen mobiilisti

Mobiilikehityksen työnkulku

Claude Code + etäkäyttö muuttaa perusteellisesti sitä, milloin ja missä voit olla tuottava. Käytännön työnkulku:

1. Aamun työmatka: Tarkista yön yli ajettujen CI-testien tulokset puhelimellasi, käynnistä korjaustehtävät Remote Controlin kautta
2. Lounastauko: Seuraa edistymistä ntfy-ilmoitusten kautta, hyväksy tai uudelleenohjaa muutoksia
3. Ilta: Ota kannettava tietokoneesi esiin, ja tmux-istunto on täsmälleen siellä, mihin se jäi

Milloin mobiilikoodaus on järkevää

Mobiilikoodaus Claude Code:n kautta sopii parhaiten:

• Tehtävän aloittamiseen — kuvaile mitä haluat rakennettavan ja anna Claude Code työskennellä, kun olet poissa
• Koodikatselmointiin — lue diff-muutoksia ja hyväksy ne puhelimestasi
• Bugien priorisointiin — tutki ongelmia ja osoita Claude Code korjaamaan ne
• Edistymisen seurantaan — tarkista pitkäkestoisten tehtävien tila

Se sopii huonommin:

• Monimutkaiseen virheenkorjaukseen — pienet näytöt tekevät stack trace -lukemisesta tuskaista
• Visuaaliseen työhön — CSS- ja asettelumuutokset vaativat täyden näytön
• Laajamittaiseen refaktorointiin — laajat muutokset halutaan tarkistaa kunnon näytöltä

Rakentaminen ZBuild-alustalla mistä tahansa

Kehittäjille, jotka haluavat rakentaa ja iteroida sovelluksia mobiilisti, alustat kuten ZBuild täydentävät Claude Code -etätyönkulkua. ZBuild tarjoaa visuaalisen sovellusrakentajan, joka toimii hyvin tableteilla ja se voidaan yhdistää Claude Code -työkaluun monimutkaisempaa backend-logiikkaa varten — antaen sinulle full-stack-kehitysmahdollisuuden, joka ei vaadi työpöytätyöasemaa.

Osa 8: Vianetsintä

Yleiset ongelmat ja korjaukset

Ongelma: "Remote Control not available on your plan" Korjaus: Varmista, että käytössäsi on Pro, Max, Team tai Enterprise. Free-taso ei tue Remote Control -ominaisuutta.

Ongelma: QR-koodi ei skannaudu Korjaus: Varmista, että Claude-sovelluksesi on päivitetty uusimpaan versioon. Kokeile käyttää istunnon URL-osoitetta suoraan skannaamisen sijaan.

Ongelma: mosh-yhteys katkeaa eikä yhdistä uudelleen Korjaus: Varmista, että mosh-server on käynnissä työpöydälläsi (which mosh-server). Tarkista, että Tailscale on yhdistetty molemmilla laitteilla. Varmista, että UDP-portit 60000-61000 ovat auki, jos et käytä Tailscalea.

Ongelma: tmux-istunto näyttää tyhjää näytön uudelleenyhdistämisen jälkeen Korjaus: Aja tmux attach -t claude uuden istunnon luomisen sijaan. Jos istunto kuoli, tarkista kaatuiko Claude Code katsomalla lokit kohteesta ~/.claude/logs/.

Ongelma: ntfy-ilmoitukset eivät saavu Korjaus: Varmista, että ntfy-palvelin on käynnissä (curl http://100.64.x.x:8090/health). Tarkista, että ntfy-sovelluksen tilaus-URL vastaa palvelimesi osoitetta. Varmista, että puhelimesi Tailscale-yhteys on aktiivinen.

Ongelma: Claude Code -istunto vanhentui puhelimen ollessa irti verkosta Korjaus: Näin käy Remote Control -ominaisuuden kanssa pitkän passiivisuuden jälkeen. Käytä tmux-pohjaista asennusta istunnoille, joiden on säilyttävä tuntikausia. tmux-istunnot säilyvät loputtomiin riippumatta asiakasyhteyksistä.

Ongelma: Kirjoittaminen on hidasta mobiililaitteella Korjaus: Käytä äänisyöttöä (Happy Coder) tai pidä viestit lyhyinä ja tehtäväkeskeisinä. Vaihtoehtoisesti valmistele kehotteet muistiinpanosovelluksessa ja liitä ne terminaaliin.

Osa 9: Turvallisuusnäkökohdat

Remote Control -turvallisuus

• Kaikki liikenne on salattu TLS:llä Anthropic API:n kautta
• Istuntojen URL-osoitteet ovat yksilöllisiä ja vanhenevat käytön jälkeen
• Koneellesi ei avata saapuvia portteja
• Kirjautumistietosi ja tiedostosi eivät koskaan poistu koneeltasi (vain Claude Code:n tekstimuotoinen tuloste välitetään)

SSH-turvallisuuden parhaat käytännöt

Kun avaat SSH-yhteyden mobiilikäyttöä varten:

# 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

Tailscale-turvallisuus

Tailscalen WireGuard-pohjainen verkko tarjoaa:

• Päästä päähän -salauksen laitteiden välillä
• Ei datan reititystä Tailscalen palvelimien kautta (suorat yhteydet)
• MagicDNS helppoon isäntänimen selvitykseen
• Access control lists (ACLs) tiimiasetuksia varten

Johtopäätös

Claude Code -etäkäyttö vuonna 2026 vaihtelee erittäin yksinkertaisesta (yksi /rc-komento) täysin räätälöityyn (SSH + tmux + mosh + ntfy + Tailscale). Oikea asennus riippuu työnkulustasi:

• Remote Control nopeisiin mobiilitarkistuksiin nolla-asennuksella
• SSH-pino kehittäjille, jotka elävät terminaalissa ja tarvitsevat maksimaalista sietokykyä
• Happy Coder ilmaisena, ominaisuusrikkaana keskitienä

Käytännön vaikutus on merkittävä. Kehitystyö ei ole enää sidottu työpöydän ääreen kannettavan tietokoneen ollessa auki. Voit aloittaa tehtävän, kävellä pois ja säilyttää hallinnan. Rakensitpa sitten sivuprojektia, hallitsit tiimin koodikantaa tai prototyypit sovellusta ZBuild avulla, mobiili Claude Code -pääsy tarkoittaa, että kehitystyön kulkusi seuraa sinua, ei toisinpäin.

Lähteet

• 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