Claude Code Remote Control: Näin koodaat puhelimellasi QR-koodin avulla vuonna 2026

Lisää ohjeita on Ailoot-dokumentaatiossa.

Mikä Remote Control on, ja miksi koodata puhelimella?#

Anthropic julkaisi Remote Controlin 24. helmikuuta 2026. Anthropic kuvaa sitä tavaksi jatkaa paikallisia istuntoja millä tahansa laitteella.

Yksinkertaisesti: käynnistät istunnon terminaalissa tavalliseen tapaan. Ota Remote Control käyttöön. Avaa puhelimen Claude-sovellus → Code-välilehti → näet istuntosi vihreän pisteen kanssa. Napauta sitä, lue ja vastaa. Voit kirjoittaa kannettavallasi, puhelimellasi ja selaimellasi missä tahansa yhdistelmässä – kaikki synkronoituu.

Virallinen Remote Control -dokumentaatio erottaa paikallisen suorituksen verkkoliikenteestä: komennot ja tiedostojärjestelmätoiminnot suoritetaan koneellasi, mutta keskustelu synkronoidaan Anthropicin kautta.

Tämä on keskeinen ero Claude Codeen verkossa, jossa istunto toimii Anthropicin pilvi-VM:ssä. Tässä Claude toimii edelleen omalla laitteistollasi, kaikkien Git-tietovarastojesi, ympäristömuuttujiesi ja tietokanta-avaimiesi kanssa. Puhelin on vain näyttö, jolla puhut sille.

Miksi vibe-koodaaja saattaisi tarvita tätä

Kolme käytännön tilannetta, joissa kirjoittaja käytti sitä joka viikko:

1. Pitkä refaktorointi yön yli. Anna Claudelle tehtäväksi päivittää 40 tiedostoa uutta APIa varten. Jätä kannettava rauhaan. Aamulla käy sohvalle puhelimen kanssa, tarkista diff ja sano: ”Hyväksy ensimmäiset 12; näytä loput erikseen.” Kannettavaa ei tarvitse avata.
2. Hyväksy työmatkalla tarvittava vaihe. Olet metrossa, kun Claude lähettää push-ilmoituksen: ”Tarvitsen päätöksen skeeman migraatiosta.” Avaa se, lue kaksi vaihtoehtoa ja kirjoita: ”Valitse ensimmäinen vaihtoehto; älä koske testeihin.” Istunto jatkuu matkasi ajan.
3. Livestreamin tai kokouksen aikana. Zoom-kokouksessa voit tarkistaa puhelimesta, että toinen Claude-istunto on tehnyt testiversion. Sinun ei tarvitse vaihtaa pois videopuhelusta.

Mitä Remote Controlin käyttämiseen tarvitaan#

Täydellinen vaatimusluettelo:

Tarkista versiosi komennolla:

claude --version

Jos versio on vanhempi kuin 2.1.51, päivitä:

npm install -g @anthropic-ai/claude-code@latest

Jos ympäristössäsi on asetettuna ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN tai apiKeyHelper, Remote Control ei käynnisty. Versiosta v2.1.139 (11.05.2026) lähtien Anthropic estää ominaisuuden nimenomaisesti, kun nämä muuttujat ovat käytössä. Suorita unset ANTHROPIC_API_KEY ja kirjaudu uudelleen komennolla /login.

Remote Controlin käynnistäminen: 3 tapaa kahdessa minuutissa#

Tapa 1. Palvelintila – erillinen palvelin etäistunnoille

1. Avaa pääte projektikansiossa

   Siirry cd-komennolla kerran hakemistoon, jossa työskentelet. Jos kansio on uusi, suorita claude tavalliseen tapaan ja viimeistele Workspace Trust -valintaikkuna.

2. Käynnistä palvelin

   claude remote-control
   

   Pääte jää käyntiin. Alareunaan ilmestyy istunnon URL-osoite ja kehote ”Press space to show QR”. Palvelin odottaa yhteyksiä.

