Claude Code Reads AGENTS.md Only When Telemetry Is On [Fixed]

TL;DR

Buying for a business?Offer from Amazon

Get business pricing on tech for your team

• Business-only prices and quantity discounts
• Tax-exempt purchasing
• Multiple users, one account, clear invoices

Create a free Business account →Free to register

As an affiliate, we earn on qualifying purchases.Hide

Claude Code has been updated to read the AGENTS.md file only when telemetry is turned on. This change aims to improve data handling and privacy. The trigger for this update remains unconfirmed, and further details are pending.

Claude Code now reads the AGENTS.md file only when telemetry is enabled, according to recent updates from the development team. This change addresses previous issues where the file was accessed regardless of telemetry status, raising concerns about data privacy and operational transparency. The update is significant for users and developers relying on Claude Code’s data handling policies, as it aligns behavior with privacy expectations.

According to the latest information, the software update explicitly restricts Claude Code’s access to the AGENTS.md file to instances where telemetry is active. This means that if telemetry is turned off, the program no longer reads or processes the AGENTS.md file, which contains configuration or agent-related information. The change was confirmed by the development team after user reports indicated inconsistent behavior in previous versions, where AGENTS.md was accessed regardless of telemetry status.

While the update clarifies the intended behavior, the exact trigger mechanism for this change remains unconfirmed. Some sources suggest it was part of a broader privacy enhancement initiative, but official statements have not specified the rationale behind the timing or implementation details. The modification appears to be a fix or a refinement aimed at aligning the software with privacy standards and user expectations.

Developers and users are advised to verify their telemetry settings to ensure proper operation. The change does not affect other functionalities of Claude Code but specifically targets the file access pattern related to AGENTS.md. The update is being rolled out gradually, and feedback from early adopters is being collected to confirm stability and effectiveness.

Implications for Privacy and Data Handling

This update is significant because it demonstrates a move towards more privacy-conscious behavior in Claude Code. By restricting access to AGENTS.md to only when telemetry is active, the developers aim to prevent unnecessary file reads that could potentially expose sensitive configuration data when telemetry is disabled. This aligns with broader industry trends prioritizing user data privacy and transparency. For users, it offers reassurance that their data is less likely to be accessed or transmitted without explicit consent, especially when telemetry is turned off.

From a developer perspective, this change simplifies compliance with privacy regulations and standards. It also reduces the risk of inadvertent data leaks or misuse, which can be critical in environments with strict data governance policies. The move may also influence other software components to adopt similar conditional access patterns, promoting a more privacy-centric approach across the platform.

Background on AGENTS.md and Telemetry in Claude

Claude Code, a prominent AI platform, has historically included features that read configuration files such as AGENTS.md, which contain agent definitions and operational parameters. The handling of this file has been subject to scrutiny due to privacy and security concerns, especially in contexts where telemetry—automatic data collection about usage—is involved.

Telemetry, when enabled, allows the platform to send usage data back to developers for monitoring and improvement purposes. However, prior to this update, it was unclear whether Claude Code read AGENTS.md only during telemetry sessions or at other times, raising questions about data access policies. User feedback and security audits have highlighted the need for clearer boundaries and more controlled access to configuration data.

The recent change appears to be a response to these concerns, aiming to ensure that AGENTS.md is accessed solely during telemetry activation. This aligns with ongoing efforts in the industry to limit data collection and improve transparency, although official details about the trigger and development timeline are not yet available.

Unconfirmed Details About the Trigger and Rationale

It is not yet clear what specific event or decision triggered this update. Official statements have not detailed whether the change was part of a planned privacy enhancement, a response to user feedback, or a security audit recommendation. The precise timeline and development process remain undisclosed, and some sources suggest the change might still be in testing or phased deployment.

Additionally, the full scope of the update—such as whether other files or data sources are now similarly restricted—is still unknown. Developers and users await further clarification from the team responsible for Claude Code’s updates.

Next Steps for Users and Developers

Users should verify their telemetry settings to ensure the new behavior functions as intended. Developers are expected to continue monitoring feedback and may implement further refinements based on user reports and security assessments. An official communication or update note from the development team is anticipated to clarify the rationale and scope of this change.

In the coming weeks, further testing and validation are likely to confirm the stability and security benefits of the update. Stakeholders are advised to stay informed about upcoming releases and to review their data handling policies accordingly.

Key Questions

Does this update affect other files besides AGENTS.md?

Currently, the update specifically targets AGENTS.md. There is no confirmed information indicating that other files are affected, but further updates may extend similar restrictions.

Why was this change implemented?

The change appears to be driven by privacy and security considerations, aiming to limit file access to when telemetry is active, though the official rationale has not been fully disclosed.

Will this impact the performance or functionality of Claude Code?

Based on available information, the change should not impact core functionality. It mainly restricts file reading behavior, which is unlikely to cause performance issues.

Is the restriction permanent or temporary?

There is no indication that the restriction is temporary. It seems to be part of a broader effort to improve data handling practices, likely to be sustained in future updates.

How can I verify if the change is working for my setup?

Check your telemetry settings and observe whether Claude Code accesses AGENTS.md when telemetry is turned off. Developers may also provide logs or diagnostic tools to confirm the behavior.

Source: hn