Claude Code krijgt ondersteuning voor instructiebestand Agents.md

Claude Code ondersteunt vanaf versie 2.1.277 Agents.md van OpenAI. Daarin staan instructies voor bijvoorbeeld verwacht gedrag en voorkeurstools. De ondersteuning voor Agents.md maakt het voor ontwikkelaars gemakkelijker om met AI-programmeeragents van verschillende platformen te werken.

"Als er geen Claude.md in een map staat, zoekt Claude naar Agents.md en gebruikt dat bestand", zegt Claude Code-engineer Thariq Shihipar op X. Gebruikers kunnen dit gedrag zelf aan- en uitzetten via /config.

AI-programmeertools als Claude Code lezen bij ieder verzoek dat ze krijgen een instructiebestand. Daarin kunnen ontwikkelaars instructies in Markdown zetten voor hun AI-agents. OpenAI maakte daarvoor enige tijd geleden al Agents.md. Vorig jaar werd het bestand ondergebracht bij de Agentic AI Foundation, die onder de Linux Foundation valt. Agents.md is niet gebonden aan één specifieke tool en veel andere platformen gebruiken dit ook.

Claude Code gebruikte tot nu toe alleen zijn eigen variant: Claude.md. Ontwikkelaars die werken met zowel Claude Code als een andere AI-agent, moesten dus twee instructiebestanden onderhouden. Claude.md is namelijk gebonden aan alleen Claude zelf.

Er bestonden wel workarounds om gemakkelijker om te gaan met beide Markdown-bestanden, zegt The Register. Denk aan symlinks maken om Claude.md en Agents.md te synchroniseren. Dergelijke oplossingen zijn nu dus niet meer nodig.

Claude Code

Reacties (25)

[Dlsruptor]

Owke, ik vind dit heel interessant. Maar kan iemand voor mij een kleine use-case geven waarvoor dit nuttig is? Ik snap het niet helemaal.

[Robbaman]

Wij werken in ons team met zowel Claude als Codex. Voorheen moesten we dus een Agents.md en Claude.md bestand hebben (waarbij wij dus maar in de een verwijzen naar de ander). Dit is nu dus niet meer nodig.

[Dlsruptor]

Ahhh. dit is het context bestand van Claude of ChatGPT? Als je deze dus beide bijhoud hebben beide dezelfde context?

Dat is handig want ik gebruik dus ook beide voor het coderen.

Zit ik dan op de goede gedachte?

[cmegens]

Agents.md is een instructiebriefje voor een AI assistent die aan een project werkt. Het is een gewoon tekstbestand in de projectmap, met afspraken over hoe de AI moet werken.

Vergelijk het met een overdrachtsbriefje voor een nieuwe collega: dit is ons project, zo werken we hier en hier moet je op letten.

[latka]

In de agents.md zet je bijv. neer dat de agent niet zomaar mag pushen, alleen commiten en dat je geen oude frameworks wilt gebruiken in dit project etc. De werkafspraken zeg maar.

[ro4sho]

is het niet handiger om een symlink te maken? Dan is het gewoon 1 bestand.

[P_Tingen]

Aparte bestanden of in de ene verwijzen naar de andere is in ieder geval expliciet en voor sommigen beter "zichtbaar" dan een symbolic link. Zeker op Windows zijn die niet persé gemeengoed

[sjongenelen]

Nou, je hebt allemaal 'wrappers' om LLMs heen op het internet. Bijvoorbeeld copilot of litellm. In een git repo wil je zo min mogelijk files en zo makkelijk mogelijk agents wisselen

[blabla1234]

Je kunt in je claude.md instructies geven die je anders bij elke prompt zou moeten doorgeven, zoals regels voor naamgeving, tests etc. Over het algemeen werken die instructies bij elke LLM (het is immers geschreven tekst), maar tot nu toe werkte alle andere llms met een bestand genaamd 'agents.md' terwijl claude naar 'claude.md' zocht.

Helemaal op het moment komen er zo'n beetje elke maand nieuwe modellen uit, waarvan de ene soms net even wat beter werkt dan de andere, dus het is niet ongebruikelijk om meerdere modellen door elkaar heen te gebruiken

[Reactie gewijzigd door blabla1234 op 21 september 2026 14:24]

[demonite]

Goede vraag voor je AI

[Timmmeeehhh]

