Claude Code leest nu AGENTS.md: wat is er veranderd in 2.1.277

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.

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.

Wat is er veranderd in versie 2.1.277?#

Het officiële Claude Code-projectbestand CHANGELOG.md op GitHub zegt het als volgt:

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#

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.

4 modi voor Project instructions — welke kies je?#

Het gedrag van de modi in de tabel wordt beschreven in de documentatie van Anthropic. De rechterkolom geeft aanbevelingen voor de keuze:

Je kunt de modus ook zonder de interface kiezen, via settings.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 uit hoe de @-import werkt. Deze methode werkt nog steeds.

Waarom staat Project instructions niet in /config?#

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?#

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#

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. 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 — 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.