Edisi Markdown

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

# Claude Code dapat melewatkan AGENTS.md saat telemetri dinonaktifkan

> Dukungan bawaan Claude Code untuk AGENTS.md bergantung pada versi, akses flag fitur, penyedia, dan prioritas berkas. Baris telemetri pada plugin agents-md yang dirilis tidak memuat jalur berkas maupun teksnya.

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.

Claude Code 2.1.277 menambahkan dukungan bawaan untuk instruksi repositori di `AGENTS.md`. Fitur ini memiliki batas penting: dokumentasi Anthropic saat ini menyatakan bahwa sesi yang tidak dapat mengambil flag fitur—termasuk sesi dengan telemetri dinonaktifkan dan banyak konfigurasi penyedia pihak ketiga—memuat `CLAUDE.md` saja.

Plugin `agents-md` yang dirilis memisahkan pemuatan berkas dari baris telemetri opsionalnya. Baris tersebut berisi jumlah dan pilihan tetap, tanpa jalur berkas ataupun teksnya. Ketergantungannya berada satu lapis lebih awal, saat sebuah flag jarak jauh menentukan apakah pemuat bawaan tersedia.

## Perubahan besar

- **Yang berubah:** Berkas instruksi lokal kini bergantung pada mekanisme peluncuran jarak jauh: akses flag fitur menentukan apakah pembaca bawaan Claude Code untuk `AGENTS.md` tersedia.
- **Mengapa ini penting:** Dua pengembang pada commit yang sama dapat menerima instruksi proyek yang berbeda karena versi, penyedia, atau pengaturan privasinya berbeda. Akibatnya, perilaku agen lebih sulit direproduksi di seluruh tim.
- **Yang perlu dipantau:** Tim yang menggunakan beberapa penyedia atau lingkungan terkunci dapat memperlakukan pemuatan instruksi sebagai dependensi saat berjalan, memverifikasinya di tiap konfigurasi, dan menyimpan impor `CLAUDE.md` sebagai jalur yang portabel.

## Apa yang dibuktikan oleh rilis dan laporan

Catatan rilis Anthropic [v2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277), bertanggal 18 September, menyatakan Claude Code membaca `AGENTS.md` jika proyek tidak memiliki `CLAUDE.md`. Catatan itu juga mengecualikan Bedrock, Vertex, dan Foundry dari rilis tersebut.

