Bevindingen

Claude Code, het volledige naslagwerk

Dit is je eigen document, geschreven voor een eerdere versie van Claude Code en op 15 november 2026 overgezet naar deze vault. De opbouw, de indeling en de blokken "Wat betekent dit precies" zijn van jou. Alleen de opmaak is opgeruimd: de streepjes zijn weg, de omgeleide links zijn leesbaar gemaakt en de lege tabelkoppen zijn rechtgezet. Drie dingen zijn verouderd en staan hieronder rechtgezet: de installatie gebeurt niet meer met npm, Windows heeft geen WSL meer nodig, en het toegangssysteem heeft meer standen dan de vier die hier staan. Voor de lesversie bij dit document: Claude Code, een tweede paar handen op je eigen pc.

Claude Code is een AI-coding agent die direct in je terminal draait. Het kan code door het hele codebase lezen, bewerken en uitvoeren.

Claude Code is een op de terminal gebaseerde AI-agent, gebouwd op Claude. Het heeft directe toegang tot je filesystem, shell en verschillende tools. Hierdoor kun je taken in begrijpelijke taal omschrijven en regelt Claude de implementatie van begin tot eind, zonder copy-pasting of het wisselen van context.

Wat kan Claude Code doen?

  • Bestanden lezen en bewerken: Claude leest bronbestanden, schrijft nieuwe inhoud en voert gerichte bewerkingen uit. Het toont diffs (verschillen) voordat het wijzigingen doorgevoerd, zodat jij de controle behoudt.
  • Shell-commando's uitvoeren: Voer tests, build scripts, git operations en elk ander shell command uit, met instelbare toegangsrechten voor jouw veiligheid.
  • Zoeken in je codebase: Vind bestanden op basis van een glob pattern, doorzoek inhoud met regular expressions en navigeer door grote codebases zonder elk bestand handmatig te hoeven openen.
  • Gegevens ophalen van het web: Raadpleeg documentatie, lees API specs of zoek op het web, allemaal zonder je terminal session te verlaten.
  • Sub-agents aanmaken: Deel complexe taken op in taken die tegelijkertijd kunnen worden uitgevoerd. Claude kan meerdere agents opstarten en coördineren om aan verschillende delen van een probleem tegelijkertijd te werken.
  • MCP servers verbinden: Breid de mogelijkheden van Claude uit met Model Context Protocol (MCP) servers voor databases, API's, interne tools en meer.

Toegangssysteem

Elk gebruik van een tool in Claude Code gaat door een toestemmingscontrole. Jij bepaalt hoeveel beslissingsbevoegdheid Claude heeft.

ModeGedrag
defaultClaude vraagt toestemming voordat het shell commands uitvoert of wijzigingen aanbrengt. Jij keurt elke actie goed of wijst deze af.
acceptEditsBestandsbewerkingen worden automatisch toegepast. Shell commands vereisen nog steeds goedkeuring.
planClaude maakt een plan en vraagt om jouw akkoord voordat er actie wordt ondernomen. Handig voor het controleren van grote wijzigingen.
bypassPermissionsAlle acties worden uitgevoerd zonder vragen. Bedoeld voor geautomatiseerde pipelines in beveiligde omgevingen, niet voor interactief gebruik.

Wat betekent dit precies?

  • bypassPermissions: Dit is de "alles mag"-stand. De AI vraagt niet meer om een bevestiging en voert direct uit wat hij denkt dat moet gebeuren. Gebruik dit alleen in een veilige, geïsoleerde digitale omgeving (zoals een Docker container), anders kan de AI per ongeluk belangrijke bestanden op je eigen computer verwijderen of aanpassen zonder dat je het doorhebt.

Stel je permission mode in met de --permission-modeflag wanneer je Claude opstart, of pas dit aan met /permissions, waarmee je ook regels voor specifieke tools kunt beheren:

claude --permission-mode acceptEdits

CLAUDE.md geheugensysteem

Claude Code leest bij de start van elke session de CLAUDE.md-bestanden uit je repository. Deze bestanden laten je projectspecifieke kennis vastleggen, zoals build commands, codeer-conventies, architectuurnotities en vereiste environment variables, zodat Claude deze niet telkens opnieuw hoeft te ontdekken.

Er zijn drie niveaus:

  1. Project:CLAUDE.md in de hoofdmap van de repository. Gedeeld door iedereen in het team en opgenomen in source control.
  2. Persoonlijk:CLAUDE.local.md in de hoofdmap. Jouw privévoorkeuren voor dit project, die in de.gitignore staan.
  3. Submap: Een CLAUDE.md in een submap. Deze wordt automatisch geladen wanneer Claude in die map werkt. Handig voor monorepos met verschillende modules.

Voer /init uit in een Claude Code session om automatisch een CLAUDE.md voor je project te genereren. Claude analyseert je codebase en maakt een bestand met de commando's en context die er echt toe doen.

Binnen een Claude Code session

/init

Houd CLAUDE.md beknopt. Elke regel moet deze test doorstaan: "Zou Claude fouten maken als ik dit zou verwijderen?" Zo nee, haal het dan weg.

Authenticatie

Claude Code kan op twee manieren inloggen:

  1. OAuth (aanbevolen): Log in met je Anthropic-account op claude.ai. Voer claude voor de eerste keer uit en volg de instructies in de browser.
  2. API key: Stel de ANTHROPIC_API_KEY environment variable in. Handig voor CI pipelines en niet-interactieve sessies.

Zie Authentication voor de volledige volgorde van prioriteiten en opties voor cloudproviders (zoals AWS Bedrock of GCP Vertex AI).

Installeer Claude Code, verifieer je identiteit en voltooi je eerste codeerklus in minder dan 5 minuten.

Vereisten

  • Node.js 18 of hoger
  • npm

Om je Node.js versie te controleren:

node --version

Als je Node.js nog moet installeren of upgraden, download het dan via nodejs.org.

Stap 1: Claude Code installeren

Installeer het package wereldwijd met npm:

Bijgewerkt op 15 november 2026. Deze npm-route is niet meer de aanbevolen weg. Anthropic levert nu een eigen installatiescript, en op Windows werkt Claude Code native, zonder WSL. De huidige commando's staan in de lesmodule Claude Code, een tweede paar handen op je eigen pc.

npm install -g @anthropic-ai/claude-code

Controleer of de installatie is gelukt:

claude --version

Stap 2: Authenticatie

Voer claude uit vanuit een willekeurige map om de eerste installatie te starten:

claude

Bij de eerste keer opstarten opent Claude Code je browser en leidt het je door het inlogproces met je Anthropic-account. Zodra dit is voltooid, worden je credentials veilig opgeslagen en hergebruikt voor toekomstige sessions.

Als alternatief kun je direct een API key instellen als je liever geen OAuth gebruikt:

export ANTHROPIC_API_KEY=sk-ant-...

API keys krijgen voorrang wanneer de ANTHROPIC_API_KEY environment variable is ingesteld. Voor interactief gebruik wordt OAuth aanbevolen, omdat dit het verversen van tokens automatisch regelt.

Wat betekent dit precies?

  • OAuth: Dit is een veilige manier om in te loggen via je browser, vergelijkbaar met de knop "Inloggen met Google" op veel websites. Het is makkelijker omdat je geen ingewikkelde codes hoeft te kopiëren en plakken.
  • API key: Dit is een lange, unieke reeks tekens (een wachtwoord voor computers) die je gebruikt om toegang te krijgen tot de diensten van Anthropic. Het wordt vaak gebruikt voor geautomatiseerde systemen (scripts) die niet in een browser kunnen kijken.
  • Environment variable: Dit is een variabele op je computer die wereldwijd toegankelijk is voor programma's. Door deze variabele in te stellen, weet Claude automatisch welke API key hij moet gebruiken zonder dat je deze bij elk commando opnieuw hoeft in te typen.

Stap 3: Navigeer naar je project

Claude Code werkt binnen de map waarin je je bevindt. Navigeer naar het project waar je aan wilt werken:

cd my-project

Stap 4: Start een interactieve session

Voer claude uit om een interactieve session te starten:

claude

Je ziet een prompt waar je taken in gewone taal kunt typen. Claude leest je projectbestanden, voert commando's uit en brengt wijzigingen aan op basis van wat jij omschrijft.

Voorbeelden van eerste taken om te proberen:

explain the structure of this codebase

add input validation to the signup form

write tests for the UserService class

find all places where we catch and swallow errors

Claude laat zien wat het van plan is voordat het wijzigingen doorvoert die toestemming vereisen. Je kunt bij elke stap goedkeuren, weigeren of om een andere aanpak vragen.

Stap 5: Een CLAUDE.md bestand initialiseren

Voer /init uit binnen je session om een CLAUDE.md-bestand voor je project te genereren:

/init

