Claude Code update: zo werk je bij, check je je versie en lees je de changelog

Updaten

Claude Code updaten: het commando per installatiemethode

Welk commando je nodig hebt, hangt af van hoe je Claude Code hebt geïnstalleerd. Weet je dat niet meer, draai dan eerst claude doctor: dat laat je installatie zien. Updaten kost niets extra. Je hebt alleen een account nodig waarop Claude Code werkt, en dat begint bij Pro (€15 per maand bij jaarbetaling of €18 per maand, excl. btw).

Wat claude update je terugmeldt

Is er een nieuwe versie, dan zie je "Successfully updated from <oude versie> to version <nieuwe versie>". Ben je al bij, dan meldt het commando "Claude Code is up to date" met je versienummer. Zie je "Claude is up to date!", dan beheert Homebrew, WinGet of apk je installatie. In dat geval doet claude update niets en werk je bij met het commando uit de tabel.

claude update

De nieuwe versie werkt pas als je Claude Code opnieuw start. Sluit dus lopende sessies af en open een nieuwe.

Gebruik bij npm nooit npm update -g

Het voor de hand liggende npm update -g houdt zich aan het versiebereik van je eerste installatie en brengt je daardoor niet altijd naar de nieuwste release. Anthropic raadt het daarom af. Gebruik ook geen sudo: Claude Code werkt zichzelf bij zonder sudo, dus een installatie die sudo nodig had, kan zichzelf later niet bijwerken.

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

Homebrew en WinGet toch automatisch laten bijwerken

Zet de omgevingsvariabele CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE op 1. Claude Code draait dan zelf het upgradecommando op de achtergrond zodra er een nieuwe versie is en vraagt je daarna om te herstarten. Het raakt alleen het Claude Code-pakket, niet je andere software. Op WinGet kan de upgrade mislukken zolang Claude Code draait, omdat Windows het bestand vergrendelt; sluit dan alle sessies (meer Windows-specifieke tips op Claude Code op Windows). Voor apt, dnf en apk bestaat deze optie niet, omdat die commando's beheerdersrechten vragen.

Melding "update beschikbaar" maar de upgrade vindt niets

Dat is een bekend probleem: Claude Code kan een nieuwe versie melden voordat die in Homebrew of WinGet staat. Er is niets kapot. Probeer het een paar uur later opnieuw. Homebrew bewaart oude versies op je schijf; ruim ze af en toe op met brew cleanup.

Automatisch

Hoe automatische updates van Claude Code werken

Met de native installer hoef je in principe niets te doen. Claude Code kijkt bij het starten en regelmatig tijdens het werken of er een nieuwe versie is. Die wordt op de achtergrond gedownload en geïnstalleerd, en is actief bij je volgende start. Je huidige sessie wordt dus nooit midden in je werk vervangen.

Rode melding: "Auto-update failed · Run claude doctor"

Deze regel onder in je sessie betekent dat de update op de achtergrond niet is gelukt. Je kunt gewoon doorwerken. claude doctor toont dan "Last update attempt: failed (install_failed)" met een datum, maar zonder oorzaak. Draai daarom in een gewone terminal claude update: dat maakt de update af of laat de echte foutmelding zien. Die foutmelding zoek je op in de probleemsectie van de installatiegids.

Eigen launcher? Dan beslis jij welke versie draait

Op macOS en Linux is ~/.local/bin/claude een snelkoppeling naar een map met versies in ~/.local/share/claude/versions/. Heb je die snelkoppeling vervangen door een eigen script, dan laat de updater hem staan. Nieuwe versies komen wel in de versiemap, maar jouw script bepaalt wat er start. Claude Code bewaart dan ook alle versies op schijf. Wil je terug naar normaal gedrag: verwijder ~/.local/bin/claude en draai claude update.

De VS Code-extensie heeft een eigen versie

De extensie levert haar eigen kopie van Claude Code mee voor het chatpaneel. Het versienummer van de extensie is de Claude Code-versie die erin zit. Werk de extensie dus apart bij in het Extensions-overzicht van VS Code. Typ je claude in de terminal van VS Code, dan draait je losse installatie, en die kan een andere versie hebben. Meer over de extensie staat in de VS Code-tutorial.

