Näin päivität Claude Coden uusimpaan versioon vuonna 2026

Claude Code muuttuu lähes joka päivä. Avaat uusimman muutoslokin ja löydät uusia komentoja, korjattuja bugeja ja nopeusparannuksia. Samaan aikaan päätteessäsi on kaksi viikkoa vanha versio, eivätkä puolet näistä parannuksista yksinkertaisesti toimi. Claude ei kerro siitä sinullekaan: se käynnistyy tavalliseen tapaan, ja jäät ihmettelemään, miksi muilla on ominaisuus, jota sinulla ei ole.

Käyn läpi, miten tarkistat versiosi, päivität uusimpaan versioon ja toimit, jos päivitys ei asennu. Komennot on lainattu täsmälleen Claude Coden virallisesta dokumentaatiosta, ja ne tarkistettiin syyskuun 2026 alussa. Tuolloin uusin julkaistu versio oli 2.1.261, mutta sinun versionumerosi on erilainen. Tietyn numeron tavoittelussa ei ole järkeä – tärkeintä on yksinkertaisesti käyttää tuoretta versiota.

Tietoa Ailootin käytöstä on saatavilla dokumentaatiossa.

Miten päivität Claude Coden nopeasti uusimpaan versioon?#

Selitän jokaisen tapauksen tarkemmin alla, mutta jos sinulla on kiire, nämä kolme komentoa kattavat lähes kaikki tilanteet.

claude --version   # mikä versio on nyt asennettuna
claude update      # päivitä heti (natiivi asennus)
claude doctor      # tarkista asennus ja päivitykset

Ensimmäinen näyttää version, toinen päivittää sen ja kolmas selvittää ongelmat, jos jokin menee pieleen. Alla selitän, milloin kutakin komentoa kannattaa käyttää ja miksi claude update ei toimi kaikilla.

Miten tarkistat, mikä Claude Coden versio on tällä hetkellä asennettuna?#

Ennen päivittämistä kannattaa tietää, mistä versiosta päivität. Komento on yksinkertainen:

claude --version

Saat rivin, joka näyttää tältä: 2.1.211 (Claude Code). Se on nykyinen versiosi. Vertaa kahta ensimmäistä numeroa muutoslokin uusimpaan numeroon – jos omasi on paljon pienempi, on aika päivittää.

Jos haluat laajemman yleiskuvan, suorita claude doctor. Se vain tarkistaa asioita eikä muuta mitään: se ei käynnistä istuntoa, mutta näyttää asennuksen tilan, asetustiedoston virheet sekä varoitukset ja valmiit ehdotukset korjattavista asioista. Se näyttää myös viimeisimmän automaattisen päivitysyrityksen tuloksen – hyödyllistä, jos epäilet taustapäivityksen epäonnistuneen hiljaisesti.

Päivittyykö Claude Code itsestään?#

Kaikki riippuu siitä, miten asensit Claude Coden. Natiivi asennus – jota Anthropic suosittelee ja jonka verkkosivuston skripti asentaa – voi päivittyä itsestään, kuten dokumentaatiossa sanotaan suoraan.

Näin se toimii: Claude Code tarkistaa päivitykset käynnistyksen yhteydessä ja säännöllisesti käytön aikana. Jos se löytää uuden version, se lataa ja asentaa sen taustalla ja ottaa sen käyttöön seuraavalla käynnistyskerralla. Sulje ja avaa istunto uudelleen parin päivän välein, niin olet taas ajan tasalla.

Voit tarkistaa viimeisimmän taustapäivitysyrityksen tuloksen samalla claude doctor -komennolla. Se näyttää, jos päivityksen asennus epäonnistui jostain syystä.

Jos kuitenkin asensit Claude Coden paketinhallinnan kautta – Homebrew’n MacBookiin, WinGetin Windowsiin tai apt:n tai dnf:n Linuxiin – taustapäivitystä ei ole. Tällaiset asennukset päivitetään tavallisella päivityskomennolla; siitä on oma osionsa alla.

