Claude Code 2.1.277 faces issues loading AGENTS.md without telemetry

by@steipete

Summary

Claude Code 2.1.277 announced support for reading AGENTS.md files, but users have encountered an issue where the file can only be accessed when telemetry is enabled. The current implementation relies on a server-side flag, meaning that if telemetry is turned off, as is common for users concerned with privacy, the local AGENTS.md file remains unread without any warning or indication of the problem. This design choice creates confusion, as users might believe that their instructions are being ignored rather than that the file was never loaded. As a workaround, users can create a one-line CLAUDE.md file that imports AGENTS.md, yet this solution necessitates managing an additional file per project, which undermines the initial purpose of supporting AGENTS.md.

Analysis

agents-md: agents-md is the built-in plugin in Claude Code that handles loading of AGENTS.md files as project instructions when no CLAUDE.md exists. Its registration uses a remote feature flag called tengu_agents_md_mod that defaults to unavailable and prevents the plugin from activating without successful server resolution. The news describes how this gate blocks the feature entirely for users who keep telemetry off, including in third-party gateways. Claude Code: Claude Code is Anthropic's command-line tool for using Claude models in coding workflows and project interactions. It includes built-in support for project instruction files such as CLAUDE.md and AGENTS.md through plugins. The reported issue shows that its AGENTS.md loader depends on a remote feature flag tied to telemetry, so the local file is never read when nonessential traffic is disabled. Privacy Tradeoff: Disabling telemetry or nonessential traffic silently disables an unrelated local file-reading capability without any warning to the user. Feature Dependency: AGENTS.md loading in Claude Code waits on a server-side flag instead of relying solely on the presence of the local file in the working directory. Workaround Availability: A one-line CLAUDE.md file using an @import can load AGENTS.md even when telemetry is disabled, though this requires maintaining an extra file per project.

Categories

ai_agentsaimachine_learning
View Original Tweet