Claude analyseert je repository, door manifest files, bestaande documentatie en de codestructuur te lezen, en produceert een CLAUDE.md met de commando's en context die nodig zijn om effectief in jouw codebase te werken. Het is aan te raden het gegenereerde bestand te controleren en te bewerken voordat je het vastlegt (commit).

CLAUDE.md wordt bij de start van elke session geladen. Het is de beste plek om zaken als niet-standaard build commands, eigenaardigheden bij het testen en team-specifieke codeerconventies vast te leggen.

Een niet-interactief commando uitvoeren

Gebruik de -pflag om één enkele taak uit te voeren en het resultaat te tonen, zonder een interactieve session te starten. Dit is handig voor scripting of losse vragen:

claude -p "explain this codebase"
claude -p "list all TODO comments and the files they appear in"
claude -p "check for unused exports in src/"

Belangrijke slash-commando's

Zodra je in een interactieve session zit, zijn dit de handigste commando's om te kennen:

CommandoBeschrijving
/helpToon beschikbare commando's en sneltoetsen
/initGenereer of update een CLAUDE.md voor het huidige project
/memoryBekijk en bewerk geheugenbestanden (CLAUDE.md, CLAUDE.local.md)
/permissionsBekijk of wijzig de huidige permission mode
/mcpBeheer verbonden MCP servers
/clearWis de huidige gesprekscontext
/exitBeëindig de session

Hoe Claude Code werkt

De onderliggende logica van de agentic loop, het laden van de context, het tool execution model en de levenscyclus van de conversatie.

Claude Code is een terminal-based coding-agent die een continue agentic loop uitvoert: het leest je verzoek, redeneert over wat er moet gebeuren, roept tools aan, bekijkt de resultaten en herhaalt dit proces totdat de taak is voltooid of totdat het jouw input nodig heeft.

De agentic loop

Elke interactie volgt dezelfde fundamentele cyclus:

  1. Gebruiker verstuurt een bericht: Je typt een bericht in de terminal (interactive mode) of geeft er een door via --print / stdin (non-interactive / headless mode). Het bericht wordt toegevoegd aan de gespreksgeschiedenis.
  2. Context wordt verzameld: Voordat het model wordt aangeroepen, stelt Claude Code een system prompt samen die het volgende bevat: de huidige datum, git status (branch, recente commits, working-tree status), alle geladen CLAUDE.md geheugenbestanden en de lijst met beschikbare tools. Deze context wordt eenmaal per gesprek opgebouwd en in het geheugen opgeslagen (memoized).
  3. Claude redeneert en selecteert tools: Het samengestelde gesprek wordt naar de Anthropic API gestuurd. Het model redeneert over de taak en voert een of meer tool_use blokken uit, elk met een specifieke tool-naam en gestructureerde JSON-input.
  4. Toestemmingscontrole: Voor elke tool call evalueert Claude Code de huidige permission mode en eventuele allow/deny regels. Afhankelijk van de modus wordt de actie automatisch goedgekeurd, wordt er om bevestiging gevraagd, of wordt de aanroep volledig geblokkeerd.
  5. Tool voert uit en geeft resultaat: Goedgekeurde tool calls worden uitgevoerd. Resultaten, bestandsinhoud, commando-output, zoekresultaten, worden toegevoegd aan het gesprek als tool_result blokken.
  6. Loop gaat door: Het model ontvangt de resultaten en roept ofwel meer tools aan, of geeft een uiteindelijke tekstuele reactie. De loop herhaalt zich totdat er geen tool calls meer over zijn in een beurt van het model.

De loop draait volledig in jouw terminal process. Er is geen externe server voor uitvoering, je bestanden, shell en credentials verlaten nooit jouw machine, tenzij een tool ze expliciet verzendt (bijv. WebFetch, WebSearch of een MCP server).

Wat betekent dit precies?

  • Agentic loop: Dit is een proces waarbij de AI niet zomaar één antwoord geeft, maar zelfstandig "nadenkt", acties onderneemt (zoals een bestand aanpassen), kijkt of dat lukte, en op basis daarvan de volgende stap bedenkt. Net zoals een menselijke assistent die stapsgewijs een klus in je kast opknapt.
  • Memoized / Memoize: Dit is een programmeertechniek waarbij de computer het resultaat van een berekening onthoudt. De volgende keer dat diezelfde berekening nodig is, hoeft de computer niet opnieuw na te denken, maar kan hij direct het antwoord uit zijn "geheugen" pakken. Dat bespaart tijd en rekenkracht.
  • Stdin / Stdout: Dit zijn de standaardkanalen voor input en output in een computer. Stdin is wat jij intypt (input), stdout is wat de computer op je scherm schrijft (output). Met piping kun je de output van het ene programma direct doorsturen als input naar het volgende programma.

Context laden

Aan het begin van elk gesprek bouwt Claude Code twee context-blokken die vooraf worden gegaan aan elke API call:

  • Systeemcontext: Samengesteld door getSystemContext() in context.ts. Bevat:
  • Git status: huidige branch, standaard/main branch, git username, de output van git status --short (afgekapt tot 2.000 tekens indien groter), en de laatste 5 commits van git log --oneline.
  • Cache-breaking injection: een optionele, tijdelijke string die intern wordt gebruikt om de server-side prompt cache te omzeilen tijdens het debuggen.
  • Gebruikerscontext: (Git status wordt overgeslagen wanneer CLAUDE_CODE_REMOTE=1 is ingesteld of wanneer git instructies zijn uitgeschakeld in de instellingen).

Beide context-blokken zijn in het geheugen opgeslagen voor de duur van het gesprek via lodash/memoize. Het aanroepen van setSystemPromptInjection() wist de caches direct.

Tool execution model

Claude Code voert tool calls standaard niet autonoom uit. Elke tool heeft een checkPermissions methode, en het resultaat bepaalt wat er daarna gebeurt:

Resultaat toestemmingWat er gebeurt
allowDe tool wordt direct uitgevoerd; het resultaat wordt aan het gesprek toegevoegd.
askClaude Code pauzeert en toont een bevestigingsvenster.
denyDe tool call wordt afgewezen; Claude ontvangt een foutmelding.

Het gedrag hiervan wordt bepaald door de actieve permission mode en geconfigureerde allow/deny regels. In de --bypassPermissions modus worden alle controles overgeslagen. In de acceptEdits modus worden file-edit tools automatisch goedgekeurd, maar bash-commando's vragen nog steeds om bevestiging. Veilige, read-onlytools (zoals Read, Glob, Grep) worden over het algemeen in alle modi automatisch goedgekeurd.

Interactief vs. non-interactive (task) modus

  • Interactieve (REPL) modus: De standaardervaring. Claude Code rendert een live terminal UI met behulp van React/Ink. Je ziet streaming output, bevestigingen voor tool-use en animaties terwijl de agent werkt. Berichten blijven behouden gedurende de session totdat je deze afsluit.
  • Non-interactive / print modus: Geactiveerd met --print of door stdin te pipen. Er wordt geen UI getoond. Output wordt geschreven naar stdout zodat deze kan worden opgevangen door scripts of CI pipelines. Handig voor geautomatiseerde taken ("one-shot").

Sub-agents (Task tool)

Claude kan sub-agents aanmaken via de Task tool (AgentTool). Elke sub-agent voert zijn eigen nested agentic loop uit met een geïsoleerd gesprek en, optioneel, een beperkte tool set. Sub-agents kunnen lokaal (in-process) of op externe rekenkracht (remote compute) draaien. Resultaten worden teruggestuurd naar de hoofdagent wanneer de sub-agent klaar is.

Gespreksopslag en hervatting

Gesprekken worden opgeslagen als JSON transcript-bestanden op de schijf (standaard in ~/.claude/). Elk gesprek heeft een unieke session ID. Je kunt een vorig gesprek hervatten met --resume <session-id> of een gesprek uit de lijst kiezen door alleen --resume te gebruiken.

Wanneer een gesprek wordt hervat:

  • De volledige gespreksgeschiedenis wordt van de schijf geladen.
  • Geheugenbestanden worden opnieuw gevonden en kunnen verschillen van toen het gesprek voor het eerst werd gestart.
  • De permission mode wordt gereset naar de geconfigureerde standaard, tenzij deze in de session was opgeslagen.
  • Lange gesprekken worden periodiek gecomprimeerd, de oudste berichten worden samengevat om het context window beheersbaar te houden. De volledige, ruwe transcript blijft altijd op de schijf bewaard; compressie heeft alleen invloed op wat naar de API wordt gestuurd.

De query engine

Achter de schermen wordt elke "beurt" in de agentic loop aangestuurd door een query, een aanroep naar query.ts die de huidige lijst met berichten naar de Anthropic API stuurt en de reactie terug streamt. De query engine regelt:

  • Het in real-time streamen van token output naar de terminal.
  • Het doorsturen van tool_use blokken naar de juiste tool handlers.
  • Het handhaven van budgetten per beurt voor tokens en tool-calls.
  • Het verzamelen van tool results en het toevoegen hiervan voor de volgende model call.
  • Het triggeren van compressie wanneer het context window vol raakt.

