Press enter or click to view image in full size

Member-only story

AGENTS.md in Claude Code: What it is and why it matters

Nick Babich

6 min read8 hours ago

AGENTS.md is a Markdown file with instructions that tell AI coding agents how to work with your project. Claude Code supports AGENTS.md natively starting with version 2.1.277 (released in September 2026). This makes it easier to share one set of project instructions across various AI coding tools such as Claude Code, OpenAI Codex, and Cursor.

In this article, I want to answer the most common questions about AGENTS.md

How AGENTS.md works?

AGENTS.md provides a set of instructions for Claude Code that help it better understand your project and the product you’re building.

Imagine you’re using Claude Code to build a website.…