Hoe deel je CLAUDE.md en context met je hele ontwikkelteam?

Kort antwoord

Zet de project-CLAUDE.md, de map .claude/rules/, .claude/settings.json en je skills in git; wie de repo kloont, krijgt ze mee. Regels voor het hele bedrijf rolt IT uit als beheerde CLAUDE.md of managed settings. Auto memory en CLAUDE.local.md blijven op de computer van elke ontwikkelaar en worden niet gedeeld.

Wat met de repo meegaat en wat niet

Claude Code haalt zijn context uit bestanden. Waar een bestand staat, bepaalt voor wie het geldt. Gedeeld is het pas als het gecommit en opgehaald is, en lokale instellingen kunnen nog iets overschrijven. Zo ligt het volgens de documentatie:

Gedeeld via git Gedeeld door IT, voor de hele organisatie Niet gedeeld
./CLAUDE.md of ./.claude/CLAUDE.md Beheerde CLAUDE.md op het systeempad Auto memory in ~/.claude/projects/<project>/memory/
.claude/rules/*.md claudeMd in managed-settings.json ./CLAUDE.local.md (zet hem zelf in .gitignore)
.claude/settings.json met hooks en ingeschakelde plugins Managed settings: toegestane marketplaces, verplichte plugins ~/.claude/CLAUDE.md en ~/.claude/rules/
Skills in de repo .claude/settings.local.json

Een opzet die werkt

  1. Eén korte project-CLAUDE.md. Build- en testcommando’s, de opbouw in een paar regels, afspraken die je niet uit de code haalt. Onder de 200 regels: hij laadt in elke sessie van elke ontwikkelaar en kost elke keer tokens.
  2. Onderwerpbestanden in .claude/rules/. Eén bestand per onderwerp: API-stijl, databasemigraties, frontend. Met paths laadt een regel alleen als Claude die bestanden aanraakt.
  3. Importeren in plaats van kopiëren. Heb je al een README of AGENTS.md, haal die binnen met @README.md of @AGENTS.md.
  4. Hooks voor wat niet mag misgaan. In .claude/settings.json, en die commit je. Een actieve PreToolUse-hook die met code 2 stopt, blokkeert de aanroep, wat CLAUDE.md ook zegt. Een ontwikkelaar kan projecthooks wel uitzetten; voor beleid dat niemand mag omzeilen zet IT de hook in managed settings. Zie wat hooks zijn.
  5. Een beheerde CLAUDE.md voor bedrijfsregels. Beveiliging, omgang met data, de standaardstack. IT zet hem op het beheerde pad via MDM, Group Policy of Ansible, of zet claudeMd in managed settings. Ontwikkelaars kunnen hem niet uitsluiten.
  6. Persoonlijke voorkeuren blijven persoonlijk. Eigen gewoontes gaan in CLAUDE.local.md of ~/.claude/CLAUDE.md, niet in het gedeelde bestand.
  7. Behandel CLAUDE.md als code. Wijzigingen via een pull request, zodat het team ziet wat de agent te horen krijgt.

Het misverstand: “Claude heeft het geleerd, dus het team heeft het”

Corrigeer je Claude Code en zegt het dat het dit zal onthouden, dan belandt die notitie meestal in auto memory. Dat is lokaal op jouw machine, niet gedeeld tussen computers of cloudomgevingen. De agent van je collega heeft het niet geleerd, en je eigen sessie op claude.ai/code ook niet. De les komt pas bij het team als iemand hem in de project-CLAUDE.md of een rules-bestand zet, met de hand of via een vaste, nagekeken werkwijze.

Dat gebeurt niet vanzelf. Het gedeelde bestand bevat wat iemand ging zitten opschrijven; de dagelijkse correcties, het “zo doen we het hier niet”, stapelen zich op in een tiental losse MEMORY.md-bestanden.

Wat dit betekent voor een team

De teamcontext in Claude Code is een tekstbestand in git plus wat de agent van elke ontwikkelaar apart oppikte. Voor vaste afspraken werkt dat. Repo-instructies halen kennis van buiten de repo niet vanzelf op (dat kan alleen als iemand er bijvoorbeeld een MCP-server voor aansluit): het besluit uit de mailwisseling van vorige week, de eis van een klant in een document, wat in de standup is afgesproken. En het stopt bij Claude Code. Wie voor dezelfde repo Cursor of Copilot opent, krijgt dezelfde regels alleen als die tool dezelfde bestanden leest, en niets van het auto memory. Meer hierover: hoe het geheugen van Claude Code werkt en bedrijfscontext vastleggen voor AI.

Waar Bombos past

Bombos is een plugin die Claude Code en elke andere AI-tool van het team één gedeeld geheugen geeft: teamkennis, de regels die het team geleerd heeft, en wat er al ligt in mail, documenten en repo’s, met zichtbaar waarop elk antwoord rust. Een correctie van één ontwikkelaar komt beschikbaar voor de agents van de anderen. Het draait in de cloud of op je eigen server, en één ontwikkelaar kan het eerst zelf proberen voordat hij het team meeneemt.

Vragen die hierbij horen

Kan ik het auto memory van Claude Code met mijn team delen?

Niet uit zichzelf. Auto memory is lokaal op de machine en wordt niet gedeeld tussen computers of cloudomgevingen. Is een notitie voor iedereen belangrijk, zet hem dan in de project-CLAUDE.md of een rules-bestand.

Hoe deel ik regels over meerdere repo's?

Met symlinks in .claude/rules/ naar een gedeelde map, of met een beheerde CLAUDE.md die IT op elke computer zet voor regels die overal gelden.

Kan een ontwikkelaar de CLAUDE.md van het bedrijf uitzetten?

Nee. Met claudeMdExcludes sla je andere CLAUDE.md-bestanden over, maar niet de beheerde.

Installeert een plugin in de projectinstellingen zich vanzelf bij iedereen?

Nee. Elke collega installeert hem nog zelf met claude plugin install naam@marketplace --scope project. Beheerders kunnen plugins verplicht installeren via managed settings.

Bronnen

  1. Claude Code docs: How Claude remembers your project
  2. Claude Code docs: Hooks reference
  3. Claude Code docs: Discover and install plugins
  4. Claude Code docs: Manage costs effectively
Het eerste half uur · kosteloos

Wat vergeet jullie AI?

  1. 01Je vertelt welke AI jullie gebruiken en waar het steeds opnieuw moet.
  2. 02We laten zien wat een gedeeld geheugen daar verandert, op jullie eigen voorbeelden.
  3. 03Je krijgt het plan mee. Dat houd je, ook zonder Bombos.
Piet Baudoin
Piet BaudoinJe spreekt Piet, van het team van BombosNederlands team uit Utrecht en Nijmegen · data in Europa
We reageren dezelfde werkdag.