Claude Fixes bug: code reads AGENTS.md only with telemetry enabled
agents claude
| Source: HN | Original article
Claude Code now only reads AGENTS.md when telemetry is enabled, and will ignore it if a CLAUDE.md file exists anywhere in the directory hierarchy.
Claude Code’s handling of the project‑level AGENTS.md file has been corrected after a rollout quirk surfaced on Hacker News. Users discovered that the configuration file – intended to guide the model’s behavior across a codebase – was only being read when telemetry was enabled. The anomaly was traced to a feature‑flag mechanism that allowed Anthropic to disable the functionality remotely; with telemetry turned off, the flag never fired, leaving the file ignored.
Anthropic confirmed the issue and shipped a fix in version v2.1.281, released the same day the bug was reported. The fix restores the expected behavior: Claude Code now checks the working directory and each parent folder for a CLAUDE.md file, falling back to AGENTS.md only when no CLAUDE.md is found. The logic is implemented as a built‑in plugin, which explains why it can be toggled via configuration rather than being hard‑coded.
The episode matters because AGENTS.md is a primary means for developers to embed high‑level instructions without altering source code. When the file is silently ignored, projects can behave unpredictably, eroding trust in the toolchain and raising concerns about hidden dependencies on telemetry settings. It also highlights Anthropic’s reliance on remote feature flags, a practice that can complicate debugging and privacy expectations.
Going forward, observers will watch for any further adjustments to Claude Code’s plugin architecture and for how Anthropic communicates telemetry‑related changes. The community will also be keen to see whether additional safeguards are added to prevent similar rollout artifacts, especially as Claude Code becomes more central to AI‑assisted development workflows.
Sources
Back to AIPULSEN