Claude Code -etäkatkosten vianetsintä: kuuden katkaisutyypin oireet, kriteerit ja ratkaisut

Kun käytät Claude Codea etänä, pahinta ei ole se, ettei yhteys muodostu, vaan että yhteys katkeaa sen jälkeen, kun se on muodostettu, ja joka kerta syy on erilainen.

Sana "katkeaminen" itse asiassa peittää alleen kuusi täysin erilaista vikaa. Niiden oireet ovat erilaisia, eivätkä korjaustavat liity toisiinsa — jos kohtelee verkon vaihdosta johtuvaa pitkän yhteyden katkeamista koneen nukkumisena, virransäästön poistaminen ei auta; jos kohtelee puolikuollutta yhteyttä huonona verkkona ja jää odottamaan, se ei parane itsestään edes aamunkoittoon mennessä.

Tämä artikkeli päättelee syyn sen perusteella, mitä todella näet: jokaiselle katkaisutyypille annetaan oireet, miten sen tunnistaa, ja vastaava ratkaisu. Jos haluat ryhtyä heti toimiin, hyppää viimeisen osion vianetsintälistaan.

Tämä käsittelee vain katkeamisten vianetsintää. Etäkäytön rakentamisesta katso Claude Code -etäkäyttö: hallitse istuntoja mistä tahansa, vaikka paikallinen kone olisi pois päältä ja mobiilikäytöstä katso Claude Code puhelimella: tarkastele istuntoja ja hyväksy työkaluja iOS:lla milloin vain.

Tunnista ensin oireet: minkä tyyppisen näet

Etäyhteys koostuu kahdesta osasta: Claude Codea suorittava kehityskone ←→ katselulaite käsissäsi. Kummassa tahansa osassa ilmenevä ongelma näkyy "katkenneena", mutta oireet eroavat:

Näkemäsi oire	Todennäköinen syy	Siirry
Istunto pysähtyy yhtäkkiä, ja uudelleen yhdistettäessä edistyminen on pysähtynyt samaan hetkeen	Kehityskone nukkuu / lukittu	§1
Katkeaa hetkellä, kun menet hissiin, vaihdat 4G:hen tai vaihdat WiFiä	Pitkä yhteys katkaistaan	§2
Kun paikallinen pääte suljetaan tai paikallinen kone nukkuu, etäyhteys katkeaa heti	Näytön peilausratkaisun kova rajoite	§3
Näyttää olevan yhteydessä, mutta viestit katoavat eikä virheitä tule	Puolikuollut yhteys	§4
Uudelleenyhdistäminen onnistuu, mutta yhteys palautuu tyhjään istuntoon / katkeamisen aikaiset viestit ovat kadonneet	Uudelleenyhdistäminen ei palaa alkuperäiseen istuntoon	§5
Muutaman tunnin kuluttua yhdistettäessä istuntoa ei enää ole	Prosessi on kerätty talteen eikä kylmäpalautusta ole	§6

Helpoiten väärin tulkitaan neljäs tyyppi: se ei anna virheilmoitusta. Yhteyden tila on vihreä, viestit lähtevät, mutta vastausta ei koskaan tule — sitä on vaikeampi havaita kuin suoraa katkeamista, koska kaikki merkkivalot kertovat "kaikki on kunnossa".

1. Kehityskoneen nukkuminen / lukitus / kannen sulkeminen

Oireet: Istunto pysähtyy kokonaan jollakin hetkellä. Uudelleen yhdistettäessä edistyminen on edelleen siinä kohdassa, missä se katkesi, eikä askeltakaan ole edetty.

Miksi: Monet luulevat, että "kehityskone on koko ajan päällä", mutta järjestelmän lepotila, kannen sulkeminen ja ajastettu lukitus keskeyttävät Claude Code -prosessin tai tappavat sen suoraan. Katselupäässä tämä näkyy "yhtäkkiä pysähtyneenä".

Miten varmistat: Mene takaisin kehityskoneelle ja tarkista, onko prosessi edelleen olemassa ja onko järjestelmälokeissa lepotila-merkintöjä. Jos prosessi on edelleen olemassa mutta aikaleima on pysähtynyt katkeamishetkeen, se on todennäköisesti tämä.

Ratkaisu: Aseta kehityskoneen virrankäyttösuunnitelmaksi "ei lepotilaa / ei lepotilaa kannen sulkeutuessa". Tämä on ainoa tapa poistaa ongelma juurineen — mikään etäratkaisu ei pelasta konetta, joka on jo nukahtanut.

2. Verkon vaihto katkaisee pitkän yhteyden

Oireet: Katkeaminen tapahtuu hyvin selvällä hetkellä — menet hissiin, WiFi vaihtuu 4G:hen tai kotilaajakaista soittaa uudelleen keskellä yötä.

Miksi: Etäreaaliaikainen synkronointi perustuu pitkään yhteyteen (WebSocket / SSH). Kun IP muuttuu, yhteys menee heti käyttökelvottomaksi, eikä neuvotteluvaraa ole.

