AGENTS.md

Simpele Uitleg

AGENTS.md is een open standaard die AI-codeeragenten vertelt hoe ze met jouw project moeten werken. Het is vergelijkbaar met CLAUDE.md, maar dan voor alle AI-tools tegelijk: Cursor, OpenAI Codex, en meer. Eén bestand, meerdere tools. Denk aan een universele briefing die elke AI-assistent begrijpt.

Technische Definitie

AGENTS.md is een Markdown-gebaseerde standaard voor het instrueren van AI coding agents. Het bestand wordt in de projectroot geplaatst en bevat projectcontext, codestandaarden en architectuurbeslissingen. De standaard wordt ondersteund door 20.000+ open-source projecten en tools als OpenAI Codex, Cursor en Amp. Claude Code ondersteunt AGENTS.md niet native, maar je kunt het importeren via @AGENTS.md in je CLAUDE.md-bestand.

Waarom Dit Belangrijk Is

Steeds meer teams gebruiken meerdere AI-tools naast elkaar. De ene developer werkt met Claude Code, de andere met Cursor, een derde met Codex. Zonder gedeelde instructies levert elke tool andere code op — andere conventies, andere structuur, andere kwaliteit.

AGENTS.md lost dit op. Je schrijft één bestand met je projectafspraken, en elke AI-tool die de standaard ondersteunt, volgt dezelfde regels. Dat is vooral belangrijk voor teams die AI breed inzetten en niet willen dat de toolkeuze bepaalt hoe de code eruitziet.

Voor Claude Code gebruik je CLAUDE.md voor Claude-specifieke instructies en importeer je AGENTS.md voor de universele afspraken. Zo heb je het beste van beide werelden.

Hoe Het Werkt

Je maakt een bestand genaamd AGENTS.md in de root van je project. Daarin beschrijf je dezelfde informatie als in een CLAUDE.md: frameworks, buildcommando's, codestandaarden, architectuurbeslissingen. Het verschil is dat AGENTS.md door meerdere tools wordt gelezen.

Tools als Cursor en OpenAI Codex laden AGENTS.md automatisch. Voor Claude Code voeg je één regel toe aan je CLAUDE.md: @AGENTS.md. Claude Code importeert dan de inhoud alsof het onderdeel is van CLAUDE.md.

De standaard groeit snel. Tienduizenden projecten op GitHub bevatten al een AGENTS.md. Voor development teams die met meerdere AI-tools werken is het de logische manier om consistentie te waarborgen. Meer leren over agentic workflows? Bekijk de Claude Code Masterclass.

Use Cases

Multi-tool teams

Een development team waar sommigen Claude Code gebruiken en anderen Cursor. Met AGENTS.md volgen alle tools dezelfde codestandaarden, ongeacht welke AI iemand prefereert.

Open-source projecten

Een open-source project met contributors die verschillende AI-tools gebruiken. AGENTS.md zorgt dat elke AI-assistent de projectconventies kent — van naamgeving tot teststructuur.

Gecombineerd met CLAUDE.md

Gebruik AGENTS.md voor universele projectafspraken en CLAUDE.md voor Claude-specifieke instructies (zoals subagent-configuratie). Importeer AGENTS.md in CLAUDE.md via @AGENTS.md.

Team-breed AI standaardiseren

De kracht van AGENTS.md is dat het toolonafhankelijk is. In AI als Teamsport leer je hoe je dit soort standaarden inzet zodat elk teamlid — ongeacht hun toolkeuze — consistente AI-output krijgt.

Voorbeelden

AGENTS.md vs. CLAUDE.md

AGENTS.md is de universele briefing: "We gebruiken TypeScript, Tailwind, en Vitest." Elke AI-tool begrijpt dit.

CLAUDE.md is Claude-specifiek: "Gebruik /init om het project te analyseren, schrijf commits in het Nederlands, en gebruik de Explore-agent voor codebase-zoeken."

De twee vullen elkaar aan. Importeer AGENTS.md in CLAUDE.md voor het beste van beide.

Ondersteunde tools

AGENTS.md wordt native ondersteund door OpenAI Codex, Cursor, Amp, en tientallen andere tools. Claude Code ondersteunt het via import. VS Code Copilot-ondersteuning is in ontwikkeling. De adoptie groeit snel — meer dan 20.000 open-source projecten gebruiken het al.

Veelgemaakte Fouten

"AGENTS.md vervangt CLAUDE.md"

Ze vullen elkaar aan. AGENTS.md bevat universele projectafspraken die elke tool begrijpt. CLAUDE.md bevat Claude Code-specifieke instructies (subagents, skills, hooks). Gebruik beide voor het beste resultaat.

"Claude Code leest AGENTS.md automatisch"

Claude Code ondersteunt AGENTS.md niet native. Je moet het importeren door @AGENTS.md toe te voegen aan je CLAUDE.md-bestand. Dan wordt de inhoud meegeladen als onderdeel van de projectinstructies.

"Ik heb AGENTS.md niet nodig als ik alleen Claude Code gebruik"

Als je team alleen Claude Code gebruikt, volstaat CLAUDE.md. Maar als je ooit switcht of combineert met andere tools, heb je AGENTS.md al klaar. Het is ook nuttig voor open-source projecten waar contributors verschillende tools gebruiken.

Tools Die Dit Gebruiken

OpenAI CodexCursorAmpClaude Code (via import)

Veelgestelde Vragen

Wat is het verschil tussen AGENTS.md en CLAUDE.md?

AGENTS.md is een open standaard die door meerdere AI-tools wordt gelezen (Codex, Cursor, Amp). CLAUDE.md is specifiek voor Claude Code en ondersteunt extra features als subagents, skills en hooks. Gebruik AGENTS.md voor universele projectafspraken en CLAUDE.md voor Claude-specifieke configuratie.

Hoe gebruik ik AGENTS.md met Claude Code?

Voeg @AGENTS.md toe aan je CLAUDE.md-bestand. Claude Code importeert dan automatisch de inhoud. Je kunt ook een symlink maken van AGENTS.md naar CLAUDE.md als je maar één bestand wilt onderhouden.

Welke AI-tools ondersteunen AGENTS.md?

OpenAI Codex, Cursor, Amp en tientallen andere tools laden AGENTS.md native. Claude Code ondersteunt het via import. VS Code Copilot-ondersteuning is in ontwikkeling. De standaard wordt beheerd op agents.md en groeit snel.

Moet ik AGENTS.md in mijn project hebben?

Als je team meerdere AI-tools gebruikt of je project is open-source, is AGENTS.md sterk aan te raden. Als je alleen Claude Code gebruikt, volstaat CLAUDE.md. Maar AGENTS.md toevoegen kost weinig moeite en maakt je project toekomstbestendig.

Gerelateerde Termen

Claude Code AI Agent Subagents MCP Prompt Engineering Cursor Codex

Wil je deze term in de praktijk leren toepassen?

Bekijk Trainingen Plan Kennismaking