Claude Code-tutorial: Installatie, refactoren en debuggen in de praktijk

Wat is Claude Code?

Claude Code is een tool die rechtstreeks in je terminal draait, je codebase begrijpt en helpt bij ontwikkelingstaken via opdrachten in natuurlijke taal. Het integreert met minimale setup in je ontwikkelomgeving, zodat jij je kunt focussen op het schrijven en verbeteren van code.

Dit zijn enkele kernmogelijkheden van Claude Code:

• Bewerken en refactoren: Wijzig, optimaliseer en verbeter je codebase met AI-gestuurde suggesties.
• Bugfixing: Identificeer en los fouten, ontbrekende dependencies en prestatieknelpunten op.
• Codebegrip: Stel vragen over de architectuur, logica en dependencies van je code.
• Geautomatiseerd testen & linting: Voer falende tests uit en repareer ze, draai lintingcommando’s en verbeter de codekwaliteit.
• Git-integratie: Doorzoek githistorie, los mergeconflicten op, maak commits en genereer moeiteloos pull requests.

Of je nu aan een open-sourceproject werkt of enterprise-codebases beheert, Claude Code helpt je met intelligente automatisering die zich aanpast aan je codestijl en projectvereisten. Recente updates voegen auto mode (minder onderbrekingen voor toestemming), plan mode (design-first workflows) en Routines toe (geplande cloudagents die op triggers draaien zonder dat jouw machine aanstaat).

Dit zijn enkele ideale gebruikers voor deze service:

• Softwareontwikkelaars: Codekwaliteit en onderhoudbaarheid verbeteren.
• Open-sourcebijdragers: Onbekende codebases begrijpen en verbeteren.
• DevOps-engineers: Code review en lintingtaken automatiseren.

Claude Code gebruikt nu standaard Claude Opus 4.7 op Max- en Team Premium-abonnementen. Pro-gebruikers starten met Sonnet 4.6 maar kunnen voor veeleisende taken naar Opus-modellen schakelen. Je kunt tijdens een sessie van model wisselen met het /model-commando of de redeneerverdieping aanpassen met de /effort-slider. Je kunt ook zelfstandige AI-agents bouwen met de Claude Agents SDK.

Anthropic heeft ook Cowork geïntroduceerd voor agentachtige hulp bij alledaagse taken met bestanden en documenten buiten het coderen om. Het is beschikbaar voor alle betalende abonnees (Pro, Max, Team, Enterprise) in de Claude Desktop-app.

Laten we beginnen met ons hands-on project.

Stap 1: Claude Code instellen

Om te beginnen met Claude Code heb je een terminal nodig, een codeproject om in te werken en óf een Claude-abonnement (Pro/Max/Teams/Enterprise) óf een Claude Console-account met actieve facturering.​

Installeer Claude Code eenvoudig door een van de volgende commando’s in je terminal uit te voeren, afhankelijk van je besturingssysteem en terminal.

macOS / Linux / WSL: 

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

Windows PowerShell: 

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

Windows CMD:  

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

Opmerking: Installatie via npm install -g @anthropic-ai/claude-code bestaat nog maar is verouderd, dus geef de voorkeur aan het native installatieproces hierboven. Als je eerder via npm hebt geïnstalleerd, kun je migreren met claude install.

Zodra de installatie klaar is, navigeer je naar je projectmap en start je Claude met:

cd your-project-directory
claude

Voor authenticatie wordt je gevraagd of je Claude Code wilt gebruiken op basis van een betaald abonnement of API-gebruikfacturering.

Vervolgens ontvang je een loginlink die leidt naar een verificatiecode die je in de terminal met Claude Code moet invoeren. Daarna ben je klaar en wordt er automatisch een speciale “Claude Code”-werkruimte aangemaakt voor gebruikstracking en kostenbeheer.

Nu is Claude Code klaar voor gebruik.

Stap 2: Ontwikkelomgeving opzetten

