Claude Code 2.1: Een gids met praktische voorbeelden

Claude Code is een agentische codetool ontwikkeld door Anthropic die direct in je terminal draait en ook via een gekoppelde webinterface kan werken. In plaats van te werken met losse prompts, begrijpt Claude Code de hele repository, kan over bestanden heen redeneren, code bewerken en tools uitvoeren. 

Vergeleken met eerdere versies, die zich vooral richtten op interactieve code-assistentie, biedt Claude Code 2.1 extra ondersteuning voor agents, hooks en herbruikbare skills die actief kunnen bepalen hoe en wanneer codewijzigingen plaatsvinden.

Claude Code is ontworpen voor ontwikkelaars die AI-assistentie direct in hun echte workflows willen inbedden, in plaats van steeds te schakelen tussen een editor en een chat-UI. Hoewel het nog in research preview is, toont het nu al sterke praktische bruikbaarheid in echte ontwikkelworkflows. 

Wil je meer leren over de Claude-modellen? Dan raad ik de cursus Introduction to Claude Models aan. Bekijk ook onze Claude Cowork-tutorial.  

Wat is er nieuw in Claude Code 2.1?

Claude Code 2.1 bouwt voort op de kernervaring in de terminal met upgrades die agent-gedreven workflows flexibeler maken. Deze veranderingen breiden uit hoe Claude Code over een codebase redeneert en hoe ontwikkelaars ermee interacteren tijdens echte ontwikkelingstaken.

Enkele van de meest opvallende toevoegingen in Claude Code 2.1 zijn:

• Agent- en skill-hooks in frontmatter, waarmee ontwikkelaars controles en beperkingen kunnen afdwingen voordat codebewerkingen worden toegepast.
• Uitgebreide skill-ondersteuning met geforkte context, hot reload en aangepaste skill-definities, waardoor herbruikbare workflows flexibeler en krachtiger worden.
• Slash- (/) skill-aanroep voor snelle toegang tot vaak gebruikte acties tijdens interactieve sessies.
• Agents in Claude Code 2.1 stoppen niet langer met redeneren wanneer een tool-aanroep wordt geweigerd, zodat workflows zonder onderbreking kunnen doorgaan.
• De tool ondersteunt taalgestuurde antwoorden, vooral handig voor meertalige documentatie, reviews en teamcollaboratie.
• Wildcard tool-permissies, zoals Bash(*-h*), bieden fijnmaziger automatiseringscontrole.
• De CLI ondersteunt nu Shift+Enter voor invoer over meerdere regels, wat de interactieve schrijverservaring verbetert zonder extra setup.

In deze gids focussen we op een reeks praktische experimenten die laten zien hoe deze nieuwe mogelijkheden worden toegepast in echte projecten.

Claude Code cloudgebaseerde webervaring instellen

Claude Code 2.1 is beschikbaar als een webgebaseerde ervaring die volledig in de cloud draait. Deze modus is vooral handig voor collaboratieve workflows, pull request-reviews en automatisering op repo-niveau zonder lokale setup.

Stap 1: Log in en open Claude Code

Ga naar https://claude.ai/code om te beginnen, en je komt terecht op de Claude Code (Research Preview)-interface. 

Stap 2: Verbind Claude Code met GitHub

Om met echte repositories te werken, heeft Claude Code toegang tot GitHub nodig. Klik op Connect to GitHub om de Claude GitHub App te installeren. 

Tijdens de autorisatie vraagt GitHub om toestemming om verbinding te maken met repositories door:

• Je GitHub-identiteit te verifiëren
• Te bekijken welke repositories Claude kan benaderen
• Namens jou te handelen (bijvoorbeeld branches of commits aanmaken)

Je kunt kiezen tussen:

• Alle repositories, of
• Alleen geselecteerde repositories (aanbevolen voor strakkere controle)

Typische permissies zijn onder meer:

• Leestoegang tot repository-metadata en checks
• Lees- en schrijftoegang tot code, issues, pull requests en workflows

Klik op Install & Authorize; je kunt toegang later wijzigen of intrekken via de app-instellingen van GitHub. Deze stap is vereist zodat Claude Code repositories kan lezen, pull requests kan openen en commits kan pushen wanneer je in de webomgeving werkt.