Dokumentasi terkini tentang [memori proyek](https://code.claude.com/docs/en/memory) juga mengecualikan sesi pertama setelah pemasangan atau peningkatan ke versi yang mendukung, serta sesi saat plugin bawaan dinonaktifkan.

Dalam tulisannya, [Przemek Szypowski](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) melaporkan uji canary pada versi 2.1.280. Ia menyebut bahwa `DISABLE_TELEMETRY` dan `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` menggagalkan pemuatan berkas `AGENTS.md` miliknya, sedangkan impor `CLAUDE.md` berfungsi. BIG CHANGE tidak mereproduksi pengujian model berbayar tersebut. Dokumentasi Anthropic kini secara terpisah menyatakan kondisi ketersediaan yang sama.

## Ketersediaan fitur dan pencatatan telemetri adalah hal terpisah

Dokumentasi [variabel lingkungan Anthropic](https://code.claude.com/docs/en/env-vars) menyebut bahwa nilai `DISABLE_TELEMETRY` apa pun yang tidak kosong, termasuk `0` atau `false`, menonaktifkan telemetri dan pengambilan flag fitur. `DO_NOT_TRACK` serta `DISABLE_GROWTHBOOK` dan `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` juga dapat menghentikan pengambilan tersebut. Sesi penyedia pihak ketiga dikecualikan kecuali host penyemat menetapkan `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`; sesi gateway aplikasi Claude juga dikecualikan.

Isi [README plugin yang dirilis](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) menyebut panggilan telemetri yang tidak tersedia akan diabaikan tanpa mengubah pekerjaan plugin lainnya. Ikhtisar repositori [mods](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) mengidentifikasi telemetri dan `agents-md` sebagai fitur bawaan yang terpisah.

Kode sumber menjelaskan cara kerja pemuat; dokumentasi produk menjelaskan apakah suatu sesi memperoleh pemuat itu. Pencatatan opsional di dalam modul tidak menghilangkan syarat ketersediaan yang berada di luarnya.

Pada 23 September, BIG CHANGE mengambil berkas `agents-md` README dan [modul pendaftaran](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) dari `main` maupun tag 2.1.280 yang dirilis pada 22 September; setiap pasangan berkas identik byte demi byte.

## Cara Claude Code memuat berkas

Untuk plugin yang tersedia dan diaktifkan, mode bawaan mengikuti urutan prioritas ini:

| Berkas instruksi | Hasil bawaan |
| --- | --- |
| `AGENTS.md`, jika proyek tidak memiliki berkas instruksi Claude | `AGENTS.md` akan dimuat |
| Instruksi proyek `CLAUDE.md`, `.claude/CLAUDE.md` atau `CLAUDE.local.md` di direktori kerja atau direktori induknya | Pemuatan langsung `AGENTS.md` tidak digunakan jika berkas tersebut ada |
| Instruksi pengguna atau yang dikelola `CLAUDE.md`, atau `.claude/rules/` | juga tidak digantikan oleh `AGENTS.md` |

Ubah instruksi Proyek di `/config` agar kedua jenis berkas dimuat. Opsi JSON-nya berada di pengaturan pengguna, `--settings` atau pengaturan terkelola; berkas pengaturan proyek dan lokal diabaikan.

## Solusi cadangannya adalah satu impor eksplisit

Untuk sesi tanpa dukungan langsung, Anthropic menyarankan `CLAUDE.md` di dekat berkas bersama yang memuat:

`@AGENTS.md`

Impor tersebut menyertakan isi berkas; prosa yang meminta Claude membacanya menyerahkan keputusan itu kepada model.

Periksa `claude --version` dan Instruksi Proyek di `/config`. Pada versi 2.1.280, `/memory` atau `/context` dapat menampilkan berkas `AGENTS.md`; versi terdahulu yang mendukung fitur ini belum menampilkannya di sana.

## Sources

- [Claude Code hanya membaca AGENTS.md saat telemetri aktif](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Pengujian canary dan solusi yang dilaporkan Przemek Szypowski pada 2.1.280. BIG CHANGE tidak mereproduksi pengujian model berbayar tersebut; artikel memisahkan pengamatannya dari dokumentasi produk resmi dan penafsiran sumber.
- [Claude Code v2.1.277: rilis](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — Catatan rilis resmi yang memperkenalkan dukungan AGENTS.md dan mengecualikan Bedrock, Vertex, serta Foundry dari ketersediaan saat peluncuran.
- [Cara Claude mengingat proyek Anda](https://code.claude.com/docs/en/memory) — Dokumentasi resmi terkini mengenai versi minimum, prioritas berkas, mode Instruksi Proyek, kondisi sesi yang tidak mendapat fitur, diagnostik, dan solusi cadangan impor CLAUDE.md.
- [Variabel lingkungan Claude Code](https://code.claude.com/docs/en/env-vars) — Dokumentasi resmi terkini yang menjelaskan bahwa memilih keluar dari telemetri juga menonaktifkan pengambilan flag fitur sehingga pemuatan langsung AGENTS.md tidak tersedia, serta mencantumkan sesi lain yang terdampak.
- [Sumber dan perilaku bawaan agents-md, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — Uraian sumber yang dirilis mengenai mode berkas instruksi, prioritas, dan baris telemetri opsional. Disebutkan bahwa baris tersebut berisi jumlah dan pilihan tetap, bukan jalur berkas atau teksnya.
- [Mod bawaan Claude Code, v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — Ikhtisar rilis yang menetapkan bahwa telemetri dan agents-md merupakan plugin bawaan yang terpisah, serta bahwa sumber bertag tersebut dikirimkan di dalam Claude Code.
- [Modul pendaftaran agents-md, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — Sumber pendaftaran yang dirilis dan diperiksa bersama README. Saat diperiksa pada 23 September, byte-nya cocok dengan berkas terkait di cabang main.