Tutorials
When Claude Code reads AGENTS.md, and when it does not
The author looks at when Claude Code skips AGENTS.md because a CLAUDE.md is already present, and lists ways to make the rules apply.
On 10 October 2026 @torfinpd posted an analysis of when Claude Code reads AGENTS.md: if a CLAUDE.md is already present, AGENTS.md may never be opened, and what that means in repositories that ship both files. A related X article the post quotes, https://x.com/i/article/2107149896969031680 , was still unavailable on 15 November 2026, so this page relies only on the still-available post and not on that article. Figures cited in the post stay with the original; this page does not retell the full argument.
After you upgrade Claude Code, open your own repository and see which rules file actually loads. If the project agreement lives in AGENTS.md, check whether you need to reference it from CLAUDE.md, or use another approach the author describes. Likes and reposts were captured on 15 November 2026.
This page is a guide, not the original text.
Note (verified 15 November 2026): This post discusses when Claude Code reads AGENTS.md. Product behavior may have changed since then. The original post was not reopened in this review, and there was no reputation sample from the past one to three months.
In this category
- Tutorials
Generative AI for Beginners
Microsoft’s beginner course: lessons that connect prompting, apps, and retrieval.
microsoft - Tutorials
AI Agents for Beginners
Microsoft’s 18-lesson course, from chat to tool calls and multi-step tasks.
microsoft - Tutorials
Claude Cookbooks
Anthropic’s notebooks of concrete Claude recipes, closer to runnable code than a product page.
anthropics