3. Yhdistä puhelimella

   Paina välilyöntiä – QR-koodi tulee näkyviin. Skannaa se Claude-sovelluksella tai iPhonen kameralla avataksesi istunnon.

Valinnainen: aseta istunnon nimi ja parametrit:

claude remote-control --name "Refactor API" --spawn worktree --capacity 4

• --name – istunnon nimi, joka näkyy puhelimen luettelossa.
• --spawn worktree – jokainen uusi istunto avautuu omaan Git-worktreehynsä, jotta rinnakkaiset istunnot eivät häiritse toisiaan.
• --capacity 4 – palvelimella voi olla enintään 4 samanaikaista etäistuntoa. Oletusarvo on 32.

Tapa 2. Vuorovaikutteinen tila – istuntoni, jossa Remote Control on käytössä

claude --remote-control
# or shorter:
claude --rc

Tämä käynnistää tavallisen vuorovaikutteisen istunnon terminaalissa Remote Control käytössä. Voit kirjoittaa Claudelle sekä kannettavalta että puhelimelta – kyseessä on yksi synkronoitu keskustelu.

Toisin kuin palvelintilassa, tässä on kyse yhdestä istunnosta. Se sopii tilanteeseen, jossa aiot työskennellä enimmäkseen tietokoneella ja haluat puhelimen varalle, jos joudut poistumaan.

Tapa 3. Aktiivisesta istunnosta komennolla /rc

Työskenteletkö jo Claude Codessa? Älä lopeta istuntoa. Kirjoita vain:

/remote-control

tai lyhyemmin:

/rc

Istunto muuttuu etäistunnoksi. Sen konteksti säilyy. Kätevää, kun huomaat kesken tehtävän, että sinun täytyy lähteä.

QR-koodi: yhdistä puhelin 10 sekunnissa#

1. Asenna Claude-sovellus

   Jos sinulla ei vielä ole sitä, kirjoita Claude Codeen /mobile. Näkyviin tulee QR-koodi sovelluksen lataamiseksi App Storesta tai Google Playsta. Tämä on nopeampaa kuin manuaalinen haku.

2. Näytä istunnon QR-koodi terminaalissa

   Kun olet suorittanut komennon claude --rc tai claude remote-control, paina välilyöntiä. QR-koodi ilmestyy suoraan terminaaliin.

3. Skannaa puhelimella

   Avaa Claude-sovellus → kamera tai käytä tavallista iPhonen kameraa (myös Android-kamerat voivat skannata koodin). Jos se ei toimi, levennä pääteikkunaa, vaihda iTerm2:een tai Windows Terminaliin tai kopioi QR-koodin yläpuolella oleva URL-osoite ja liitä se selaimeen.

4. Ota push-ilmoitukset käyttöön

   Kirjoita istunnossa /config ja ota käyttöön ”Push when Claude decides”. Claude Coden version on oltava 2.1.110 tai uudempi.

Mitä näet puhelimessa

Claude-sovelluksessa avautuu Code-välilehti. Istuntosi näkyy luettelossa tietokonekuvakkeen ja vihreän pisteen (online) kanssa. Avaa istunto napauttamalla sitä.

Sen jälkeen käyttö muistuttaa claude.ai/codea: voit nähdä Clauden viestit ja tiedostodiffit, hyväksyä tai hylätä ne tai pyytää muutoksia. Voit kirjoittaa uuden pyynnön. Kaikki siirtyy koneellesi, jossa paikallinen Claude käsittelee sen ja palauttaa vastauksen.

Mitä Claude voi tehdä push-ilmoituksilla

Claude lähettää push-ilmoituksia, kun se katsoo niiden olevan tarpeen. Oletusarvoisesti tämä tapahtuu kahdessa tilanteessa: pitkä tehtävä valmistuu tai Claude tarvitsee päätöksesi. Voit myös pyytää sitä suoraan: ”Ilmoita, kun testit menevät läpi”, jolloin se lähettää ilmoituksen.

