AnswersPublished18 sources
Claude Code 2.1.277 Adds AGENTS.md Fallback Support
Claude Code 2.1.277, released September 18, 2026, can read AGENTS.md as project instructions when a project has no CLAUDE.md. The change makes AGENTS.md first repositories easier to use across coding tools, while existing CLAUDE.md based projects still need an intentional strategy for shared and Claude specific guid...
Published byEdited with GPT-5.6 TerraImages generated with GPT Image 2
Research answer
Key takeaways
- Claude Code 2.1.277, released September 18, 2026, can read AGENTS.md as project instructions when a project has no CLAUDE.md.
- The change makes AGENTS.md first repositories easier to use across coding tools, while existing CLAUDE.md based projects still need an intentional strategy for shared and Claude specific guidance.
- AGENTS.md is repository guidance; SKILL.md packages reusable, on demand capabilities.
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: What changed in Claude Code version 2.1.277, released on September 18, 2026, regarding support for the open AGENTS.md project-instructions f. Article summary: Claude Code 2.1.277 adds native, opt-in-configurable fallback support for `AGENTS.md`: a repository without `CLAUDE.md` can now supply Claude Code’s project instructions through the shared open format instead. It is a fa. Topic tags: general, general web, user generated. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
Claude Code 2.1.277 introduces support for the open AGENTS.md convention as a project-instructions fallback. In the documented default case, Claude Code reads AGENTS.md when no CLAUDE.md is present in the project. That lets repositories built around a shared agent-instructions file work with Claude Code without first creating a Claude-specific file. 1
The practical fallback rule
The release behavior is straightforward:
- Project has no
CLAUDE.md: Claude Code can useAGENTS.mdfor project instructions.1
- Project has
CLAUDE.md:CLAUDE.mdremains the established project-instructions file; the release announcement does not describe automatic combination of both files in its default fallback behavior.
The behavior can be enabled or changed in Claude Code’s Project instructions settings, accessed through /config. Anthropic says the feature is not yet supported in Claude Code deployments on Amazon Bedrock, Google Vertex AI, or Azure AI Foundry. 1
Why AGENTS.md matters
AGENTS.md is an open, Markdown-based place for repository-specific guidance for coding agents—often described as a “README for agents.” It can hold the information an agent needs to work safely and consistently: project context, setup steps, build and test commands, conventions, and contribution expectations. 19
32
The format emerged from collaboration involving OpenAI Codex, Amp, Google Jules, Cursor, and Factory, and is stewarded by the Agentic AI Foundation under the Linux Foundation. The project reports adoption in more than 60,000 open-source repositories. 19
21
Its published ecosystem includes tools such as OpenAI Codex, Google Jules, Cursor, GitHub Copilot’s coding agent, Gemini CLI, Aider, Zed, Warp, VS Code, Devin, JetBrains Junie, Factory, Goose, and OpenCode. Support and discovery rules still vary by tool, so a file’s presence does not guarantee identical loading behavior everywhere. 19
The interoperability benefit
Before native support, teams using a shared AGENTS.md convention often had to maintain a separate CLAUDE.md, symlink it to AGENTS.md, or use a small CLAUDE.md that imported the shared file. Earlier guidance documented the import and symlink approaches as workarounds because Claude Code did not natively read AGENTS.md. 10
The new fallback reduces that extra maintenance for repositories that do not need Claude-specific project instructions. A shared file can now provide the baseline guidance to Claude Code as well as to other compatible tools.
That does not make every instruction system interchangeable. Teams should continue to verify how each coding agent discovers files, resolves directory-specific instructions, and handles conflicts.
AGENTS.md versus SKILL.md
AGENTS.md and SKILL.md are complementary formats rather than substitutes.
AGENTS.mdis repository-level guidance: the standing context and rules for working in one codebase.19
32
SKILL.mdis part of an Agent Skill: a reusable filesystem package that can include instructions, metadata, and optional supporting resources. Claude uses skills when relevant to provide specialized workflows or domain knowledge.33
Claude Code says its skills follow the cross-tool Agent Skills standard. In Claude Code documentation, a project skill is organized as a directory containing SKILL.md, for example .claude/skills/<name>/SKILL.md. 37
39
Limits that remain
This release adds an instruction-file fallback; it does not by itself establish universal parity with every agent convention.
In particular, Claude Code’s documented project skill location is .claude/skills/<name>/SKILL.md. The 2.1.277 changelog announcement covers AGENTS.md project instructions and does not announce discovery of a .agents/skills/ directory. 1
37
Likewise, the documented fallback should not be treated as an automatic merge rule for CLAUDE.md and AGENTS.md. If a repository needs both portable rules and Claude-specific behavior, make that relationship explicit rather than relying on the fallback alone.
A sensible layout for existing Claude Code projects
For a project that already relies on CLAUDE.md, a practical split is:
- Put general, cross-tool repository rules in
AGENTS.md. - Keep
CLAUDE.mdfor instructions that are specifically for Claude Code. - Where appropriate, explicitly reference or import the shared guidance from
CLAUDE.mdrather than assuming both files will be loaded together.
This approach preserves portability while keeping Claude-specific workflows separate. Claude Code 2.1.277 is therefore a meaningful interoperability improvement: it makes an AGENTS.md-first repository viable for Claude Code when CLAUDE.md is absent, without claiming that all instruction and skill-discovery conventions now behave the same way.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Claude Code 2.1.277 Adds AGENTS.md Fallback Support"?
Claude Code 2.1.277, released September 18, 2026, can read AGENTS.md as project instructions when a project has no CLAUDE.md.
What are the key points to validate first?
Claude Code 2.1.277, released September 18, 2026, can read AGENTS.md as project instructions when a project has no CLAUDE.md. The change makes AGENTS.md first repositories easier to use across coding tools, while existing CLAUDE.md based projects still need an intentional strategy for shared and Claude specific guidance.
What should I do next in practice?
AGENTS.md is repository guidance; SKILL.md packages reusable, on demand capabilities.