Hehe, dat duurde even. Niet dat het heel lastig was om gewoon agents.md in je claude.md te refereren, maar fijn dat dat niet meer hoeft.

[SilentLucidity]

dat is ook precies wat ik doe! sneller dan dat Claude hem toevallig tegen moet komen bij een repo scan.

[sebastienbo]

Of symbolic link maken

[Zoijar]

Je ziet wel dat het biljoenen-bedrijven zijn, heh

[Hardfreak]

Hey Claude, add support for agents.md, same filecontent, different name.

There I fixed it

[SinergyX]

Maar je kon toch gewoon zeggen 'gebruik Agents.md'? ik heb mijn lokale 8b al lange tijd via md's werkend.

[Zoijar]

Ja, ik doe dat ook lokaal regelmatig. Of in plaats van "skills" gewoon zeggen "als je naar git pushed lees ff git.md"

[Llopigat]

Doe je alles in het Nederlands?

In het begin viel het altijd wat tegen als je geen Engels gebruikte (ivm minder trainingsmateriaal) en ik werk toch altijd in het Engels dus dat ben ik blijven doen. Maar ik had er niet aan gedacht dat het ook in het Nederlands kan nu. De modellen zijn zoveel beter dan in de begintijd.

[Zoijar]

Oh, nee, alles in het engels. Nederlands kan wel, maar van wat ik zo zag zijn models gewoon aantoonbaar slechter in het nederlands. Weet niet of dat nog zo is, maar lijkt me wel logisch, veel minder trainingsdata, tenzij ze misschien alles automatisch vertalen voor training ofzo, maar dat lijkt me niet.

[NovapaX]

Mijn ervaring is dat ze op de achtergrond vooral in het engels werken en denken, en dan hun uitvoer gewoon naar het nederlands 'vertalen'
Ik heb nu een project wat ik ooit in het nederlands begonnen ben als een simpel scriptje wat een beetje uit de hand gelopen is, het werkt eigenlijk prima in het nederlands. Wel soms wat opmerkelijke woorden die je letterlijk vertaald nooit tegenkomt, zoals 'werkboom', 'bouw' (in plaats van build).
En soms vallen namen van engelse concepten opeens op hun plaats doordat je ze in het nederlands leest en gaat nadenken 'wat bedoelt ie nou'. Denk bijvoorbeeld aan 'gate'.
Dat woord heb ik in development-context altijd gelezen met de betekenis zoals ik het in die context had geleerd, maar nu lees je 'poort' en valt de associatie op zijn plek... niet heel spannend, maar wel grappig.

[Teun!]

Mag ik vragen wat je op 8b draait? Ik heb zelf eens wat geprobeerd met de kleine modellen maar vond voor mijn usecase dat het eigenlijk gewoon niet goed genoeg was.

[joint_me]

Gaan ze dan ook ~/.agents folder ondersteunen? Of is dat nog een stap te ver.

[ronaldmathies]

Even een vraag, ik gebruik nu bij claud zelf skills, bijvoorbeeld /java-code, /java-review etc.. waarin een algemene beschrijving staat en referencies naar belangrijke reference files zoals java-code-conventions.md die dan door verschillende andere reference files of skills gebruikt worden.

Ik vindt dit persoonlijk handiger om meer controle te hebben over de initiele context bij een vraag.

Want niet alles in een /java-review hoeft terug te komen in /java-code en andersom.

Hoe doen andere dit?

[Hardfreak]

Wij hebben in onze globale .claude folder een CLAUDE.md met daarin de basics over onze omgevingen (ik doe vooral cloudops, dus onze account mapping steekt er bv in). Die file houden we bewust relatief klein om de token overhead beperkt te houden.

Voor terraform, ansible, ... hebben we dan aparte skills. En nog wat aparte skills om bv `tofu apply` met Haiku te runnen ipv wat we dan net gebruiken van model.

Een CLAUDE.md file binnen een repo is vaak niet nodig bij ons, maar kan de voor dat project specifieke documentatie of gotcha's/regeltjes bevatten.

//edit: kort samengevat. Claude.md in een project folder is eigenlijk de readme.md die niemand ooit schreef.

[Reactie gewijzigd door Hardfreak op 21 september 2026 14:42]

[camper69]

Pijnlijk (en dus opgelost) voor Windows-gebruikers. De rest van de wereld gebruikte gewoon een symbolic link.