Tuore Claude Code -versio on perusta, mutta se ei yksin vie sinua perille. Johdonmukaiset tulokset eivät synny työkalun versiosta vaan siitä, miten työskentelet sen kanssa.

Miten päivität Claude Coden manuaalisesti yhdellä komennolla?#

Sinun ei tarvitse odottaa taustatarkistusta uuden version havaitsemiseksi. Tällä komennolla voit päivittää heti:

claude update

Mahdollisia tuloksia on kaksi. Jos päivitys löytyy ja asennetaan, Claude Code näyttää esimerkiksi rivin Successfully updated from <old version> to version <new version>. Jos käytössäsi on jo uusin versio, näet viestin Claude Code is up to date (<version>) – se tarkoittaa, ettei päivitettävää ole.

Tähän komentoon liittyy yksi mutka, kun käytössä on paketinhallinta. Jos Claude Code asennettiin Homebrew’n, WinGetin tai apk:n kautta, claude update antaa lyhyemmän vastauksen – Claude is up to date! – eikä aina hae uutta versiota itse. Näissä asennuksissa on luotettavampaa käyttää paketinhallinnan omaa päivityskomentoa, joka esitellään alla.

Miten päivität Homebrew’n tai WinGetin kautta asennetun Claude Coden?#

Jos asensit Claude Coden paketinhallinnan kautta verkkosivuston skriptin sijasta, vastaat itse sen päivittämisestä. Tässä ovat kunkin järjestelmän komennot.

macOS:ssä Homebrew’llä:

brew upgrade claude-code

Homebrew tarjoaa kaksi vaihtoehtoa. Claude Codea on kahta versiota. claude-code seuraa stable-kanavaa – noin viikon vanhaa versiota, josta vakavia ongelmia sisältävät julkaisut on jätetty pois. claude-code@latest saa uusimman version heti sen julkaisun jälkeen. Päivitä asentamasi versio: jos käytössäsi on claude-code@latest, komento on brew upgrade claude-code@latest.

Windowsissa WinGetillä:

winget upgrade Anthropic.ClaudeCode

WinGet-päivitys epäonnistuu joskus Claude Coden ollessa käynnissä, koska Windows käyttää suoritettavaa tiedostoa. Claude Code näyttää tällöin manuaalisen komennon; sulje ohjelma ja suorita päivitys uudelleen.

Linuxissa apt:n, dnf:n tai apk:n kanssa ei tarvitse opetella erillistä komentoa – uusin versio tulee tavallisen järjestelmäpäivityksen mukana, koska Claude Code julkaisee allekirjoitettuja pakettivarastoja.

Jos et halua pitää tätä mielessä, voit käyttää ympäristömuuttujaa CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Aseta sen arvoksi 1, niin Claude Code suorittaa päivityksen taustalla Homebrew’n ja WinGetin kanssa ja ehdottaa onnistuneen päivityksen jälkeen uudelleenkäynnistystä. Dokumentaatiossa mainitaan varaus: Claude Code ilmoittaa joskus uudesta versiosta ennen kuin se on tosiasiassa ilmestynyt paketinhallintaan. Jos päivitys ei löydä uutta versiota, odota hetki ja yritä uudelleen.

Jos vielä harkitset, miten asennat Claude Coden, erillisessä artikkelissa on yksityiskohtainen opas Claude Coden asentamiseen – myös siitä, miksi natiivi asennusohjelma on paketinhallintoja kätevämpi.

Miksi Claude Code ei päivity, ja mitä sinun pitäisi tehdä?#

Joskus päivität kerta toisensa jälkeen, mutta claude --version näyttää itsepintaisesti vanhaa numeroa. Käyn läpi tärkeimmät syyt alkaen yleisimmästä.

