Claude Code leest nu AGENTS.md als projectinstructie

Claude Code leest sinds versie 2.1.277 ook AGENTS.md als projectinstructie wanneer een repository geen CLAUDE.md bevat, meldt Anthropic in de changelog van 18 september.

Voor een Nederlands ontwikkelteam dat meerdere codeagents in dezelfde repository gebruikt, verandert daarmee de plek waar projectafspraken wonen. Algemene regels kunnen in AGENTS.md staan, terwijl Claude-specifieke instructies in CLAUDE.md blijven waar dat nodig is. Dat vermindert dubbele configuratie en de kans dat twee agents met verschillende bouw-, test- of veiligheidsregels werken.

Eén bestand voor meerdere codeagents

AGENTS.md is opgezet als een open format voor instructies aan codeagents, vergelijkbaar met een README voor software die namens ontwikkelaars werkt. Het bestand kan uitleggen hoe een project bouwt, test en code controleert. Claude Code sloot tot nu toe aan op zijn eigen CLAUDE.md, terwijl andere tools hun instructies uit AGENTS.md konden halen.

Die scheiding leverde vooral beheerwerk op. The Register beschrijft hoe teams CLAUDE.md en AGENTS.md naast elkaar bijhielden, met symbolische links of imports als noodoplossing om de twee bestanden gelijk te houden. Die instructiebestanden worden bij elk verzoek gelezen en bepalen onder meer gewenst gedrag, toolgebruik en codeconventies. Een verouderde kopie is daardoor niet alleen administratie, maar kan ook direct sturen wat een agent doet.

Wat versie 2.1.277 precies doet

De release van 18 september gebruikt AGENTS.md als terugvaloptie: alleen als het project geen eigen CLAUDE.md heeft, leest Claude Code het gedeelde bestand. Die keuze is in /config aan te passen onder Project instructions. De standaard is dus geen automatische samenvoeging van twee bestanden. Bestaande projecten met een CLAUDE.md houden hun huidige gedrag.

Er is ook een belangrijke grens. Anthropic vermeldt dat deze ondersteuning nog niet beschikbaar is wanneer Claude Code via Bedrock, Vertex of Foundry draait. Teams met zo’n provider kunnen de nieuwe bestandsindeling dus niet zonder meer als gemeenschappelijke basis gebruiken.

Wat de release niet oplost

De uitwisseling gaat alleen over projectinstructies. Claude Code wordt hierdoor niet dezelfde agent als Codex en provider-specifieke rechten, plug-ins of vaardigheden worden niet automatisch gesynchroniseerd. De gedeelde laag kan bouw- en testafspraken bevatten, terwijl tool-specifieke instellingen apart blijven.

Voor een organisatie betekent dat centraler beheer van de algemene werkwijze, maar niet één universeel instellingenbestand voor de hele agentketen. Juist dat onderscheid voorkomt dat een gedeeld document volloopt met aannames die maar voor één leverancier gelden.

De mod-laag is nog niet af

De ondersteuning voor AGENTS.md draait als een ingebouwde agents-md-mod. Anthropic heeft de bron en de beschikbare instructiemodi publiek gemaakt. Daarin staan naast de terugvaloptie ook modi om alleen CLAUDE.md, beide bestandstypen of alleen beheerde instructies te gebruiken.

De bredere mogelijkheid om zelf zulke mods te bouwen is iets anders. In een aankondiging van Claude Code-engineer Thariq Shihipar wordt die uitbreiding nog als aankomend beschreven. De officiële mod-directory noemt de hook-API bovendien vroegtijdige toegang, waarschuwt dat die tussen versies kan veranderen en zegt dat de mods niet in de marketplace staan. De ingebouwde AGENTS.md-mod is dus beschikbaar, maar een stabiele algemene uitbreidingslaag nog niet.

Voor teams die Claude Code, Codex of andere codeagents door elkaar gebruiken, is de directe winst wel concreet: één repositorybestand kan de gedeelde werkwijze dragen. De release verplaatst de bron van die afspraken van een leveranciersinstelling naar de codebase zelf. Anthropic neemt daarmee een bestaande open conventie over, terwijl de volgende stap, de agentomgeving zelf aanpasbaar maken, voorlopig in de fase van aankondiging en vroege toegang blijft.