Miten varmistat: Jos katkeamishetki vastaa verkon vaihtamisen hetkeä, se on tämä.

Ratkaisu: Tätä tyyppiä ei voi välttää, vaan se hoidetaan automaattisella uudelleenyhdistämisellä ja takaisinvedolla (1s→2s→5s…, vältä voimakasta toistuvaa yhdistämistä katkeamisen jälkeen). Pelkkä SSH ei tähän pysty; kun yhteys katkeaa, se on katkennut, ja se on yhdistettävä manuaalisesti. Tämä on kova vaatimus ratkaisua valittaessa.

3. Näytön peilausratkaisu: paikallisen koneen on oltava auki etualalla

Oireet: Kun paikallinen pääte suljetaan tai paikallinen kone nukkuu, puhelimen päässä yhteys katkeaa heti. Kyse ei ole hitaasta aikakatkaisusta vaan synkronoinnin lakkaamisesta.

Miksi: Anthropicin virallinen Remote Control heijastaa paikallisella koneellasi parhaillaan käynnissä olevan istunnon puhelimeen/selaimeen. Sen edellytyksenä on, että paikallinen Claude Code -istunto on koko ajan auki etualalla ja että paikallinen kone on koko ajan yhteydessä. Kun paikallinen kone putoaa, etäpäässä ei ole itsenäistä elinkaarta, johon nojata.

Miten varmistat: Sulje paikallinen pääteikkuna ja katso, katkeaako etäyhteys samassa sekunnissa. Jos katkeaa, käytössäsi on näytön peilausratkaisu.

Ratkaisu: Vaihda arkkitehtuuriin, jossa kehityskoneen puolella on pysyvä taustapalvelu — se pää, jossa istunto suoritetaan, tehdään käynnistyksen yhteydessä automaattisesti käynnistyväksi taustapalveluksi, joka elää riippumattomasti katselulaitteestasi. Vaikka katselupää suljetaan, vaihdetaan tai katkeaa, istunto jatkaa normaalisti kehityskoneella. Tämä on olennainen ero "peilauksen" ja "pysyvän palvelun" välillä, eikä sitä saa aikaan parametreja säätämällä.

4. Puolikuollut yhteys (half-open): vaikein havaita

Oireet: Näyttää olevan yhteydessä, mutta viesteihin ei tule vastausta, eikä virheitäkään tule. Saattaa jumiutua muutamaksi minuutiksi tai pysyä jumissa, kunnes yhdistät manuaalisesti uudelleen.

Miksi: Kun verkko katkeaa hiljaisesti (NAT-taulukon merkinnät vanhenevat, välilaite menettää tilan, signaali on niin heikko että vain paketit katoavat mutta yhteys säilyy), TCP:n molemmat päät saattavat luulla olevansa edelleen yhteydessä, vaikka data ei enää kulje. Ilman sydämenlyöntiä molemmat osapuolet ylläpitävät tätä harhaa.

Miten varmistat: Yhteyden tila näyttää normaalilta, mutta lähetetyt viestit eivät saa kuittausta eivätkä aiheuta virhettä; kun katkaiset yhteyden ja yhdistät manuaalisesti uudelleen, toiminta palautuu heti — se on tämä.

Ratkaisu: Yhteydessä on käytettävä sydämenlyöntiä (keepalive ping): jos toiselta osapuolelta ei tule mitään vastausta sovitun ajan kuluessa, yhteys todetaan puolikuolleeksi ja se katkaistaan ja yhdistetään uudelleen aktiivisesti, eikä jäädä odottamaan. Kriteerinä on oltava "ei vastausta", ei "ei virhettä" — puolikuollut yhteys ei koskaan anna virhettä.

5. Uudelleenyhdistäminen ei palaa alkuperäiseen istuntoon / viestit katoavat

Oireet: Katkeamisen jälkeen uudelleenyhdistäminen onnistuu, yhteys palautuu joko tyhjään istuntoon tai toisen osapuolen katkeamisen aikana lähettämät viestit ovat kadonneet kokonaan.

Miksi: Uudelleenyhdistäminen luo vain uuden yhteyden eikä tilaa sitä takaisin alkuperäiseen istuntoon; katkeamisen aikaisia viestejä ei myöskään ole tallennettu sinulle.

Miten varmistat: Uudelleenyhdistämisen jälkeen istunnon tunnus on muuttunut tai historia alkaa vasta uudelleenyhdistämishetkestä.

Ratkaisu: Valitse ratkaisu, joka uudelleenyhdistämisen jälkeen tilaa automaattisesti takaisin alkuperäiseen istuntoon ja toistaa katkeamisen aikaisen historian. Jos ratkaisu vain yhdistää uudelleen mutta ei palauta istuntoa, se on turha.

6. Istuntoprosessi on kerätty talteen eikä kylmäpalautusta ole

