Claude Code gebruiken: complete handleiding (2026)

Claude Code is de programmeeragent van Anthropic voor werk in je terminal, editor, desktopapp of een cloudomgeving. Sinds 24 juli 2026 kun je Claude Opus 5 in Claude Code gebruiken, maar een goede werkwijze blijft belangrijker dan alleen het krachtigste model kiezen.

In het kort

• De native installer is de aanbevolen installatiemethode voor de CLI
• Claude Code kan bestanden onderzoeken en bewerken, commando's uitvoeren en tests draaien
• Claude Opus 5 is beschikbaar vanaf Claude Code versie 2.1.219
• Het standaardmodel verschilt per abonnement en organisatie-instelling
• Een CLAUDE.md-bestand bewaart blijvende projectafspraken
• Je beoordeelt zelf de diff, testresultaten en gevolgen van iedere wijziging

Wat is Claude Code?

Claude Code is geen gewone chatbot die alleen codefragmenten terugstuurt. Het is een agentische ontwikkeltool die context verzamelt, acties uitvoert en het resultaat verifieert. Binnen de toegang die jij geeft kan Claude Code onder meer:

• bestanden in je project lezen, zoeken, aanmaken en bewerken;
• terminalcommando's uitvoeren;
• je Git-status en recente geschiedenis bekijken;
• builds, tests en linters draaien;
• meerdere bestanden in samenhang aanpassen;
• sessies hervatten en projectspecifieke instructies uit CLAUDE.md gebruiken.

De tool werkt niet uitsluitend in de terminal. Anthropic biedt ook interfaces voor VS Code, JetBrains, desktop en web. De uitvoering en beschikbare lokale context verschillen per interface. In de terminal en een lokale desktopsessie werkt Claude bijvoorbeeld met de bestanden op jouw machine, terwijl een websessie een repository in een beheerde cloudomgeving kloont.

Nieuw met Claude? Lees dan eerst de Claude-handleiding voor beginners. Wil je meerdere AI-tools naast elkaar zetten, bekijk dan onze vergelijking van AI-tools.

Claude Opus 5 in Claude Code

Anthropic bracht Claude Opus 5 op 24 juli 2026 uit. Volgens de officiële aankondiging is het model gericht op zorgvuldig, proactief werk en presteert het sterker dan Opus 4.8 bij softwareontwikkeling en kenniswerk. Anthropic noemt ook verbeteringen in zelfcontrole en het itereren totdat een taak aantoonbaar werkt.

Voor Claude Code zijn drie details belangrijk:

1. Je hebt Claude Code 2.1.219 of nieuwer nodig. Werk een oudere installatie eerst bij met claude update.
2. Opus 5 is niet voor ieder account het standaardmodel. Op 28 juli 2026 gebruikt Claude Code standaard Opus 5 voor onder meer Max en bepaalde zakelijke of API-accounts. Pro, Team Standard en Enterprise-abonnementsplaatsen starten standaard met Sonnet 5, tenzij een beheerder iets anders instelt.
3. Je kunt het model zelf controleren. Open /model om het actieve model te bekijken of te wijzigen. Het alias opus verwijst bij de Anthropic API naar Opus 5, maar aliases kunnen na verloop van tijd naar een nieuwere aanbevolen versie gaan.

Gebruik Opus 5 vooral voor complexe refactors, lastige foutanalyse en werk dat meerdere controle- en iteratiestappen vraagt. Voor een kleine, duidelijke wijziging kan het standaardmodel sneller en zuiniger zijn. Controleer altijd in /model welk model daadwerkelijk actief is.

Heb je voor een aantoonbaar moeilijke taak meer capaciteit nodig dan Opus biedt, lees dan eerst hoe Claude Fable 5 omgaat met beschikbaarheid, weigeringen, fallback en verplichte retentie. Die voorwaarden maken Fable geen automatische vervanger voor het standaardmodel.

Let ook op de automatische modelfallback van Claude Code. Vanaf versie 2.1.219 wordt een verzoek aan Opus 5 dat door de veiligheidsclassificatie als cybersecurity wordt gemarkeerd op de Anthropic API standaard opnieuw uitgevoerd met Opus 4.8, mits automatisch omschakelen (switchModelsOnFlag) is ingeschakeld en Opus 4.8 volgens availableModels is toegestaan. Bij Bedrock, Google Cloud's Agent Platform en Microsoft Foundry moet Claude Code beide provider-specifieke modellen herkennen; ANTHROPIC_DEFAULT_OPUS_MODEL kan daar een andere toegestane Opus-doelversie aanwijzen. Staat switchModelsOnFlag uit, dan pauzeert een interactieve sessie en kun je alsnog omschakelen of de prompt aanpassen en opnieuw proberen. In een niet-interactieve omgeving, of wanneer de fallback niet is toegestaan of herkenbaar, eindigt het gemarkeerde verzoek in een weigering en blijft het sessiemodel ongewijzigd. Een gemarkeerd biologieverzoek aan Opus 5 wordt altijd geweigerd zonder fallback. Na een geslaagde omschakeling toont Claude Code een melding en gaat de sessie verder met het fallbackmodel. Controleer daarna opnieuw /model voordat je modelgebonden resultaten vergelijkt.

