Claude Code ondersteunt nu AGENTS.md

In het kort

• Wat: Vanaf versie 2.1.277 leest Claude Code een AGENTS.md-bestand in een projectmap zodra daar geen CLAUDE.md staat. AGENTS.md is een open instructieformaat dat al door meer dan 30 andere AI-codeertools wordt gebruikt.
• Waarom relevant: Instructies die je voor het ene tool schrijft, werken nu ook in het andere. Minder dubbel werk, minder gedoe bij het overstappen of combineren van tools.
• Wat je ermee kunt: In één tekstbestand vastleggen hoe jouw software gebouwd, getest en opgeleverd moet worden — en dat bestand hergebruiken over meerdere AI-tools heen.

Wat er precies is veranderd

Claude Code is de opdrachtregel-tool van Anthropic waarmee je Claude direct in je codeproject laat meewerken. Tot nu toe las Claude Code project-instructies uit een bestand met de naam CLAUDE.md. Daarin leg je vast wat Claude moet weten over jouw project: welke stijl je aanhoudt, hoe je tests draait, welke mappen belangrijk zijn.

Sinds versie 2.1.277 kijkt Claude Code ook naar een bestand met de naam AGENTS.md. De regel is eenvoudig: staat er een CLAUDE.md in de map, dan gebruikt Claude die. Is die er niet, dan valt Claude terug op AGENTS.md. Het is dus een terugval, geen samenvoeging — beide bestanden worden niet door elkaar gehusseld. Bestaande projecten met een CLAUDE.md merken er niets van en blijven precies werken zoals ze deden.

Je kunt dit gedrag zelf aan- of uitzetten. Dat doe je in Claude Code via /config, onder het kopje Project instructions. Handig als je wilt bepalen welk bestand voor jouw team leidend is.

Eén kanttekening: deze terugval werkt nog niet op de platformen Bedrock, Vertex en Foundry. Draai je Claude daar, dan heb je voorlopig nog een CLAUDE.md nodig.

Waarom een gedeeld formaat handig is

AGENTS.md is geen uitvinding van Anthropic. Het is een open afspraak die inmiddels door meer dan 30 AI-codeertools wordt gelezen — denk aan tools als Cursor, GitHub Copilot en OpenAI Codex — en die in tienduizenden softwareprojecten al in gebruik is. (Santa Claude is overigens niet gelieerd aan Anthropic; we volgen de ontwikkelingen alleen op de voet.)

Het idee erachter: één plek waar staat hoe een AI-assistent zich in jouw project moet gedragen. Vroeger schreef je die uitleg voor elk tool apart, elk in een eigen bestand met een eigen naam. Wie twee of drie tools naast elkaar gebruikte, onderhield dus twee of drie keer dezelfde instructies. Foutgevoelig en tijdrovend.

Met een gedeeld formaat schrijf je het één keer. Stap je later over op een ander tool, of werkt een nieuwe collega met een ander programma, dan leest dat tool dezelfde afspraken. De kennis over jouw project zit in het project, niet in het toevallige tool dat iemand op dat moment gebruikt.

Wat dit concreet betekent voor het Nederlandse MKB

Voor een ondernemer klinkt dit misschien als een detail voor techneuten. Toch raakt het een reëel probleem. Als je software laat bouwen — door een eigen ontwikkelaar, een freelancer of een extern bureau — dan zit veel waardevolle kennis in hoofden en verspreide documenten. Hoe test je? Welke afspraken gelden? Wat mag niet aangeraakt worden?

Een AGENTS.md dwingt om die afspraken op één begrijpelijke plek te zetten. Dat levert drie praktische voordelen op:

• Minder afhankelijk van één persoon of één tool. De werkafspraken staan in het project vastgelegd, niet in het geheugen van de ontwikkelaar die toevallig het meeste weet. Vertrekt iemand, dan blijft de kennis.
• Soepeler samenwerken met externen. Werk je met wisselende freelancers of leveranciers die elk hun eigen voorkeurstool hebben, dan lezen die tools nu dezelfde instructies. Minder misverstanden, minder inwerktijd.
• Toekomstbestendiger. Het AI-tooling-landschap verandert snel. Een open formaat dat door tientallen tools wordt gelezen, gijzelt je niet aan één leverancier.

Belangrijk om nuchter te blijven: dit is een technische verbetering onder de motorkap, geen wondermiddel. Het maakt goede afspraken makkelijker te delen — maar die afspraken moeten er nog wel komen, en helder opgeschreven zijn. Daar zit vaak het echte werk.

Hoe je hiermee aan de slag gaat

Gebruik je Claude Code al? Werk dan bij naar versie 2.1.277 of hoger en de terugval werkt automatisch. Heb je nog geen CLAUDE.md maar wel een AGENTS.md (bijvoorbeeld van een ander tool), dan pikt Claude die vanaf nu op.

Begin je net en weet je niet waar je moet starten? Het schrijven van goede projectinstructies is precies het soort werk waarbij een ervaren meedenker het verschil maakt. Wil je iemand die met je meekijkt, dan kun je een Claude-specialist vinden binnen onze community.

Wil je eerst breder zien wat Claude Code voor een klein bedrijf kan doen, lees dan ook Projects opnieuw ontworpen: van map naar gesprek in Claude Code. Dat artikel laat zien hoe je een project op een toegankelijke manier met Claude aanpakt.

Benieuwd wat dit voor jouw situatie betekent? Plan gerust een vrijblijvende, gratis kennismaking via [email protected] — dan kijken we samen waar de winst voor jouw bedrijf zit.