Tarkista ensin, onko sinulla useita Claude Code -asennuksia samaan aikaan. Näin voi käydä, jos asensit sen ensin npm:n kautta ja asensit sen myöhemmin uudelleen natiivisti. Komento päivittää yhden kopion, mutta pääte käynnistää toisen, joten versio näyttää pysyvän ennallaan. Tarkista, kuinka monta kopiota sinulla on:

which -a claude

Claude Code voi sijaita kolmessa paikassa: ~/.local/bin/claude on natiivi asennus, ~/.claude/local/ on vanha paikallinen npm-asennus varhaisista versioista, ja globaalin npm-paketin näkee komennolla npm -g ls @anthropic-ai/claude-code. Jos löydät useamman kuin yhden, pidä vain yksi – mieluiten natiivi asennus. Poista ylimääräiset näin:

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

Toinen yleinen syy on globaali npm-kansio, johon ei voi kirjoittaa. Jos asensit Claude Coden globaalisti npm:llä eikä sillä ole oikeutta kirjoittaa kansioonsa, taustapäivitys ei asennu. Claude Code näyttää käynnistyksen yhteydessä kertaluonteisen ilmoituksen, ja claude doctor kertoo tarkalleen, mitä pitää korjata. Tämä on toinen syy suosia natiivia asennusta: se kirjoittaa kotikansioosi eikä vaadi näitä oikeuksia.

Kolmas tilanne on se, että olet joskus korvannut käynnistimen ~/.local/bin/claude omalla skriptillä tai symbolisella linkillä. Versiosta 2.1.207 alkaen automaattiset päivitykset jättävät tällaisen käynnistimen rauhaan: uudet versiot asennetaan yhä kansioon ~/.local/share/claude/versions/, mutta skriptisi valitsee käynnistettävän version. Älä poista ainoaa käynnistintäsi ja kutsu sitten claude update -komentoa nimellä. Säilytä ensin oma käynnistin ja symbolisen linkin tapauksessa sen kohde erillisessä käyttämättömässä varmuuskopiosijainnissa. Siirrä oma käynnistin pois alkuperäisestä polusta vasta kopion todentamisen jälkeen. Palauta natiivi käynnistin virallisella asentimella, joka ei tarvitse olemassa olevaa claude-komentoa:

# macOS, Linux tai WSL: virallinen natiiviasennin
curl -fsSL https://claude.ai/install.sh | bash

Avaa asentimen valmistuttua uusi terminaali ja varmista tulos:

claude --version
claude doctor

Ensimmäisen komennon pitää tulostaa versionumero. Tarkista doctor-tulosteesta käynnistimen tai PATHin varoitukset ennen jatkamista. Älä poista säilytettyä käynnistintä ennen korvaajan toimimista.

Toinen oire on, että claude update tai claude doctor jumittuu heti rivin Checking for updates jälkeen. Vanhemmissa versioissa (ennen versiota 2.1.214) näin kävi joskus, kun jokin komentotulkin asetustiedosto, kuten ~/.zshrc, olikin tiedoston sijaan kansio. Uusimmat versiot ohittavat tämän, joten päivittäminen uusimpaan versioon korjaa myös virheen.

Miten valitset päivityskanavan: latest vai stable?#

Uusimpaan versioon päivittäminen ei aina tarkoita uusimman version asentamista heti sen ensimmäisenä julkaisupäivänä. Claude Code antaa valita kahdesta kanavasta, mikä vaikuttaa siihen, mitä saat päivittäessäsi.

latest-kanava on oletus. Uudet ominaisuudet tulevat saataville heti niiden julkaisun jälkeen, mikä on kätevää, jos haluat kokeilla niitä ensimmäisten joukossa. stable-kanava tarjoaa noin viikon vanhan version: se on ehtinyt vakiintua ja jättää vakavia ongelmia sisältävät julkaisut väliin. Se sopii niille, jotka arvostavat mielenrauhaa enemmän kuin nopeutta.

Helpoin tapa vaihtaa kanavaa on käyttää Claude Coden sisäistä /config-komentoa kohdassa Auto-update channel. Voit myös lisätä asetuksen käsin settings.json-asetustiedostoon:

{
  "autoUpdatesChannel": "stable"
}

Jos haluat mukauttaa Claude Coden omiin tapoihisi, erillisessä oppaassa neuvotaan Claude Coden mukauttamisessa – siinä käsitellään koko asetustiedosto, ei vain päivityskanavaa.

Miten asennat tietyn version tai määrität vähimmäisversion?#

Joskus tarvitset tietyn version uusimman sijaan – esimerkiksi palataksesi versioon, jossa työnkulku varmasti toimi. Natiivi asennusohjelma tukee tätä: se hyväksyy sekä kanavan nimen että tarkan versionumeron. Asenna tietty versio näin:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

Windowsissa vastaava PowerShell-komento näyttää hieman erilaiselta:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

Voit asentaa stable-kanavan samalla tavalla: kirjoita numeron sijaan stable. Asennuksen aikana valitsemastasi kanavasta tulee tulevien automaattisten päivitysten oletuskanava.

Jos haluat suojautua vanhempaan versioon palaamiselta, aseta vähimmäisversio settings.json-tiedostossa:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

Tämä on alaraja. Taustapäivitys tai claude update ei asenna määritettyä versiota vanhempaa versiota. Tämä on hyödyllistä, kun vaihdat stable-kanavalle etkä halua palata käyttämääsi uudempaa versiota vanhempaan.

Miten poistat automaattiset päivitykset käytöstä, jos ne häiritsevät?#

Joskus taustapäivitykset ovat tiellä – esimerkiksi, kun haluat pitää tiimisi täsmälleen samassa versiossa. Voit poistaa ne käytöstä asetustiedoston kautta:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Tärkeä yksityiskohta: DISABLE_AUTOUPDATER hiljentää vain taustatarkistuksen. claude update -komento toimii edelleen, joten voit yhä päivittää manuaalisesti. Jos sinun on estettävä kaikki päivitystavat kerralla, myös manuaaliset päivitykset, voit käyttää tiukempaa muuttujaa DISABLE_UPDATES. Sitä käytetään, kun jaat Claude Coden oman kanavasi kautta ja haluat käyttäjien pysyvän täsmälleen tarjoamassasi versiossa.

Tavallisessa henkilökohtaisessa käytössä näitä muuttujia ei kannata muuttaa: uudempi Claude Code -versio on lähes aina vanhaa parempi, ja päivitys voi tuoda mukanaan tietoturvakorjauksen. Työkalun pitäminen ajan tasalla auttaa säilyttämään käyttöoikeuden ja välttämään omituisia bugeja; erillisessä artikkelissa kerrotaan, miten vältät Claude-tilisi menettämisen.

Mistä kannattaa aloittaa?#

Tässä on lyhyt toimintasuunnitelma.

1. Tarkista nykyinen versiosi komennolla claude --version. Vertaa sitä muutoslokin uusimpaan numeroon.
2. Päivitä. Natiivi asennus – claude update. Homebrew – brew upgrade claude-code. WinGet – winget upgrade Anthropic.ClaudeCode.
3. Käynnistä Claude Code -istunto uudelleen, jotta uusi versio tulee käyttöön.
4. Jos versio ei ole muuttunut, suorita claude doctor ja which -a claude. Sinulla on luultavasti useita asennuksia tai npm-kansio, johon ei voi kirjoittaa.
5. Valitse sinulle sopiva kanava: latest, jos haluat uudet ominaisuudet heti niiden ilmestyessä, tai stable, jos ennakoitavuus on tärkeämpää. Vaihda kanavaa komennolla /config.

Tuore versio korjaa bugeja ja lisää uusia komentoja, mutta päivitetty työkalu ei rakenna projektiasi puolestasi. Opas Claude Code -vaihtoehtoihin selittää, miten Claude Code eroaa muista päätetyökaluista ja milloin vaihtoehtojen harkitseminen on järkevää.

Tutustu Ailootiin.