English

PLUS ULTRAProduct LaunchesAnthropicClaude Code

Claude Code supports AGENTS.md but feature is silently disabled when telemetry is off

PLUS ULTRA by Amenoyomi

Anthropic has added support for AGENTS.md in Claude Code (version 2.1.277), released on September 18. In projects where no CLAUDE.md file exists, the tool is designed to read AGENTS.md instead. This feature allows for easier configuration sharing between different AI coding assistants and agents, following industry standards used by tools like GitHub Copilot and Cursor. The ability to use AGENTS.md can be adjusted via the "Project instructions" in the /config settings, though the feature is currently unavailable on Amazon Bedrock, Google Vertex, or Microsoft Foundry.

However, technical reports and GitHub issue #95690 indicate that the AGENTS.md loading mechanism is implemented as a plugin gated by a remote Anthropic feature flag. This means the feature is silently disabled if users have turned off telemetry or non-essential traffic via environment variables such as CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 or DISABLE_TELEMETRY=1. Additionally, users accessing Claude Code through third-party gateways like Bedrock or Vertex face the same issue because the required remote flag cannot be resolved.

Critically, the tool does not provide a warning or error message when the AGENTS.md file is skipped. This silence can lead users to incorrectly conclude that the model is ignoring their instructions when, in fact, the local file was never loaded into the session. Currently, a workaround involves using a single-line CLAUDE.md file that contains an @AGENTS.md import, which functions correctly even with telemetry disabled.

PLUS ULTRAby Amenoyomi

The loading of AGENTS.md is managed by a built-in plugin called agents-md. This plugin is not active by default; it requires a server-side switch known as the tengu_agents_md_mod remote feature flag to be enabled for the file to be read.

Because the plugin depends on this remote flag, any configuration that blocks non-essential traffic—such as setting DISABLE_TELEMETRY=1 or CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1—prevents the flag from being fetched. This also occurs when using third-party gateways like Amazon Bedrock or Google Vertex, where the flag cannot resolve to true, effectively locking the local file reading behind a network requirement.

Since Claude Code provides no warning or error message when this process fails, users are left unaware that their project instructions were skipped. This silent failure creates a risk where users misinterpret the lack of response as the model ignoring instructions or lacking capability, potentially leading them to waste time on unnecessary prompt adjustments.

To bypass this dependency, users can create a CLAUDE.md file containing a single line: @AGENTS.md. This import mechanism does not rely on the remote feature flag and ensures that the instructions in AGENTS.md are loaded regardless of telemetry or gateway settings.

Sources

  1. Claude Code reads AGENTS.md only when telemetry is on (Hacker News Frontpage, 2026-09-23)
  2. Issue #95690
2 more sourcesHide sources
  1. Claude Codeが「AGENTS.md」に対応。CLAUDE.mdが存在しない場合、自動的に読み込み (Publickey, 2026-09-23)
  2. Claude Code Changelog