Stap 3: Maak een cloudomgeving

Voordat je je eerste sessie start, vraagt Claude Code je om een cloudomgeving te maken. Deze omgeving bepaalt de netwerktoegang en uitvoergrenzen van Claude.

De beschikbare opties zijn:

• None: Geen internettoegang; vooral nuttig voor maximale veiligheid.
• Trusted (aanbevolen): Biedt toegang tot geverifieerde pakketbronnen.
• Full: Onbeperkte internettoegang.

Voor de meeste use-cases biedt de optie Trusted de beste balans tussen veiligheid en flexibiliteit.

Stap 4: Start een websessie

Na de setup kom je in de Claude Code-webeditor zoals in de onderstaande screenshot.

Vanaf hier kun je:

• Een repository en branch kiezen
• Refactors en reviews uitvoeren
• Nieuwe branches en commits maken
• Eerdere sessies hervatten (indien aanwezig)
• Tussen repositories wisselen zonder omgevingen te veranderen

Claude Code terminalgebaseerde CLI-ervaring instellen

De CLI is de meest directe manier om met Claude Code 2.1 te werken. Ideaal voor lokale ontwikkeling, stapsgewijze refactors en situaties waarin je fijnmazige controle wilt over wat Claude in je repository doet.

Stap 1: Installatie

Claude Code kan rechtstreeks vanuit de terminal worden geïnstalleerd met een platform-specifieke installer.

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

Zodra de installatie is voltooid, zie je een bevestigingsbericht met de Claude Code-versie en het installatiepad. Voor extra setup-opties kun je terecht in de officiële setupgids.

Stap 2: Aan de slag

Ga na installatie naar de root van je project en start Claude Code:

cd your-project-directory
Claude Code

Wanneer Claude Code start, scant het meteen de repository en bouwt het een eerste begrip op van de codebase. 

Deze initiële context stelt Claude Code in staat later effectiever te redeneren.

Experimenteren met Claude Code 2.1

Voor deze demo gebruikte ik een van mijn projecten op GPT 5.2. Hier is een kort overzicht van het project.

Zodra Claude Code toegang heeft tot alle bestanden en mappen binnen de map, kunnen we gaan experimenteren.

Refactoren met skills met geforkte context 

Als onderdeel van de evaluatie van Claude Code 2.1 voerde ik een repository-brede refactor uit om de pipeline te verbeteren. Dit experiment benadrukt skills met geforkte context, waarbij Claude over meerdere bestanden kan redeneren in plaats van geïsoleerde single-file-edits te doen.

Prompt:

Refactor the CSV parsing and slide generation logic across the repository.
Improve readability, split responsibilities, and avoid duplicated logic.

Claude genereert eerst een gedetailleerd refactorplan, inclusief de voorgestelde modulestructuur, duplicatiepunten en een implementatievolgorde, en vraagt vervolgens om goedkeuring voordat er iets verandert. 

Zodra je akkoord geeft, past Claude de refactor stapsgewijs toe en toont het onderweg diffs en voortgang.

Met Claude Code bereikte ik de volgende verbeteringen:

• Verantwoordelijkheden over modules gesplitst: Claude scheidde CSV-laden, transformaties, Excel-bouw, PowerPoint-generatie en LLM-planning (eigenlijk alle modules) in dedicated componenten.
• Verminderde dubbele logica: Het centraliseerde herhaalde utilities (zoals kolomdetectie en opmaak) en verplaatste gedeelde constanten naar een gemeenschappelijke configuratielaag.
• Verbeterde onderhoudbaarheid: Claude verkleinde ook de omvang van app.py terwijl het externe gedrag van de applicatie consistent bleef.

Hier is een vergelijking van de projectstructuur en de refactoroutput voor en na de wijzigingen.

Voor:

Na:

Tot slot probeerde ik dezelfde refactor in Claude Code Web. Het belangrijkste verschil is de workflow:

• CLI gaat stap voor stap met expliciete goedkeuringen.
• Web kan de refactor direct naar een nieuwe branch pushen, wat handig is voor samenwerking en PR-gebaseerde workflows.