Voor deze demo gebruik ik de Supabase Python-bibliotheek supabase-py, een open-source Pythonclient voor interactie met Supabase, een backend-as-a-service gebouwd op PostgreSQL. Supabase biedt een reeks tools, waaronder authenticatie, realtime-subscripties, opslag en automatisch gegenereerde API’s.

Laten we beginnen met het clonen van de repository en het opzetten van onze ontwikkelomgeving.

1. Open je terminal, navigeer naar de map waar je de Supabase-py-repository wilt clonen (bijv. cd Desktop) en voer het volgende commando uit:

git clone https://github.com/supabase/supabase-py.git
cd  supabase-py

2. Maak vervolgens een virtuele omgeving en installeer de vereiste dependencies door de volgende commando’s één voor één in je terminal te draaien

python3 -m venv env
source env/bin/activate  # On Windows, use ./env/Scripts/activate
pip install -e .

Je Python-omgeving is nu ingericht met alle noodzakelijke dependencies om de Supabase-bibliotheek te draaien, en je repository is klaar om te verkennen. 

Stap 3: Bijdragegebieden identificeren

Een goede manier om bij te dragen is door het tabblad Issues op GitHub te bekijken. In de Supabase-repository heb ik een issue gevonden in client.py met betrekking tot codeleesbaarheid, structuur en een gebrek aan zinvolle comments.

Dit is wat we met Claude Code gaan doen:

• We refactoren de code om leesbaarheid, onderhoudbaarheid en structuur te verbeteren.
• We voegen zinvolle docstrings en inline commentaar toe om het doel van verschillende componenten te verduidelijken.
• We identificeren en repareren bugs door issues en andere potentiële fouten te analyseren.

Stap 4: Experimenteren met Claude Code

Omdat we al in de supabase-py-map zitten, navigeer je naar de supabase-map met het bestand client.py en start je Claude Code:

cd supabase
claude

Claude Code heeft nu toegang tot elk bestand en elke map binnen de Supabase-py-map. Laten we nu experimenteren.

Code refactoren

Als onderdeel van het verbeteren van de Supabase Python-SDK refactoren we het bestand client.py om de leesbaarheid, onderhoudbaarheid en organisatie te verbeteren. Voer simpelweg de volgende prompt in op de command line:

Prompt: Refactor de code in het bestand client.py in de map Supabase.

Claude vraagt om bevestiging voordat hij doorgaat. Druk op Enter om de wijzigingen goed te keuren. Na afloop werkt Claude Code het bestand bij, toont de wijzigingen in de terminal en geeft een samenvatting van de aangebrachte veranderingen.

Met Claude Code hebben we de volgende verbeteringen toegepast op client.py:

• Georganiseerde imports:  Claude Code heeft gerelateerde imports gegroepeerd in logische secties (authfouten, API-typen, functionfouten), imports hernoemd voor duidelijkheid en overbodige aliassen verwijderd voor consistentie.
• Verbeterde leesbaarheid: Er zijn sectiecomments toegevoegd om imports te classificeren en duplicatie in de __all__-lijst is verwijderd voor een schonere organisatie.
• Vereenvoudigde clientopties: Ook zijn meerdere regels teruggebracht door vergelijkbare imports in één statement te combineren.

Hier zie je een vergelijking naast elkaar van de originele en de gerefactorde code.

Code documenteren

Naast refactoren kan Claude Code projectbrede codedocumentatie genereren, bijwerken en standaardiseren. Het kan ongedocumenteerde secties identificeren, gestructureerde docstrings of comments genereren en naleving van projectdocumentatiestandaarden controleren.

We hebben Claude Code gebruikt om de documentatie in client.py te verbeteren, wat resulteerde in:

• Duidelijke docstrings op modulniveau die het doel van het bestand uitleggen.
• Uitgebreide sectiecomments die imports categoriseren (fouttypen, clientimplementaties, opslagservices).
• Inline commentaar om fouttypen, clientfuncties en belangrijke componenten te beschrijven.