Versie

Welke Claude Code-versie heb je? Drie manieren om het te zien

Je versie checken kost tien seconden en voorkomt een middag zoeken. Een functie uit een handleiding die bij jou ontbreekt, een model dat niet in /model staat: meestal zit je gewoon op een oudere versie.

claude doctor leest je updatestatus voor

Kijk in de uitvoer naar twee regels. "Auto-updates" zegt of automatische updates aanstaan, en zo niet, waarom: bijvoorbeeld "disabled (set by env: DISABLE_AUTOUPDATER)". "Last update attempt" zegt wanneer de laatste poging was en of die lukte. Het commando start geen sessie en verandert niets.

claude doctor

Vergelijk met de actuele versie

Op 30 oktober 2026 staat het latest-kanaal op 2.1.314 en het stable-kanaal op 2.1.308. Wil je dat zelf nagaan zonder deze pagina, gebruik dan de npm-regel uit de tabel, of kijk bovenaan de officiële changelog. Let op het verschil tussen /doctor in een sessie en claude doctor in de terminal: /doctor is een skill die je setup nakijkt en reparaties voorstelt, claude doctor leest alleen uit.

Kanalen

Latest of stable: welk Claude Code-releasekanaal kies je?

Claude Code heeft twee releasekanalen. latest is de standaard en geeft je elke versie zodra die uitkomt. stable geeft je een versie die meestal ongeveer een week oud is en slaat releases met grote fouten over. Het kanaal bepaalt wat automatische updates en claude update binnenhalen.

Overstappen naar stable

Open /config en kies bij Auto-update channel voor stable. Of zet het in je settings.json. Stap je over terwijl je al op een nieuwere latest-versie zit, dan vraagt /config of je op je huidige versie blijft of terug mag. Kies je blijven, dan zet Claude Code minimumVersion op je huidige versie, zodat je niet terugvalt. Ga je later terug naar latest, dan wordt die ondergrens weer gewist.

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

Kanaal kiezen bij een nieuwe installatie

De installer neemt een kanaal of een versienummer aan. Het kanaal dat je bij installatie kiest, wordt je standaard voor automatische updates.

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

In PowerShell is dat & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable.

Beslisregel

Kies latest als je alleen werkt, nieuwe modellen meteen wilt gebruiken en een foutje in een release voor lief neemt. Na een kapotte release staat er vaak snel een nieuwe versie klaar: in oktober 2026 verschenen er 25. Kies stable als meerdere mensen in dezelfde repo werken of als Claude Code in een vaste werkstroom zit, zoals releases of klantwerk met deadlines. Dan weegt voorspelbaarheid zwaarder dan een week eerder een nieuwe functie. Stap tijdelijk naar latest als er een nieuw model uitkomt dat je nu wilt gebruiken.

Terug

Terug naar een oudere versie van Claude Code

Werkt iets niet meer na een update, dan kun je een specifieke versie installeren. Doe daarna één ding erbij: zet automatische updates tijdelijk uit. Anders zet de updater je bij de volgende start gewoon weer op de nieuwste versie.

Een specifieke versie installeren

macOS, Linux en WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.308 && del install.cmd

npm:

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

Automatische updates tijdelijk uitzetten

Zet dit in ~/.claude/settings.json. Draai daarna claude doctor: de regel Auto-updates hoort nu "disabled (set by env: DISABLE_AUTOUPDATER)" te tonen.

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

Dit stopt alleen de controle op de achtergrond. claude update werkt nog steeds, dus wie het handmatig draait, zit meteen weer op de nieuwste versie.

Liever geen versie vastzetten maar het kanaal wisselen

Zit het probleem in één nieuwe release, dan is overstappen naar stable vaak genoeg. Stable slaat releases met grote fouten over, en je blijft wel updates krijgen. Dat is minder onderhoud dan een vaste versie die je zelf weer moet vrijgeven.

Team

Claude Code-updates regelen voor een team

Werken vijf mensen in dezelfde repo met vijf verschillende versies, dan krijg je vragen als "bij mij werkt het wel". Er zijn drie niveaus om dat te regelen, van een afspraak in de repo tot een harde regel die niemand kan omzeilen.