Lees bij het bijwerken van een bestaande installatie ook wat veranderde in Claude Code 2.1.219 en 2.1.220.

Stappenplan: Claude Code installeren en gebruiken

Stap 1: controleer wat je nodig hebt

Voor de CLI heb je een terminal, een lokaal codeproject en een geschikt account nodig. Claude Code ondersteunt:

• Claude Pro, Max, Team of Enterprise;
• een Claude Console-account met gebruikstegoed;
• ondersteunde zakelijke cloudproviders, waaronder Amazon Bedrock, Google Cloud en Microsoft Foundry.

Het gratis Claude-plan bevat geen Claude Code. Gebruik je de native installer, dan hoef je Node.js niet apart te installeren.

Stap 2: installeer de CLI

Voor macOS, Linux of WSL is de aanbevolen native installatie:

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

Op Windows gebruik je in PowerShell:

irm https://claude.ai/install.ps1 | iex

De native installatie werkt zichzelf op de achtergrond bij. Je kunt op macOS ook Homebrew gebruiken:

brew install --cask claude-code

Een Homebrew-installatie wordt niet standaard automatisch bijgewerkt. Draai daarvoor regelmatig brew upgrade claude-code. Volg bij installatieproblemen de actuele officiële Claude Code-quickstart, omdat installatiemethoden en systeemeisen kunnen veranderen.

Stap 3: log in

Start Claude Code:

claude

Bij het eerste gebruik opent Claude Code een browser om je te laten inloggen. Je kunt ook vanuit een actieve sessie /login gebruiken. Controleer na het inloggen of je het bedoelde persoonlijke, zakelijke of Console-account gebruikt.

Stap 4: open het juiste project

Ga eerst naar je projectmap en start daar een sessie:

cd /pad/naar/je/project
claude

Claude Code leest bestanden wanneer ze voor je vraag nodig zijn. Het krijgt ook toegang tot de Git-status, terminal en instructiebestanden binnen de ingestelde rechten. Controleer daarom vóór je begint:

• de huidige map;
• de actieve Git-branch;
• niet-gecommitte wijzigingen;
• beschikbare tests en buildcommando's;
• bestanden met geheimen die buiten bereik moeten blijven.

Stap 5: laat Claude eerst onderzoeken

Begin met een vraag zonder meteen wijzigingen te laten uitvoeren:

Leg uit hoe dit project is opgebouwd.
Noem de relevante bestanden en testcommando's.
Verander nog niets.

Zo zie je of Claude Code de juiste onderdelen heeft gevonden. Daarna kun je een afgebakende taak geven:

Los de fout in het loginformulier op.
Verander alleen de validatie en bijbehorende tests.
Laat eerst de oorzaak zien.
Draai daarna de relevante tests en rapporteer de diff.

Stap 6: leg projectafspraken vast in CLAUDE.md

Maak in de hoofdmap van je repository een bestand CLAUDE.md:

Projectafspraken

- Dit is een Next.js-project met TypeScript
- Gebruik npm voor packagecommando's
- Draai tests, lint en build voor iedere afgeronde wijziging
- Wijzig geen authenticatie zonder expliciete opdracht
- Voeg nooit geheimen of .env-bestanden toe aan Git

Claude Code leest dit bestand bij iedere sessie. Zet er blijvende regels en relevante commando's in, niet de volledige documentatie van je project. Voor een tijdelijke taak geef je de specifieke scope en acceptatiecriteria in je prompt.

Stap 7: kies bewust een permission mode

Claude Code vraagt in de standaardmodus toestemming voordat het gevoelige acties uitvoert. Voor onderzoek kun je Plan mode gebruiken. Claude beschrijft dan de aanpak zonder direct bestanden te wijzigen. Ruimere modi kunnen sneller werken, maar vergroten ook de impact van een verkeerde aanname.

Gebruik bij onbekende repositories of gevoelige systemen een voorzichtige modus. Controleer voorgestelde commando's, beperk netwerktoegang waar nodig en zet wachtwoorden of API-sleutels nooit in een prompt of CLAUDE.md.

Stap 8: beoordeel het resultaat

