# Claude Code leest nu AGENTS.md: wat is er veranderd in 2.1.277 > Op 18 september 2026 kreeg Claude Code 2.1.277 directe ondersteuning voor AGENTS.md: wanneer het bestand wordt geladen, hoe je een van de 4 modi kiest en wat je met imports doet. Source: https://ailoot.ai/blog/nl/claude-code-agents-md-support/ Canonical: https://ailoot.ai/blog/nl/claude-code-agents-md-support/ Language: nl Publisher: Ailoot (https://ailoot.ai/) Translation: guide-041 Revision: sha256-c9f5ad13bb77412da8c440f9fab7ebf69fbc7c039ae64dddc04650ab26f69cd1 Op 18 september 2026 is ondersteuning voor `AGENTS.md` toegevoegd aan Claude Code 2.1.277. Als de functie beschikbaar is in de sessie en in de werkmap, en er nergens in de mapstructuur erboven een `CLAUDE.md`, `.claude/CLAUDE.md` of `CLAUDE.local.md` staat, leest Claude Code standaard `AGENTS.md` zonder handmatige import. Voorheen gebeurde dit via een `@AGENTS.md`-import in `CLAUDE.md` of via een symbolische koppeling van `CLAUDE.md` naar `AGENTS.md` — lees voor meer informatie het artikel [over één instructiebestand voor meerdere agents](https://ailoot.ai/blog/nl/agents-md-claude-md-one-instruction-file/). Als je Claude Code en een of twee andere tools in dezelfde repository gebruikt, bepaalt de modus Project instructions die je kiest welke instructiebestanden Claude Code leest. Hieronder staan de voorwaarden voor elk van de vier modi en de stappen om over te stappen van de oude configuratie. Meer informatie over het configureren van tools vind je in de [Ailoot-documentatie](https://ailoot.ai/docs/).
[Ailoot-gidsen](https://ailoot.ai/docs/)
## Wat is er veranderd in versie 2.1.277?
Belangrijkste conclusie Sinds 18 september 2026 leest Claude Code standaard `AGENTS.md` als er nergens in de mapstructuur vanaf de werkmap naar boven een `CLAUDE.md`, `.claude/CLAUDE.md` of `CLAUDE.local.md` staat. Als zo'n bestand bestaat, is het automatisch lezen van `AGENTS.md` via Project instructions niet ingeschakeld. Een expliciete `@AGENTS.md`-import vanuit `CLAUDE.md` blijft werken. `~/.claude/CLAUDE.md` op gebruikersniveau, door de organisatie beheerde `CLAUDE.md` en `.claude/rules/` worden onafhankelijk van de keuze tussen projectbestanden geladen. Je schakelt de modus om via `/config`. De functie is nog niet beschikbaar op Bedrock, Vertex of Foundry.
Het officiële Claude Code-projectbestand CHANGELOG.md op GitHub zegt het als volgt:

Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under "Project instructions" in /config (not yet on Bedrock, Vertex or Foundry)

— Anthropic, claude-code CHANGELOG.md commit, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
Vertaling: ondersteuning voor `AGENTS.md` is toegevoegd — in een project zonder `CLAUDE.md` leest Claude Code nu in plaats daarvan `AGENTS.md`; je kunt dit wijzigen onder “Project instructions” in `/config` (nog niet beschikbaar op Bedrock, Vertex of Foundry). Vóór deze versie zorgde de afwezigheid van `CLAUDE.md`, `.claude/CLAUDE.md` en `CLAUDE.local.md` in de werkmap en daarboven op zichzelf niet voor het inlezen van `AGENTS.md`. Daarvoor was een expliciete import, een symbolische koppeling of een handmatige hook nodig. Nu pikt de agent het bestand automatisch op wanneer de functie beschikbaar is. ## Welke bestanden blokkeren het automatisch lezen van AGENTS.md
Belangrijkste conclusie In de standaardmodus wordt in de werkmap en de mappen daarboven gecontroleerd op `CLAUDE.md`, `.claude/CLAUDE.md` en `CLAUDE.local.md`. Persoonlijke `~/.claude/CLAUDE.md`, door de organisatie beheerde `CLAUDE.md` en bestanden in `.claude/rules/` blokkeren het lezen van `AGENTS.md` niet en worden daarnaast geladen.
Als je een persoonlijke `~/.claude/CLAUDE.md` met instellingen voor de programmeerstijl hebt, verhindert die niet dat Claude Code de `AGENTS.md` van het project leest. Maar elke `CLAUDE.local.md` in de werkmap — zelfs een bestand dat niet aan Git is toegevoegd en voor persoonlijke notities wordt gebruikt — blokkeert het automatisch lezen van `AGENTS.md` in de standaardmodus. Een expliciete import blijft werken; als je beide bestanden rechtstreeks wilt laten lezen, moet je van modus wisselen. Als in Project instructions een modus voor rechtstreeks lezen is geselecteerd (zie hieronder “4 modi voor Project instructions — welke kies je?”) en er in de werkmap of daarboven geen `CLAUDE.md`, `.claude/CLAUDE.md` of `CLAUDE.local.md` staat, leest Claude Code bij het starten van de sessie alle `AGENTS.md`- en `.claude/AGENTS.md`-bestanden in die mappen. Voor het geval er geen blokkerende bestanden zijn, toont de documentatie een regel zoals deze in een interactieve sessie: ``` no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md ``` Een `AGENTS.md` in een submap wordt geladen wanneer Claude daar met de Read-tool een bestand opent. In de modus `claude-md-or-agents-md` gebeurt dit alleen als die submap zelf geen `CLAUDE.md`, `.claude/CLAUDE.md` of `CLAUDE.local.md` bevat. Voor `claude-md-and-agents-md` beschrijft de documentatie de algemene regel: `CLAUDE.md` en `AGENTS.md` worden samen gelezen, met in elke map eerst `CLAUDE.md` en daarna `AGENTS.md`. `AGENTS.local.md`, `AGENTS.override.md` en alles in de map `.agents/` worden niet automatisch gelezen. Informatie over het configureren van de werkruimte van een AI-agent, waaronder instructiebestanden met projectcontext, vind je in de [Ailoot-documentatie](https://ailoot.ai/docs/).
[Ailoot-gidsen](https://ailoot.ai/docs/)
## 4 modi voor Project instructions — welke kies je?
Belangrijkste conclusie In het gedeelte Project instructions van de opdracht `/config` zijn er vier waarden: `claude-md-or-agents-md` (standaard — een van de twee bestanden), `claude-md-and-agents-md` (beide samen), `claude-md` (alleen `CLAUDE.md` wordt automatisch gelezen, zelfs als het project alleen `AGENTS.md` bevat) en `managed-only` (bij het starten alleen de door de organisatie beheerde `CLAUDE.md` en het automatische geheugen, zonder project- of persoonlijke bestanden). De wijziging gaat in vanaf het volgende verzonden bericht en in elke nieuwe sessie.
Het gedrag van de modi in de tabel wordt beschreven in de documentatie van Anthropic. De rechterkolom geeft aanbevelingen voor de keuze: | Waarde | Wat Claude Code leest | Wanneer gebruiken | |----|----|----| | `claude-md-or-agents-md` | `CLAUDE.md`, of `AGENTS.md` als er in de werkmap of daarboven geen `CLAUDE.md`, `.claude/CLAUDE.md` of `CLAUDE.local.md` staat | Standaard, als de repository slechts één van de twee bestanden gebruikt en er daarboven geen blokkerende bestanden zijn | | `claude-md-and-agents-md` | Beide bestanden samen: in elke map eerst `CLAUDE.md`, daarna `AGENTS.md` | Je hebt een gedeelde `AGENTS.md` nodig voor alle tools plus een korte `CLAUDE.md` alleen voor Claude; of je moet `AGENTS.md` laten lezen wanneer `CLAUDE.local.md` bestaat | | `claude-md` | Alleen `CLAUDE.md`; automatisch lezen van `AGENTS.md` via Project instructions is uitgeschakeld, zelfs als `AGENTS.md` het enige bestand is (een expliciete `@AGENTS.md`-import vanuit `CLAUDE.md` blijft wel werken) | `AGENTS.md` is geschreven voor een andere tool en zou Claude in verwarring kunnen brengen | | `managed-only` | Bij het starten van de sessie worden alleen de door de organisatie beheerde `CLAUDE.md` en het automatische geheugen gelezen; project-, lokale en gebruikersbestanden `CLAUDE.md`, `.claude/rules/` en alle `AGENTS.md`-bestanden zijn uitgesloten van de initiële set. `CLAUDE.md`- en `.claude/rules/`-bestanden in submappen worden later echter nog steeds geladen wanneer Claude daar een bestand opent. De modus beperkt de initiële set, maar biedt geen volledige isolatie van projectbestanden | Voor organisaties die willen bepalen met welke instructies Claude Code een sessie start, ongeacht of het project zelf `CLAUDE.md` of `AGENTS.md` bevat | Je kunt de modus ook zonder de interface kiezen, via `settings.json`: ```json { "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` Claude Code negeert deze waarde in `project`- en `local`-instellingen. Volgens de documentatie van Anthropic kan deze worden ingesteld in `~/.claude/settings.json`, in een bestand dat met `--settings` is opgegeven of in door de organisatie beheerde instellingen. Als je al een gedeeld instructiebestand voor meerdere AI-tools in één repository hebt ingesteld, leggen de [instructies voor versies vóór 2.1.277](https://ailoot.ai/blog/nl/agents-md-claude-md-one-instruction-file/) uit hoe de `@`-import werkt. Deze methode werkt nog steeds. ## Waarom staat Project instructions niet in /config?
Belangrijkste conclusie Volgens de documentatie van Anthropic kan het gedeelte Project instructions om de volgende redenen ontbreken: - Claude Code is ouder dan versie 2.1.277. - De sessie ontvangt geen feature flags van Anthropic — bijvoorbeeld bij gebruik van Bedrock, een andere externe provider of wanneer telemetrie is uitgeschakeld. - Dit is de eerste sessie direct na installatie of een update vanaf een oudere versie. Als dit de enige reden is, verschijnt de functie in de volgende sessie. `AGENTS.md` zelf wordt alleen geladen als aan de voorwaarden van de geselecteerde modus is voldaan. - De ingebouwde `agents-md`-plugin is uitgeschakeld in `/plugin`.
Controleer eerst de versie met de opdracht `claude --version`. Als die lager is dan 2.1.277, werk Claude Code dan bij. Als de versie geschikt is maar het gedeelte nog steeds niet verschijnt, controleer dan de andere hierboven genoemde redenen. Zolang de functie niet beschikbaar is, blijft een `@AGENTS.md`-import in `CLAUDE.md` een werkend alternatief. ## Wat doe je met de oude @AGENTS.md-import?
Belangrijkste conclusie Je kunt de `@AGENTS.md`-import in `CLAUDE.md` en de symbolische koppeling behouden: in geen enkele modus wordt het bestand twee keer gelezen. Een tekstueel verzoek om “AGENTS.md te lezen” moet je vervangen door een import als je `CLAUDE.md` behoudt. Sla vóór het verwijderen van een bestand alle benodigde instructies op en controleer de voorwaarden van de geselecteerde modus. Als je overstapt op rechtstreeks lezen, verwijder dan elke `SessionStart`-hook die de inhoud van `AGENTS.md` handmatig heeft afgedrukt; anders wordt een tweede kopie van het bestand aan de context toegevoegd. Controleer daarna het laden in een nieuwe sessie; hoe je dat doet, hangt af van de versie en van de aanwezigheid van blokkerende bestanden.
De volgende stappen hangen af van de oude configuratie. Controleer eerst of de functie beschikbaar is in je sessie, zoals beschreven in het vorige gedeelte. - **`CLAUDE.md` met een `@AGENTS.md`-import.** Je kunt dit zo laten — Claude Code leest het bestand niet twee keer, ongeacht de waarde van Project instructions. `CLAUDE.md` verwijderen is optioneel: de import geeft Claude al toegang tot de inhoud van `AGENTS.md`. Blijf het laden via de import controleren met `/memory`; Claude rechtstreeks vragen naar de inhoud van de instructies is slechts een zwakke controle. - **`CLAUDE.md` waarin in woorden wordt gevraagd om `AGENTS.md` te lezen.** Zo'n verzoek is geen import en garandeert op zichzelf niet dat het bestand wordt geladen. Vervang de tekst door een `@AGENTS.md`-import als je `CLAUDE.md` wilt behouden (bijvoorbeeld voor tools die het ook lezen). Als je besluit `CLAUDE.md` helemaal te verwijderen en de modus `claude-md-or-agents-md` te gebruiken, controleer dan eerst of `CLAUDE.md` geen unieke instructies bevat en of er in de werkmap of daarboven geen andere `CLAUDE.md`, `.claude/CLAUDE.md` of `CLAUDE.local.md` staat; anders blijft Claude Code het overgebleven bestand lezen in plaats van `AGENTS.md`. Controleer na het verwijderen of de overgang is voltooid: als er geen blokkerende bestanden meer zijn, verschijnt de regel `AGENTS.md loaded` in een interactieve sessie. Als `CLAUDE.md` blijft staan en beide bestanden in de modus `claude-md-and-agents-md` worden gelezen, controleer dan `/memory` (in versie 2.1.280+). Claude rechtstreeks iets vragen kan rechtstreeks laden niet onderscheiden van een import. - **`CLAUDE.md` als symbolische koppeling naar `AGENTS.md`.** Je kunt die behouden: in geen enkele modus wordt het bestand dubbel gelezen. Controleer voordat je de koppeling verwijdert in de modus `claude-md-or-agents-md` of de benodigde instructies behouden zijn en of er in de werkmap of daarboven geen andere `CLAUDE.md`, `.claude/CLAUDE.md` of `CLAUDE.local.md` staat. Controleer het laden op dezelfde manier: de regel `AGENTS.md loaded` bij het starten als er geen blokkerende bestanden zijn, of `/memory` (2.1.280+). Als `CLAUDE.md` blijft staan in de modus `claude-md-and-agents-md`, is Claude rechtstreeks iets vragen slechts een zwakke controle. De afwezigheid van een foutmelding is niet voldoende om te bevestigen dat het bestand is geladen. - **Een `SessionStart`-hook die de inhoud van `AGENTS.md` handmatig heeft afgedrukt.** Wanneer het bestand rechtstreeks wordt gelezen, voegt zo'n hook een tweede kopie toe aan de context. Zolang de hook actief is, bevestigt de vraag “wat staat er in je instructies?” niet dat het bestand rechtstreeks is geladen: Claude kan antwoorden op basis van tekst die door de hook is toegevoegd. Stap in deze volgorde over: 1. Controleer of de functie beschikbaar is: versie 2.1.277 of hoger, de sessie ontvangt feature flags, de plugin is ingeschakeld en de eerste sessie na installatie of update is voltooid. Kies een modus voor rechtstreeks lezen — dus niet `claude-md` of `managed-only`. Controleer voor de standaardmodus ook dat er geen blokkerende bestanden zijn. 2. Verwijder de hook. 3. Sluit de sessie en open een nieuwe. De `SessionStart`-hook voegt de tekst toe bij het opstarten, dus die inhoud blijft in de context van een al geopende sessie staan. Claude's antwoord over de inhoud van de instructies in zo'n sessie bevestigt niet dat ze rechtstreeks zijn geladen. 4. Controleer het laden in de nieuwe sessie. In versie 2.1.280+ is het pad naar `AGENTS.md` zichtbaar in `/memory`. In versies 2.1.277–2.1.279 zoek je, als er geen blokkerende bestanden zijn, bij het opstarten naar de regel `AGENTS.md loaded`: de documentatie beschrijft die specifiek voor het geval waarin geen `CLAUDE.md` is gevonden. Als je `CLAUDE.md` behoudt en de modus `claude-md-and-agents-md` gebruikt, zijn de controlemogelijkheden beperkt: `/memory` toont `AGENTS.md` in deze versies niet, de documentatie beschrijft voor dit geval geen laadregel en een parafrase van de instructies kan rechtstreeks lezen niet onderscheiden van een `@`-import in `CLAUDE.md`. Werk in dat geval bij naar 2.1.280+ en controleer `/memory`. ## Controleren of AGENTS.md is geladen
Belangrijkste conclusie Vanaf versie 2.1.280 verschijnt `AGENTS.md` dat via Project instructions is geladen in `/memory` en in de lijst Memory files van de opdracht `/context`. In versies 2.1.277–2.1.279 verschijnt het daar niet, ook al werken de opdrachten zelf en tonen ze de geladen `CLAUDE.md` en andere geheugenbestanden. Controleer in deze versies, als er geen blokkerende bestanden zijn, bij het starten van de sessie op de regel `AGENTS.md loaded`. Claude naar de inhoud van de instructies vragen is slechts een zwakke controle: het antwoord kan rechtstreeks lezen niet onderscheiden van een `@`-import en kan steunen op tekst die door een `SessionStart`-hook is toegevoegd. Vraag dit daarom alleen in een nieuwe sessie nadat je zo'n hook hebt verwijderd.
Er zijn nog twee verschillen met gewone `CLAUDE.md`: `InstructionsLoaded`-hooks worden niet uitgevoerd voor dit type `AGENTS.md` (ze werken wel voor `AGENTS.md` dat via de `@`-syntaxis vanuit `CLAUDE.md` is geïmporteerd of via een symbolische koppeling van `CLAUDE.md` is gekoppeld); mappen die zijn toegevoegd met de vlag `--add-dir` en de variabele `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` laden alleen de `CLAUDE.md` van die map — de bijbehorende `AGENTS.md` wordt niet meegenomen. Als je de inhoud van een groot projectinstructiebestand wilt beoordelen, lees dan de afzonderlijke analyse [over het instellen van CLAUDE.md zonder het bestand te laten uitdijen](https://ailoot.ai/blog/nl/claude-md-template/). Die behandelt de structuur van instructies; de voorwaarden voor het laden van `AGENTS.md` staan hierboven. Voor werkaantekeningen tussen sessies, lees de analyse over [een tweede brein in Claude Code](https://ailoot.ai/blog/nl/tweede-brein-claude-code/) — over persoonlijke herinneringen die boven op projectinstructies worden gelaagd. ## Wat nu? De functie is op 18 september 2026 uitgebracht in versie 2.1.277. Anthropic kan details van de modi in toekomstige releases verduidelijken. Vergelijk dit artikel daarom met de huidige `/config` en de officiële changelog voordat je instellingen in een belangrijk project wijzigt.
### Bronnen - [Claude Code, CHANGELOG.md-commit op GitHub met de vermelding voor 2.1.277 (18 september 2026)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3) - [Claude Code Docs: Hoe Claude je project onthoudt — het gedeelte AGENTS.md](https://code.claude.com/docs/en/memory)
[Ailoot-gidsen](https://ailoot.ai/docs/)
[Ga naar Ailoot](https://ailoot.ai/)
## Vragen en antwoorden ### Waarom wordt AGENTS.md niet geladen terwijl het bestand bestaat? In de standaardmodus blokkeert een CLAUDE.md, .claude/CLAUDE.md of CLAUDE.local.md in de werkmap of een bovenliggende map de automatische keuze van AGENTS.md. Controleer ook de Claude Code-versie, beschikbaarheid van de functie en de modus Project instructions in /config. ### Hoe controleer ik direct laden na het verwijderen van een handmatige hook? Open een nieuwe sessie zodat de oude SessionStart-uitvoer ontbreekt. Bekijk in versie 2.1.280 of later /memory of de lijst Memory files in /context; bij 2.1.277-2.1.279 geldt de laadregel bij opstarten wanneer blokkerende CLAUDE.md-bestanden ontbreken. Alleen een parafrase van Claude is zwak bewijs. ## Ailoot · Het bedrijf en zijn projectenportefeuille Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle. Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden. Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.