Elke tool heeft een maxResultSizeChars eigenschap. Wanneer een resultaat deze limiet overschrijdt, wordt de inhoud opgeslagen in een tijdelijk bestand ("temporary file") en ontvangt het model een voorbeeld met het bestandspad, waardoor een context-window overflow door grote outputs wordt voorkomen.

Installatie

Installeer Claude Code op macOS, Linux of Windows (via WSL). Vereist Node.js 18 of hoger.

Vereisten

  • Node.js 18 of hoger: Claude Code controleert de Node.js-versie bij het opstarten en sluit af met een foutmelding als deze lager is dan 18.
  • npm: Standaard meegeleverd met Node.js.

Controleer je huidige versies:

node --version
npm --version

Installatie van Claude Code

Installeer het package wereldwijd met npm:

npm install -g @anthropic-ai/claude-code

Controleer na de installatie of het werkt:

claude --version

Platformspecifieke opmerkingen

MacOS

npm globale installaties werken direct op macOS. Als je een autorisatiefout (permissions error) krijgt bij het uitvoeren van npm install -g, heb je twee opties:

Optie A: npm autorisaties herstellen (aanbevolen)

Configureer npm om een map in je home folder te gebruiken:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

Voeg het volgende toe aan je shell profile (~/.zshrc of ~/.bash_profile):

export PATH=~/.npm-global/bin:$PATH

Herlaad daarna je profile en installeer:

source ~/.zshrc

npm install -g @anthropic-ai/claude-code

Optie B: Gebruik een Node version manager

Tools zoals nvm of fnm installeren Node.js in je home directory, waardoor globale autorisatieproblemen volledig worden voorkomen:

Met nvm

nvm install --lts

nvm use --lts

npm install -g @anthropic-ai/claude-code

Linux

(Opmerking: De instructies voor Linux zijn doorgaans gelijk aan die van macOS (Optie A of B). Als je een beheerderswachtwoord nodig hebt voor de installatie, overweeg dan ook het gebruik van nvm of fnm om problemen te voorkomen.)

Windows(WSL)

Claude Code ondersteunt Windows via WSL (Windows Subsystem for Linux). Installeer Node.js en npm binnen je WSL-distributie (bijv. Ubuntu) en volg daarna de standaard Linux-installatie-instructies.

Wat betekent dit precies?

  • WSL (Windows Subsystem for Linux): Dit is een handige functie van Windows waarmee je een Linux-omgeving kunt draaien op je Windows-computer. Voor technische tools zoals Claude Code werkt dit veel beter dan de standaard Windows-opdrachtprompt.
  • Shell profile (.zshrc / .bash_profile): Dit is een verborgen configuratiebestand dat vertelt hoe je terminal zichzelf moet instellen als je hem opent. Door hier een export PATH regel aan toe te voegen, vertel je de computer: "Kijk ook in deze map als ik een commando intyp".
  • Node version manager (nvm / fnm): Een tool waarmee je makkelijk tussen verschillende versies van Node.js kunt schakelen. Het is de veiligste manier om software te installeren zonder dat je systeembeheerdersrechten (sudo) nodig hebt.

Bijwerken

Update Claude Code naar de nieuwste versie met:

npm update -g @anthropic-ai/claude-code

Of gebruik het ingebouwde update-commando van Claude Code:

claude update

Om te zien welke versie je draait:

claude --version

Verwijderen

Verwijder Claude Code met:

npm uninstall -g @anthropic-ai/claude-code

Dit verwijdert het claudebinary (het uitvoerbare bestand). Je configuratiebestanden in ~/.claude/ worden niet automatisch verwijderd. Om deze handmatig te verwijderen:

rm -rf ~/.claude

Troubleshooting

  • claude commando niet gevonden na installatie: Je PATH is waarschijnlijk niet correct bijgewerkt. Controleer of de map waar npm de pakketten installeert, in je PATH staat.
  • Node.js versie lager dan 18: Upgrade Node.js via nodejs.org of je version manager.
  • 'Permission denied' bij npm install -g: Gebruik nvm/fnm (zie Optie B) of configureer een lokale map voor npm (zie Optie A).
  • Authenticatie mislukt bij de eerste keer opstarten: Zorg dat je browser toegankelijk is vanuit je terminal-omgeving.
  • Draaien in Docker of een CI environment: Gebruik de API key methode (ANTHROPIC_API_KEY) voor niet-interactieve omgevingen.

Geheugen en Context (CLAUDE.md)

Hoe Claude Code CLAUDE.md-geheugenbestanden ontdekt, laadt en prioriteert om Claude constante, projectbewuste instructies te geven.

Claude Code ondersteunt een gelaagd geheugensysteem op basis van eenvoudige Markdown-bestanden. Door instructies in CLAUDE.md-bestanden op verschillende niveaus van je filesystem te schrijven, kun je het gedrag van Claude aanpassen op globaal niveau, per project of per gebruiker, en kun je sommige instructies privé houden terwijl je andere opneemt in source control.

De hiërarchie op 4 niveaus

