Claude Code-tutorial: Setup, 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 ontwikkeltaken met natuurlijke-taalopdrachten. Het integreert met minimale setup in je ontwikkelomgeving, zodat jij je kunt focussen op het schrijven en verbeteren van code.

Hier zijn een paar kernmogelijkheden van Claude Code:

• Bewerken en refactoren: Wijzig, optimaliseer en verbeter je codebase met AI-gestuurde suggesties.
• Bugfixing: Identificeer en verhelp fouten, ontbrekende dependencies en prestatieknelpunten.
• Codebegrip: Stel vragen over de architectuur, logica en dependencies van je code.
• Geautomatiseerd testen & linting: Voer tests uit en repareer falende tests, draai linting-commando’s en verbeter de codekwaliteit.
• Git-integratie: Doorzoek git-geschiedenis, los merge-conflicten 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 cloud-agents die op triggers draaien zonder dat je 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 linting-taken 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 /model-commando of de redeneerkracht aanpassen met de /effort-slider. Je kunt ook zelfstandige AI-agents bouwen met de Claude Agents SDK.

Anthropic heeft ook Cowork geïntroduceerd voor agent-achtige hulp bij alledaagse bestands- en documenttaken buiten het coderen. Het is beschikbaar voor alle betaalde abonnementen (Pro, Max, Team, Enterprise) in de Claude Desktop-app.

Als je Claude Code afweegt tegen de terminalagent van xAI, test onze vergelijking Grok Build vs. Claude Code beide op dezelfde taak.

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 ó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. Geef daarom 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 door te draaien:

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 moet invoeren in de terminal waarin Claude Code draait. Dan ben je klaar en wordt er automatisch een speciale “Claude Code”-werkruimte aangemaakt voor gebruiksregistratie en kostenbeheer.

Nu is Claude Code klaar voor gebruik.

Stap 2: Ontwikkelomgeving instellen

Voor deze demo gebruik ik de Supabase Python-bibliotheek supabase-py, een open-source Python-client 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 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 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 verkennen. In de Supabase-repository identificeerde ik een issue in client.py met betrekking tot codeleesbaarheid, structuur en het ontbreken van zinvol commentaar.

Dit is wat we met Claude Code gaan doen:

• We refactoren de code om leesbaarheid, onderhoudbaarheid en structuur te verbeteren.
• Zinvolle docstrings en inline commentaar toevoegen om het doel van verschillende componenten te verduidelijken.
• Bugs identificeren en oplossen door issues en andere potentiële fouten te analyseren.

Stap 4: Experimenteren met Claude Code

Omdat we ons al in de supabase-py-map bevinden, 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 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. 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 (auth-fouten, API-typen, functie-fouten), imports hernoemd voor duidelijkheid en overbodige aliassen verwijderd voor consistentie.
• Verbeterde 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 soortgelijke imports te combineren in één statement.

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

Code documenteren

Naast refactoren kan Claude Code documentatie genereren, bijwerken en standaardiseren in een heel project. Het kan ongedocumenteerde secties identificeren, gestructureerde docstrings of commentaar 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 module-niveau die het doel van het bestand verklaren.
• 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 gerfactorde en gedocumenteerde code.

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

Zodra de documentatie is toegevoegd, kun je de naleving van je projectstandaarden verifiëren met deze 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, hoofdoorzaken te identificeren en fixes voor te stellen. Of je nu te maken hebt met ontbrekende imports, runtime-fouten 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. Krijg 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 geregeld om importgerelateerde issues in het bestand client.py op te lossen: 

• Type-ignore-commentaar: # type: ignore-commentaar 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 originele code en de gefixte code.

Prompt: Ik zie enkele bugs, zoals ‘Import gotrue.errors’ kon niet worden opgelost. Help me alle fouten in client.py te fixen.

Claude Code-commando’s

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

Voor meer verdieping raad ik onze gids met Claude Code-slashcommando’s aan.

Geavanceerde functies van Claude Code

Zodra je de basis van refactoren en debuggen onder de knie hebt, 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 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, waarbij je drie dingen definieert:

• De gebeurtenis: Wanneer wordt de hook geactiveerd?

• De matcher: Welke acties worden geraakt?

• Het commando: Wat wordt er uitgevoerd wanneer de hook afgaat?

Een hook kan bijvoorbeeld triggeren nadat Claude een Python-bestand schrijft en 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 output geven aan Claude’s transcript of foutmeldingen rechtstreeks 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

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

• Documentatie: API-documentatie automatisch genereren wanneer bronbestanden veranderen

• Git-automatisering: Slimme commits maken en branchbeveiligingsbeleid valideren

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

• Compliance: Licentieheaders of codeerstandaarden afdwingen voordat wijzigingen worden toegestaan

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

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 teamcommunicatieplatforms.

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 codewijzigingen analyseren en automatisch issues aanmaken in Jira, of koppelen aan je interne testinfrastructuur. Plugins reageren op dezelfde events als hooks, maar sturen data naar externe services en verwerken reacties om Claude’s workflow te beïnvloeden.

Hier zijn een paar taken waar Claude Code-plugins uitstekend voor zijn:

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

• Projectmanagement: Issues automatisch aanmaken of bijwerken in Jira, GitHub of Linear

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

• Code review: Pull requests automatisch aanmaken en reviews beheren op GitHub/GitLab

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

• Aangepaste tools: Integreren met propriëtaire systemen en workflows van het bedrijf

• IDE-extensies: Aangepaste commando’s en navigatiehulpen 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 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 permissie-classifier die Claude met minder onderbrekingen laat werken, handig voor langere taken waarbij je niet elke file write wilt goedkeuren.
• Routines: Geplande cloud-agents die afgaan op een cronschema, een GitHub-event (zoals PR geopend) of een webhook-call. 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: Voer Claude Code-sessies uit 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, documenteren en debuggen. We verbeterden de codeleesbaarheid, voegden gestructureerde documentatie toe en losten importproblemen op.

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

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