Markdown edition

AI-translated from English; not yet reviewed by a fluent editor.

# Maaaring hindi mabasa ng Claude Code ang AGENTS.md kapag naka-off ang telemetry

> Nakadepende sa bersiyon, akses sa feature flag, provider at pagkakasunod-sunod ng mga file ang katutubong suporta ng Claude Code sa AGENTS.md. Hindi kasama sa mga tala ng opsyonal na telemetry ng inilabas na agents-md plugin ang mga path o teksto ng file.

By BIG CHANGE Editorial

Published: 2026-09-23T13:54:58.721Z
Updated: 2026-09-23T13:54:58.721Z
Canonical: https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags

![A desktop monitor shows a minimal project-instructions view with plain AGENTS.md and CLAUDE.md labels above a keyboard and mouse.](https://bigchange.ai/api/media/file/claude-code-project-instructions-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Nagdagdag ang Claude Code 2.1.277 ng katutubong suporta sa mga tagubilin ng repository sa `AGENTS.md`. May mahalagang limitasyon ang tampok: ayon sa kasalukuyang dokumentasyon ng Anthropic, mga session lang na nakakakuha ng feature flag ang makakagamit nito. Kabilang sa hindi nakakakuha nito ang mga session na naka-disable ang telemetry at maraming setup ng third-party provider; `CLAUDE.md` lang ang nilo-load ng mga ito.

Inihihiwalay ng inilabas na `agents-md` plugin ang paglo-load ng file sa opsyonal nitong mga tala ng telemetry. Bilang at mga nakapirming pagpipilian lang ang laman ng mga talang ito, hindi ang mga path o teksto ng file. Nasa mas naunang antas ang pagkadepende: remote flag ang nagpapasiya kung magagamit ang built-in loader.

## Ang malaking pagbabago

- **Ano ang nagbago:** Dumaraan na ngayon sa hangganan ng remote rollout ang lokal na file ng tagubilin: tinutukoy ng akses sa feature flag kung magagamit ang built-in na `AGENTS.md` reader ng Claude Code.
- **Bakit ito mahalaga:** Maaaring magkaiba ang tagubiling natatanggap ng dalawang developer sa iisang commit dahil magkaiba ang bersiyon, provider o setting ng privacy nila. Dahil dito, mas mahirap ulitin at ihambing ang asal ng agent sa loob ng pangkat.
- **Ano ang dapat bantayan:** Maaaring ituring ng mga pangkat na gumagamit ng maraming provider o saradong kapaligiran na runtime dependency ang paglo-load ng mga tagubilin, tiyakin itong gumagana sa bawat setup at panatilihin ang isang `CLAUDE.md` import bilang madadala sa iba’t ibang setup na paraan.

## Ano ang pinatutunayan ng release at ulat

Sinasabi sa [mga tala ng release 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277), na may petsang Setyembre 18, na binabasa ng Claude Code ang `AGENTS.md` kapag walang `CLAUDE.md` ang proyekto. Hindi rin kasama sa release na ito ang Bedrock, Vertex at Foundry.

Hindi rin kasama sa kasalukuyang [dokumentasyon tungkol sa memorya ng proyekto](https://code.claude.com/docs/en/memory) ang unang session matapos mag-install o mag-upgrade sa suportadong bersiyon, at ang mga session na naka-disable ang built-in plugin.

Inilalarawan sa [ulat ni Przemek Szypowski na nagpasimula sa usapin](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) ang canary test sa 2.1.280. Ayon sa kanya, pinigilan ng `DISABLE_TELEMETRY` at `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ang paglo-load ng kanyang `AGENTS.md`, samantalang gumana ang katabing `CLAUDE.md` import. Hindi muling isinagawa ng BIG CHANGE ang pagsubok na iyon sa bayad na modelo. Malaya nang inilalahad ng dokumentasyon ng Anthropic ang kaparehong mga kondisyon sa pagkakaroon ng tampok.

## Magkahiwalay ang pagkakaroon ng tampok at pagtatala ng telemetry

Sinasabi sa [dokumentasyon ng mga environment variable](https://code.claude.com/docs/en/env-vars) ng Anthropic na anumang halagang hindi bakante sa `DISABLE_TELEMETRY`—kabilang ang `0` o `false`—ay nag-o-opt out sa telemetry at nagdi-disable sa pagkuha ng feature flag. Maaari ring pumigil sa pagkuha ng flag ang `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` at `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. Hindi kasama ang mga session ng third-party provider maliban kung itinatakda ng host na nag-e-embed ang `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`; hindi rin kasama ang mga session sa gateway ng Claude apps.

Sinasabi sa README ng [inilabas na plugin](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) na itinatapon ang mga nawawalang tawag sa telemetry nang hindi binabago ang iba pang gawain ng plugin. Tinutukoy sa [pangkalahatang-ideya ng mga mod](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) ng repository na magkahiwalay na built-in ang telemetry at `agents-md`. Magkaibang paliwanag ang mga ito tungkol sa kondisyon sa pagtakbo ng loader at pagtatala ng telemetry.

Inilalarawan ng source ang gumaganang loader; inilalarawan ng dokumentasyon ng produkto kung makakakuha ng loader ang isang session. Hindi inaalis ng opsyonal na pagtatala sa loob ng module ang kondisyon sa pagkakaroon nito sa labas ng module.

Noong Setyembre 23, kinuha ng BIG CHANGE ang `agents-md` README at [ module ng pagpaparehistro](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) mula sa `main` at tag na 2.1.280, na inilabas noong Setyembre 22; magkapareho byte por byte ang bawat pares.

## Kailan nilo-load ng Claude Code ang file

Para sa plugin na magagamit at naka-enable, ganito ang pagkakasunod-sunod ng default mode:

| Mga file ng tagubilin | Default na resulta |
| --- | --- |
| `AGENTS.md`, walang file ng tagubilin ng proyekto para sa Claude | `AGENTS.md` ang nilo-load |
| Proyekto `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md` sa kasalukuyang directory o sa mas mataas na antas | Direktang `AGENTS.md` paglo-load ay napapailalim sa mga file na iyon |
| Pang-user o pinamamahalaang `CLAUDE.md`, o `.claude/rules/` | Hindi pinapalitan ng mga ito ang `AGENTS.md` |

Baguhin ang mga tagubilin ng proyekto sa `/config` para i-load ang dalawang uri ng file. Dapat nasa user, `--settings` o managed settings ang opsyong JSON nito; hindi pinapansin ang project at local settings file.

## Isang tahasang import ang alternatibo

Para sa mga session na walang direktang suporta, inirerekomenda ng Anthropic ang isang `CLAUDE.md` katabi ng pinagsasaluhang file na naglalaman ng:

`@AGENTS.md`

Isinasama ng import ang file; ipinauubaya naman sa modelo ang pagpili kapag pangungusap lang ang nagsasabing basahin ito ni Claude.

Tingnan ang `claude --version` at Mga Tagubilin ng Proyekto sa `/config`. Sa 2.1.280, maaaring ilista ng `/memory` o `/context` ang direktang na-load na `AGENTS.md`; hindi ito nakalista roon sa mga naunang suportadong bersiyon.

## Sources

- [Binabasa lang ng Claude Code ang AGENTS.md kapag naka-on ang telemetry](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Iniulat ni Przemek Szypowski ang mga canary test at alternatibo sa 2.1.280. Hindi inulit ng BIG CHANGE ang pagsubok niya sa bayad na modelo; ibinubukod ng artikulo ang mga obserbasyon niya sa opisyal na dokumentasyon ng produkto at interpretasyon ng source code.
- [Release ng Claude Code v2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — Opisyal na tala ng release na nagdagdag ng suporta sa AGENTS.md at hindi nagsama sa pagkakaroon nito sa Bedrock, Vertex at Foundry sa oras ng paglulunsad.
- [Paano naaalala ng Claude ang proyekto mo](https://code.claude.com/docs/en/memory) — Kasalukuyang opisyal na dokumentasyon tungkol sa pinakamababang bersiyon, pagkakasunod-sunod ng file, mga mode ng Project instructions, kondisyong hindi magagamit ang tampok, diagnostic at alternatibong import ng CLAUDE.md.
- [Mga environment variable ng Claude Code](https://code.claude.com/docs/en/env-vars) — Kasalukuyang opisyal na dokumentasyon na nagpapakitang pinahihinto rin ng pag-opt out sa telemetry ang pagkuha ng feature flag, kaya hindi magagamit ang direktang paglo-load ng AGENTS.md, at inililista ang iba pang apektadong session.
- [Source at asal ng built-in na agents-md sa Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — Paglalarawan sa inilabas na source para sa mga mode at pagkakasunod-sunod ng file ng tagubilin at opsyonal na tala ng telemetry. Sinasabi nitong bilang at mga nakapirming pagpipilian ang laman ng mga tala, hindi mga path o teksto ng file.
- [Mga built-in mod ng Claude Code, v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — Opisyal na pangkalahatang-ideya na nagpapatunay na magkahiwalay na built-in plugin ang telemetry at agents-md at kasama sa Claude Code ang naka-tag na source.
- [Module ng pagpaparehistro ng agents-md, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — Inilabas na source ng pagpaparehistro na sinuri kasabay ng README. Magkapareho ang mga byte nito sa katumbas na file sa main nang suriin noong Setyembre 23.