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

Wat is Claude Code?

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

Dit zijn een paar kernmogelijkheden van Claude Code:

• Bewerken en refactoren: Wijzig, optimaliseer en verbeter je codebase met AI-voorstellen.
• Bugfixes: Identificeer en los fouten, ontbrekende afhankelijkheden en prestatieknelpunten op.
• Codebegrip: Stel vragen over de architectuur, logica en afhankelijkheden van je code.
• Geautomatiseerd testen & linting: Voer tests uit en repareer falende tests, 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 met slimme automatisering die zich aanpast aan jouw codestijl en projectvereisten. Recente updates hebben automodus (minder toestemmingsonderbrekingen), planmodus (design-first-workflows) en Routines toegevoegd (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 reviews 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 overschakelen naar Opus-modellen. Je kunt midden in een sessie van model wisselen met het commando /model of de redeneerdiepte aanpassen met de schuifregelaar /effort. Je kunt ook zelfstandige AI-agents bouwen met de Claude Agents SDK.

Anthropic heeft ook Cowork geïntroduceerd voor agent-stijl hulp bij alledaagse bestands- en documenttaken buiten 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 starten met Claude Code heb je een terminal nodig, een codeproject om in te werken, en ofwel een Claude-abonnement (Pro/Max/Teams/Enterprise) of 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

Let op: Installatie via npm install -g @anthropic-ai/claude-code bestaat nog maar is verouderd; geef daarom de voorkeur aan het hierboven genoemde native installatieproces. 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 gevraagd of je Claude Code wilt gebruiken op basis van een betaald abonnement of API-gebruikfacturering.

Vervolgens ontvang je een inloglink met een verificatiecode die je in de terminal waar Claude Code draait moet invoeren. Dan ben je klaar, en er wordt automatisch een speciale “Claude Code”-werkruimte aangemaakt voor gebruiksregistratie 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 om met Supabase te werken, 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 na elkaar in je terminal uit te voeren

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 benodigde 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 verkennen. In de Supabase-repository heb ik een issue gevonden in client.py met betrekking tot codeleesbaarheid, structuur en het ontbreken van 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 onderdelen 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 eenvoudig de volgende prompt in op de commandoregel:

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

Claude zal om bevestiging vragen voordat hij doorgaat. Druk op Enter om de wijzigingen goed te keuren. Zodra het klaar is, werkt Claude Code het bestand bij, toont de wijzigingen in de terminal en geeft een samenvatting van wat er is aangepast.

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

• Geordende imports:  Claude Code heeft gerelateerde imports gegroepeerd in logische secties (authfouten, API-typen, functionfouten), imports hernoemd voor duidelijkheid en overbodige aliassen verwijderd voor consistentie.
• Betere leesbaarheid: Er zijn sectiecommentaren 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 te combineren in één statement.

Hier is een vergelijking naast elkaar van de oorspronkelijke 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 commentaar genereren en controleren of aan de documentatiestandaarden van het project wordt voldaan.

We hebben Claude Code gebruikt om de documentatie in client.py te verbeteren, met als resultaat:

• Heldere module-level docstrings die het doel van het bestand uitleggen.
• Uitgebreide sectiecommentaren 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 commentaar toe te voegen om het begrip te verbeteren.

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

Prompt: Controleer of de documentatie onze projectstandaarden volgt.

Bugs fixen

Debuggen kan tijdrovend zijn, maar Claude Code verkort de cyclus door foutmeldingen te analyseren, hoofdoorzaken 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 stelt gerichte correcties voor.

Zo gebruik je Claude Code voor debugging:

1. Identificeer het probleem:  Deel de foutmelding met Claude.
2. Ontvang 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 import-gerelateerde problemen in het bestand client.py op te lossen: 

• Type-ignore-commentaar: # 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 is commentaar toegevoegd om aan te geven waarom bepaalde imports zijn genegeerd in plaats van verwijderd.

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

Prompt: Ik zie een paar bugs, zoals 'Import gotrue.errors' kon niet worden opgelost. Help me alle fouten in client.py te repareren.

Claude Code-commando’s

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

Ik raad ook aan de officiële Anthropic-tutorials en onze gids met best practices voor Claude Code te bekijken.

Geavanceerde functies van Claude Code

Zodra je je prettig voelt met de basis van refactoren en debuggen, kun je de mogelijkheden van Claude Code uitbreiden door zijn gedrag aan te passen. Hooks en plugins laten je terugkerende taken automatiseren en externe systemen integreren.

Claude Code-hooks

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

Hooks gebruiken een event-actie-systeem, waarin je drie dingen definieert:

• De gebeurtenis: Wanneer wordt de hook getriggerd?

• De matcher: Welke acties worden geraakt?

• Het commando: Wat wordt er uitgevoerd als de hook triggert?

Zo kan een hook bijvoorbeeld na het schrijven van een Pythonbestand door Claude automatisch black draaien om de code te formatteren. Hooks ontvangen JSON-context over wat er gebeurde, waardoor slimme beslissingen mogelijk zijn op basis van bestandstypen of paden. Ze kunnen outputten naar Claude’s transcript of foutmeldingen direct naar Claude sturen om bewerkingen te blokkeren.

Veelvoorkomende use-cases voor hooks zijn de volgende

• Codeformattering: Automatisch linters en formatters draaien na schrijfbewerkingen

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

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

• Documentatie: API-documentatie automatisch genereren wanneer bronbestanden veranderen

• Git-automatisering: Slimme commits maken en branchprotectieregels valideren

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

• Compliance: 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 teamcommunicatieplatformen.

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

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

Dit zijn enkele taken waar Claude Code-plugins uitstekend voor 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 bij wijzigingen

• 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 propriëtaire systemen en workflows van je bedrijf

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

Installeer plugins vanuit 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 grote mogelijkheden toegevoegd die uitbreiden hoe en waar je het kunt gebruiken:

• Planmodus: Een design-first-workflow waarin Claude een gedetailleerd implementatieplan maakt voordat er code wordt geschreven. Ik gebruik dit voor elke niet-triviale taak.
• Automodus: Een toestemmingsclassificatie die Claude met minder onderbrekingen laat werken; handig voor langere taken waarbij je niet elke schrijfbewerking wilt goedkeuren.
• Routines: Geplande cloudagents die afgaan 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 ondersteuning voor meerdere sessies.
• Remote control en Channels: Draai Claude Code-sessies en werk 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 leesbaarheid van de code verbeterd, gestructureerde documentatie toegevoegd en importproblemen opgelost.

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

Wil je een volgende stap zetten, lees dan onze tutorial Claude Code Best Practices die je leert het maximale uit Claude’s contextvenster te halen. Als je een project vanaf de grond wilt opbouwen, raad ik onze tutorial Spec-Driven Development met Claude Code aan.