Uiteindelijk heeft Claude de code gerefactord en naar een branch gepusht.

Pre-edit validatiehook

Datapipelines falen vaak om een eenvoudige reden: het invoer-CSV-schema komt niet overeen met wat de code verwacht. In Claude Code 2.1 kun je dit type fouten verminderen met pre-edit hooks. Deze nieuwe mogelijkheid laat een agent validatiecontroles uitvoeren voordat Claude code mag wijzigen.

In dit voorbeeld vroeg ik Claude Code om een agent te maken die de CSV-structuur valideert voordat er bewerkingen worden toegepast.

Prompt:

Create a Claude Code agent that validates the CSV schema before modifying any code. The agent should reject edits if the CSV schema is unclear.

Claude Code genereerde eerst een CSV-schemavalidatieagent en koppelde die in de workflow zodat deze als poortwachter kan fungeren. De CLI-output laat zien dat Claude niet slechts één script maakte, maar een klein validatiesysteem samenstelde met onder meer:

• Een kernmodule voor schema-validatie die vereiste kolommen, ontbrekende waarden en basisconsistentie controleert.
• Een pre-edit gatekeeper-hook die automatisch validatie uitvoert voordat bewerkingen doorgaan.
• Tot slot een testsuite en enkele gebruiksvoorbeelden om de validator te verifiëren voor geldige/ongeldige CSV-cases.

In de praktijk wordt de workflow eenvoudig:

• Claude voert automatisch schema-checks uit voordat er codewijzigingen plaatsvinden en dwingt zo een voorwaarde af.
• Als het schema onduidelijk of ongeldig is, blokkeert de agent bewerkingen hard en geeft actiegerichte foutmeldingen om de fix te sturen.
• Zodra de validatie slaagt, gaat Claude verder met aanpassingen, waardoor wijzigingen voorspelbaar en met guardrails blijven.

De weboutput toont een vergelijkbaar resultaat, met één belangrijk verschil. Claude Code Web kan de wijzigingen direct naar een nieuwe branch pushen, inclusief de validatiemodule, hook-integratie, documentatie en tests. 

Kortom, Claude Code 2.1 dwingt guardrails af vóórdat edits plaatsvinden door hooks direct in agents en skills te embedden. Dit maakt hooks bijzonder waardevol in data-intensieve projecten, waar de correctheid van input vaak een grotere bron van bugs is dan de code zelf.

Slash-commands voor terugkerende taken

Claude Code 2.1 introduceerde herbruikbare slash-command-skills: zelfvoorzienende workflows die je interactief binnen een Claude-sessie kunt aanroepen of direct vanaf de command line kunt uitvoeren. 

In dit voorbeeld maken we een herbruikbare /generate-slides-skill die een CSV-bestand omzet in een professionele PowerPoint-presentatie.

Prompt:

Create a reusable skill called /generate-slides that converts a CSV into a PPT.

Tip: Gebruik /statusline om een aangepaste statusregel te configureren die onder de invoerprompt verschijnt (handig om repo, branch of modus te tonen).

Claude Code genereert een complete skilldefinitie onder .claude/skills/, inclusief documentatie, validatielogica en een uitvoerbaar Python-entrypoint.

• Skillcreatie: Claude schrijft een volledig gedocumenteerde generate-slides-skill met beschrijving van doel, inputs, validatiestappen en uitvoeringsflow.
• Schemavalidatie: De skill valideert het CSV-schema vóór verwerking, voor datakwaliteit en duidelijke foutmeldingen.
• Uitvoering: De skill is rechtstreeks vanuit de terminal te draaien en gedraagt zich als een zelfstandige command-linetool.
• Foutafhandeling: Ontbrekende bestanden, ongeldige schema's of ontbrekende API-sleutels leveren heldere, uitvoerbare fouten op.
• Automatisering: Met één command genereer je Excel-artifacts, grafieken en een PowerPoint-deck.

Je kunt de skill lokaal testen met:

python .claude/skills/generate-slides.py --csv-file kpis.csv

Let op: Zorg dat je je API-sleutel hebt toegevoegd voordat je dit draait. 

