Claude Code Kini Membaca AGENTS.md: Apa yang Berubah di 2.1.277

Pada 18 September 2026, dukungan untuk AGENTS.md ditambahkan di Claude Code 2.1.277. Jika fitur ini tersedia dalam sesi dan di direktori kerja, serta tidak ada CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md di mana pun dalam rantai direktori di atasnya, Claude Code membaca AGENTS.md secara default tanpa impor manual. Sebelumnya, hal ini dilakukan melalui impor @AGENTS.md di CLAUDE.md atau melalui tautan simbolis CLAUDE.md ke AGENTS.md—untuk detail lebih lanjut, lihat artikel tentang satu file instruksi untuk beberapa agen.

Jika Anda menggunakan Claude Code dan satu atau dua alat lain di repositori yang sama, mode Project instructions yang Anda pilih menentukan file instruksi mana yang dibaca Claude Code. Berikut adalah ketentuan untuk masing-masing dari empat mode dan langkah-langkah untuk beralih dari pengaturan lama.

Materi lainnya tentang konfigurasi alat tersedia di dokumentasi Ailoot.

Apa yang berubah di versi 2.1.277?#

CHANGELOG.md proyek Claude Code resmi di GitHub menyatakannya seperti ini:

Terjemahan: dukungan untuk AGENTS.md telah ditambahkan—dalam proyek tanpa CLAUDE.md, Claude Code kini membaca AGENTS.md; ini dapat diubah di “Project instructions” dalam /config (belum tersedia di Bedrock, Vertex, atau Foundry).

Sebelum versi ini, tidak adanya CLAUDE.md, .claude/CLAUDE.md, dan CLAUDE.local.md di folder kerja dan direktori di atasnya tidak dengan sendirinya mengaktifkan pembacaan AGENTS.md. Diperlukan impor eksplisit, tautan simbolis, atau hook manual. Kini, jika fitur tersedia, agen memuat file tersebut secara otomatis.

File apa yang menghalangi pembacaan otomatis AGENTS.md#

Jika Anda memiliki ~/.claude/CLAUDE.md pribadi dengan pengaturan gaya pemrograman, file itu tidak akan mencegah Claude Code membaca AGENTS.md proyek. Namun, CLAUDE.local.md apa pun di folder kerja—bahkan yang tidak ditambahkan ke Git dan digunakan untuk catatan pribadi—menghalangi pembacaan otomatis AGENTS.md dalam mode default. Impor eksplisit tetap berfungsi; untuk membaca kedua file secara langsung, Anda perlu beralih mode.

Jika mode pembacaan langsung dipilih di Project instructions (lihat “4 mode Project instructions—mana yang harus dipilih” di bawah) dan tidak ada CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md di direktori kerja atau di atasnya, Claude Code membaca setiap AGENTS.md dan .claude/AGENTS.md di direktori tersebut saat sesi dimulai. Untuk kasus tanpa file penghalang, dokumentasi menampilkan baris seperti ini dalam sesi interaktif:

no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md

File AGENTS.md di subdirektori dimuat saat Claude membuka file di sana menggunakan alat Read. Dalam mode claude-md-or-agents-md, ini hanya terjadi jika subdirektori tersebut tidak memiliki CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md sendiri. Untuk claude-md-and-agents-md, dokumentasi menjelaskan aturan umum: CLAUDE.md dan AGENTS.md dibaca bersama, dengan CLAUDE.md terlebih dahulu lalu AGENTS.md di setiap direktori. AGENTS.local.md, AGENTS.override.md, dan apa pun di direktori .agents/ tidak dibaca secara otomatis.

Materi tentang konfigurasi ruang kerja agen AI, termasuk file instruksi yang berisi konteks proyek, tersedia di dokumentasi Ailoot.

4 mode Project instructions—mana yang harus dipilih#

Perilaku mode dalam tabel dijelaskan dalam dokumentasi Anthropic. Kolom kanan memberikan rekomendasi untuk memilihnya:

Anda juga dapat memilih mode tanpa antarmuka, melalui settings.json:

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": {
        "instructionFiles": "claude-md-and-agents-md"
      }
    }
  }
}

Claude Code mengabaikan nilai ini dalam pengaturan project dan local. Menurut dokumentasi Anthropic, nilai ini dapat ditetapkan di ~/.claude/settings.json, dalam file --settings, atau dalam pengaturan yang dikelola organisasi.

Jika Anda sudah mengonfigurasi file instruksi bersama untuk beberapa alat AI dalam satu repositori, instruksi untuk versi sebelum 2.1.277 menjelaskan cara kerja impor @. Metode ini masih berfungsi hingga kini.

Mengapa Project instructions tidak ada di /config#

Pertama, periksa versi dengan perintah claude --version. Jika versinya lebih lama dari 2.1.277, perbarui Claude Code. Jika versinya sesuai tetapi bagian tersebut tetap tidak muncul, periksa alasan lain yang tercantum di atas. Selama fitur tidak tersedia, mengimpor @AGENTS.md di CLAUDE.md tetap menjadi cara alternatif yang berfungsi.

Apa yang harus dilakukan dengan impor @AGENTS.md lama#

Langkah selanjutnya bergantung pada pengaturan lama. Pertama, pastikan fitur tersedia dalam sesi Anda, seperti yang dijelaskan di bagian sebelumnya.