Geheugenbestanden worden geladen in de onderstaande volgorde (van laagste naar hoogste prioriteit). Bestanden die later worden geladen hebben voorrang, omdat het model meer aandacht besteedt aan instructies die later in het context window verschijnen.

  1. Managed memory (laagste prioriteit):
  • Pad: /etc/claude-code/CLAUDE.md (of het platform-equivalent geconfigureerd door je organisatie).
  • Systeembrede instructies ingesteld door een beheerder/beheertool. Geldt voor alle gebruikers op de machine. Ondersteunt ook een rules/ submap. Kan niet worden overschreven door gebruikers- of projectbestanden als het via beleidsinstellingen wordt afgedwongen.
  1. User memory:
  • Pad: ~/.claude/CLAUDE.md en ~/.claude/rules/*.md.
  • Jouw persoonlijke, globale instructies voor elk project. Ideaal voor eigen voorkeuren zoals codeerstijl, standaardtaal of je git username. Dit bestand wordt nooit toegevoegd aan een repository.
  1. Project memory:
  • Pad (wordt gecontroleerd in elke bovenliggende map, vanaf de root tot aan de CWD): CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md.
  • Instructies in de codebase gedeeld met het hele team. Ideaal voor projectconventies, architectuurnotities, testcommando's en alles wat iedereen moet volgen. Wordt opgenomen in source control.
  1. Local memory (hoogste prioriteit):
  • Pad: CLAUDE.local.md (gecontroleerd in elke bovenliggende map).
  • Privé, projectspecifieke instellingen die afwijken van de standaard. Dit bestand moet aan.gitignore worden toegevoegd. Gebruik dit voor persoonlijke voorkeuren die alleen voor dit project gelden, zoals paden naar lokale omgevingen, persoonlijke snelkoppelingen of instructies die je niet wilt delen.

Wat betkent dit precies?

  • Hiërarchie: Dit betekent dat als je in twee bestanden tegenstrijdige regels zet, de "lokale" regel (die bovenaan staat in de hiërarchie) wint.
  • Prioriteit: Bij computers is het vaak zo dat de instructie die als laatste wordt gelezen, de vorige instructies mag "overschrijven" of "bijsturen". Daarom hebben bestanden die later in het proces worden geladen, de meeste macht.

Ontdekkingsmechanisme

Wanneer Claude Code start, doorzoekt het het filesystem vanaf de huidige map (CWD) omhoog tot aan de root. De zoekvolgorde zorgt ervoor dat bestanden met een lagere prioriteit eerst in de context verschijnen. De volledige lijst met gevonden bestanden wordt in het geheugen opgeslagen (memoised) voor de duur van het gesprek. Gebruik /memory om de editor te openen en een herlaadbeurt te forceren.

De @include instructie

Geheugenbestanden kunnen verwijzen naar andere bestanden met de @ notatie. Het verwezen bestand wordt ingevoegd als een apart item in de context.

  • Regels:
  • @include-paden in code blocks of inline code worden genegeerd.
  • Circulaire verwijzingen (bestand A verwijst naar B, en B naar A) worden gedetecteerd en overgeslagen.
  • Bestanden die niet bestaan worden stilzwijgend genegeerd.
  • Maximum include diepte is 5 niveaus.
  • Alleen tekstbestanden (.md, .ts, .py, enz.) worden meegenomen. Binaire bestanden (zoals afbeeldingen) worden overgeslagen.

.claude/rules/*.md, gedetailleerde regels

In plaats van alles in één groot CLAUDE.md-bestand te proppen, kun je instructies verdelen over meerdere Markdown-bestanden in de.claude/rules/ map. Deze bestanden ondersteunen paths-scoped frontmatter:

\-\-\-

paths:

\- "src/api/**"

\- "src/services/**"

\-\-\-

Wanneer paths is ingesteld, wordt de regel alleen in de context geladen wanneer Claude werkt aan een bestand dat overeenkomt met een van de glob patterns. Dit houdt de context overzichtelijk voor grote projecten.

Maximum bestandsgrootte

De aanbevolen limiet voor elk geheugenbestand is 40.000 tekens. Bestanden die groter zijn, krijgen een melding en de kans bestaat dat Claude niet de volledige inhoud leest. Houd geheugenbestanden gefocust en bondig.

Hoe geheugen het gedrag van Claude beïnvloedt

Wanneer geheugenbestanden worden geladen, worden ze gecombineerd in één contextblok. Dit betekent dat instructies in CLAUDE.md-bestanden voorrang hebben op de ingebouwde standaardinstellingen van Claude. Gebruik dit om projectconventies af te dwingen of domeinkennis toe te voegen.

Het /memory commando

Voer /memory uit in de Claude Code REPL om de editor voor geheugenbestanden te openen. Je ziet welke bestanden geladen zijn, kunt ze direct bewerken en de context herladen bij het opslaan.

Je kunt het ook aan Claude vragen: "Voeg een regel toe aan CLAUDE.md dat we altijd 2 spaties voor inspringing gebruiken." Claude zal dan zelf het juiste bestand opzoeken en de instructie voor je schrijven.

Geheugen uitschakelen

  • CLAUDE_CODE_DISABLE_CLAUDE_MDS=1: Schakelt het laden van alle geheugenbestanden volledig uit.
  • --bare flag: Slaat het automatisch zoeken naar bestanden vanuit de CWD over; laadt alleen bestanden uit locaties die expliciet zijn opgegeven met --add-dir.
  • claudeMdExcludes instelling: Een lijst met glob patterns om specifieke geheugenpaden over te slaan (bijv. om een rommelig bovenliggend CLAUDE.md te negeren).

Rechten (Permissions)

Hoe Claude Code controleert welke acties Claude automatisch mag uitvoeren en voor welke acties jouw expliciete goedkeuring nodig is.

Claude Code voert tools uit op jouw lokale computer, het draait shell-commando's, bewerkt bestanden en haalt URL's op. Het rechtensysteem geeft je nauwkeurige controle over welke acties Claude automatisch mag doen en waarvoor jij toestemming moet geven.

Wat wordt er door rechten gecontroleerd?

Rechten zijn van toepassing op drie categorieën operaties:

  • Bestandsbewerkingen: Bestanden lezen, bewerken en schrijven op je lokale filesystem via de Read, Edit en Writetools.
  • Bash commando's: Elk shell-commando dat via de Bash tool wordt uitgevoerd, inclusief installaties, builds, git operations en scripts.
  • MCP tool calls:Tools die worden aangeboden door gekoppelde MCP servers, waaronder database-queries, API-aanroepen of browserautomatisering.

Permission modes

De permission mode bepaalt het standaardgedrag wanneer er geen specifieke "toestaan/weigeren"-regel is voor een bepaalde tool call. Stel de modus één keer in en deze geldt voor de hele session.

ModeGedrag
defaultVraagt om bevestiging bij potentieel gevaarlijke acties.
acceptEditsKeurt bestandsbewerkingen automatisch goed.
planAlleen-lezen modus om plannen te maken.
bypassPermissionsSlaat alle controles over.
dontAskOnderdrukt alle vragen.
autoTranscript-classifier modus (functie beperkt beschikbaar).

Permission mode instellen

Dit kan via de CLI flag, het /permissions commando of via settings.json.

  • Voorbeeld CLI flag:claude --permission-mode acceptEdits

Permission rules (allow/deny lijsten)

Naast de globale modus kun je specifieke regels maken die bepaalde tool calls altijd toestaan of altijd weigeren, ongeacht de actieve modus. Regels hebben drie onderdelen: toolName, ruleContent (optioneel patroon) en behavior (allow, deny, of ask).

Waar worden regels opgeslagen?

  • userSettings (~/.claude/settings.json): Geldt voor al jouw projecten.
  • projectSettings (.claude/settings.json): Geldt voor iedereen die aan dit project werkt.
  • localSettings (.claude/settings.local.json): Alleen voor jou en dit specifieke project.

Voorbeeld: Altijd specifieke git-commando's toestaan

{
"permissions": {
"allow": [
     "Bash(git status)",
     "Bash(git diff *)",
     "Bash(git log *)",
     "Read(*)"
],
"deny": [
     "Bash(rm -rf *)",
     "Bash(sudo *)"
]
}
}

Wat bekent dit precies?

  • Wildcard (): Dit teken fungeert als een joker. Bash(git ) betekent "alle commando's die beginnen met git ". Het sterretje vervangt alles wat daarna komt.
  • Compound commands: Als Claude commando's combineert (bijv. A && B), controleert het systeem beide delen apart. Als één van de twee verboden is, wordt het hele commando geblokkeerd. Dat is een veiligheidsmaatregel zodat een "boosaardig" commando niet in een reeks verstopt kan worden.

Veiligheidscontroles

Ongeacht de gekozen instellingen, worden bepaalde acties altijd geblokkeerd of extra gecontroleerd:

  • Commando's die zich richten op de.claude/ of.git/ configuratiemappen.
  • Aanpassingen aan shell-configuratiebestanden (zoals.bashrc, .zshrc).
  • Pogingen om padbeperkingen te omzeilen met trucs.

Rechten voor MCP tools

MCPtools volgen hetzelfde systeem als ingebouwde tools. Je kunt een hele MCP server of specifieke onderdelen binnen die server toestaan of weigeren. Gebruik je mcp__servername als regel, dan worden alle tools van die server direct uit de lijst gefilterd voordat Claude ze zelfs maar kan zien.

Veiligheidsadviezen

  1. Gebruik bypassPermissions alleen in veilige omgevingen: Denk aan geïsoleerde Docker containers of CI-omgevingen.
  2. Start met de default modus: Dit is voor interactief gebruik de veiligste keuze.
  3. Gebruik plan modus: Ideaal als je een codeerproject verkent dat je nog niet goed kent.
  4. Wees specifiek: Geef liever specifieke regels toestemming (allow), dan de hele beveiliging uit te schakelen (bypassPermissions).
  5. Review projectinstellingen: Als je een onbekende repository kloont, check dan of er een.claude/settings.json bestand in zit; daar kunnen instellingen in staan die Claude automatisch meer rechten geven.

Tools

Naslagwerk voor elke ingebouwde tool die Claude Code kan gebruiken, inclusief bestandsbewerkingen, shell-uitvoering, webtoegang en het aanmaken van sub-agents.

Claude Code geeft Claude een set ingebouwde tools die hij kan gebruiken om te interageren met jouw machine. Elke tool call is onderworpen aan de actieve permission mode en regels.

Bestandstools

  • Read: Leest een bestand.
  • Leest standaard maximaal 2.000 regels. Ondersteunt ook afbeeldingen, PDF's en Jupyter notebooks (.ipynb).
  • Alleen-lezen. Altijd automatisch goedgekeurd.
  • Edit: Voert exacte tekstvervangingen uit.
  • Vereist een eerdere Read-actie in hetzelfde gesprek. Vervangt old_string met new_string. Deze precisie voorkomt onbedoelde wijzigingen.
  • Write: Maakt een nieuw bestand aan of overschrijft een bestaand bestand volledig.
  • Voor bestaande bestanden is eerst een Read nodig. Gebruik liever Edit voor wijzigingen, Write is beter voor nieuwe bestanden.
  • Glob: Zoekt bestanden op naampatroon (bijv. **/*.ts).
  • Snel en efficiënt voor elke omvang codebase. Alleen-lezen en altijd goedgekeurd.

Shell tool

  • Bash: Voert shell-commando's uit in een persistente sessie.
  • De shell blijft actief gedurende het gesprek; environment variables en directory-wijzigingen blijven behouden.
  • Complexe commando's (met &&, |, etc.) worden per onderdeel gecontroleerd op rechten. run_in_background: true kan gebruikt worden voor taken die lang draaien.

Zoektools

  • Grep: Doorzoekt bestandsinhoud met regular expressions (gebaseerd op ripgrep).
  • Ondersteunt verschillende outputmodi (alleen paden, inhoud met context of aantal treffers). Alleen-lezen en altijd goedgekeurd.
  • LS: Biedt een gestructureerd overzicht van de inhoud van een map.

Webtools

  • WebFetch: Haalt een URL op en extraheert informatie.
  • Converteert HTML naar Markdown en laat een model de relevante informatie eruit filteren. Handig voor documentatie of API specs.
  • WebSearch: Doorzoekt het web.
  • Geeft resultaten met titels en Markdown-links. Voegt automatisch een "Bronnen:" sectie toe.

Agent- en taaktools

  • Task (Agent): Start een sub-agent.
  • De sub-agent voert een eigen nested agentic loop uit met een eigen gespreksgeschiedenis en (optioneel) beperkte tools. Ideaal voor complexe taken in meerdere stappen.
  • TodoWrite: Beheert een taaklijst (pending, in_progress, completed) in een paneel in de terminal.
  • Helpt de voortgang bij te houden bij taken met 3 of meer stappen.