Jos push-ilmoituksia ei tule:

• Tarkista iOS:ssä Asetukset → Ilmoitukset → Claude. Keskitystilat voivat hiljentää ne.
• Poista Androidissa Claude-sovelluksen akun optimointi käytöstä.
• Jos /config näyttää ”No mobile registered”, avaa Claude-sovellus vähintään kerran, jotta se voi päivittää push-tokeninsa.

Työskentelyä sohvalta: 5 hyödyllistä tilannetta#

Tilanne 1. Tarkistus sohvalta – yön yli tehdyn ajon läpikäynti

Anna ennen nukkumaanmenoa Claudelle tehtävä, kuten ”Aja koko tietovarasto uusien lint-sääntöjen läpi ja korjaa kaikki, mikä ei ole kriittistä; merkitse loput TODOksi.” Suorita claude --rc ja jätä pääte auki.

Aamulla käy sohvalle puhelimen kanssa. Avaa Claude-sovellus → näet istunnon vihreän pisteen kanssa → löydät 87 committia diffeinä. Selaa niitä; epäilyttävissä kohdissa kirjoita ”palauta tämä, korjaan sen itse”, ja siisteistä kirjoita ”hyväksy kaikki”. Sinun ei tarvitse ”mennä kannettavan luo” kello 7 aamulla.

Tilanne 2. Hyväksyntä työmatkalla – päätös metrossa

Käynnistä pitkä tietokannan skeeman migraatio aamulla. Kello 9.30 saat metrossa push-ilmoituksen: ”Löysin kaksi migraatiovaihtoehtoa; tarvitsen päätöksen.” Napauta ilmoitusta, lue vaihtoehdot, valitse toinen ja lisää: ”Älä poista vanhaa taulua ennen kuin koko testiajo on valmis.” Claude jatkaa.

Ilman Remote Controlia Claude pysähtyisi siinä ja odottaisi hiljaa. Saavut perille ja avaat kannettavasi – 40 minuuttia menetetty.

Tilanne 3. Poistumisen malli – pitkä tehtävä lounaan aikana

Käynnistä ennen lounasta Claude tehtävällä ”Päivitä kaikkien endpointien dokumentaatio”. Lähde kahvilaan. 25 minuutin kuluttua tulee push-ilmoitus: ”Valmis, katso.” Napauta ”hyväksy” kerran ja palaa sitten keiton pariin. Ilman Remote Controlia joko istut kannettavasi ääressä 25 minuuttia vartijana tai palaat ja huomaat, ettei Claude tehnyt mitään koko aikana, koska se osui päätöskohtaan.

Tämä on tärkeä huomio. Remote Control ei tee Claudesta itsenäisempää – se antaa sinulle vain pääsyn mistä tahansa. Mitä vähemmän päätöskohtia Claude kohtaa, sitä vähemmän push-ilmoituksia saat. Tee tehtävän ohjeista siis tarkempia: ”Tee näin; tee näissä tilanteissa näin; jos asia on todella epäselvä, pysähdy ja lähetä push-ilmoitus.”

Tilanne 4. Arkkitehtuuripäätös kahvilasta

Refaktoroinnin aikana Claude löytää kaksi migraatiotapaa ja pyytää sinua valitsemaan. Jos olet poissa tietokoneelta, avaa ehdotetut diffit puhelimellasi, valitse vaihtoehto ja lisää kommentti: ”Älä kuitenkaan koske user_settings-tauluun – poistan sen ensi viikolla.” Istunto jatkuu.

Tämä toimii erityisen hyvin worktree-tilassa (--spawn worktree): jokainen rinnakkainen tehtävä on omassa haarassaan, joten ne eivät häiritse toisiaan. Voit vaihtaa niiden välillä puhelimessa kuin keskusteluissa.

Tilanne 5. Useita worktree-istuntoja yhtä aikaa

Yksi tehokas tapa on käyttää palvelintilaa ja useita worktreeitä. Käynnistä tämä kannettavallasi:

