Claude Code Finally Reads AGENTS.md After 13-Month Standoff

Claude Code 2.1.277 now automatically reads AGENTS.md when no CLAUDE.md exists, ending the highest-voted feature request in the project's history.

@sharedot

Claude Code Finally Reads AGENTS.md After 13-Month Standoff

By @sharedot · · 7 pages

  • Programming
  • Claude Code
  • Agents Md
  • Open Source
  • Developer Tools

Claude Code 2.1.277 now automatically reads AGENTS.md when no CLAUDE.md exists, ending the highest-voted feature request in the project's history.

Claude Code caves on AGENTS.md

Anthropic has shipped support for the universal AGENTS.md instruction format in Claude Code version 2.1.277. According to 36Kr, core engineer Thariq announced the change on X in a thread that topped one million views within an hour, and the GitHub release notes list the change on their first line.

From this version on, if a project folder contains no CLAUDE.md, Claude will automatically locate and read AGENTS.md instead.

36Kr notes the request had been open on GitHub since August 2025, accumulating more than 5,200 likes and over 300 comments — the highest-voted feature request in the entire Claude Code repository, four times the votes of the runner-up.

Tibo, head of the Codex team, reportedly welcomed the news with the comment "Yay! This is the way. Come to the light."

Why teams begged for it

The frustration was practical: mixed-tool teams were maintaining two nearly identical instruction manuals for the same repository.

36Kr reports that developers resorted to soft-linking CLAUDE.md to AGENTS.md, writing an @AGENTS.md import line inside CLAUDE.md, or even installing startup hooks that printed AGENTS.md content into every new Claude conversation.

The stakes were real — update one manual and forget the other, and the AI would build code against an outdated spec that contradicted team conventions.

AGENTS.md, launched by OpenAI in August 2025, is already supported by Codex, Cursor, GitHub Copilot, Gemini CLI and Devin, and per 36Kr more than 60,000 open-source projects have adopted it.

OpenAI donated the format to the Agentic AI Foundation under the Linux Foundation last December — a foundation whose platinum members include Anthropic itself, which also donated MCP there.

The real story: mods

According to 36Kr, the deeper reveal came in Thariq's second thread: AGENTS.md support is implemented as a Claude Code "mod," a plugin mechanism for customizing the harness — the underlying runtime framework of the tool itself.

AGENTS.md is the first built-in mod, with its source code published in the mods/agents-md directory of the official repository.

36Kr quotes Thariq saying developers will in future be able to make custom versions of how project instructions are read, meaning what Claude Code reads and how will no longer be decided by Anthropic alone.

Community members reportedly began dissecting the mod hook mechanism and lifecycle the same day.

36Kr frames the contrast with DeepSeek Harness, the "everything is a plugin" framework open-sourced a month ago that has drawn 229,000 GitHub stars: mods open modification ports on a finished product rather than rebuilding from scratch.

Stakes for open-source attribution

The move lands amid broader anxiety about how AI tools treat open-source licensing. devops.com reports that the Ninth Circuit's September 16 decision in Doe v.

GitHub found that AI-generated code lacking copyright management information does not automatically violate Section 1202 of the DMCA, giving GitHub, Microsoft and OpenAI a significant win — though the court explicitly did not decide whether training on open-source code infringes copyright, and license-compliance claims remain before the district court.

OSI executive director Duane O'Brien told devops.com the ruling answered only a narrow DMCA question, while Software Freedom Conservancy's Karen Sadler cautioned it is "very easy to overread this decision."

Against that backdrop, Anthropic adopting a community instruction standard reads as a gesture toward interoperability that open-source developers have been demanding.

What comes next

For working developers, the immediate change is cleanup: repositories already configured with AGENTS.md for Codex, Cursor or Copilot can now be pointed at Claude Code with no CLAUDE.md, no import rules and no settings changes, per 36Kr.

The watch item is the mod ecosystem — if custom mods let teams redefine how agents ingest project instructions, harness customization could become the next battleground in coding-agent tooling, alongside frameworks like DeepSeek Harness.

The broader developer-tooling conversation stays busy: How-To Geek argues Google's open-source Flutter remains the best introduction to building cross-platform apps for mobile, desktop and web.

36Kr's reporting cites Thariq's X thread, the official Claude Code changelog and memory documentation, and the mods/agents-md source in the Anthropic repository for verification.

Sources

  1. eu.36kr.com › Claude Code Fully Open-Source & Integrated with AGENTS.md – Complete Guide
  2. devops.com › US District Court Decision in AI's Favor Worries Open-Source Developers
  3. howtogeek.com › Google's open-source Flutter is the best introduction to creating your own apps

More on Programming