Niveau 1: een afspraak in de repo

Zet het kanaal in .claude/settings.json en commit dat bestand. Iedereen die in die repo werkt, volgt dan hetzelfde kanaal. Het is geen harde regel, want persoonlijke instellingen kunnen ervan afwijken, maar voor een klein team is het genoeg.

{
  "autoUpdatesChannel": "stable"
}

Niveau 2: managed settings voor de hele organisatie

Met managed settings legt een beheerder kanaal en ondergrens vast voor iedereen, en gebruikers kunnen dat niet overschrijven. Met requiredMinimumVersion start een te oude versie niet eens. Handig na een beveiligingsfix: je weet dan zeker dat niemand nog op de kwetsbare versie werkt.

Niveau 3: zelf uitrollen via je eigen kanaal

Rolt je IT-partner software uit via WinGet, een softwarecatalogus of een eigen script, gebruik dan DISABLE_UPDATES. Dan krijgt iedereen precies de versie die jullie hebben goedgekeurd. Dat is ook de aanbevolen route bij thuismappen op een netwerkschijf. Een npm-update op één machine kan daar het programma weghalen waarmee sessies op andere machines nog draaien. De keerzijde: jullie moeten zelf bijhouden wanneer er een beveiligingsfix uitkomt. Hoe je dat op Windows-laptops met WinGet, Intune of Group Policy inricht, staat op Claude Code uitrollen op Windows.

Changelog

Waar staat de Claude Code-changelog?

De changelog staat op vier plekken, met dezelfde inhoud. Het verschil zit in hoe makkelijk je hem leest. Het tempo is hoog: tussen 1 augustus en 30 oktober 2026 verschenen er 81 versies, in oktober alleen al 25. Achteraf per versie bijhouden wat er veranderde is dus geen doen. Zoek gericht.

Laat Claude de changelog voor je samenvatten

Je hoeft niet zelf door honderden regels te lezen. Plak deze prompt in een sessie. De opdracht noemt je versie en je werk, zodat Claude filtert op wat voor jou verandert in plaats van alles op te sommen.