claude remote-control --spawn worktree --capacity 4

Käynnistä puhelimestasi istuntoja eri haaroissa: yksi rakentaa ominaisuutta, toinen korjaa luettelon bugeja ja kolmas suorittaa regressiotestit. Kaikki toimivat rinnakkain kannettavallasi; mikään ei estä toisiaan.

Tietoturva: mikä pysyy tietokoneellasi ja mitä lähetetään#

Päätä ennen arkaluonteisen projektin yhdistämistä, mitä sisältöä kehotteisiin ja työkalutulosteisiin saa päätyä. Pidä tuotannon salaisuudet agentin käyttöympäristön ulkopuolella. Tiedonsiirtotaulukko ei todista, ettei tietty istunto voisi paljastaa niitä.

Arkikielellä kannettavasi kysyy Anthropicilta: ”Onko minulle viestejä?”, vastaanottaa vastauksen ja käsittelee sen paikallisesti. Kukaan ulkopuolinen ei avaa saapuvaa porttia koneellesi. Yrityksen palomuuri sallii tämän ilman erityisiä asetuksia.

Mitä Anthropiciin fyysisesti lähetetään

Remote Control lisää synkronoidun käyttöliittymän, ei verkotonta päättelytilaa. Anthropic tallentaa yhdistetyn istunnon keskustelutallenteen, mukaan lukien viestit, vastaukset ja työkalutoiminnan, tietojenkäyttökäytäntönsä mukaisesti. Tarkista sekä mallille lähetettävä sisältö että yhdistettyjen laitteiden pääsy.

Huomautus tunnistetiedoista

Toisin sanoen lyhytikäisten tunnusten joukko kiertää kannettavasi, Anthropicin ja puhelimesi välillä yhden pitkäikäisen tunnuksen sijasta. Yhden vaarantuminen ei anna pääsyä niihin kaikkiin.

Vielä yksi tärkeä rajoitus: --dangerously-skip-permissions ei toimi Remote Controlissa. Jokainen työkalukutsu (Bash, Write, Edit) odottaa edelleen hyväksyntääsi. Tämä on tarkoituksellista, jotta puhelinominaisuus ei muuttuisi ”valvomatta automaattiohjauksella toimivaksi kannettavaksi”.

Käynnistitkö Remote Controlin? Säädä nyt asiat niin, ettei Claude keskeytä sinua 10 minuutin välein#

/rc on kätevä tapa tuoda istunto puhelimeesi. Mutta jos Claude kirjoittaa ”En ymmärrä, mitä pitäisi tehdä” 10 minuutin välein, ongelma ei ole puhelimessa vaan kontekstin suunnittelussa: siinä, miten selkeästi määrität säännöt alussa.

Kuusi ensimmäisen käyttökerran ongelmaa ja niiden korjaaminen#

Ongelma 1. ”Remote Control environments are not available for your account”