Laat Claude Code niet alleen melden dat de taak klaar is. Vraag om controleerbaar bewijs:

• de volledige diff;
• de uitgevoerde tests en resultaten;
• eventuele lint- of buildfouten;
• aannames die niet zijn geverifieerd;
• gevolgen voor beveiliging, privacy en bestaande functies.

Bekijk de wijziging zelf en test de echte gebruikersroute. Een geslaagde unit test bewijst niet automatisch dat de interface, toegankelijkheid of integratie correct werkt.

Voorbeelden

Voorbeeld 1: een codebase leren kennen

Breng de authenticatiestroom in kaart.
Noem de entrypoints, datastromen en relevante tests.
Verander nog niets en benoem onzekerheden.

Voorbeeld 2: een fout oplossen

Reproduceer de TypeError in app.py.
Zoek de hoofdoorzaak, schrijf eerst een falende test en maak daarna de kleinste fix.
Voer de test opnieuw uit en laat de diff zien.

Voorbeeld 3: gecontroleerd refactoren

Splits process_data() op in kleinere functies zonder het publieke gedrag te wijzigen.
Behoud de bestaande API en voeg regressietests toe.

Voorbeeld 4: Git-status beoordelen

Bekijk mijn niet-gecommitte wijzigingen.
Groepeer bevindingen op risico en stel een passend commitbericht voor.
Commit nog niets.

Voorbeeld 5: tests uitbreiden

Zoek ongeteste randgevallen in utils.py.
Voeg gerichte tests toe en verander productiecode alleen als een test een echte fout aantoont.

Tips voor effectief gebruik

1. Benoem het gewenste resultaat. Schrijf niet alleen wat Claude moet doen, maar ook wanneer het werk aantoonbaar klaar is.
2. Houd de scope klein. Een beperkte diff is eenvoudiger te reviewen en terug te draaien.
3. Gebruik CLAUDE.md voor vaste regels. Daarmee voorkom je dat projectafspraken per sessie verschillen.
4. Vraag om bewijs. Laat tests, commando-uitvoer en de diff rapporteren.
5. Kies het model bewust. Gebruik /model om te zien welk model actief is. Opus 5 is nuttig bij complexe taken, maar niet automatisch nodig voor iedere wijziging.
6. Hervat alleen de juiste sessie. Gebruik /resume of claude -c bewust, zodat oude context niet per ongeluk een nieuwe taak beïnvloedt.
7. Schrijf scherpere opdrachten. Onze gids voor goede prompts helpt je met doel, context en randvoorwaarden.
8. Deel grote taken bewust op. Lees hoe je grote Claude Code-taken opdeelt met dynamic workflows voordat je meerdere agents of werkstromen tegelijk inzet.

Veelgemaakte fouten

Fout 1: verouderde installatie-instructies volgen

Een oude handleiding kan nog npm install -g @anthropic-ai/claude-code en Node.js 18 voorschrijven. De native installer is inmiddels de aanbevolen route en heeft Node.js niet nodig. Controleer de officiële quickstart voordat je een nieuwe machine inricht.

Fout 2: aannemen dat Opus 5 automatisch actief is

Het standaardmodel hangt af van je abonnement, provider en organisatiebeleid. Open /model en controleer de actieve selectie. Voor Opus 5 heb je bovendien Claude Code 2.1.219 of nieuwer nodig.

Fout 3: een te brede opdracht geven

"Bouw een complete webshop" bevat te veel beslissingen en risico's voor één wijziging. Begin bijvoorbeeld met het datamodel en de tests, beoordeel dat resultaat en pak daarna de API en interface op.

Fout 4: wijzigingen niet zelf controleren

Een agent kan een test verkeerd interpreteren of buiten de bedoelde scope werken. Bekijk de diff, voer belangrijke gebruikersroutes zelf uit en laat productiegevoelige code door een bevoegde reviewer beoordelen.

Fout 5: geheimen in projectcontext zetten

Een CLAUDE.md-bestand hoort in veel projecten in Git. Zet er daarom geen tokens, wachtwoorden of privésleutels in. Gebruik beheerde secrets en beperk toegang tot lokale credentialbestanden.

Fout 6: projectafspraken alleen in het gesprek zetten

Lange sessies kunnen worden samengevat en een nieuwe sessie begint zonder de volledige oude conversatie. Zet blijvende commando's, conventies en beperkingen daarom in CLAUDE.md.

Geavanceerde functies

Model en effort kiezen

Open /model om een model te selecteren. Opus 5 ondersteunt op 28 juli 2026 de effortniveaus low, medium, high, xhigh en max. Een hoger niveau geeft het model meer ruimte voor moeilijke redeneertaken, maar kan langer duren en meer gebruik verbruiken. Kies het niveau op basis van de taak en controleer de limieten van je organisatie.

