)`. Dat betekent dat er niets hoeft te worden bijgewerkt.
Bij pakketbeheerders zit er een addertje onder het gras. Is Claude Code geïnstalleerd via Homebrew, WinGet of apk, dan geeft `claude update` een kortere reactie — `Claude is up to date!` — en haalt de opdracht niet altijd zelf de nieuwe build op. Voor deze installaties is het betrouwbaarder om de eigen upgradeopdracht van de pakketbeheerder te gebruiken. Die staat hieronder.
## Hoe werk je Claude Code bij als het via Homebrew of WinGet is geïnstalleerd?
Het belangrijkste
Pakketbeheerders werken Claude Code niet automatisch bij, dus moet je de upgradeopdracht zelf uitvoeren. Op een MacBook met Homebrew is dat brew upgrade claude-code. Op Windows met WinGet is het winget upgrade Anthropic.ClaudeCode. Op Linux komt de update met apt, dnf of apk mee met de gewone systeemupgrade. Wil je dat Claude Code de upgrade zelf uitvoert met Homebrew en WinGet, stel dan de omgevingsvariabele CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE in op one.
Heb je Claude Code via een pakketbeheerder geïnstalleerd in plaats van met het script van de website, dan ben je zelf verantwoordelijk voor updates. Dit zijn de opdrachten per systeem.
Op macOS met Homebrew:
```bash
brew upgrade claude-code
```
Homebrew heeft twee opties. Het installeert Claude Code in twee varianten. De variant `claude-code` volgt het stabiele kanaal: een versie die ongeveer een week oud is en releases met grote problemen overslaat. De variant `claude-code@latest` krijgt de nieuwste versie zodra die wordt uitgebracht. Werk de variant bij die je hebt geïnstalleerd. Heb je `claude-code@latest`, dan is de opdracht `brew upgrade claude-code@latest`.
Op Windows met WinGet:
```powershell
winget upgrade Anthropic.ClaudeCode
```
Met WinGet mislukt de upgrade soms terwijl Claude Code actief is, omdat Windows het uitvoerbare bestand in gebruik heeft. Claude Code toont dan de handmatige opdracht. Sluit het programma en voer de upgrade opnieuw uit.
Op Linux met apt, dnf of apk hoef je geen aparte opdracht te leren: de nieuwste versie komt mee met de gewone systeemupdate, omdat Claude Code ondertekende pakketbronnen aanbiedt.
| Installatiemethode | Updateopdracht |
|----------------------|----------------|
| Native installatieprogramma | werkt zichzelf bij, of `claude update` |
| Homebrew (macOS) | `brew upgrade claude-code` |
| WinGet (Windows) | `winget upgrade Anthropic.ClaudeCode` |
| apt / dnf / apk (Linux) | gewone systeemupgrade |
Wil je dit niet zelf in de gaten houden, gebruik dan de omgevingsvariabele `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`. Stel die in op `1`; Claude Code voert dan de upgrade op de achtergrond uit met Homebrew en WinGet en stelt voor om opnieuw te starten nadat de update is geslaagd. De documentatie vermeldt een kanttekening: Claude Code meldt soms een nieuwe versie voordat die daadwerkelijk in de pakketbeheerder beschikbaar is. Vindt de upgrade geen update, wacht dan even en probeer het opnieuw.
Trouwens, kies je nog hoe je Claude Code gaat installeren, dan vind je een uitgebreide handleiding in het aparte artikel over [Claude Code installeren](https://ailoot.ai/blog/nl/install-claude-code/). Daarin staat ook waarom het native installatieprogramma handiger is dan pakketbeheerders.
## Waarom wordt Claude Code niet bijgewerkt en wat kun je doen?
Het belangrijkste
Er zijn meestal drie mogelijke oorzaken. Ten eerste heb je meerdere Claude Code-installaties die elkaar in de weg zitten: de opdracht werkt de ene bij, maar de andere wordt gestart. Ten tweede is de globale npm-map niet beschrijfbaar, waardoor de update op de achtergrond ongemerkt niet wordt geïnstalleerd. Ten derde heb je de launcher mogelijk vervangen door je eigen script. Begin met het oplossen van problemen met claude doctor en de opdracht which -a claude; die laten precies zien waar het probleem zit.
Soms werk je steeds opnieuw bij, maar blijft `claude --version` koppig het oude nummer tonen. Ik bespreek de belangrijkste oorzaken, te beginnen met de meest voorkomende.
Controleer eerst of je meerdere Claude Code-installaties hebt. Dat kan gebeuren als je het eerst via npm hebt geïnstalleerd en het daarna opnieuw native hebt geïnstalleerd. De opdracht werkt één exemplaar bij, maar de terminal start een ander exemplaar, waardoor het lijkt alsof de versie niet verandert. Controleer hoeveel exemplaren je hebt:
```bash
which -a claude
```
Claude Code kan op drie plekken staan: `~/.local/bin/claude` is het native installatieprogramma, `~/.claude/local/` is de oude lokale npm-installatie uit de eerste versies en het globale npm-pakket wordt weergegeven door de opdracht `npm -g ls @anthropic-ai/claude-code`. Vind je er meer dan één, houd er dan maar één over — bij voorkeur de native installatie. Verwijder de extra installaties zo:
```bash
npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local
```
De tweede veelvoorkomende oorzaak is een globale npm-map die niet beschrijfbaar is. Heb je Claude Code wereldwijd met npm geïnstalleerd en mag het niet naar die map schrijven, dan wordt de update op de achtergrond niet geïnstalleerd. Claude Code toont eenmalig een melding bij het opstarten en `claude doctor` geeft precies aan wat je moet oplossen. Dat is nog een reden om de native installatie te verkiezen: die schrijft naar je thuismap en vereist die machtigingen niet.
De derde situatie is dat je ooit de launcher `~/.local/bin/claude` door een eigen script of symlink verving. Vanaf versie 2.1.207 laten automatische updates die met rust: nieuwe versies komen nog in `~/.local/share/claude/versions/`, maar je script kiest welke start. Verwijder niet je enige launcher om daarna `claude update` op naam aan te roepen. Bewaar eerst de eigen launcher en bij een symlink ook het doel op een aparte ongebruikte back-uplocatie. Verplaats de launcher pas uit het oorspronkelijke pad nadat die kopie is gecontroleerd. Herstel de native launcher met het [officiële installatieprogramma](https://code.claude.com/docs/en/setup#install-claude-code), dat geen bestaande `claude`-opdracht nodig heeft:
```bash
# macOS, Linux of WSL: officieel native installatieprogramma
curl -fsSL https://claude.ai/install.sh | bash
```
Open na installatie een nieuwe terminal en controleer het resultaat:
```bash
claude --version
claude doctor
```
De eerste opdracht moet een versienummer tonen. Bekijk de doctor-uitvoer op launcher- of PATH-waarschuwingen voordat je doorgaat; verwijder de bewaarde launcher pas wanneer de vervanger werkt.
Een ander symptoom is dat `claude update` of `claude doctor` meteen na de regel `Checking for updates` blijft hangen. Bij oudere versies (vóór 2.1.214) gebeurde dit soms als een van de configuratiebestanden van de shell, zoals `~/.zshrc`, een map in plaats van een bestand was. Recente builds slaan dit nu over, dus bijwerken naar de nieuwste versie verhelpt de bug ook.
## Hoe kies je een updatekanaal: latest of stable?
Het belangrijkste
Claude Code heeft twee updatekanalen. Latest is het standaardkanaal; nieuwe functies komen beschikbaar zodra ze worden uitgebracht. Stable is een versie die ongeveer een week oud is en releases met grote problemen overslaat. Vind je nieuwe functies belangrijker, blijf dan op latest. Vind je voorspelbaarheid belangrijker en wil je geen ruwe builds tegenkomen, schakel dan over naar stable. Je kunt dit aanpassen met de instelling autoUpdatesChannel in het bestand settings.json of met de opdracht /config.
Bijwerken naar de nieuwste versie betekent niet altijd dat je op de eerste dag de allernieuwste build binnenhaalt. Claude Code laat je kiezen tussen twee kanalen. Die keuze bepaalt precies wat je ontvangt wanneer je bijwerkt.
Het kanaal `latest` is standaard. Nieuwe functies komen beschikbaar zodra ze worden uitgebracht. Dat is handig als je ze als eerste wilt uitproberen. Het kanaal `stable` biedt een versie die ongeveer een week oud is: die heeft de tijd gehad om zich te bewijzen en slaat releases met grote problemen over. Dit is de keuze voor mensen die meer waarde hechten aan gemoedsrust dan aan snelheid.
Je schakelt het eenvoudigst van kanaal met de opdracht `/config` in Claude Code, onder Auto-update channel. Je kunt het ook handmatig invoeren in het instellingenbestand `settings.json`:
```json
{
"autoUpdatesChannel": "stable"
}
```
Wil je Claude Code aanpassen aan je gewoontes, bekijk dan de aparte handleiding voor [Claude Code aanpassen](https://ailoot.ai/blog/nl/claude-personalization-profile-memory/). Die behandelt het hele instellingenbestand, niet alleen het updatekanaal.
## Hoe installeer je een specifieke versie of stel je een minimumversie in?
Het belangrijkste
Het native installatieprogramma accepteert zowel een kanaalnaam als een exact versienummer. Voeg het nummer toe aan het einde van de installatieopdracht om een specifieke build te installeren, bijvoorbeeld bash -s 2.1.89. Je kunt op dezelfde manier ook het stable-kanaal installeren in plaats van latest. Stel de instelling minimumVersion in settings.json in om te voorkomen dat updates je ooit terugzetten naar een versie onder een bepaald nummer. Dit is de ondergrens waar automatische updates en claude update niet onder komen.
Soms heb je een specifieke versie nodig in plaats van de nieuwste — bijvoorbeeld om terug te keren naar een build waarin je workflow zeker werkte. Het native installatieprogramma ondersteunt dit en accepteert zowel een kanaalnaam als een exact versienummer. Installeer een specifieke build zo:
```bash
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
```
Op Windows ziet het equivalent in PowerShell er iets anders uit:
```powershell
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
```
Je kunt het stable-kanaal op dezelfde manier installeren: schrijf `stable` in plaats van een nummer. Het kanaal dat je tijdens de installatie kiest, wordt het standaardkanaal voor toekomstige automatische updates.
Wil je voorkomen dat je terugvalt naar een oudere versie, stel dan een minimumversie in `settings.json` in:
```json
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.100"
}
```
Dit is de ondergrens. Noch een update op de achtergrond, noch `claude update` installeert een versie lager dan de opgegeven versie. Dit is handig wanneer je overschakelt naar stable en niet wilt teruggaan vanaf een nieuwere build die je al gebruikt.
## Hoe schakel je automatische updates uit als ze in de weg zitten?
Het belangrijkste
Heb je de updates van Claude Code op de achtergrond niet nodig, schakel ze dan uit met de variabele DISABLE_AUTOUPDATER in het env-blok van het bestand settings.json. Dit stopt alleen de controle op de achtergrond: de opdracht claude update blijft werken als je handmatig wilt bijwerken. Wil je elke manier van bijwerken blokkeren, ook handmatige updates, gebruik dan de andere variabele, DISABLE_UPDATES. Dit is handig wanneer je Claude Code met je team deelt en iedereen dezelfde versie moet blijven gebruiken.
Soms zitten updates op de achtergrond in de weg, bijvoorbeeld wanneer je je team op precies één versie wilt houden. Je kunt ze uitschakelen via het instellingenbestand:
```json
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
```
Een belangrijk detail: `DISABLE_AUTOUPDATER` schakelt alleen de controle op de achtergrond uit. De opdracht `claude update` blijft werken, zodat je handmatig kunt bijwerken. Wil je alle manieren van bijwerken tegelijk blokkeren, inclusief handmatige updates, gebruik dan de strengere variabele `DISABLE_UPDATES`. Die wordt gebruikt wanneer je Claude Code via je eigen kanaal verspreidt en mensen precies op de build wilt houden die jij hebt geleverd.
Voor normaal eigen gebruik kun je deze variabelen beter niet aanpassen: een recente versie van Claude Code is bijna altijd beter dan een oude, en een update kan een beveiligingsoplossing bevatten. De tool bijgewerkt houden is onderdeel van toegang behouden en vreemde bugs voorkomen; een apart artikel legt uit [hoe je je Claude-account behoudt](https://ailoot.ai/blog/nl/claude-account-suspension-appeal/).
## Waar begin je?
Het belangrijkste
Begin met claude --version om je versie te controleren en vergelijk die met het nieuwste nummer in de changelog. Heb je Claude Code native geïnstalleerd, werk dan bij met claude update en start je sessie opnieuw. Heb je het via Homebrew of WinGet geïnstalleerd, voer dan de upgradeopdracht van je pakketbeheerder uit. Verandert de versie niet, voer dan claude doctor en which -a claude uit om conflicten tussen meerdere installaties op te sporen. Kies ook een kanaal: latest voor nieuwe functies, stable voor gemoedsrust.
Hier is een kort stappenplan.
1. Controleer je huidige versie: `claude --version`. Vergelijk die met het nieuwste nummer in de changelog.
2. Werk bij. Native installatie — `claude update`. Homebrew — `brew upgrade claude-code`. WinGet — `winget upgrade Anthropic.ClaudeCode`.
3. Start de Claude Code-sessie opnieuw zodat de nieuwe versie actief wordt.
4. Is de versie niet veranderd, voer dan `claude doctor` en `which -a claude` uit. Waarschijnlijk heb je meerdere installaties of is een npm-map niet beschrijfbaar.
5. Kies het kanaal dat bij je past: `latest` als je nieuwe functies meteen wilt ontvangen, of `stable` als voorspelbaarheid belangrijker is. Wijzig het via `/config`.
Een recente versie verhelpt bugs en voegt nieuwe opdrachten toe, maar een bijgewerkte tool bouwt je project niet voor je. De handleiding over [alternatieven voor Claude Code](https://ailoot.ai/blog/nl/claude-code-alternatives/) legt uit hoe Claude Code verschilt van andere terminalagents en wanneer het zinvol is alternatieven te overwegen.
### Bronnen
- [Claude Code - Advanced setup, officiële documentatie](https://docs.claude.com/en/docs/claude-code/setup) - automatische updates voor native installaties, de opdracht claude update, de kanalen latest en stable, de instellingen autoUpdatesChannel en minimumVersion, DISABLE_AUTOUPDATER en een specifieke versie installeren
- [Claude Code - Troubleshoot installation, officiële documentatie](https://docs.claude.com/en/docs/claude-code/troubleshoot-install) - conflicten tussen meerdere installaties, which -a claude, machtigingen voor npm-mappen, aangepaste launchers en vastlopen van claude update
- [Claude Code - CHANGELOG on GitHub](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) - lijst met versies en wijzigingen in elke build; waar je het nieuwste nummer controleert
Maak kennis met [Ailoot](https://ailoot.ai/).
## Vragen en antwoorden
### Waarom start claude update nog mijn oude wrapper?
De native updater laat een eigen launcher staan, zodat die wrapper nog steeds het uitvoerbare bestand kiest. Bewaar wrapper en doel voordat je de launcher herstelt; gebruik het gedocumenteerde native installatieprogramma in plaats van de enige opdracht te verwijderen en die meteen aan te roepen.
### Hoe controleer ik of launcherherstel werkte?
Open een nieuwe terminal en voer claude --version uit; die moet een versienummer tonen. Voer daarna claude doctor uit om installatie- en launcherwaarschuwingen te bekijken. Ontbreekt de opdracht, herstel dan eerst PATH.
## Ailoot · Het bedrijf en zijn projectenportefeuille
Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle.
Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.
Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.