Ik zit op Claude Code-versie [JOUW VERSIE] en wil bijwerken naar de nieuwste.
Lees https://code.claude.com/docs/en/changelog vanaf mijn versie tot nu.
Ik gebruik Claude Code voor [bijv. onze Next.js-website en offertescripts],
op [macOS/Windows], met [plugins/MCP-servers die je gebruikt].
Geef me:
1. Wijzigingen die mijn huidige werkwijze veranderen (gedrag, standaarden, verwijderde commando's).
2. Nieuwe functies die voor mijn werk nuttig zijn, met het commando om ze te proberen.
3. Alles wat ik moet aanpassen in mijn settings of CLAUDE.md.
Noem bij elk punt het versienummer. Sla fixes voor Bedrock, Vertex en gateways over.

Wat is nieuw

Wat is er nieuw in Claude Code? De belangrijkste updates van augustus tot oktober 2026

Een selectie uit 81 versies: de wijzigingen die je als gebruiker of teamlead merkt. Fixes en wijzigingen die alleen voor Bedrock, Vertex, Foundry of de Claude apps gateway gelden, laten we weg. Bij elke regel staat de versie die je minimaal nodig hebt.

Waarom de modelregels het zwaarst wegen

Een nieuw model kies je pas als je Claude Code-versie het kent. Wie in september op een versie van voor 2.1.280 bleef hangen, zag Opus 5.5 niet in /model. Dat is in trainingen meestal de verklaring als iemands scherm er anders uitziet dan dat van een collega. Wat elk model kost en wanneer je welk kiest, staat op Claude Code modellen en in onze review van Opus 5.5.

Let op bij de wissel naar Opus en auto mode

Twee wijzigingen veranderen gedrag zonder dat je iets instelt. Sinds 2.1.280 start Pro op Opus in plaats van Sonnet, en Opus verbruikt meer van je limiet; kijk op Claude Code limieten als je pot sneller leeg is. Sinds 2.1.284 starten interactieve sessies in auto mode als je zelf geen modus hebt ingesteld. Wil je dat niet, zet dan permissions.defaultMode in je settings. De achtergrond lees je in ons stuk over auto mode.

Valkuil

De grootste valkuil: twee installaties naast elkaar

Je draait claude update, krijgt een succesmelding, en claude --version toont toch het oude nummer. In onze trainingen is dat de updatevraag die we het vaakst krijgen. De oorzaak is bijna altijd dezelfde: er staan twee installaties op je computer, bijvoorbeeld een oude npm-installatie en de native installer. Je werkt er één bij, maar je terminal start de andere.

Waarom dit zo vaak gebeurt

Claude Code werd in het begin vooral via npm geïnstalleerd. Later werd de native installer de aanbevolen route. Wie de nieuwe installer gewoon over de oude heen draaide, heeft er nu twee. Welke start, hangt af van de volgorde in je PATH, en die verschilt per terminal. Daarom werkt het in de terminal van VS Code soms anders dan in je gewone terminal.

De tweede valkuil: Homebrew of WinGet vergeten

Installeerde je via Homebrew of WinGet, dan werkt Claude Code zichzelf niet bij. Je merkt niets, tot een collega een model of commando gebruikt dat jij niet hebt. Oplossing: zet CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE op 1, of zet een maandelijkse herinnering voor brew upgrade of winget upgrade.

Ons oordeel

Ons oordeel: zo regel je Claude Code-updates in een mkb-team

Ons advies na trainingen met Nederlandse mkb-teams: laat automatische updates aanstaan en stuur alleen op het kanaal. Versies vastzetten kost onderhoud en levert een klein team zelden iets op. Achterlopen kost wel iets: modellen, beveiligingsfixes en antwoorden op vragen als "waarom heb ik dat commando niet".

Wanneer wel latest, wanneer stable

Werk je alleen of met twee mensen aan je eigen website of interne scripts, blijf dan op latest. Een kapotte release los je meestal op met claude update zodra de volgende versie er is. Werken meer mensen in dezelfde repo, of draait Claude Code mee in iets waar een klant op wacht, zet dan stable in .claude/settings.json. Je loopt een week achter, maar iedereen heeft hetzelfde gedrag. Komt er een nieuw model uit dat je echt nodig hebt, stap dan tijdelijk naar latest.

Nederlandse context: AVG, IT-beheer en Windows

Updaten zelf verandert niets aan wat er met je data gebeurt: dat regelen je plan en je instellingen, zie privacy en Claude Code. Wel relevant voor de AVG: beveiligingsfixes komen via updates. Een bewust uitgezette updater zonder eigen updateproces is dus een risico dat je moet kunnen uitleggen. Beheert een IT-partner jullie Microsoft 365- en Windows-laptops, spreek dan af wie bijwerkt. Óf Claude Code werkt zichzelf bij via de native installer, óf de partner rolt uit via WinGet met DISABLE_UPDATES. Een mengvorm levert precies de dubbele installaties op uit de valkuil hierboven. Werkt je netwerk met een strikte firewall, laat dan downloads.claude.ai toestaan; daar komen de updates vandaan.

Concreet voorbeeld

Een installatiebedrijf met een website in Next.js en een paar scripts die offertes opmaken. Twee mensen werken met Claude Code: de eigenaar op een Mac via Homebrew, een medewerker op Windows via de native installer. Wat we zouden doen: de eigenaar stapt over op de native installer, zodat beide machines zichzelf bijwerken. In de repo komt een .claude/settings.json met stable als kanaal. Eens per maand draait iemand de changelogprompt uit de changelogsectie en past CLAUDE.md aan als er iets verandert. Dat kost tien minuten per maand en voorkomt dat de twee verschillend gedrag zien.

Wanneer je dit níet zelf hoeft te regelen

Gebruik je Claude Code alleen in de desktop-app of via claude.ai/code in de browser, dan gelden de commando's op deze pagina niet: die werken op je terminalinstallatie. Wil je dat je hele team Claude Code zo inricht dat updates, instellingen en CLAUDE.md voor iedereen kloppen, dan is dat precies wat we in de Claude Code Masterclass samen opzetten.