MCP tools

Model Context Protocol (MCP) servers kunnen extra tools aan Claude Code toevoegen (zoals databaseverbindingen of cloud-API's). Deze tools zijn herkenbaar aan het mcp__ prefix:

mcp__<server-name>__<tool-name>

Je kunt ze beheren via ~/.claude/mcp_servers.json en de rechten per server instellen via het permissions systeem:

{
"permissions": {
"deny": ["mcp__untrusted-server"]
}
}

Notebook tool

  • NotebookEdit: Bewerk cellen in een Jupyter notebook (.ipynb) met regelprecisie (invoegen, vervangen, verwijderen).

Wat betekent dit precies?

  • Persistent / Persistente sessie: Dit betekent dat de computer de context onthoudt. Als je met Bash naar een map gaat (cd src), onthoudt Claude dat bij de volgende keer dat je de Bash tool gebruikt.
  • Tool call: Een officieel verzoek van Claude aan de software om een actie uit te voeren met een specifieke tool.
  • Grep: Een bekende term in de programmeerwereld voor "zoeken naar tekst in bestanden".

Tip: Benieuwd welke tools voor jou beschikbaar zijn in je huidige sessie? Typ /tools in de Claude Code REPL.

Authenticatie

Configureer hoe Claude Code zich identificeert bij de Anthropic API, AWS Bedrock of GCP Vertex AI. De gebruikte methode hangt af van hoe je de API benadert: direct via Anthropic, via een cloudprovider, of met een script voor API-sleutelbeheer.

1. Claude.ai OAuth (standaard)

Wanneer je voor het eerst claude uitvoert zonder dat er een API key is ingesteld, start Claude Code een OAuth-stroom via je claude.ai-account.

  1. Voer Claude Code uit: Open je terminal en typ claude.
  2. Volg de inlog-prompt: Claude Code toont een URL. Open deze in je browser, log in op je claude.ai-account en verleen toestemming.
  3. Keer terug naar de terminal: Na autorisatie ontvangt Claude Code automatisch het OAuth-token en slaat dit veilig op (bijv. in de macOS Keychain).

Tokens worden automatisch ververst voordat ze verlopen. Je hoeft niet opnieuw te authenticeren tenzij je expliciet uitlogt.

2. API-sleutel

Je kunt in plaats van OAuth ook een Anthropic API key gebruiken.

  • Omgevingsvariabele: Stel de ANTHROPIC_API_KEY in voordat je claude start:
  • export ANTHROPIC_API_KEY=sk-ant-...
  • Wanneer deze variabele is ingesteld (of apiKeyHelper in je instellingen), wordt de OAuth-stroom volledig uitgeschakeld.

3. AWS Bedrock

Om Claude te gebruiken via Amazon Bedrock:

  1. Schakel Bedrock-modus in:export CLAUDE_CODE_USE_BEDROCK=1
  2. Configureer AWS-credentials: Claude Code volgt de standaard AWS-keten (bijv. ~/.aws/credentials, omgevingsvariabelen zoals AWS_ACCESS_KEY_ID, of IAM roles).
  3. Regio/Model (optioneel): Stel je regio in via export AWS_REGION=us-east-1.
  • Geautomatiseerde verversing: Als je AWS-sessie verloopt (bijv. bij tijdelijke SSO-tokens), kun je awsAuthRefresh in je instellingen configureren om een commando uit te voeren dat je credentials automatisch vernieuwt.

4. GCP Vertex AI

Om Claude te gebruiken via Google Cloud Vertex AI:

  1. Schakel Vertex-modus in:export CLAUDE_CODE_USE_VERTEX=1
  2. Configureer GCP-credentials: Claude gebruikt Google Application Default Credentials (ADC). Dit werkt via gcloud auth application-default login, een service account key bestand, of Workload Identity.
  3. Project en regio: Stel je project in via export ANTHROPIC_VERTEX_PROJECT_ID=my-gcp-project en export CLOUD_ML_REGION=us-central1.

Accountbeheer

  • Van account wisselen: Gebruik /login in de Claude Code REPL om een nieuwe OAuth-stroom te starten. Dit overschrijft de opgeslagen tokens.
  • Uitloggen: Gebruik /logout. De opgeslagen gegevens worden verwijderd en de volgende keer dat je Claude opstart, word je opnieuw gevraagd om in te loggen.

Tokenverloop en verversing

  • Claude Code controleert voor elk API-verzoek of je access token nog geldig is.
  • Is het verlopen? Dan ververst de software dit automatisch met het refresh token zonder dat jij iets hoeft te doen.
  • Dankzij een lock file kunnen meerdere instanties van Claude Code tegelijk draaien zonder dat ze elkaars verversing in de war schoppen.

Prioriteitsvolgorde voor authenticatie

Wanneer er meerdere methoden zijn geconfigureerd, doorloopt Claude Code deze lijst:

  1. ANTHROPIC_AUTH_TOKEN (omgevingsvariabele)
  2. CLAUDE_CODE_OAUTH_TOKEN (omgevingsvariabele)
  3. OAuth-token uit een bestand (voor beheerde omgevingen)
  4. apiKeyHelper (uit de instellingen)
  5. Opgeslagen claude.aiOAuth-tokens (kieslijst of bestand)
  6. ANTHROPIC_API_KEY (omgevingsvariabele)

Tip voor CI/CD en automatisering: Gebruik ANTHROPIC_API_KEY of CLAUDE_CODE_OAUTH_TOKEN. Deze worden als eerste gecontroleerd, wat essentieel is voor omgevingen waar je geen browser kunt openen voor inloggen.

Wat betekent dit precies?

  • OAuth: Een veilige standaard om in te loggen zonder dat je je wachtwoord direct aan het programma hoeft te geven.
  • ADC (Application Default Credentials): Een manier voor Google Cloud-programma's om automatisch te "weten" wie je bent door te kijken naar de instellingen van je gcloud-tool of omgevingsvariabelen.
  • Lock file: Een klein bestandje dat dient als "bezet"-bordje voor programma's. Hiermee voorkomt Claude Code dat twee kopieën van het programma tegelijkertijd proberen een token te vernieuwen (wat voor fouten zou zorgen).

MCP servers

Breid Claude Code uit met Model Context Protocol (MCP) servers om verbinding te maken met databases, API's en aangepaste tools.

Het Model Context Protocol (MCP) is een open standaard waarmee Claude Code verbinding kan maken met externe databronnen en diensten. Wanneer je een MCP server toevoegt, krijgt Claude toegang tot nieuwe tools, bijvoorbeeld het doorzoeken van een database, het lezen van Jira-tickets of het interageren met een Slack-werkruimte.

  • Uitbreidbaarheid: Verbind Claude met elke dienst die een MCP server aanbiedt.
  • Project- of gebruikersniveau: Sla serverconfiguraties op per project of globaal.
  • Beheer tijdens runtime: Schakel servers in of uit met /mcp zonder configuratiebestanden aan te passen.
  • Rechtencontrole: Claude Code vraagt altijd om bevestiging voordat een MCP tool wordt aangeroepen.

Een server toevoegen

De meest gebruikte manier is via het claude mcp add commando of door direct een configuratiebestand te bewerken.

Via de CLI

Typ /mcp om het beheerpaneel te openen. Voor toevoegen vanaf de commandoregel:

claude mcp add <naam> -- <commando> [argumenten...]

Voorbeelden:

  • Project-scope (gedeeld met team):

claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp

  • Gebruikers-scope (beschikbaar in alle projecten):

claude mcp add --scope user my-db -- npx -y @my-org/mcp-server-postgres

Configuratie (Config file format)

Configuraties gebruiken JSON met een mcpServers sleutel. De meeste servers draaien als een lokaal subproces (stdio):

{
"mcpServers": {
"filesystem": {
     "command": "npx",
     "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"],
     "env": {
       "NODE_ENV": "production"
     }
}
}
}
  • command: Het uitvoerbare bestand (bijv. npx, python).
  • args: Lijst met argumenten.
  • env: Omgevingsvariabelen. Ondersteunt $VAR syntax die automatisch wordt uitgebreid vanuit je shell.

Configuratie-niveaus (Scopes)

ScopeLocatieGebruik
project.mcp.json in huidige mapGedeelde teamconfiguratie
user~/.claude.jsonPersoonlijke servers (overal beschikbaar)
local.claude/settings.local.jsonPrivé-override (wordt niet gecommit)

Als een server op meerdere plekken gedefinieerd is, heeft local voorrang op project, en project voorrang op user.

Servers beheren

  • Inschakelen/Uitschakelen:/mcp enable <naam> of disable.
  • Opnieuw verbinden:/mcp reconnect <naam> (handig als een verbinding is weggevallen).
  • Status bekijken: Typ /mcp voor een overzicht van de status (connected, pending, failed, needs-auth, disabled).