Yleisin valitus anthropics/claude-code-repositoriossa (issue #29449 ja yli tusina kaksoiskappaletta). Vastasit y kysymykseen ”enable Remote Control?” – CLI palautti virheen eikä enää tarjoa uutta yritystä.

Syy on melkein aina sama: ympäristössä on asetettuna ANTHROPIC_API_KEY tai CLAUDE_CODE_OAUTH_TOKEN. Remote Control toimii vain täydellä OAuth-kirjautumisella /login-komennon kautta, ei avaimella.

Korjaus:

unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# check that the environment is clean:
env | grep -i anthropic
env | grep -i claude

# sign in again:
claude
/logout
/login

Remote Controlin pitäisi käynnistyä, kun olet kirjautunut uudelleen selaimen kautta komennolla /login.

Ongelma 2. Puhelin ei skannaa QR-koodia

Puhelimen kamera osoittaa koodia, mutta ei reagoi tai ilmoittaa: ”Tätä ei voi lukea.”

Syy: pääte näyttää QR-koodin liian pienenä tai liian vähäkontrastisena.

Korjaus:

1. Suurenna pääteikkuna koko näytön kokoiseksi.
2. Jos käytät Apple Terminalia, vaihda iTerm2:een (tai Warpiin). Jos käytät Windowsia, käytä Windows Terminalia CMD:n sijasta.
3. Pienennä päätteen fonttikokoa 1–2 pistettä, jotta QR-koodi näkyy suurempana.
4. Jos tämä ei auta, kopioi QR-koodin yläpuolella oleva URL-osoite ja avaa se puhelimen selaimessa.

Ongelma 3. Palomuuri estää portin 443

Näin käy tavallisesti yritystietokoneissa, joissa on liikennettä sieppaava välityspalvelin (Zscaler tai MITM:ää käyttävä yrityksen VPN).

Korjaus: aloita yksityiskohtaisella lokituksella ja tallenna tarkka virhe:

claude remote-control --verbose

Jos näet virheen ”certificate verification failed”, yhteyttä tarkkaillaan MITM-välityksellä ja sinun on keskusteltava verkkosi järjestelmänvalvojan kanssa. Jos näet ”connection refused” / ”timeout”, pyydä järjestelmänvalvojaa sallimaan ulospäin suuntautuva yhteys osoitteeseen *.anthropic.com:443.

Ongelma 4. Claude Code on liian vanha

Tarkista:

claude --version

Jos versio on vanhempi kuin 2.1.51, päivitä:

npm install -g @anthropic-ai/claude-code@latest

VS Code -laajennus edellyttää vähintään versiota v2.1.79. Push-ilmoitukset edellyttävät versiota v2.1.110.

Ongelma 5. Push-ilmoitukset eivät saavu

Tilanne: Remote Control toimii, mutta puhelimesi pysyy hiljaisena, kun Claude saa pitkän tehtävän valmiiksi.

Tarkistuslista:

1. Suorita /config istunnossa. Jos komento näyttää ”No mobile registered”, avaa Claude-sovellus puhelimellasi vähintään kerran, jotta se voi päivittää push-tokenin.
2. iOS: Asetukset → Ilmoitukset → Claude → varmista, että ilmoitukset ovat käytössä eivätkä Keskittyminen-tila hiljennä niitä.
3. Android: avaa akkuasetukset ja poista Claude akun optimoinnista.
4. Jos iOS:n ilmoitusyhteenveto on käytössä, push-ilmoitus voi saapua mutta näkyä tuntikohtaisessa yhteenvedossa. Poista Clauden yhteenveto käytöstä.

Ongelma 6. Claude Desktop rikkoo /remote-control-komennon

Jos suoritat Claude Desktop -sovelluksessa /remote-control, saat virheen ”Remote Control requires a full-scope login token” (GitHub issue #48378).

Syy: Claude Desktop syöttää OAuth-tokenin, jolla on rajalliset käyttöoikeudet (vain päättely).

Korjaus: suorita Claude Code tavallisessa järjestelmän terminaalissa, älä Claude Desktopiin sisäänrakennetussa terminaalissa. Tämä on tunnettu rajoitus; Anthropic työskentelee korjauksen parissa.

Lisäongelma. Automaattinen uudelleenyhdistäminen lakkaa toimimasta pitkissä istunnoissa ilman ilmoitusta

Oire: Remote Control -istunto toimii 30–60 minuuttia, minkä jälkeen puhelin katkaisee yhteyden hiljaisesti ilman merkkiä siitä (issue #34255). Korjaa ongelma manuaalisesti: /remote-control → Disconnect → käynnistä uudelleen. Se ei ole ihanteellista, mutta ominaisuus on edelleen tutkimuskäytössä oleva esikatseluversio.

Pelkästään toukokuussa 2026 Anthropic julkaisi kahdeksan nimenomaan Remote Controliin liittyvää korjausta – ominaisuutta kehitetään aktiivisesti. Ongelmiin voi toki olla tyytymätön, mutta on kohtuullista odottaa useimpien häviävän parissa kuukaudessa.

Remote Control verrattuna Telegram-botteihin ja SSH+tmuxiin#

Vertailutaulukko

Milloin valita kukin vaihtoehto

• Remote Control – oletusratkaisu, kun haluat ”jättää kannettavan ja jatkaa työn ohjaamista”. Täysi käyttöliittymä, laitteiden välinen synkronointi eikä kolmannen osapuolen palveluita.
• Channels (Telegram-botti) – kun haluat, että CI-virhe, uusi asiakasvalitus tai chat-viesti saa Clauden automaattisesti tutkimaan asiaa. Kyseessä on ”tapahtuma → Claude reagoi”, ei ”ohjaan Claudea puhelimeltani”. Lue lisää Telegramia ja Claude Codea käsittelevästä oppaasta.
• SSH + tmux – kun tarvitset puhelimellasi yleiskäyttöisen komentotulkin omille komennoillesi (julkaisun käyttöönotto, lokin tarkistaminen, palvelun käynnistäminen uudelleen). Yleiskäyttöinen komentotulkki Claude Coden ulkopuolella. Yksittäisiin tehtäviin se toimii Termuxin/Blinkin kautta.
• Muut koodausagentit – Anthropicin Remote Control toimii vain Claude Coden kanssa. Claudea ja vaihtoehtoja vertaillaan oppaassa Cursor vs Claude Code.

Anthropicin omassa dokumentaatiossa nämä kaksi ominaisuutta erotetaan siis käyttötarkoituksen perusteella: Remote Control on ohjaamista varten; Channels reagointia varten.

Remote Controlin uudet ominaisuudet toukokuusta 2026 kesäkuuhun 2026#

Täydellinen korjausaikajana:

Kahdeksan Remote Controliin liittyvää korjausta kuukaudessa on tavallista tutkimuskäytössä olevalle esikatseluominaisuudelle. Anthropic reagoi selvästi palautteeseen ja korjaa reunatapauksia.

Jos ominaisuus toimii oudosti, tarkista ensin versio ja päivitä. On hyvin mahdollista, että virhe on jo korjattu.

Tarkistuslista: määritä asetukset ja ota toiminto käyttöön 5 minuutissa#

1. Tarkista Claude Code -versiosi

   claude --version – sen pitäisi olla 2.1.51 tai uudempi. Jos näin ei ole, suorita npm install -g @anthropic-ai/claude-code@latest.

2. Poista API-avaimet ympäristöstä

   Suorita unset ANTHROPIC_API_KEY ja unset CLAUDE_CODE_OAUTH_TOKEN. Suorita sitten /logout → /login selaimen kautta.

3. Asenna Claude-sovellus puhelimeesi

   Suorita Claude Code -istunnossa /mobile, niin saat QR-koodin App Storeen / Google Playhin.

4. Käynnistä Remote Control

   Suorita claude --rc tai istunnon sisällä /rc. Näkyviin tulee URL ja kehote ”Press space to show QR”.

5. Skannaa QR-koodi puhelimellasi

   Paina terminaalissa välilyöntiä → käytä kameraa tai Claude-sovellusta. Suurenna pääteikkunaa, jos koodi ei skannaudu.

6. Ota push-ilmoitukset käyttöön

   /config → ”Push when Claude decides”. Jos näet ilmoituksen ”No mobile registered”, avaa Claude-sovellus vähintään kerran.

7. Käynnistä pitkä tehtävä ja poistu

   Tee kehotteesta täsmällinen: ”Tee näin; näissä tapauksissa tee noin; epäselvissä tapauksissa lähetä push-ilmoitus.” Jatka sitten työskentelyä puhelimella push-ilmoitusten avulla.

Eräässä käytännön esimerkissä tyhjästä aloittamisesta ensimmäiseen sohvalta käytyyn keskusteluun kului 3–5 minuuttia.

Kun olet valmis, tutustu Ailootiin.