Hier is een vergelijking naast elkaar van gerefactorde en gedocumenteerde code.

Prompt: Documenteer de client.py-code door comments toe te voegen om het begrip te verbeteren.

Zodra de documentatie is toegevoegd, kun je de naleving van je projectstandaarden controleren met de volgende prompt voor Claude:

Prompt: Controleer of de documentatie onze projectstandaarden volgt.

Bugs oplossen

Debuggen kan tijdrovend zijn, maar Claude Code verkort de cyclus door foutmeldingen te analyseren, oorzaken te identificeren en fixes voor te stellen. Of je nu te maken hebt met ontbrekende imports, runtimefouten of logische issues, het verkleint de zoekruimte en doet gerichte verbetervoorstellen.

Zo gebruik je Claude Code voor debugging:

1. Identificeer het probleem:  Deel de foutmelding met Claude.
2. Vraag om fix-aanbevelingen: Vraag Claude om mogelijke oplossingen.
3. Pas de fix toe en verifieer:  Implementeer Claude’s suggesties en controleer of het probleem is opgelost.

Claude Code heeft het volgende gedaan om importgerelateerde issues in het bestand client.py op te lossen: 

• Type-ignore-comments: # type: ignore toegevoegd om IDE- en typecheck-waarschuwingen voor onopgeloste imports te onderdrukken.
• Consistente foutcategorisatie: Claude Code zorgde ervoor dat foutimports van authenticatie, database, opslag en functies duidelijk gegroepeerd zijn.
• Leesbaarheid behouden: Er zijn comments toegevoegd om aan te geven waarom bepaalde imports zijn genegeerd in plaats van verwijderd.

Hier is een vergelijking naast elkaar van de originele code en de gefixte code.

Prompt: Ik zie wat bugs, zoals ‘Import gotrue.errors’ could not be resolved. Help me alle errors in client.py te fixen.

Claude Code-commando’s

Hier zijn een paar commando’s om met Claude te proberen.

Voor meer diepgang raad ik onze gids voor Claude Code-slashcommando’s aan.

Geavanceerde Claude Code-functies

Zodra je de basis van refactoren en debuggen beheerst, kun je de mogelijkheden van Claude Code uitbreiden door het gedrag aan te passen. Hooks en Plugins laten je repetitieve taken automatiseren en externe systemen integreren.

Claude Code-hooks

Claude Code-hooks zijn geautomatiseerde triggers die shellcommando’s uitvoeren wanneer specifieke events optreden tijdens je Claude Code-sessie. Ze automatiseren repetitieve taken zoals codeformattering, tests draaien en securitychecks die Claude anders misschien overslaat.

Hooks gebruiken een event-actiesysteem, waarbij je drie dingen definieert:

• Het event: Wanneer wordt de hook getriggerd?

• De matcher: Welke acties worden geraakt?

• Het commando: Wat draait er wanneer de hook triggert?

Een hook kan bijvoorbeeld triggeren nadat Claude een Pythonbestand schrijft en automatisch black draaien om de code te formatteren. Hooks ontvangen JSON-context over wat er is gebeurd, waardoor slimme beslissingen mogelijk zijn op basis van bestandstypen of paden. Ze kunnen outputten naar het transcript van Claude of foutmeldingen direct naar Claude sturen om operaties te blokkeren.

Veelvoorkomende use-cases voor hooks zijn onder andere

• Codeformattering: Linters en formatters automatisch draaien na codewrites

• Testen: Testsuites uitvoeren na wijzigingen om bugs vroeg te vangen

• Security: Wijzigingen aan gevoelige bestanden zoals productieconfigs of API-sleutels blokkeren

• Documentatie: API-documentatie automatisch genereren wanneer bronbestanden wijzigen

• Git-automatisering: Smarter commits maken en branchbeveiligingsbeleid valideren