Goedkeuren van MCP tool calls

Claude Code toont een bevestigingsvenster voordat een MCP tool wordt aangeroepen. Je ziet de naam van de tool en de invoerargumenten.

  • Allow once: Sta deze specifieke actie toe.
  • Allow always: Sta alle toekomstige aanroepen naar deze tool in deze sessie toe.
  • Deny: Blokkeer de actie; Claude krijgt een foutmelding en moet een andere aanpak proberen.

Voorbeeld: Database server

{
"mcpServers": {
"postgres": {
     "command": "npx",
     "args": ["-y", "@modelcontextprotocol/server-postgres"],
     "env": {
       "POSTGRES_CONNECTION_STRING": "$DATABASE_URL"
     }
}
}
}

Stel DATABASE_URL in als omgevingsvariabele in je terminal voordat je claude start, en de server zal deze automatisch oppikken.

Wat betekent dit precies?

  • Stdio: Communicatie via de standaard invoer- en uitvoerkanalen van een proces. Dit is de meest gebruikelijke manier voor lokale MCP-servers.
  • Scope: Het bereik van de instelling. Een user-scope betekent "overal op mijn computer", een project-scope betekent "alleen in dit project".
  • Registry: Op modelcontextprotocol.io is een officiële lijst te vinden met community-gemaakte servers voor tools zoals Slack, GitHub, Postgres, etc.

Tip: Kijk in de documentatie of bekijk de officiële MCP registry voor kant-en-klare servers die je direct aan je project kunt toevoegen!

Hooks

Voer automatisch shell-commando's, HTTP-verzoeken of prompts uit wanneer Claude tools gebruikt of wanneer er mijlpalen worden bereikt in een sessie.

Hooks maken het mogelijk om automatisering te koppelen aan de levenscyclus van Claude Code. Wanneer Claude een bestand leest, een bash-commando uitvoert of een antwoord afrondt, wordt je geconfigureerde hook automatisch geactiveerd. Gebruik hooks om bijvoorbeeld codeerstijlen af te dwingen, tests te draaien, tool-gebruik te loggen of acties van Claude te blokkeren.

Hoe hooks werken

Een hook is een commando (shell-script, HTTP-verzoek of LLM-prompt) gekoppeld aan een specifieke gebeurtenis. Wanneer die gebeurtenis plaatsvindt, voert Claude Code alle relevante hooks uit en gebruikt de exit code en output om te bepalen wat de volgende stap is.

Exit code betekenis:

  • 0 (Succes): Claude Code gaat door.
  • 2 (Blokkeren/Injecteren): Claude Code verwerpt de actie en toont de stderr aan Claude.
  • Anders: Foutmelding wordt alleen aan de gebruiker getoond; het proces gaat gewoon door.

Belangrijke Hook-gebeurtenissen

  • PreToolUse / PostToolUse: Vóór of na het uitvoeren van een tool.
  • Stop: Vóórdat Claude zijn antwoord beëindigt.
  • SessionStart / SessionEnd: Bij het starten of afsluiten van een sessie.
  • CwdChanged: Wanneer de werkmap verandert (handig voor het laden van.env-bestanden).
  • PermissionRequest: Wanneer Claude een toestemmingsvenster zou tonen. Je kunt hier programmatisch goedkeuren of afwijzen.
  • FileChanged: Wanneer een specifiek bestand (zoals.envrc) op de schijf verandert.

Hooks configureren

Typ /hooks in Claude Code om het beheerpaneel te openen. Hooks worden opgeslagen in de hooks-sectie van je instellingenbestanden:

  • ~/.claude/settings.json (Globaal)
  • .claude/settings.json (Per project)
  • .claude/settings.local.json (Lokaal/privé)

Configuratievoorbeeld

{
"hooks": {
"PostToolUse": [
     {
       "matcher": "Write",
       "hooks": [
         { "type": "command", "command": "prettier --write \\"$CLAUDE_FILE_PATH\\" 2>/dev/null || true" }
       ]
     }
]
}
}

Hook commando opties

  • type: "command" (shell), "http", "llm" of "agent".
  • timeout: Maximaal aantal seconden (bijv. 60).
  • async: true om in de achtergrond te draaien zonder Claude te blokkeren.
  • if: Een voorwaardelijke regel (bijv. "Bash(git *)") om de hook alleen uit te voeren als aan die voorwaarde is voldaan.

Voorbeelden

  • Auto-format: Draai Prettier na elke Write-actie (zie voorbeeld hierboven).
  • Testen na Bash: Draai npm test alleen als een bash-commando .ts-bestanden heeft gewijzigd.
  • Blokkeren van gevaarlijke commando's: Gebruik PreToolUse met een grep '-q rm -rf' en exit 2 om te voorkomen dat Claude bestanden verwijdert.
  • Environment injecteren: Gebruik CwdChanged om automatisch .env-variabelen in CLAUDE_ENV_FILE te schrijven wanneer je van map wisselt.

Wat betekent dit precies?

  • Matcher: Een patroon dat bepaalt wanneer de hook afgaat. Bijvoorbeeld: als je matcher instelt op "Write", gebeurt er alleen iets als Claude Write aanroept.
  • CLAUDE_FILE_PATH / CLAUDE_TOOL_INPUT: Dit zijn speciale variabelen die Claude Code tijdelijk beschikbaar stelt aan je hook-script, zodat je script precies weet om welk bestand of welk commando het gaat.
  • Hooks vs. Skills:
  • Hooks gaan automatisch (altijd bij een gebeurtenis).
  • Skills (vaardigheden) gebruik je wanneer je zelf een specifieke workflow wilt aanroepen via een commando (zoals /mijn-vaardigheid).

Tip: Voor langlopende taken zoals integratietests, gebruik altijd "async": true in combinatie met een ruime timeout, zodat Claude Code niet "bevriest" terwijl hij op de tests wacht.

Skills

Maak herbruikbare vaardigheden op aanvraag die Claude oproept met een slash-commando (/).

Skills zijn Markdown-bestanden die herbruikbare prompts en workflows definiëren. Wanneer je /skill-naam typt in Claude Code, laadt Claude de instructies van die vaardigheid en voert de beschreven actie uit. Dit is ideaal voor workflows die je vaak herhaalt, zoals een deployment uitvoeren, een changelog schrijven, een PR reviewen of projectspecifieke codeerconventies toepassen.

Hoe skills werken

Een skill is een map binnen.claude/skills/ met een SKILL.md-bestand. Deze worden "lui" geladen: ze worden pas gelezen op het moment dat je ze aanroept, wat de opstarttijd en contextgrootte niet beïnvloedt.

Waar sla je ze op?

  • .claude/skills/ (project-niveau, voor het hele team).
  • ~/.claude/skills/ (gebruikers-niveau, beschikbaar in alle projecten).

Een skill maken

Maak een map aan en schrijf een SKILL.md-bestand:

\-\-\-

description: Voer het releaseproces uit

argument-hint: versienummer (bijv. 1.2.3)

\-\-\-

Release het project op versie $ARGUMENTS.

Stappen:

  1. Update versie in package.json naar $ARGUMENTS.
  1. Update CHANGELOG.md.
  1. Run npm test.
  1. Commit met bericht "chore: release v$ARGUMENTS".
  1. Maak een git tag v$ARGUMENTS.

Aanroepen doe je simpelweg met: /my-skill 1.2.3

Instellingen (Frontmatter)

Bovenaan je SKILL.md kun je het gedrag configureren met frontmatter (tussen \-\-\- regels):

  • description: Korte omschrijving voor de /skills lijst.
  • argument-hint: Hint voor de autocomplete van het commando.
  • allowed-tools: Beperk Claude tot specifieke tools (bijv. Bash, Write).
  • when_to_use: Beschrijving van wanneer Claude deze vaardigheid uit zichzelf moet voorstellen.
  • context: Gebruik fork om de skill in een geïsoleerde sub-agent context te draaien.
  • paths: Glob-patronen; de skill wordt alleen geactiveerd als je aan bestanden in die mappen werkt.

Geavanceerde mogelijkheden

Argumenten vervangen

  • Gebruik $ARGUMENTS voor de tekst die na je /commando komt.
  • Voor meerdere argumenten, definieer ze in de frontmatter:
  • arguments: [naam, map]

Je typt dan /my-skill gebruiker src en gebruikt in het bestand $naam en $map.

Inline shell-commando's (Dynamische input)

Je kunt live data uit je project invoegen in de prompt met ! en backticks:

Hier zijn de laatste commits:

!git log --oneline -20

Review deze wijzigingen.

Dit wordt uitgevoerd op het moment dat je de skill aanroept.

Namespaced skills (Mappenstructuur)

Mappen in.claude/skills/ worden automatisch namespaced:

  • .claude/skills/database/migrate/SKILL.md wordt /database:migrate.

Skills vs. Hooks

