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.
Lees meer
Reacties (87)
En je AGENTS.md file bevatte dan de context van het project ( dit kon ook in je home directory zijn in de .claude map).@AGENTS.md
Zodoende ging CLAUDE je CLAUDE.md inlezen terwijl het in de achtergrond AGENTS.md laadt.
Dit is niet meer nodig, dus je kan gewoon CLAUDE.md wissen.
Sterker nog, ik werk met Codex Soul.md en zelfs die krijg ik eigenlijk bijna altijd door m'n strot geduwd door Claude terwijl dit eigenlijk juist weer niet de bedoeling is (want specifiek juist op Codex gericht).
maar de kanttekening is wel de moeite waard. Het is inderdaad niet waterdicht. Wat CLAUDE.md en AGENTS.md sws niet zijn.
Kun je gewoon controleren in de code op GitHub fyi.
[Reactie gewijzigd door NicoJuicy op 22 september 2026 15:04]
Ik wil geen platform afhankelijke meuk in de root folder van mijn project.
[Reactie gewijzigd door satoer op 21 september 2026 18:08]
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]
In AGENTS.md staan afspraken en instructies waar de AI-agents zich aan moeten houden. Dat kunnen hele kleine en logisch lijkende dingen zijn, maar ook uitgebreidere afspraken over bijvoorbeeld code style, documentatie, security en de manier waarop wijzigingen binnen het project moeten worden uitgevoerd.
Het doel is vooral dat een AI-agent niet iedere keer zelf hoeft te bedenken hoe iets binnen het project hoort, maar vooraf duidelijke kaders en afspraken meekrijgt.
Nu dus niet meer. Let wel op dat sub folders met agents.md niet correct werken in bijv. een monorepo (onafhankelijk van de instelling: claude_or_agents / claude_and_agents). De enige manier om dat werkend te krijgen is door in de agents.md in de root te verwijzen naar de subfolder agents.md met als opmerking ‘leed dit alleen als je in die map zit’.
Nu dus niet meer, nu leeft het wel in het geheugen maar buiten de context van elke prompt. Let wel op dat sub folders met agents.md niet correct werken in bijv. een monorepo (onafhankelijk van de instelling: claude_or_agents / claude_and_agents). De enige manier om dat werkend te krijgen is door in de agents.md in de root te verwijzen naar de subfolder agents.md met als opmerking ‘leed dit alleen als je in die map zit’.
Dus elke context is minimaal 10.000 tokens en maximaal 80.000 tokens.
Ter info, Claude raad zelf aan onder kopje "Write effective instructions" dat de file niet langer dan 200 regels moet zijn:
Size: target under 200 lines per CLAUDE.md file. Longer files consume more context and reduce adherence
Nu dus niet meer. Let wel op dat sub folders met agents.md niet correct werken in bijv. een monorepo (onafhankelijk van de instelling: claude_or_agents / claude_and_agents). De enige manier om dat werkend te krijgen is door in de agents.md in de root te verwijzen naar de subfolder agents.md met als opmerking ‘lees dit alleen als je in die map zit’.
De AGENTS.md file is te groot. Zelfs zonder @import.Dus elke context is minimaal 10.000 tokens en maximaal 80.000 tokens
Dat is handig want ik gebruik dus ook beide voor het coderen.
Zit ik dan op de goede gedachte?
Vergelijk het met een overdrachtsbriefje voor een nieuwe collega: dit is ons project, zo werken we hier en hier moet je op letten.
Done.@AGENTS.md
Werkt verder voor bijv. een Claude Code CLI sessie idd perfect.
[Reactie gewijzigd door R4gnax op 21 september 2026 19:17]
Ik raad iedereen sterk af om dat te gebruiken. Mijn directe collega gebruikt het veel, maar als ik zie hoe ver je dan achterloopt op features van Claude Desktop en het gebruiken van andere zaken, voor mij echt totaal niet interessant.zoals inline prompts in VS 2026
/Workflows werkt niet, kun je dus helemaal niet zien of dat allemaal goed gaat. Komt nog eens bij dat VS code een soort single threaded processes afdwingt met de plugin. Dus waar ik heel wat sessies kan laten starten vanuit 1 sessie (dus afzonderlijk in de gaten te houden, maar wel georchestreerd) schijnt de VScode variant dat niet te kunnen. Voor alleen een simpele werkwijze prima, maar ik ga het daar niet mee redden.
Het belangrijkste verschil zit in de praktische uitvoering van taken. In CLAUDE.md definieer je de exacte terminalcommando's voor het bouwen, linten en testen van de codebase. De open AGENTS.md-standaard ondersteunt deze toolspecifieke terminalacties niet. Daarnaast activeer en configureer je via CLAUDE.mdaangepaste slash-commands in de CLI. Ook gebruikt Claude dit bestand als landingsplaats voor het automatische geheugensysteem om projectspecifieke lessen op te slaan, zonder de universele opzet van AGENTS.md voor andere tools zoals Codex te verstoren.
Het loont om beide bestanden te behouden door de taken te scheiden. Alle inhoudelijke richtlijnen, security-baselines en mappenstructuren blijven in de grote AGENTS.md staan als centrale bron voor elke AI-agent. Daarnaast gebruik je een minimale CLAUDE.md die uitsluitend de lokale scripts aanroept en via een importregel naar AGENTS.md verwijst. Door de recente update indexeert Claude dat grote bestand efficiënt op de achtergrond, waardoor de tokens niet meer bij elke prompt worden meegestuurd.
Een regel in de agend.md en dan gaat het goed.
Als je het in claude.md of agents.md zet zal dat altijd in elke sessie context ingeladen worden, terwijl je het lang niet altijd nodig hebt.
AGENTS.md is het tool-onafhankelijke equivalent: een open standaard die door meerdere AI-codeertools (Codex, Cursor, Copilot, Kimi code en anderen) wordt gelezen. Zelfde doel, dezelfde soort inhoud, maar niet gebonden aan één leverancier.
Waar dit echt belangrijk gaat worden is als je met harnas engineering aan de gang gaat. De harnas beschrijvingen (wat wel en niet mag, hoe iets wel en niet mag en welke tools er beschikbaar zijn) zorgen ervoor dat iedere agent altijd start met een fatsoenlijke context die niet afhankelijk is van de gebruiker zelf. Het nadeel is alleen dat het suggesties blijven. Deze zaken worden nooit hard afgedwongen, maar zijn dus een instructie om een soort gedeelde basis mee te beginnen. Handig voor "gebruik geen any in TypeScript" of "run eerst de tests", maar het is geen afdwinging. De daadwerkelijke harde instructies (permissions, hooks, tools) staan daadwerkelijk een laag dieper in .claude/settings.json. Bij codex kun je zelfs nog een Soul.md gebruiken waar je dit echt in zet en dat wordt dan zwaarder meegenomen in de beslissingen. Zelfs operator override wordt dan veel vaker geweigerd.
Nog steeds is het niet per se deterministisch, maar je kunt er heel ver mee komen om meer zaken in code te beleggen die als tooling ter beschikking komen, waardoor het wel deterministisch is. Ik gebruik het onder andere voor cost en time rolups en comments plaatsen op tickets met een specifiek format.
Je kunt gewoon één agents.md gebruiken met instructies voor alle AI tools van alle leveranciers.
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?
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]
Maar minstens zo belangrijk is wat hij absoluut niet mag doen. Denk aan het vermijden van specifieke JavaScript code die niet compatibel is met iOS 12 of Safari 12 (als dat belangrijk is voor je project). Misschien ben je tegen problemen aangelopen met bepaalde timers en mag hij die simpelweg niet meer aanraken. Of je hebt al flink geoptimaliseerd en je wilt voorkomen dat hij dat allemaal weer om zeep helpt omdat hij voor de makkelijkste weg kiest. Bijvoorbeeld door domweg een hele lijst instellingen te refreshen in plaats van heel gericht alleen de aangepaste data bij te werken.
Het zijn zomaar wat voorbeelden waar ik zelf tegenaan ben gelopen en die de agent nu keurig links laat liggen, puur omdat het helder in de onboarding instructies staat.
Overigens is dat onderzoek inmiddels wat verouderd. Het gaat erg rap met nieuwe modellen dus resultaten van GPT 5.2 zijn waarschijnlijk niet echt meer relevant.
[Reactie gewijzigd door Wolfos op 21 september 2026 19:07]
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.
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.
Maar ik woon al jaren in diverse buitenlanden dus ik spreek sowieso weinig Nederlands meer. En het is een paar jaar geleden dat ik het geprobeerd heb.
[Reactie gewijzigd door Llopigat op 21 september 2026 15:23]
Ja, want ik merk met mijn Nederlandstalige projecten dat ie mogelijk dingen verkeert interpreteert doordat een stuk jargon mogelijk in het engels weer iets anders betekent. Ook meervoud van Nederlandstalige woorden in het engels wordt een puinhoop.Doe je alles in het Nederlands?
Als je een engels project hebt, dikke prima, maar als er ergens Nederlandstalige domeinkennis om de hoek komt kijken (wat bij overheid eigenlijk altijd is) dan ga je hel snel nat. Zeker met alle DLA's en VLA's die er voorbijkomen.
[Reactie gewijzigd door Stroper op 22 september 2026 11:30]
Gebruik bij voorkeur skills met een bondige trigger phrase en description om Claude te leren hoe iets te doen; en rules met de juiste glob file-context om Claude te leren wanneer iets te doen.
[Reactie gewijzigd door R4gnax op 21 september 2026 19:02]
Een keer in de zoveel tijd vraag ik hem ook die files te inspecteren en op inconsistencies te scannen en eventueel wat te herschrijven.
Ik geloof dat ik nu zon 100 A4tjes mds heb, een geweldige project documentatie ook, tijdens het bouwen alle redenen en keuzes vastgelegd op hoger niveau dan de code zelf. En ik type geen regel zelf
[Reactie gewijzigd door Zoijar op 21 september 2026 20:27]
En dat is ook handiger, want op die manier heb je zowel een referentie die je kan checken, alsook up to date informatie wat je niet hebt als het in het model ingebakken zit. En met ingebakken kennis is het lastig na te gaan of hij niet aan het hallucineren is. Bovendien, in mijn geval gaat het vaak om dingen die persoonlijk zijn. En die gaan natuurlijk niet in de trainingset van een cloud model zitten. Dat is juist de kracht van een lokaal model, je kan er dingen in stoppen die je niet per se in de cloud zou willen. Een vraag begrijpen, zoeken naar antwoorden in bronmateriaal en het antwoord daaruit destilleren gaat een 8b model prima lukken. Vertalen en samenvatten ook. Dingetjes aanroepen om het huis te bedienen ook (dat kan zelfs met een 2b model). Je moet niet verwachten dat je een claude Opus equivalent hebt natuurlijk, maar eigenlijk is dat ook gewoon overkill voor de meeste dingen.
Alleen ingewikkelde taken als programmeren vallen tegen, maar qwen 27b schijnt daar ook best aardig in te zijn. Die heb ik nog niet draaiende, ik ben nog op zoek naar een goedkope 32GB kaart (een Instinct MI50 ofzo)
Wat ik nu doe is meerdere kaarten tegelijk draaien met verschillende modellen er op, die ik dan altijd in het VRAM laat zitten zodat ze supersnel opstarten.
[Reactie gewijzigd door Llopigat op 21 september 2026 15:21]
Mag ik vragen welke modellen je ervaring mee hebt? Een van de nieuwere doe ik heb geprobeerd is ornith 1.5 9b en qwen (3.6 dacht ik)9b, maar had het idee dat ze constant over zichzelf vielen zeg maar. Eerlijk is eerlijk ik heb behalve wat hermes skills niet veel erom heen hangen, rag en mcp staan op de lijst, maar juist het feit dat de modellen zo tegenvallen met mijn setup in elk geval, zorgt ervoor dat ik daar nog geen energie ingestoken heb. Mocht je daar tips voor hebben, dan hoor ik dat ook graag.
Helaas heb ik maar een enkele 6950xt, de vorige kaart is niet de moeite van het starten waard voor ai taken, helaas.
[Reactie gewijzigd door Teun! op 21 september 2026 18:41]
Maar wat bedoel je met over zichzelf heen vallen?
Ik heb hier twee kaarten in de server momenteel (een Nvidia en een AMD) maar er kan er nog eentje bij. Er kan er maar eentje op x16 maar dat is niet zo'n ramp want er gaat met LLM inferentie weinig over de PCI bus als je het binnen een enkele kaart houdt.
Heb het daardoor ook nog niet echt voor nuttige taken in kunnen zetten, voor mij zit het nu op het niveau speelgoed (mijn implementatie dan, qua nuttigheid zeg maar).
Maar voor IT dingen heb je inderdaad wat grotere modellen nodig. Qwen 27b en 35b (MoE) schijnen dat beter te kunnen. Maar op een 16gb kaart draaien die voor mijn zin niet goed genoeg.
Ik gebruik het meer voor research / web opzoeken, en als assistent om persoonlijke dingen aan te vragen. Zo kan het bijvoorbeeld WhatsApp groepen in de gaten houden waar ik zelf geen zin in heb om die bij te houden. Voor de recentste berichten heb ik dan MCP om het live op te vragen en de oude worden in markdown als knowledge gezet (RAG)
Ik laat wel claude scripts maken voor de lokale AI (zoals MCP tools en tools die data ophalen om in RAG te zetten). Dat maakt het ook deterministischer. En het privacy aspect speelt dan geen rol omdat hij alleen de tools maakt maar niet zelf met de data werkt.
Dan kan hij me waarschuwen van hee die en die heeft volgend weekend een verjaardag en dan kan ik followup vragen van is er een feest, wie komt er enz zonder dat ik de hele dag allerlei slap gelul bij moet houden 🤭
Dit soort dingen kan je ook met openclaud doen maar dat is veel minder deterministisch en efficiënt, die loopt continu rondjes te draaien.
[Reactie gewijzigd door Llopigat op 21 september 2026 20:53]
There I fixed it
Ik heb het idee dat er al veel mensen zijn die heel veel AI gebruiken om te programmeren en ik heb niet het idee dat het kwalitatief beter wordt. Het is wel sneller, dat wel.
En buiten dat alles: zelf dingen maken heeft nog steeds voldoening.
Ik als leek ben jaren aan kennis verwijderd van het resultaat wat een AI agent al voor je in elkaar kan toveren. in een middagje.
Kleine projecten: AI prima.
grote projecten: Experts/programmeurs nodig.
[Reactie gewijzigd door R4gnax op 21 september 2026 19:25]
Daarnaast denk ik ook dat het altijd wel nut heeft om 1 of 2 programmeertalen te kennen. Niet dat je ze perse compleet uit je hoofd moet kennen. Maar het is altijd handig om de output van AI te kunnen controleren, of zelf te debuggen, of zelf nog kleine wijzigingen te doen.
Je kunt je afvragen of je dat uberhaupt leuk vind als werk natuurlijk. Wat je moet doen in een AI prompt gooien en gewoon files met door AI gegenereerde code lezen en kijken of het ongeveer klopt.
Beetje alsof je een schilder bent, door AI een schilderij laat maken en dan bekijken of je de kleuren en vormen wel goed vind.
Om te kunnen reageren moet je ingelogd zijn
/i/2008238698.webp?f=imagenormal)
:strip_icc():strip_exif()/u/621125/crop65cd0fde312bc_cropped.jpg?f=community)
:strip_exif()/u/591794/crop61a251d10f7b3.gif?f=community)
:strip_icc():strip_exif()/u/1470316/crop6746d52637e96_cropped.jpg?f=community)
/u/479384/crop58e4c54c15b23_cropped.png?f=community)
/u/286795/crop5b1a42cd59dfd_cropped.png?f=community)
:strip_icc():strip_exif()/u/151537/crop5db7498ca4eda_cropped.jpeg?f=community)
:strip_icc():strip_exif()/u/243344/crop5e013b248e994_cropped.jpeg?f=community)
:strip_icc():strip_exif()/u/140697/crop6180fb9103afa_cropped.jpg?f=community)
:strip_exif()/u/497784/tweakerslager.gif?f=community)
:strip_icc():strip_exif()/u/23158/crop6639d39f6d4f1_cropped.jpg?f=community)
:strip_icc():strip_exif()/u/5364/drillingforbrains_60x60.jpg?f=community)
:strip_icc():strip_exif()/u/604689/rsz_1triryche.jpg?f=community)
:strip_icc():strip_exif()/u/35767/images.jpg?f=community)
:strip_exif()/u/28986/javaone6666.gif?f=community)
:strip_exif()/u/121799/6d89df1809e5dffe256e3eddd2362554448.gif?f=community)
/u/486087/crop5ed11512833ce_cropped.png?f=community)
/u/381607/have%2520a%2520nice%2520day%2520-%2520small.png?f=community)
:strip_icc():strip_exif()/u/41502/breezah.jpg?f=community)
/u/2008130/crop6536ebba0daf2_cropped.png?f=community)
:strip_exif()/u/35905/turtle-logo.gif?f=community)
:strip_icc():strip_exif()/u/990805/crop5e20ca3d75443_cropped.jpeg?f=community)
:strip_exif()/u/6356/eliza.gif?f=community)