• Meldingen: Je team via Slack waarschuwen wanneer belangrijke bestanden veranderen

• Naleving: Licentieheaders of codestandaarden afdwingen voordat wijzigingen worden toegestaan

Stel hooks in met het /hooks-commando in Claude Code of bewerk ~/.claude/settings.json direct.

Claude Code-plugins

Plugins zijn extensies die Claude Code verbinden met externe tools, services en API’s. Waar hooks lokale shellcommando’s automatiseren, integreren plugins met je bredere ontwikkel-ecosysteem zoals CI/CD-pijplijnen, projectmanagementtools en communicatieplatforms van teams.

Plugins kunnen meerdere componenten bundelen—subagents (gespecialiseerde Claude-assistenten voor specifieke taken), MCP-servers (gestandaardiseerde toolintegraties) en hooks—tot één pakket dat ze samen orkestreert.

Een plugin kan bijvoorbeeld codewijzigingen analyseren en automatisch issues aanmaken in Jira, of verbinding maken met je interne testinfrastructuur. Plugins reageren op dezelfde events als hooks maar sturen data naar externe services en verwerken responses om de workflow van Claude te beïnvloeden.

Hier zijn enkele taken waarvoor Claude Code-plugins uitstekend zijn:

• CI/CD-integratie: Builds, tests en deployments triggeren wanneer bestanden veranderen

• Projectmanagement: Automatisch issues aanmaken of bijwerken in Jira, GitHub of Linear

• Teamcommunicatie: Updates posten naar Slack of Teams wanneer wijzigingen plaatsvinden

• Code review: Automatisch pull requests aanmaken en reviews beheren op GitHub/GitLab

• Externe analyse: SonarQube, CodeClimate of Snyk aanroepen voor enterprise-codescans

• Aangepaste tools: Integreren met bedrijfseigen systemen en workflows

• IDE-extensies: Aangepaste commando’s en navigatiehelpers toevoegen

Installeer plugins uit een register of bouw ze intern voor je organisatie, en configureer vervolgens op welke events ze reageren. Samen vormen hooks en plugins een uitbreidbaar platform dat Claude Code aanpast aan je bestaande infrastructuur.

Andere geavanceerde functies

Claude Code heeft in 2026 verschillende andere grote mogelijkheden toegevoegd die uitbreiden hoe en waar je het kunt gebruiken:

• Plan mode: Een design-first workflow waarin Claude een gedetailleerd implementatieplan maakt vóórdat er code wordt geschreven. Ik gebruik dit voor elke niet-triviale taak.
• Auto mode: Een toestemmingsclassifier waarmee Claude met minder onderbrekingen kan werken, handig voor langere taken waarbij je niet elke file write wilt goedkeuren.
• Routines: Geplande cloudagents die afvuren op een cronschema, een GitHub-event (zoals PR geopend) of een webhookcall. Je machine hoeft niet aan te staan.
• IDE-integratie: Claude Code heeft officiële extensies voor VS Code, Cursor en JetBrains-IDE’s met inline diffs, checkpoints en multisessie-ondersteuning.
• Remote control en Channels: Draai Claude Code-sessies en interacteer ermee vanaf je telefoon of andere apparaten.

Tot slot

In deze tutorial heb ik Claude Code gebruikt om een bestand in de Supabase Python-SDK te refactoren, te documenteren en te debuggen. We hebben de codeleesbaarheid verbeterd, gestructureerde documentatie toegevoegd en importproblemen opgelost.

Claude Code ontwikkelt zich actief met functies zoals plan mode, auto mode en Routines, dus het is de moeite waard om met je eigen projecten te experimenteren om te zien hoe het in je workflow past.

Om de volgende stap te zetten, raad ik je aan onze tutorial Claude Code Best Practices te lezen, waarin je leert hoe je het meeste uit Claude’s contextvenster haalt. Als je een project vanaf nul wilt opbouwen, raad ik onze tutorial Spec-Driven Development met Claude Code aan.