KenmerkSkillsHooks
ActiveringExpliciet (/commando)Automatisch (bij gebeurtenis)
DoelWorkflow die je intentioneel startBijwerkingen (formatten, loggen)
ConfiguratieBestanden in SKILL.mdhooks-sectie in settings.json

Wat betekent dit precies?

  • Frontmatter: De YAML-sectie bovenin een Markdown-bestand tussen de \-\-\- streepjes. Het is een standaardmanier om metadata mee te geven aan tekstdocumenten.
  • Glob-patroon: Een manier om bestanden te selecteren met jokers, zoals **/*.py (alle Python-bestanden in alle mappen).
  • Bundled skills: Dit zijn vaardigheden die standaard in Claude Code ingebakken zitten. Je kunt ze inzien met /skills, maar je hoeft ze niet zelf aan te maken.

Tip: Gebruik /skills om alle beschikbare vaardigheden in jouw huidige project en op jouw computer te zien. Het is een geweldige plek om te ontdekken wat anderen in je team al hebben opgezet!

Multi-agent workflows

Claude Code kan sub-agents inzetten: aparte Claude-instanties die onafhankelijk taken uitvoeren. Hierdoor kun je grote taken in parallel uitvoeren in plaats van alles achter elkaar in één gesprek af te werken.

Hoe sub-agents werken

Wanneer Claude de Agent tool gebruikt, start hij een nieuwe instance met:

  • Een eigen context window en system prompt.
  • Eigen rechten voor de tools.
  • De ouder-Claude wacht tot de agent klaar is, óf de agent draait op de achtergrond.

Elke agent is specialistisch en kan indien nodig zelf weer sub-agents aansturen (hoewel dit genest beperkt is).

De Agent tool

Als gebruiker roep je deze tool niet handmatig aan; Claude bepaalt zelf wanneer hij deze gebruikt. De tool ontvangt:

  • description: Een korte samenvatting van de taak.
  • prompt: De volledige instructie voor de agent.
  • isolation: Bijvoorbeeld worktree om de agent in een geïsoleerde kopie van je repository te laten werken.

Wanneer gebruikt Claude sub-agents?

  • Parallelle taken: Bijvoorbeeld: tests schrijven terwijl tegelijkertijd de documentatie wordt geüpdatet.
  • Specialisaties: Bijvoorbeeld: een "code-reviewer" agent inschakelen voor een security-audit.
  • Langdurige taken: Onderzoek doen op de achtergrond terwijl Claude aan iets anders werkt.
  • Geïsoleerde verkenning: Oplossingen testen zonder je huidige bestanden te vervuilen.

Foreground vs. Background agents

  • Foreground (standaard): Claude wacht tot de agent klaar is. Gebruik dit als het resultaat van de agent nodig is voor de volgende stap.
  • Background: De agent draait asynchroon. Claude gaat door met ander werk. Je krijgt een notificatie zodra de agent klaar is.
  • Tip: Start integratietests op de achtergrond terwijl je verder implementeert.

Context en Geheugen

Let op: Sub-agents beginnen met een "schone lei". Ze erven niet automatisch de gespreksgeschiedenis van de ouder-Claude. De ouder is verantwoordelijk voor het meegeven van alle relevante achtergrondinformatie in de prompt.

Persistent geheugen:

Sommige agent-types kunnen over sessies heen onthouden wat ze hebben geleerd via MEMORY.md-bestanden, opgeslagen op gebruikersniveau (~/.claude/agent-memory/) of projectniveau.

Worktree isolation (Veilig testen)

Met isolation: "worktree" krijgt de agent een kopie van de repository. Wijzigingen van de agent beïnvloeden jouw werkmap niet totdat jij ze als ouder-Claude samenvoegt (merge). Dit is essentieel voor risicovolle wijzigingen.

Best Practices voor Agent Prompts

Omdat agents geen context erven, moet je prompt volledig zijn:

  • Wat & Waarom: Wat moet er bereikt worden?
  • Context: Specifieke bestanden, functienamen of data.
  • Output: In welk formaat moet het resultaat ingeleverd worden?
  • Beperkingen: Wat mag de agent absoluut niet doen?

Zwak voorbeeld: "Los op basis van je bevindingen de bug op."

Sterk voorbeeld: "Los de null-reference bug op in UserService.getProfile() in src/services/user.ts op regel 247. Controleer op null, voeg een null-check toe, retourneer { theme: 'light', notifications: true } en draai npm test."

Wat betekent dit precies?

  • Sub-agent: Een tijdelijke "hulp-Claude" die door de hoofd-Claude wordt aangestuurd.
  • Worktree: Een feature van git waarmee je in een aparte map aan een specifieke branch of wijziging kunt werken zonder je huidige map te verstoren.
  • Context window: De "korte-termijngeheugenruimte" die een AI heeft om informatie te verwerken. Een schone context betekent dat de agent blanco begint en alles in de prompt moet lezen.

Veiligheidswaarschuwing: Background-agents worden niet gestopt als je de ouder-taak onderbreekt (met Escape). Gebruik het takenpaneel om achtergrondtaken expliciet te annuleren als dat nodig is.

Instellingen

Configureer het gedrag van Claude Code via JSON-bestanden op verschillende niveaus (gebruiker, project en beheerd). Claude Code past instellingen samen door ze te combineren van laagste naar hoogste prioriteit, waarbij meer specifieke instellingen de algemene overschrijven.

Waar vind je de instellingen?

  1. Globaal (Gebruiker):~/.claude/settings.json (Geldt voor al jouw sessies).
  2. Project:.claude/settings.json (Gedeeld met je team).
  3. Lokaal:.claude/settings.local.json (Jouw persoonlijke overrides, niet gecommit in git).
  4. Beheerd (Managed): Enterprise-beleid ingesteld door je beheerder (hoogste prioriteit).

Tip: Typ /config in Claude Code om de instellingen-interface te openen. Hier kun je de actieve instellingen per scope bekijken en bewerken. Claude Code herlaadt bestanden automatisch zodra ze wijzigen.

Belangrijke instellingen (Referentie)

InstellingTypeBeschrijving
modelstringOverschrijdt het standaard model (bijv. "claude-opus-4-5").
permissionsobjectBepaalt welke tools gebruikt mogen worden en de defaultMode.
hooksobjectAangepaste commando's voor/na tool-gebruik.
cleanupPeriodDaysintHoe lang chat-transcripten bewaard blijven (0 = uitschakelen).
envobjectOmgevingsvariabelen die altijd worden ingevoegd.
languagestringVoorkeurstaal voor antwoorden en spraak.
alwaysThinkingEnabledbooleanSchakelt "extended thinking" in/uit voor geschikte modellen.
effortLevellow/med/highBudget voor denk-modellen.
claudeMdExcludesstring[]Glob-patronen voor mappen/bestanden die CLAUDE.mdniet mogen laden.
respectGitignorebooleanOf de bestandskiezer.gitignore moet negeren.
defaultShellbash/psKeuze tussen bash of powershell.

Specifieke configuraties

  • Permissions: Gebruik allow, deny en ask lijsten om Claude nauwkeurig te begrenzen.
{
"permissions": {
    "defaultMode": "acceptEdits",
    "allow": ["Bash(npm run *)"],
    "deny": ["Bash(curl *)"]
}
  • }
  • Werkbomen (Worktree): Configureer hoe --worktree zich gedraagt, bijvoorbeeld door automatisch mappen als node_modules te koppelen.
  • Attributie: Pas aan welke tekst (zoals Co-Authored-By) wordt toegevoegd aan commits of PR-beschrijvingen.
  • MCP Servers:allowedMcpServers / deniedMcpServers voor enterprise-omgevingen.

Beheerde instellingen (Enterprise)

Beheerders kunnen instellingen opdringen die door gebruikers niet kunnen worden gewijzigd. Dit is cruciaal voor veiligheid:

  • allowManagedHooksOnly: Gebruikers- en project-hooks worden genegeerd.
  • allowManagedPermissionRulesOnly: Alleen beheerde regels gelden; lokale regels worden genegeerd.
  • strictPluginOnlyCustomization: Vergrendelt onderdelen (zoals skills of agents) naar uitsluitend beheerde bronnen.

JSON Schema voor Autocompletion

Voeg de volgende regel toe bovenin je settings.json voor automatische validatie en hulp van je code-editor (zoals VS Code):

{
"$schema": "https://schemas.anthropic.com/claude-code/settings.json"
}

Wat betekent dit precies?

  • Samenvoegen (Merge): Claude Code plakt de JSON-objecten samen. Als jij in je lokale instellingen een model specifiek instelt, wint die het van de globale instelling.
  • Precedence (Prioriteit): De volgorde waarin Claude kijkt. Omdat "Managed" (Beheerd) het laatste in de lijst staat, "wint" hij altijd. Als je IT-afdeling zegt dat je allow lijst leeg is, kun je dat als gebruiker niet met jouw eigen settings.json omdraaien.
  • Scalar vs Array: Voor normale waarden (zoals model) wordt de oude waarde simpelweg vervangen. Voor lijsten (arrays zoals allow-regels) worden de waarden achter elkaar gezet en dubbelen verwijderd.

CLAUDE.md

CLAUDE.md-bestanden stellen je in staat om projectkennis vast te leggen die Claude automatisch laadt bij de start van elke sessie. In plaats van telkens je architectuur of conventies uit te leggen, schrijf je ze één keer op en leest Claude ze automatisch.

Wat hoort er in CLAUDE.md?

Schrijf instructies die tot fouten leiden als ze ontbreken. Al het andere is ruis.

  • Inclusief: Build-, test- en lint-commando's, architectuurbeslissingen, projectspecifieke codeerconventies, vereiste omgevingsvariabelen en veelvoorkomende valkuilen.
  • Exclusief: Informatie die Claude al weet (standaard syntax), "schone code"-clichés, gevoelige data (API-sleutels, wachtwoorden) en informatie die te vaak verandert.

De test: Als je deze regel zou verwijderen, zou Claude dan een fout maken in je codebase? Zo nee, verwijder het dan.

Hoe werkt de volgorde?

Claude laadt bestanden van algemeen naar specifiek. Bestanden die later worden geladen, hebben een hogere prioriteit.

  1. Beheerd (Managed):/etc/claude-code/ (Global, ingesteld door admins).
  2. Gebruiker:~/.claude/CLAUDE.md en ~/.claude/rules/*.md (Persoonlijk).
  3. Project:CLAUDE.md, .claude/CLAUDE.md en.claude/rules/*.md.
  4. Lokaal:CLAUDE.local.md in je projectmap (Privé, wordt niet gecommit).

Handige functies

De @include directive

Je kunt andere bestanden laden binnen je CLAUDE.md:

@./docs/architectuur.md

@~/shared/stijlgids.md

  • Niet-bestaande bestanden worden genegeerd.
  • Er is een limiet van 5 diepe nestings.
  • Externe bestanden (buiten je project) vereisen eenmalig expliciete goedkeuring.

Frontmatter (Contextuele regels)

In.claude/rules/ kun je regels beperken tot specifieke bestandspaden met frontmatter:

\-\-\-

paths:

\- "src/api/**"

\- "*.graphql"

\-\-\-

API conventies

  • Regels met paths worden alleen geladen als Claude aan het werk is in bestanden die aan die glob-patronen voldoen.

Beheer en Generatie

  • /init: Genereert automatisch een startversie van CLAUDE.md door je codebase te analyseren. Voer dit uit in je sessie: /init.
  • /memory: Opent een editor waarin je alle momenteel geladen CLAUDE.md-bestanden direct kunt inzien en aanpassen. Wijzigingen hebben direct effect.
  • /exclude: Gebruik de instelling claudeMdExcludes in je settings.json als je bepaalde CLAUDE.md-bestanden (bijv. in vendor-mappen of gegenereerde code) wilt uitsluiten.

Voorbeeld structuur ‘CLAUDE.md’

Project: Payments API

Build en test

  • Build: bun run build
  • Tests: bun test (Geen Jest gebruiken!)

Architectuur

  • src/handlers/: Eén bestand per routegroep.
  • src/services/: Business logica, geen directe DB toegang.

Conventies

  • Alle monetaire waarden zijn gehele getallen (centen).
  • Gebruik getCurrentTimestamp() uit src/utils/time.ts (Geen new Date()).

Wat betekent dit precies?

  • Glob: Een patroon om bestanden aan te duiden (bijv. **/*.ts is "alle TypeScript-bestanden in alle mappen").
  • Frontmatter: De YAML-sectie tussen de \-\-\- bovenin een Markdown-bestand. Hiermee geef je metadata (zoals bestandspaden) mee aan Claude.
  • Stale (verouderde info): Informatie die zo snel verandert (bijv. een document dat gisteren is bijgewerkt maar morgen weer anders is) dat Claude er beter niet op kan vertrouwen.

