--- title: "AGENTS.md gebruiken in Claude Code en Codex" description: "Codex leest standaard AGENTS.md. Claude Code 2.1.277 of nieuwer leest het als je project geen CLAUDE.md heeft. Wil je beide houden, zet dan @AGENTS.md in je CLAUDE.md." canonical: "https://logbrew.co/nl/guides/agents-md" last_updated: "2026-11-10" --- # AGENTS.md gebruiken in Claude Code en Codex Codex leest standaard `AGENTS.md`. Claude Code 2.1.277 of nieuwer leest het als je project geen `CLAUDE.md` heeft. Wil je beide houden, zet dan `@AGENTS.md` in je `CLAUDE.md`. Getest op 10 november 2026 met Claude Code 2.1.319 en Codex CLI 0.167.0 Door [Furkan Erday](https://github.com/furkanerday). Furkan Erday is de oprichter van LogBrew. Hij bouwt LogBrew elke dag met Claude Code en Codex. Canonical: https://logbrew.co/nl/guides/agents-md ## Wanneer elke agent `AGENTS.md` laadt | Je project bevat | Claude Code | Codex | | --- | --- | --- | | Alleen `AGENTS.md` | Geladen | Geladen | | `AGENTS.md` en `CLAUDE.md` | Weggelaten | Geladen | | Een `CLAUDE.md` die `@AGENTS.md` importeert | Geladen | Geladen | | Een `CLAUDE.md` als symlink naar `AGENTS.md` | Geladen | Geladen | | `AGENTS.md` en `CLAUDE.local.md` | Weggelaten | Geladen | We lazen de instructies die elke agent met zijn eerste verzoek stuurde. ## 1 bestand voor beide agents ### Schrijf AGENTS.md in de hoofdmap van het project Zet je buildopdrachten, testopdrachten en coderegels in 1 bestand. Beide agents lezen het vanaf de hoofdmap van je Git-repository tot aan je huidige map. ### Werk Claude Code bij Vanaf versie 2.1.277 leest Claude Code `AGENTS.md` zelf. Oudere versies hebben de import uit de volgende stap nodig. ```bash claude update ``` ### Importeer AGENTS.md in je CLAUDE.md Staat er een `CLAUDE.md`, `.claude/CLAUDE.md` of `CLAUDE.local.md` in je map of erboven, dan leest Claude Code `AGENTS.md` niet. Zet deze regel in je `CLAUDE.md` om beide te laden. ```bash @AGENTS.md ``` ### Of koppel CLAUDE.md aan AGENTS.md Bevat je `CLAUDE.md` alleen de import, maak er dan een symlink van. ```bash ln -s AGENTS.md CLAUDE.md ``` ### Of laad beide met een instelling Wil je een `CLAUDE.local.md` houden en toch `AGENTS.md` laden, zet dit dan in `~/.claude/settings.json`. In een sessie stelt de optie Project instructions in `/config` dezelfde waarde in. ```bash { "pluginConfigs": { "cc-plugin-agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` ### Controleer wat Codex heeft geladen Voer dit uit in de map waarin je werkt. De documentatie van Codex geeft deze opdracht om Codex de geladen instructies te laten herhalen. ```bash codex --ask-for-approval never "Summarize the current instructions." ``` ## Wat we zagen in onze test We lieten beide agents met een lokale testserver praten en lazen de instructies die elke agent met zijn eerste verzoek stuurde. Zo zie je precies welke bestanden elke agent laadt. Claude Code laadde `AGENTS.md` als het project geen `CLAUDE.md` had, en het debuglog meldde `no CLAUDE.md found; AGENTS.md loaded`. Met een `CLAUDE.md` ernaast liet Claude Code `AGENTS.md` weg. Met de import `@AGENTS.md` of de symlink verscheen de tekst van `AGENTS.md` precies 1 keer. De instelling `pluginConfigs` hierboven laadde beide bestanden, ook met een `CLAUDE.local.md` in het project. Codex laadde eerst `~/.codex/AGENTS.md`, daarna de `AGENTS.md` in de hoofdmap en daarna het bestand in de huidige map. Een `AGENTS.override.md` verving de `AGENTS.md` in dezelfde map. Codex sloeg een `CLAUDE.md` over tot we die aan `project_doc_fallback_filenames` toevoegden. Bestonden beide bestanden, dan laadde Codex alleen `AGENTS.md`, ook met de fallback ingesteld. ## AGENTS.md vs CLAUDE.md Codex leest `AGENTS.override.md` of `AGENTS.md` in elke map, plus de globale `~/.codex/AGENTS.md`, standaard tot 32 KiB in totaal. Het leest `CLAUDE.md` alleen als je dat opneemt in `project_doc_fallback_filenames`. Claude Code leest eerst `CLAUDE.md`. Het leest `AGENTS.md` en `.claude/AGENTS.md` alleen als er geen project-`CLAUDE.md` geldt. Je persoonlijke `~/.claude/CLAUDE.md` telt niet mee, dus die laadt naast `AGENTS.md`. ## Wat de meldingen op GitHub zeggen #6235, met 409 reacties, vroeg om ondersteuning voor AGENTS.md in Claude Code. Op 17 augustus 2026 sloot een engineer van Anthropic de melding met de import en de symlink hierboven. Nu leest Claude Code het bestand zelf. #31005 vraagt ook om ondersteuning voor `.agents/skills/` en staat nog open. ## Veelgestelde vragen ### Leest Claude Code AGENTS.md? Ja, vanaf versie 2.1.277, als er geen `CLAUDE.md`, `.claude/CLAUDE.md` of `CLAUDE.local.md` in je map of erboven staat. We hebben het bevestigd op 2.1.319. ### Gebruik ik AGENTS.md of CLAUDE.md? Gebruik `AGENTS.md` als iemand in je team Codex of een andere agent gebruikt. Houd alleen een `CLAUDE.md` voor regels die alleen voor Claude Code gelden, en importeer daarin `@AGENTS.md`. ### Kan ik CLAUDE.md als symlink naar AGENTS.md maken? Ja. In onze test laadde Claude Code het gekoppelde bestand 1 keer, net als bij de import. ### Leest Codex CLAUDE.md? Niet standaard. Zet `project_doc_fallback_filenames = ["CLAUDE.md"]` in `~/.codex/config.toml`. ## Geef je agent je productiefouten Koppel de LogBrew MCP-server, en Claude Code of Codex leest de fouten, logs en traces van de projecten die je goedkeurt. Begin met het ruime gratis abonnement, zonder creditcard. [Koppel je agent](https://logbrew.co/nl/agents) ## Bronnen - [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md) - [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235) - [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005) ## Meer handleidingen voor AI-coding-agents - [Een MCP-server toevoegen aan Claude Code en Codex](https://logbrew.co/nl/guides/mcp-server-claude-code-codex) - [Claude overloaded error 529 en rate limit error 429 oplossen](https://logbrew.co/nl/guides/claude-overloaded-rate-limit-error) - [Fouten oplossen in Claude Code, Codex en browser-JavaScript](https://logbrew.co/nl/guides)