• CLAUDE.md dengan impor @AGENTS.md. Anda dapat membiarkannya seperti adanya—Claude Code tidak akan membaca file tersebut dua kali pada nilai Project instructions apa pun. Menghapus CLAUDE.md bersifat opsional: impor tersebut sudah memberi Claude akses ke isi AGENTS.md. Lanjutkan pemeriksaan pemuatan melalui impor menggunakan /memory; pertanyaan langsung kepada Claude tentang isi instruksi hanyalah pemeriksaan yang lemah.
• CLAUDE.md yang meminta dengan kata-kata agar AGENTS.md dibaca. Permintaan seperti itu bukan impor dan dengan sendirinya tidak menjamin file akan dimuat. Ganti kalimat tersebut dengan impor @AGENTS.md jika Anda ingin mempertahankan CLAUDE.md (misalnya, untuk alat lain yang juga membacanya). Jika Anda memutuskan untuk menghapus seluruh CLAUDE.md dan mode claude-md-or-agents-md dipilih, periksa terlebih dahulu bahwa CLAUDE.md tidak berisi instruksi unik dan tidak ada CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md lain di direktori kerja atau di atasnya; jika tidak, Claude Code akan terus membaca file yang tersisa alih-alih AGENTS.md. Setelah menghapusnya, pastikan peralihan telah terjadi: ketika tidak ada lagi file penghalang, baris AGENTS.md loaded muncul dalam sesi interaktif. Jika CLAUDE.md tetap ada dan kedua file dibaca dalam mode claude-md-and-agents-md, periksa /memory (di versi 2.1.280+). Pertanyaan langsung kepada Claude tidak dapat membedakan pemuatan langsung dari impor.
• Tautan simbolis CLAUDE.md ke AGENTS.md. Anda dapat mempertahankannya: tidak akan ada pembacaan duplikat dalam mode apa pun. Sebelum menghapus tautan dalam mode claude-md-or-agents-md, periksa bahwa instruksi yang diperlukan tetap tersimpan dan tidak ada CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md lain di direktori kerja atau di atasnya. Periksa pemuatan dengan cara yang sama: baris AGENTS.md loaded pada awal sesi jika tidak ada file penghalang, atau /memory (2.1.280+). Jika CLAUDE.md tetap ada dalam mode claude-md-and-agents-md, pertanyaan langsung kepada Claude hanyalah pemeriksaan yang lemah. Tidak adanya error tidak cukup untuk memastikan file dimuat.
• Hook SessionStart yang mencetak isi AGENTS.md secara manual. Saat file dibaca langsung, hook seperti itu menambahkan salinan kedua ke konteks. Saat hook berjalan, pertanyaan “apa isi instruksi Anda?” tidak memastikan pemuatan langsung: Claude mungkin menjawab berdasarkan teks yang ditambahkan hook. Beralihlah dengan urutan berikut:
  1. Periksa bahwa fitur tersedia: versi 2.1.277 atau lebih tinggi, sesi menerima flag fitur, plugin diaktifkan, dan sesi pertama setelah instalasi atau pembaruan telah selesai. Pilih mode pembacaan langsung—bukan claude-md maupun managed-only. Untuk mode default, periksa juga bahwa tidak ada file penghalang.
  2. Hapus hook.
  3. Tutup sesi dan buka yang baru. Hook SessionStart menambahkan teksnya saat startup, sehingga isinya tetap berada dalam konteks sesi yang sudah terbuka. Jawaban Claude tentang isi instruksi dalam sesi seperti itu tidak akan memastikan pemuatan langsung.
  4. Periksa pemuatan di sesi baru. Dalam versi 2.1.280+, jalur ke AGENTS.md terlihat di /memory. Dalam versi 2.1.277–2.1.279, jika tidak ada file penghalang, cari baris AGENTS.md loaded saat startup: dokumentasi menjelaskannya khusus untuk kasus ketika CLAUDE.md tidak ditemukan. Jika Anda mempertahankan CLAUDE.md dan menggunakan mode claude-md-and-agents-md, pemeriksaan terbatas: /memory tidak menampilkan AGENTS.md dalam versi-versi ini, dokumentasi tidak menjelaskan baris pemuatan untuk kasus ini, dan parafrasa instruksi tidak dapat membedakan pembacaan langsung dari impor @ di dalam CLAUDE.md. Dalam kasus tersebut, perbarui ke 2.1.280+ dan periksa /memory.

Cara memeriksa apakah AGENTS.md dimuat#

Ada dua perbedaan lagi dari CLAUDE.md biasa: hook InstructionsLoaded tidak dijalankan untuk AGENTS.md jenis ini (hook tersebut memang berfungsi untuk AGENTS.md yang diimpor melalui sintaks @ dari CLAUDE.md atau dihubungkan dengan tautan simbolis CLAUDE.md); direktori yang ditambahkan dengan flag --add-dir bersama variabel CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD hanya memuat CLAUDE.md direktori tersebut—AGENTS.md-nya tidak disertakan.

Jika Anda perlu meninjau isi file instruksi proyek yang besar, lihat analisis terpisah tentang cara mengonfigurasi CLAUDE.md tanpa membuatnya terlalu besar. Artikel itu membahas struktur instruksi, sedangkan ketentuan pemuatan AGENTS.md dijelaskan di atas. Untuk catatan kerja antar-sesi, lihat analisis tentang otak kedua di Claude Code—mengenai memori pribadi yang ditambahkan di atas instruksi proyek.

Apa selanjutnya#

Fitur ini dirilis pada 18 September 2026, dalam versi 2.1.277. Anthropic mungkin akan memperjelas detail mode dalam rilis mendatang, jadi sebelum mengubah pengaturan di proyek penting, bandingkan artikel ini dengan /config saat ini dan changelog resmi.