Claude Code 2.1.277 will read AGENTS.md when a repo has no CLAUDE.md
Thariq Shihipar: Anthropic’s agent now falls back to the OpenAI/Agentic AI Foundation instruction file. CLAUDE.md still wins if present. Built as a native “mod.” Not on Bedrock, Vertex or Foundry at launch.
Feature1 minEasy
James Okonkwo1 min read
- Claude Code
- AGENTS.md
- Anthropic
- OpenAI
- Agentic AI Foundation

Photo: The RegisterSource page
Claude Code 2.1.277 will read AGENTS.md when a folder has no CLAUDE.md. Thariq Shihipar, an engineer on the product, posted the change on Friday. Users can toggle it under Project instructions in `/config`. Thomas Claburn at The Register wrote that teams using Claude Code beside Codex or other agents have been keeping two Markdown files, or a symlink, so the same conventions reach both tools. AGENTS.md is the schema-free instruction file OpenAI released in 2025 and later contributed to the Linux Foundation’s Agentic AI Foundation; more than 60,000 open-source projects had adopted it by the foundation’s December 2025 launch, Runtime Wire noted, with support already in Codex, Cursor, Devin, Gemini CLI and Copilot.
CLAUDE.md still wins if it is there. Runtime Wire, from the release notes, said the fallback is unavailable on Amazon Bedrock, Google Vertex AI and Microsoft Foundry at launch. Shihipar said the feature was built as a native “mod,” Anthropic’s coming hook for changing the Claude Code harness, and published the mod’s source. Four modes: CLAUDE.md only, AGENTS.md as fallback (the default), both, or centrally managed instructions only. A repo’s `.claude/settings.json` cannot set those options; managed settings can. Thibault Sottiaux, OpenAI’s head of core product, replied to Shihipar: “Yay! This is the way. Come to the light.” The handshake emoji went back. For a multi-agent repo, the practical change is one fewer duplicate file.