Plan mode

Gebruik Plan mode wanneer je eerst architectuur, risico's of een migratiepad wilt beoordelen. In deze modus beschrijft Claude de aanpak voordat er wijzigingen worden uitgevoerd. In VS Code kun je het plan als document openen en inline feedback geven.

Meerdere interfaces

Claude Code draait met dezelfde onderliggende agentische werkwijze in verschillende omgevingen, maar de bediening verschilt:

• CLI: volledige terminalworkflow en scripting;
• VS Code en JetBrains: editorcontext en visuele diffreview;
• Desktop: lokale of cloudtaken met een grafische interface;
• Web: taken in een Anthropic-beheerde cloudomgeving met een gekoppelde GitHub-repository.

Kies de interface die past bij de benodigde context. Een websessie heeft niet automatisch je lokale niet-gecommitte bestanden, lokale tools of persoonlijke configuratie.

Uitbreidingen

Je kunt Claude Code uitbreiden met skills, subagents, hooks, MCP-servers en plugins. Voeg zulke onderdelen pas toe als de standaardtools een concrete behoefte niet afdekken. Iedere uitbreiding kan extra context, rechten of externe datastromen introduceren en moet daarom apart worden beoordeeld.

Wanneer is Claude Code de juiste keuze?

Claude Code is geschikt wanneer je:

• een bestaande codebase wilt begrijpen;
• een afgebakende bug wilt onderzoeken en oplossen;
• tests of documentatie wilt bijwerken;
• een gecontroleerde refactor over meerdere bestanden wilt uitvoeren;
• repetitief ontwikkelwerk wilt automatiseren;
• een wijziging lokaal wilt bouwen en verifiëren.

Claude Code is minder geschikt als je het resultaat niet kunt beoordelen, de projectregels ontbreken of een fout direct onomkeerbare productiegevolgen heeft. Gebruik de tool niet als enige controle voor beveiligingskritische code. Lees voor een vergelijking ook ChatGPT gebruiken om code te schrijven en onze praktische Claude-tips.

Werk je met pull requests, volg dan de afzonderlijke stappen voor een Claude Code-review in GitHub. Die route maakt het verschil duidelijk tussen één review aanvragen en reviews na volgende pushes blijven uitvoeren.

Veelgestelde vragen

Wat is Claude Code?

Claude Code is de officiële programmeeragent van Anthropic. De tool kan binnen de toegang die je geeft projectbestanden onderzoeken en aanpassen, terminalcommando's uitvoeren en resultaten controleren.

Is Claude Code gratis?

Nee, het gratis Claude-plan bevat geen Claude Code. Je hebt een Pro-, Max-, Team- of Enterprise-abonnement, een Claude Console-account met tegoed of toegang via een ondersteunde cloudprovider nodig.

Werkt Claude Code met Claude Opus 5?

Ja. Opus 5 is sinds 24 juli 2026 beschikbaar in Claude Code en vereist Claude Code versie 2.1.219 of nieuwer. Welk model standaard start hangt af van je accounttype en eventuele organisatie-instellingen.

Welke programmeertalen ondersteunt Claude Code?

Claude Code is niet aan één programmeertaal gebonden. Het werkt via je projectbestanden en terminal, waardoor je het met gangbare talen en de bijbehorende lokale build- en testtools kunt gebruiken.

Kan Claude Code hele projecten bouwen?

Claude Code kan wijzigingen over meerdere bestanden uitvoeren en grote taken helpen opdelen. Geef een afgebakend doel, laat tests draaien en beoordeel de diff, want de tool vervangt geen technische review.

Kan ik Claude Code gebruiken met VS Code?

Ja. Anthropic biedt een officiële VS Code-extensie met een grafische interface, inline diffs, bestandsverwijzingen en planreview. De extensie bundelt een eigen CLI-kopie voor het chatvenster, maar voegt claude niet toe aan je PATH. Voor claude in de geïntegreerde terminal installeer je de zelfstandige CLI apart.

Hoe geef ik Claude Code context over mijn project?

Plaats blijvende projectafspraken in een CLAUDE.md-bestand en verwijs in je opdracht naar relevante bestanden en acceptatiecriteria. Claude Code leest CLAUDE.md bij iedere sessie.

Officiële bronnen

• Anthropic: Introducing Claude Opus 5
• Claude Code: Quickstart
• Claude Code: How Claude Code works
• Claude Code: Model configuration
• Claude Code: Automatic model fallback
• Claude Code: Use Claude Code in VS Code
• Claude Code: Choose a permission mode

Laatst inhoudelijk gecontroleerd: 30 juli 2026.