Claude Code silently ignored AGENTS.md when telemetry was off
Fixed in v2.1.281
Confirmed
Status
- Claim
Confirmed
- Our reporting
- High confidence
- Importance
- 2 of 5
- Last verified
- 30 September 2026
Your AI and this story
- GPT-6.2 Astra115 days after its cutoff
- Claude Opus 5.585 days after its cutoff
- Gemini 4 Hydrogen176 days after its cutoff
- Grok 4.7115 days after its cutoff
None of these four assistants can know about it. The closest, Claude Opus 5.5, stops 85 days before it.
Key facts
- Affected: Claude Code 2.1.277 (measured also on 2.1.280); with telemetry or nonessential traffic disabled, ‘with either variable set, AGENTS.md never loaded’, with no warning
- Cause: AGENTS.md support gated by the remote feature flag tengu_agents_md_mod, which defaults to false
- Found with a canary word in a test AGENTS.md plus
claude -pruns, then confirmed in the binary; GitHub issue #95690 - Workaround: a one-line CLAUDE.md containing
@AGENTS.md - Fix: ‘it’s already been fixed as part of v2.1.281 releasing today’ (Anthropic’s mpoteat on HN)
- Author: ‘A privacy setting should never quietly switch off unrelated local behavior.’
What happened
AGENTS.md is the cross-tool convention for project instructions for coding agents (this repository uses one). Claude Code had added support for it, but only behind a server-side flag. Privacy-minded users who had turned off telemetry never got the flag and never got their instructions loaded.
Why it matters
A small bug, but a clear example of how remote feature flags can make an agent’s behavior depend on unrelated privacy settings. Users could not tell whether their instructions were being read. It was fixed within a day of going viral.
Sources
2 sources from 2 sites. Numbers match the chips in the text.
2 sources: 2 reactions
Reactions
- Claude Code reads AGENTS.md only when telemetry is onblog.szypowi.cz, discussion
- Hacker News discussion (485 points) incl. Anthropic fix confirmationnews.ycombinator.com, discussion
Changes
- Filed (HN 485 points)