{"version":1,"type":"story","url":"https://digestai.news/story/claude-code-loads-agents-md-only-when-telemetry-is-enabled","json":"https://digestai.news/story/claude-code-loads-agents-md-only-when-telemetry-is-enabled.json","markdown":"https://digestai.news/story/claude-code-loads-agents-md-only-when-telemetry-is-enabled.md","slug":"claude-code-loads-agents-md-only-when-telemetry-is-enabled","headline":"Claude Code loads agents.md only when telemetry is enabled","summary":"A Hacker News post reports that Claude Code 2.1.277 introduced support for AGENTS.md, but the built‑in agents‑md plugin is disabled by default (isOnByDefault false). The plugin checks a remote feature flag, and when the flag cannot be fetched the file is never read. The author tested an empty directory containing an AGENTS.md with a canary word and found that setting either CLAUDECODEDISABLENONESSENTIALTRAFFIC=1 or DISABLETELEMETRY=1 prevented the file from loading, with no warning displayed.\n\nA session‑level override that clears the environment variables works from the second session onward, and using a CLAUDE.md file with an @AGENTS.md import also bypasses the gate. The workaround requires an extra file per repository, which defeats the purpose of the AGENTS.md feature. The author argues that privacy settings should not silently disable local instruction files and suggests a startup warning or a global AGENTS.md location to avoid the problem.","keyPoints":["Claude Code 2.1.277 adds AGENTS.md support, but the agents‑md plugin is off by default.","Disabling telemetry via CLAUDECODEDISABLENONESSENTIALTRAFFIC=1 or DISABLETELEMETRY=1 blocks AGENTS.md loading with no warning.","A session‑level override or CLAUDE.md @import can restore functionality, but adds extra files per repo."],"whyItMatters":"The issue shows that privacy settings can unintentionally disable local instruction files, impacting developer workflows and trust in Anthropic's tooling.","category":{"slug":"agents","name":"Agents & Tools","url":"https://digestai.news/category/agents"},"entities":{"companies":["Anthropic"],"models":[],"people":[]},"firstPublishedAt":"2026-09-23T12:15:33Z","updatedAt":"2026-09-23T12:15:33Z","sourceCount":1,"hasPrimarySource":false,"sources":[{"outlet":"blog.szypowi.cz","title":"Claude Code reads AGENTS.md only when telemetry is on","url":"https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on","publishedAt":"2026-09-23T12:15:33Z","type":"press","primary":false,"lead":true}],"sourceNotes":null,"discussions":[{"site":"Hacker News","url":"https://news.ycombinator.com/item?id=49814947","points":68}],"thread":null,"cite":{"text":"Digest AI, \"Claude Code loads agents.md only when telemetry is enabled\", 23 September 2026, https://digestai.news/story/claude-code-loads-agents-md-only-when-telemetry-is-enabled","publisher":"Digest AI","title":"Claude Code loads agents.md only when telemetry is enabled","datePublished":"2026-09-23T12:15:33Z","url":"https://digestai.news/story/claude-code-loads-agents-md-only-when-telemetry-is-enabled"},"generatedBy":"Written by Digest AI's editorial model from the linked sources; the sources are the record.","license":"Headlines, digests and key points are written by Digest AI and may be quoted with a link to the story page. Linked articles belong to their publishers. Terms: https://digestai.news/terms#reuse"}