Dev tools

Claude Code 2.1.277 reads AGENTS.md when a project has no CLAUDE.md

September 18, 2026 at 11:45 AM PT

The anthropics/claude-code repository on GitHub

Image: GitHub

Why it mattersTeams that maintain both a CLAUDE.md and an AGENTS.md so different coding agents each find their file can now stop, and projects that only shipped AGENTS.md work in Claude Code with no extra setup.

Anthropic released Claude Code v2.1.277 on 18 September at 18:06 UTC. In a project with no CLAUDE.md, Claude Code now reads AGENTS.md instead, and the file name can be changed under "Project instructions" in the /config menu. The changelog notes that the new behaviour is not yet available on Bedrock, Vertex or Foundry.

Why this file name matters

AGENTS.md started as the convention OpenAI's Codex uses to keep a project's coding-agent instructions in one place, and it spread to Cursor, Aider and a number of smaller CLIs. Claude Code has always looked for CLAUDE.md instead, which is why many open-source repositories carry both files with identical or near-identical contents.

Projects that only ship AGENTS.md now work with Claude Code with no extra setup. Projects that already ship CLAUDE.md are unchanged, because Claude Code still prefers CLAUDE.md when both exist. AGENTS.md is a fallback the tool falls through to when CLAUDE.md is absent.

Other visible changes in this release

The gateway path picked up two options for teams whose only outbound network path is a forward proxy. The new environment variable CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 makes every outbound request hand the proxy the hostname rather than resolving it locally, so a proxy that expects to see hostnames in the request line works as intended. Upstreams in a Claude apps gateway config also accept a headers: map, so a static header can be attached to every request that goes to a provider through a proxy in front of the gateway.

A background task's final update now shows a "waiting" line when it finishes while a panel like /tasks is open, so a completed task no longer sits invisible until the panel is closed.

The fixes that could bite a running team

Two of the fixes affect people who saw failures that looked opaque. claude -p and Agent SDK sessions that hit an internal error could hang with no result; they now report the error and exit with code 1, so a wrapper script can tell that something went wrong. Conversations that failed every request with "text content blocks must be non-empty" after an earlier assistant turn produced an empty text block alongside other content, including after --resume, now go through.

A separate fix restores logins that were being ended by an older Claude Code build running on the same machine, for example the CLI bundled inside a VS Code extension. On a machine with two versions installed, the older one no longer signs the newer one out.

Two rendering fixes are worth noting for anyone using long-running sessions: a rare failure that stopped the screen updating for the rest of the session after an internal rendering error, and a rare Windows case where a turn ended with "Out of memory" right after Claude replied, so the reply's tool calls never ran.

The full changelog lists roughly 40 fixes covering plugin installation, Remote Control sessions, the Edit and Write tools, and /mcp and /plugin manage panels.

Source

Source: Anthropic

This item was written by an AI system from the linked source. Reveneau is responsible for what it publishes.

More from AI News

Claude Code 2.1.275 syncs skills from claude.ai to the terminal and stops plugin install scripts from running

Anthropic released Claude Code v2.1.275 on 17 September at 22:33 UTC. The release syncs skills and plugins enabled on a claude.ai account to any signed-in terminal session, adds a plugin install command that first offers to add the marketplace, and fetches plugins from npm with install scripts disabled.

Source: GitHubDev tools

Anthropic redesigns Claude Code Projects with a coordinator that splits a goal across parallel threads, and warns each thread counts as its own session

The New Stack reports that Anthropic is rolling out a redesigned Claude Code Projects in beta on Pro and Max plans, with a coordinator that breaks an engineering goal into parallel threads, shared memory across them, and the warning that each thread counts as a full Claude Code session against usage limits.

Source: PressDev tools

Anthropic banned a Claude Code account 15 minutes after it was connected to OpenAI's GPT-5.6 Sol through a proxy

The Information reports that Anthropic shut down developer Alex Getman's Claude Code account 15 minutes after he used a proxy to route it to OpenAI's GPT-5.6 Sol, and his posts about the ban got a million views within hours.

Source: PressDev tools