De .claude/ folder uitgelegd: zo maak je Claude Code slim

Je hebt Claude Code geïnstalleerd. Je gebruikt het voor taken, code reviews, of content. Maar elke keer dat je een nieuw gesprek start, begint Claude weer van nul. Geen context. Geen geheugen. Geen idee wat je project is.

Dat verandert zodra je de .claude/ folder begrijpt.

De .claude/ folder is het brein van je Claude Code project. Het is waar je Claude vertelt wie je bent, hoe je werkt, en wat hij moet doen — automatisch, bij elk gesprek.

CLAUDE.md: je team instructies

Dit is het startpunt. CLAUDE.md is een Markdown-bestand in de root van je project dat Claude automatisch leest bij elk gesprek. Zie het als een onboarding document voor je AI-collega.

Wat je erin zet:

• Wie je bent en wat je project doet
• Welke conventies je team volgt
• Welke tools en API's beschikbaar zijn
• Wat Claude wel en niet mag doen

Tip: commit CLAUDE.md naar git. Zo deelt je hele team dezelfde context.

settings.json: permissions en configuratie

In .claude/settings.json stel je in welke tools Claude mag gebruiken, welke MCP servers beschikbaar zijn, en welke acties automatisch toegestaan worden.

Er is ook een settings.local.json voor persoonlijke overrides — die wordt niet gecommit naar git.

commands/: je eigen slash commands

Dit is waar het krachtig wordt. Elk Markdown-bestand in .claude/commands/ wordt een slash command dat je kunt aanroepen.

Voorbeelden:

• review.md → /project:review — je eigen code review workflow
• deploy.md → /project:deploy — deployment checklist
• blog-write.md → /project:blog-write — blog publicatie workflow

Een command is gewoon een prompt in Markdown. Maar omdat het als bestand bestaat, is het herbruikbaar, deelbaar, en versiebaar.

rules/: modulaire instructie-bestanden

Soms wil je instructies opdelen in logische blokken. De rules/ folder laat je dat doen.

• code-style.md — hoe je team code schrijft
• testing.md — testconventies en frameworks
• api-conventions.md — API design richtlijnen

Claude leest deze automatisch mee. Zo houd je je CLAUDE.md compact en je instructies georganiseerd.

skills/: auto-invoked workflows

Skills zijn de meest geavanceerde feature. Een skill is een SKILL.md-bestand in een subfolder van .claude/skills/. Claude herkent automatisch wanneer een skill relevant is en activeert hem.

Voorbeelden van skills:

• Een meta-ads skill die triggert wanneer je over Facebook ads praat
• Een blog-write skill die je content workflow automatiseert
• Een security-review skill die triggert bij code changes

Skills zijn als specialisten in je team: ze worden alleen ingeschakeld wanneer hun expertise nodig is.

Waarom dit ertoe doet voor marketeers

De meeste marketeers gebruiken Claude als een chatbox. Vraag → antwoord → vergeten.

Met een goed ingerichte .claude/ folder wordt Claude een systeem:

• Je marketingstrategie staat in CLAUDE.md — altijd beschikbaar
• Je blog workflow zit in commands/ — één slash command en je publiceert
• Je brand guide zit in rules/ — elke output is on-brand
• Je skills triggeren automatisch — ads analyse, content creatie, Instagram posts

Het verschil tussen een AI-tool en een AI-systeem? De .claude/ folder.

Aan de slag

Begin simpel:

• Maak een CLAUDE.md in je project root
• Beschrijf wie je bent en wat je project doet
• Voeg één command toe voor je meest herhaalde taak
• Bouw van daar uit verder

Alles wat Claude moet weten over je project leeft in deze folder.

Wil je dit leren opzetten?

Bij North Star AI Academy leren we marketeers hoe je Claude Code inricht als een volwaardig marketing operating system. Van CLAUDE.md tot skills, van commands tot agents.

Bekijk onze trainingen op northstar-academy.ai/trainingen