Oireet: Lyhyet katkokset ja uudelleenyhdistämiset toimivat normaalisti, mutta kun palaat muutaman tunnin kuluttua, istuntoa ei enää ole.

Miksi: Pitkään käyttämättömänä ollut istuntoprosessi voidaan kerätä talteen, ja myös itse taustapalvelu on voinut käynnistyä uudelleen (päivitys, kaatumisen jälkeen uudelleenkäynnistys). Istunnon tila muistissa katoaa sen mukana.

Miten varmistat: Ongelma toistuu vasta pitkän katkoksen jälkeen, ei lyhyen katkoksen jälkeen.

Ratkaisu: Tarvitaan kylmäpalautuskyky — istunnon tila tallennetaan levylle, ja vaikka prosessi katoaisi, konteksti voidaan palauttaa levyltä. Ihannetapauksessa lähetät yhden viestin ja se palautuu automaattisesti ja jatkaa toimintaansa, huomaamattomasti.

Vikalistaus (toimii minkä tahansa ratkaisun kanssa)

Käy läpi järjestyksessä — jokainen vaihe voidaan erikseen todistaa vääräksi:

1. Nukkuuko tai lukittuuko istuntoa suorittava kone? → Poista automaattinen lepotila käytöstä, ei lepotilaa kannen sulkeutuessa. (§1)
2. Osuuko katkeamishetki yhteen verkon vaihdon kanssa? → Tarvitaan ratkaisu, jossa on automaattinen uudelleenyhdistäminen + takaisinveto; älä luota pelkkään SSH:han. (§2)
3. Katkeaako etäyhteys heti, kun paikallinen pääte suljetaan? → Näytön peilausratkaisun kova rajoite; on vaihdettava pysyvään taustapalveluarkkitehtuuriin. (§3)
4. Jumissa tilassa "näyttää olevan yhteydessä mutta viesteihin ei tule vastausta"? → Puolikuollut yhteys; vain sydämenlyönnin tunnistus voi pelastaa sen automaattisesti. (§4)
5. Uudelleenyhdistämisen jälkeen istunto on tyhjä / viestejä puuttuu? → Tarvitaan "palautus alkuperäiseen istuntoon + historian toisto". (§5)
6. Istunto katoaa vain pitkän katkoksen jälkeen? → Tarvitaan tallennus levylle + kylmäpalautus. (§6)

Konkreettisiin ratkaisuihin

Edellisistä kuudesta kohdasta vain kohta 1 on oman koneesi asetusongelma; loput viisi ovat arkkitehtuurin määräämiä — ne päätetään ratkaisua valittaessa, eikä parametreja säätämällä voi pelastaa ongelman ilmaannuttua.

Katkeamattoman etäratkaisun on sisällettävä samanaikaisesti: kehityskoneen puolella pysyvä taustaprosessi (vastaa §1:n jäljellä olevaa riskiä ja §3:a), automaattinen uudelleenyhdistäminen + takaisinveto (§2), sydämenlyönnin tunnistus (§4), uudelleenyhdistämisen palautus alkuperäiseen istuntoon + historian toisto (§5) ja tallennus levylle + kylmäpalautus (§6).

PandaNpc + pandapaw -yhdistelmä on rakennettu juuri näitä kuutta kohtaa vasten: pandapaw rekisteröidään kehityskoneelle käynnistyksen yhteydessä automaattisesti käynnistyväksi pysyväksi taustapalveluksi (ei siis pääteikkuna, jota sinun on pidettävä manuaalisesti auki; kaatuessaan se käynnistyy automaattisesti uudelleen); katsojapuoli yhdistää automaattisesti uudelleen takaisinvedolla; yhteydessä ajetaan sydämenlyöntiä ja jos vastausta ei kuulu, yhteys todetaan puolikuolleeksi ja yhdistetään uudelleen; uudelleenyhdistämisen jälkeen tilaus palautetaan automaattisesti alkuperäiseen istuntoon ja katkeamisen aikainen historia toistetaan; vaikka istuntoprosessi kerättäisiin talteen, lähettämällä yksi viesti istunto palautuu levyltä kylmäpalautuksella ja jatkuu.

Tarkemmat asennus- ja yhteysohjeet: Claude Code -etäkäyttö; mobiilipään istuntojen tarkastelu ja työkalujen hyväksyntä: Claude Code puhelimella.

Lisäkompastuskivi: varo laskutusta etäkäytössä

Vianetsinnän yhteydessä tulee helposti vaihdettua claude -p (headless-tila) -tilaan, mutta 15. kesäkuuta 2026 alkaen Anthropic muutti laskutusta — headless ei enää kuluta tilauskiintiötä, vaan se käyttää pienen kuukausittaisen SDK-creditin, jonka jälkeen laskutus tapahtuu API:n mukaan, ja runsas käyttö voi ylittää budjetin helposti. Interaktiivinen tila (claude REPL) käyttää edelleen tilauskiintiötä. Kun vaihdat ratkaisua vianetsinnän vuoksi, varo ettei laskutustapa vaihdu samalla.