Tip: De beste CLAUDE.md is kort en krachtig. Het is geen documentatie voor mensen, maar een "geheugensteuntje" voor de AI. Overlaad het niet met informatie die Claude al uit de code zelf kan halen.

Omgevingsvariabelen

Claude Code leest omgevingsvariabelen bij het opstarten. Hiermee kun je authenticatie, API-toegang, gedrag en runtime-opties configureren zonder configuratiebestanden aan te passen.

Authenticatie

  • ANTHROPIC_API_KEY: Je API-sleutel voor directe toegang. Heeft prioriteit boven OAuth.
  • ANTHROPIC_AUTH_TOKEN / CLAUDE_CODE_OAUTH_TOKEN: Gebruik tokens voor niet-interactieve (geautomatiseerde) omgevingen.
  • CLAUDE_CODE_USE_BEDROCK / CLAUDE_CODE_USE_FOUNDRY: Stel in op 1 of true om via AWS Bedrock of Anthropic Foundry te werken.
  • ANTHROPIC_VERTEX_PROJECT_ID: Vereist als je Claude Code via Google Cloud Vertex AI gebruikt.

Configuratiepaden

  • CLAUDE_CONFIG_DIR: Map waar Claude Code instellingen en chat-transcripten opslaat (standaard ~/.claude).
  • CLAUDE_CODE_MANAGED_SETTINGS_PATH: Overschrijf de locatie voor beheerde instellingen (handig in enterprise-omgevingen).

Modelinstellingen

  • ANTHROPIC_MODEL: Het standaard te gebruiken model.
  • CLAUDE_CODE_SUBAGENT_MODEL: Het model dat sub-agents gebruiken (standaard hetzelfde als de hoofdsessie).
  • CLAUDE_CODE_AUTO_MODE_MODEL: Model specifiek voor "auto-mode".

Gedragsmodi (Behavior toggles)

  • CLAUDE_CODE_REMOTE: Zet op 1 voor "container-modus" (bijv. in Docker). Past timeouts aan en schakelt interactieve prompts uit.
  • CLAUDE_CODE_SIMPLE: De "bare" modus. Schakelt hooks, plugins, CLAUDE.md en credentials-lezen uit. Ideaal voor lichte scripts.
  • DISABLE_AUTO_COMPACT: Schakelt het automatisch inkorten van de contextgeschiedenis uit.
  • CLAUDE_CODE_DISABLE_CLAUDE_MDS: Schakelt het inlezen van alle CLAUDE.md bestanden volledig uit.
  • CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR: Reset na elk Bash-commando de werkmap terug naar de root.

Resource-limieten

  • CLAUDE_CODE_MAX_OUTPUT_TOKENS: Maximaal aantal tokens per API-antwoord.
  • BASH_MAX_OUTPUT_LENGTH: Maximale karakters die worden opgeslagen van de output van een Bash-commando (voorkomt dat gigantische logs de context "vervuilen").
  • API_TIMEOUT_MS: Timeout voor API-verzoeken in milliseconden.

Telemetrie en observability

  • CLAUDE_CODE_ENABLE_TELEMETRY: Schakelt OpenTelemetry (traces, metrics) in.
  • CLAUDE_CODE_JSONL_TRANSCRIPT: Pad naar een bestand waar Claude de sessie in JSONL-formaat wegschrijft (handig voor logging/audit).

Cloud-specifiek

  • Regio-overrides voor Vertex AI: Je kunt voor elk modeltype een specifieke regio instellen (bijv. VERTEX_REGION_CLAUDE_3_5_SONNET="us-central1").
  • AWS Credentials: Gebruikt standaard AWS-variabelen zoals AWS_REGION of AWS_DEFAULT_REGION voor Bedrock-toegang.

Instellingen voor alle sessies (Persistente configuratie)

In plaats van je shell-profiel (.bashrc of.zshrc) te vervuilen, kun je omgevingsvariabelen ook in je settings.json instellen:

{
"env": {
"DISABLE_AUTO_COMPACT": "1",
"BASH_MAX_OUTPUT_LENGTH": "30000"
}
}

Wat betekent dit precies?

  • Bare mode: Een "kale" uitvoering van Claude Code. Handig voor CI/CD-pipelines waar je geen interactie nodig hebt en maximale snelheid/consistentie wilt.
  • Context compaction: Claude Code verkleint de gespreksgeschiedenis wanneer deze te groot wordt om binnen de limieten van het model te blijven. DISABLE_AUTO_COMPACT zet dit uit.
  • Environment variables: Variabelen die buiten de code om aan een programma worden meegegeven om het gedrag te beïnvloeden zonder de broncode te wijzigen.

Tip: Zie je dat Claude Code op een vreemde manier reageert in een container? Controleer dan of CLAUDE_CODE_REMOTE=1 helpt; dit is vaak de oplossing voor onverwachte timeouts of interactieproblemen in CI of virtuele omgevingen.

← Alles uit de vaultVul de intake in →