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, 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 juga mengecualikan sesi pertama setelah pemasangan atau peningkatan ke versi yang mendukung, serta sesi saat plugin bawaan dinonaktifkan.

Dalam tulisannya, Przemek Szypowski 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 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 menyebut panggilan telemetri yang tidak tersedia akan diabaikan tanpa mengubah pekerjaan plugin lainnya. Ikhtisar repositori mods 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 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.