Slash-commands maken van Claude Code een workflow-engine, niet alleen een assistent. In plaats van dezelfde taak steeds opnieuw te prompten, definieer je hem één keer en hergebruik je hem over projecten, sessies en omgevingen heen. Hieronder zie je de bijgewerkte repository-structuur, waarin de toevoeging van de nieuwe skill is terug te zien.

Dit voorbeeld laat zien hoe:

• Skills interactief vanuit de CLI kunnen worden aangeroepen.
• Door Claude gegenereerde skills netjes integreren met bestaande codebases.

Async Sub-agents en backgrounding

Een van de grootste frictiepunten in AI-codetools is de "wachttijd": naar een knipperende cursor kijken terwijl de AI nadenkt of een lange test-suite draait. Claude Code 2.1 lost dit op met Async Sub-agents.

Je kunt nu langlopende taken—zoals een complexe refactor, een testrun of een documentatiesweep—naar de achtergrond verplaatsen met Ctrl+B. Hiermee komt je terminal direct vrij, zodat je kunt:

• De codebase blijven bevragen.
• Een tweede, parallelle taak in de wachtrij zetten.
• Bestanden handmatig reviewen terwijl Claude werkt.

Bijvoorbeeld: terwijl Claude de module app.py refactort (wat minuten kan duren om te plannen en uit te voeren), kun je op Ctrl+B drukken en meteen vragen: "Terwijl dat draait, leg de authenticatielogica in auth.py uit."

Wanneer de achtergrondtaak klaar is, geeft Claude je een melding en kun je de context weer in je hoofdflow samenvoegen. Dit verandert Claude Code feitelijk van een single-threaded chatinterface in een multithreaded ontwikkelpartner, zoals senior engineers ook werken.

Taalgestuurde output 

Claude Code 2.1 kan zo worden ingesteld dat het in een specifieke taal reageert. Handig voor meertalige teams, gelokaliseerde documentatie en niet-Engelse code-walkthroughs. In dit voorbeeld vroegen we Claude om de pipeline voor slidegeneratie van de repository volledig in het Japans uit te leggen.

Prompt:

Explain the slide generation logic in Japanese.

Claude reageerde in het Japans en gaf een gestructureerde uitleg van de end-to-end-flow. Zoals in de output te zien is, vertaalde het niet alleen een samenvatting, maar deelde het de pipeline op in duidelijke fasen en verwees het naar de relevante modules in elke stap. De CLI-output laat zien:

• Japans van begin tot eind: Het antwoord blijft volledig in het Japans, inclusief koppen en opsommingstekens.
• Stapsgewijze flow: Claude splitst de pipeline in afzonderlijke fasen (CSV-validatie, dataverwerking, Excel-werkboek, LLM-planning en slidecreatie).
• Codebase-bewuste verwijzingen: Het verwijst naar relevante bestanden en mappen terwijl het uitlegt wat elk onderdeel doet.
• Documentatie-achtige opmaak: De output leest als interne docs, waardoor die makkelijk te hergebruiken is in een README of onboardinggids.

Let op: ik heb dit gedrag in dit voorbeeld alleen in de CLI getest, maar dezelfde taalsturing maakt deel uit van Claude Code 2.1 als geheel.

Op papier is dit een kleine feature, maar in de praktijk levert het een grote productiviteitswinst op wanneer documentatie en reviews in andere talen dan Engels moeten plaatsvinden.

Claude Code 2.1-commando's

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

Conclusie

In deze gids verkenden we Claude Code 2.1 door hands-on experimenten uit te voeren in zowel CLI- als webworkflows. We gebruikten Claude Code om een bestaande repository te refactoren met skills met geforkte context, datagaranties af te dwingen met pre-edit validatiehooks, herbruikbare slash-commands te maken en taalgestuurde uitleg direct vanuit de codebase te genereren.

Deze voorbeelden laten zien hoe Claude Code 2.1 verder gaat dan eenvoudige AI-ondersteunde edits richting meer agent-gedreven ontwikkelworkflows. Hoewel Claude Code 2.1 nog in research preview is, toont het nu al sterke praktische waarde in echte projecten.