Skip to content
Proposals/Enable AGENTS.md as Claude Code project instruct
proposaldeveloperP5Worth a lookClaude Code

Enable AGENTS.md as Claude Code project instructions in /config

Upgrade to Claude Code v2.1.277 so a repo with no CLAUDE.md loads AGENTS.md instead. Set that file under Project instructions in /config. Skip this on Bedrock, Vertex, or Foundry, which do not have the feature yet.

Why this loop

v2.1.277 makes AGENTS.md the project-instruction file whenever CLAUDE.md is missing, and you change that path under Project instructions in /config. Repos that already keep AGENTS.md for other coding agents can share that file instead of maintaining a parallel CLAUDE.md that drifts. A leftover CLAUDE.md still wins, so delete duplicates rather than keeping two copies. This mapping is not on Bedrock, Vertex, or Foundry, so those hosts should keep CLAUDE.md. Headless and SDK (claude -p) startup also no longer waits on the per-directory CLAUDE.md lookup before the first turn, which fits putting instructions in one known file at the project root.

Proposed actions

  1. Run: claude update && claude --version # require v2.1.277+; AGENTS.md support is not on Bedrock, Vertex, or Foundry
  2. In the project root, keep AGENTS.md and omit CLAUDE.md so v2.1.277 loads AGENTS.md: ls CLAUDE.md AGENTS.md 2>/dev/null; test ! -f CLAUDE.md && test -f AGENTS.md && echo "Claude Code will load AGENTS.md"
  3. Open Claude Code, run /config, and set "Project instructions" to AGENTS.md (unavailable on Bedrock, Vertex, or Foundry).
  4. If CLAUDE.md only duplicates existing AGENTS.md, delete CLAUDE.md so Claude Code reads the shared AGENTS.md instead of the Claude-only copy.

Agent prompt

Paste into your agent or query via MCP (get_agent_prompt) — free, no extra AI cost

Paste into Claude Code / CLAUDE.md task

DevAgentRadar → Claude Code

You are helping me adopt a real coding-assistant change. Work only from the facts below. Do not invent features.

Context

Assistant: Claude Code Proposal: Enable AGENTS.md as Claude Code project instructions in /config Summary: Upgrade to Claude Code v2.1.277 so a repo with no CLAUDE.md loads AGENTS.md instead. Set that file under Project instructions in /config. Skip this on Bedrock, Vertex, or Foundry, which do not have the feature yet. Primary source: https://github.com/anthropics/claude-code/releases/tag/v2.1.277

Why it matters

v2.1.277 makes AGENTS.md the project-instruction file whenever CLAUDE.md is missing, and you change that path under Project instructions in /config. Repos that already keep AGENTS.md for other coding agents can share that file instead of maintaining a parallel CLAUDE.md that drifts. A leftover CLAUDE.md still wins, so delete duplicates rather than keeping two copies. This mapping is not on Bedrock, Vertex, or Foundry, so those hosts should keep CLAUDE.md. Headless and SDK (claude -p) startup also no longer waits on the per-directory CLAUDE.md lookup before the first turn, which fits putting instructions in one known file at the project root.

Suggested actions

  1. Run: claude update && claude --version # require v2.1.277+; AGENTS.md support is not on Bedrock, Vertex, or Foundry

  2. In the project root, keep AGENTS.md and omit CLAUDE.md so v2.1.277 loads AGENTS.md: ls CLAUDE.md AGENTS.md 2>/dev/null; test ! -f CLAUDE.md && test -f AGENTS.md && echo "Claude Code will load AGENTS.md"

  3. Open Claude Code, run /config, and set "Project instructions" to AGENTS.md (unavailable on Bedrock, Vertex, or Foundry).

  4. If CLAUDE.md only duplicates existing AGENTS.md, delete CLAUDE.md so Claude Code reads the shared AGENTS.md instead of the Claude-only copy.

Config surfaces this release may change

  • agent context files (high confidence) — check your repo before applying
  • background and headless runs (high confidence) — check your repo before applying
  • skills (high confidence) — check your repo before applying
  • sandbox settings (high confidence) — check your repo before applying
  • subagent definitions (high confidence) — check your repo before applying
  • MCP servers — check your repo before applying
  • hooks — check your repo before applying
  • permission rules — check your repo before applying

After you finish

Do not report this as applied to DevAgentRadar. You cannot write the visitor's loop.

Tell the human: open https://devagentradar.com/proposals/claude-code-v2-1-277-enable-agents-md-as-claude-code-project-instruction and mark Applied, Skipped, or Failed. Proposal id: f60eefa9-63ba-4d02-9bac-ae6b83b59232

Your job

  1. Restate the change in one sentence.
  2. Propose a minimal plan for my repo (or a throwaway pilot).
  3. Implement only what I approve; prefer small diffs and tests.
  4. Call out risks (permissions, breaking APIs, cost).

Start by confirming you understood the proposal.

agentmcpmodelsecurityideRelease source ↗

Your loop

This browser · no sign-in · not shared as “you”

After you run the prompt

Only you can mark this. Agents cannot write your loop.

Your decision stays on this device. A public tally appears after a few votes.

Originating release signal

Claude Codev2.1.277Sep 18, 2026

v2.1.277

Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under "Project instructions" in /config (not yet on Bedrock, Vertex or Foundry) · Added CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 for Claude apps gateways whose only egress is a forward proxy: every outbound request hands the proxy the hostname instead of resolving it locally · Added an optional headers: map on Claude apps gateway upstreams, to send static headers to a proxy you run in front of a provider · +92 more changes
Verified excerpt — the source's own words

What's changed

  • Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under "Project instructions" in /config (not yet on Bedrock, Vertex or Foundry)
  • Added CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 for Claude apps gateways whose only egress is a forward proxy: every outbound request hands the proxy the hostname instead of resolving it locally
  • Added an optional headers: map on Claude apps gateway upstreams, to send static headers to a proxy you run in front of a provider
  • Added a line saying a background task's update is waiting when it finishes while a panel such as /tasks is open
  • Fixed claude -p and Agent SDK sessions that could hang with no result after an internal error; they now report the error and exit with code 1
  • Fixed conversations failing every request with "text content blocks must be non-empty" when an earlier assistant turn held an empty text block beside other content, including after --resume
  • Fixed being unexpectedly logged out when an older Claude Code build (for example an IDE extension's bundled CLI) runs on the same machine as the current one

Excerpt ends here — this release continues at the source ↗.

Primary source ↗