AnswersPublished18 sources
Claude Code krijgt AGENTS.md-fallback, maar geen automatische samenvoeging
Claude Code 2.1.277, uitgebracht op 18 september 2026, kan AGENTS.md als projectinstructie lezen als een project geen CLAUDE.md bevat. De instelling is te wijzigen via Project instructions in /config; de functie is nog niet beschikbaar op Amazon Bedrock, Google Vertex AI en Azure AI Foundry.
Gepubliceerd doorBewerkt met GPT-5.6 TerraAfbeeldingen gegenereerd met GPT Image 2
Research answer
Key takeaways
- Claude Code 2.1.277, uitgebracht op 18 september 2026, kan AGENTS.md als projectinstructie lezen als een project geen CLAUDE.md bevat.
- De instelling is te wijzigen via Project instructions in /config; de functie is nog niet beschikbaar op Amazon Bedrock, Google Vertex AI en Azure AI Foundry.
- AGENTS.md is bedoeld voor vaste repositoryregels, terwijl SKILL.md herbruikbare, taakgerichte vaardigheden verpakt.
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: What changed in Claude Code version 2.1.277, released on September 18, 2026, regarding support for the open AGENTS.md project-instructions f. Article summary: Claude Code 2.1.277 adds native, opt-in-configurable fallback support for `AGENTS.md`: a repository without `CLAUDE.md` can now supply Claude Code’s project instructions through the shared open format instead. It is a fa. Topic tags: general, general web, user generated. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
Claude Code 2.1.277 ondersteunt nu het open bestandsformaat AGENTS.md als terugvaloptie voor projectinstructies. In de standaardconfiguratie leest Claude Code AGENTS.md wanneer er in het project geen CLAUDE.md staat. Daardoor kunnen repositories die al één gedeeld instructiebestand voor coding agents gebruiken, ook met Claude Code werken zonder eerst een Claude-specifiek bestand toe te voegen. 1
De standaardregel: fallback, geen automatische combinatie
De praktische werking is als volgt:
- Geen
CLAUDE.mdin het project: Claude Code kanAGENTS.mdals projectinstructie gebruiken.1
- Wel een
CLAUDE.mdaanwezig:CLAUDE.mdblijft het bestaande instructiebestand. De aangekondigde standaard-fallback betekent niet dat beide bestanden automatisch worden samengevoegd.
Via Project instructions in /config kan de gebruiker dit gedrag inschakelen of aanpassen. De ondersteuning is voorlopig niet beschikbaar voor Claude Code-deployments op Amazon Bedrock, Google Vertex AI en Azure AI Foundry. 1
Wat is AGENTS.md?
AGENTS.md is een open Markdown-conventie voor aanwijzingen die specifiek zijn voor een repository — kort gezegd: een README voor agents. Het bestand kan bijvoorbeeld projectcontext, installatie-instructies, build- en testcommando's, codeconventies en bijdragerafspraken bevatten. 19
32
Het formaat kwam voort uit samenwerking tussen partijen in het ecosysteem rond AI-softwareontwikkeling, waaronder OpenAI Codex, Amp, Google Jules, Cursor en Factory. Het beheer ligt bij de Agentic AI Foundation onder de Linux Foundation. Volgens het project wordt het formaat gebruikt in meer dan 60.000 opensourcerepositories. 19
21
Tot de genoemde ecosystemen behoren onder meer OpenAI Codex, Google Jules, Cursor, GitHub Copilot coding agent, Gemini CLI, Aider, Zed, Warp, VS Code, Devin, JetBrains Junie, Factory, Goose en OpenCode. Per tool kunnen de regels voor het vinden en inladen van bestanden echter verschillen; de aanwezigheid van een AGENTS.md garandeert dus niet overal exact hetzelfde gedrag. 19
Minder dubbel onderhoud voor teams
Voor native ondersteuning moesten teams die AGENTS.md als gedeelde conventie gebruikten vaak daarnaast een CLAUDE.md bijhouden, een symbolische link maken naar AGENTS.md, of een klein CLAUDE.md-bestand gebruiken dat het gedeelde bestand importeerde. Die import- en symlinkconstructies waren eerdere workarounds, omdat Claude Code AGENTS.md nog niet zelf inlas. 10
De nieuwe fallback neemt die extra onderhoudsstap weg voor repositories die geen Claude-specifieke projectinstructies nodig hebben. Eén gedeeld bestand kan daarmee de basisregels leveren aan Claude Code én aan andere compatibele hulpmiddelen.
Dat maakt de verschillende instructiesystemen overigens niet volledig uitwisselbaar. Teams doen er goed aan per coding agent te controleren hoe bestanden worden gevonden, hoe instructies in submappen worden toegepast en wat er gebeurt bij mogelijke conflicten.
AGENTS.md en SKILL.md hebben verschillende rollen
AGENTS.md en SKILL.md vullen elkaar aan, maar zijn geen alternatieven voor elkaar.
AGENTS.mdbevat doorlopende aanwijzingen op repositoryniveau: de vaste context en regels voor werk in één codebase.19
32
SKILL.mdhoort bij een Agent Skill: een herbruikbaar pakket op het bestandssysteem met instructies, metadata en eventueel aanvullende bestanden. Claude gebruikt zulke skills wanneer ze relevant zijn, bijvoorbeeld voor specialistische workflows of domeinkennis.33
Claude Code stelt dat zijn skills de cross-toolstandaard Agent Skills volgen. In de documentatie wordt een projectskill bijvoorbeeld geplaatst in een map als .claude/skills/<naam>/SKILL.md. 37
39
Grenzen van de nieuwe ondersteuning
Deze release voegt een fallback voor instructiebestanden toe, maar brengt niet automatisch volledige gelijkheid met alle conventies voor andere agents.
Zo is de gedocumenteerde locatie voor Claude Code-projectskills .claude/skills/<naam>/SKILL.md. De changelog van 2.1.277 kondigt ondersteuning voor AGENTS.md als projectinstructie aan, maar niet het automatisch vinden van een map .agents/skills/. 1
37
Ook moet de fallback niet worden opgevat als een algemene samenvoegregel voor CLAUDE.md en AGENTS.md. Als een repository zowel portable regels als Claude-specifiek gedrag nodig heeft, is het verstandiger die relatie expliciet vast te leggen dan alleen op de fallback te vertrouwen.
Handige indeling voor bestaande Claude Code-projecten
Voor een project dat al op CLAUDE.md leunt, ligt deze verdeling voor de hand:
- Zet algemene, toolonafhankelijke repositoryregels in
AGENTS.md. - Gebruik
CLAUDE.mdvoor instructies die uitsluitend voor Claude Code bedoeld zijn. - Verwijs of importeer vanuit
CLAUDE.mdwaar passend expliciet naar de gedeelde richtlijnen, in plaats van ervan uit te gaan dat beide bestanden altijd samen worden geladen.
Zo blijft de algemene documentatie bruikbaar voor meerdere tools, zonder dat Claude-specifieke workflows verdwijnen. Claude Code 2.1.277 is daarmee een betekenisvolle stap voor interoperabiliteit: een repository die primair op AGENTS.md is ingericht, kan nu met Claude Code werken wanneer CLAUDE.md ontbreekt — maar instructie- en skilldetectie werken nog niet overal hetzelfde.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Claude Code krijgt AGENTS.md-fallback, maar geen automatische samenvoeging"?
Claude Code 2.1.277, uitgebracht op 18 september 2026, kan AGENTS.md als projectinstructie lezen als een project geen CLAUDE.md bevat.
What are the key points to validate first?
Claude Code 2.1.277, uitgebracht op 18 september 2026, kan AGENTS.md als projectinstructie lezen als een project geen CLAUDE.md bevat. De instelling is te wijzigen via Project instructions in /config; de functie is nog niet beschikbaar op Amazon Bedrock, Google Vertex AI en Azure AI Foundry.
What should I do next in practice?
AGENTS.md is bedoeld voor vaste repositoryregels, terwijl SKILL.md herbruikbare, taakgerichte vaardigheden verpakt.