# Claude Code Kini Membaca AGENTS.md: Apa yang Berubah di 2.1.277
> Pada 18 September 2026, Claude Code 2.1.277 mendapatkan dukungan langsung untuk AGENTS.md: kapan file dimuat, cara memilih satu dari 4 mode, dan apa yang harus dilakukan terkait impor.
Source: https://ailoot.ai/blog/id/claude-code-agents-md-support/
Canonical: https://ailoot.ai/blog/id/claude-code-agents-md-support/
Language: id
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-041
Revision: sha256-fcb27ac608957e3e90952e0bf20e06fecef68448fd8ba029f2ca9e6fe03b62a0
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](https://ailoot.ai/blog/id/agents-md-claude-md-one-instruction-file/).
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](https://ailoot.ai/docs/).
[Panduan Ailoot](https://ailoot.ai/docs/)
## Apa yang berubah di versi 2.1.277?
Poin utama
Mulai 18 September 2026, Claude Code membaca `AGENTS.md` secara default jika tidak ada `CLAUDE.md`, `.claude/CLAUDE.md`, atau `CLAUDE.local.md` di mana pun dalam rantai direktori dari folder kerja ke atas. Jika file seperti itu ada, pembacaan otomatis `AGENTS.md` melalui Project instructions tidak diaktifkan. Impor `@AGENTS.md` yang eksplisit dari `CLAUDE.md` tetap berfungsi. `~/.claude/CLAUDE.md` tingkat pengguna, `CLAUDE.md` yang dikelola organisasi, dan `.claude/rules/` dimuat secara terpisah dari pilihan antara file proyek. Mode diubah melalui `/config`. Fitur ini belum tersedia di Bedrock, Vertex, atau Foundry.
CHANGELOG.md proyek Claude Code resmi di GitHub menyatakannya seperti ini:
Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under "Project instructions" in /config (not yet on Bedrock, Vertex or Foundry)
— Anthropic, commit CHANGELOG.md claude-code, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
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
Poin utama
Dalam mode default, `CLAUDE.md`, `.claude/CLAUDE.md`, dan `CLAUDE.local.md` diperiksa di direktori kerja dan direktori di atasnya. `~/.claude/CLAUDE.md` pribadi, `CLAUDE.md` yang dikelola organisasi, dan file `.claude/rules/` tidak menghalangi pembacaan `AGENTS.md` dan dimuat bersamanya.
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](https://ailoot.ai/docs/).
[Panduan Ailoot](https://ailoot.ai/docs/)
## 4 mode Project instructions—mana yang harus dipilih
Poin utama
Di bagian Project instructions pada perintah `/config`, ada empat nilai: `claude-md-or-agents-md` (default—salah satu dari dua file), `claude-md-and-agents-md` (keduanya bersama-sama), `claude-md` (hanya `CLAUDE.md` yang dibaca otomatis, meskipun proyek hanya memiliki `AGENTS.md`), dan `managed-only` (saat startup—hanya `CLAUDE.md` yang dikelola organisasi dan memori otomatis, tanpa file proyek atau pribadi). Perubahan berlaku mulai pesan berikutnya yang dikirim dan di setiap sesi baru.
Perilaku mode dalam tabel dijelaskan dalam dokumentasi Anthropic. Kolom kanan memberikan rekomendasi untuk memilihnya:
| Nilai | Yang dibaca Claude Code | Kapan digunakan |
|----|----|----|
| `claude-md-or-agents-md` | `CLAUDE.md`, atau `AGENTS.md` jika tidak ada `CLAUDE.md`, `.claude/CLAUDE.md`, atau `CLAUDE.local.md` di direktori kerja atau di atasnya | Default, jika repositori hanya menggunakan salah satu dari dua file dan tidak ada file penghalang di atasnya |
| `claude-md-and-agents-md` | Kedua file bersama-sama: di setiap direktori, `CLAUDE.md` terlebih dahulu, lalu `AGENTS.md` | Anda memerlukan `AGENTS.md` bersama untuk semua alat serta `CLAUDE.md` singkat hanya untuk Claude; atau Anda perlu membaca `AGENTS.md` ketika `CLAUDE.local.md` ada |
| `claude-md` | Hanya `CLAUDE.md`; pembacaan otomatis `AGENTS.md` melalui Project instructions dinonaktifkan, bahkan jika `AGENTS.md` adalah satu-satunya file (impor `@AGENTS.md` eksplisit dari `CLAUDE.md` tetap berfungsi) | `AGENTS.md` ditulis untuk alat lain dan dapat membingungkan Claude |
| `managed-only` | Saat sesi dimulai—hanya `CLAUDE.md` yang dikelola organisasi dan memori otomatis; proyek, lokal, dan `CLAUDE.md` pengguna, `.claude/rules/`, serta semua file `AGENTS.md` dikecualikan dari kumpulan awal. Namun, file `CLAUDE.md` dan `.claude/rules/` di subdirektori tetap dimuat kemudian saat Claude membuka file di sana. Mode ini membatasi kumpulan awal dan tidak memberikan isolasi penuh dari file proyek | Untuk organisasi yang memperhatikan kumpulan instruksi mana yang digunakan Claude Code untuk memulai sesi, terlepas dari apakah proyek itu sendiri berisi `CLAUDE.md` atau `AGENTS.md` |
Anda juga dapat memilih mode tanpa antarmuka, melalui `settings.json`:
```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](https://ailoot.ai/blog/id/agents-md-claude-md-one-instruction-file/) menjelaskan cara kerja impor `@`. Metode ini masih berfungsi hingga kini.
## Mengapa Project instructions tidak ada di /config
Poin utama
Menurut dokumentasi Anthropic, bagian Project instructions mungkin tidak muncul karena alasan berikut:
- Versi Claude Code lebih lama dari 2.1.277.
- Sesi tidak menerima flag fitur dari Anthropic—misalnya, saat menggunakan Bedrock, penyedia pihak ketiga lainnya, atau telemetri dinonaktifkan.
- Ini adalah sesi pertama setelah menginstal atau memperbarui dari versi yang lebih lama. Jika ini satu-satunya alasan, fitur akan muncul pada sesi berikutnya. `AGENTS.md` sendiri hanya akan dimuat jika ketentuan mode yang dipilih terpenuhi.
- Plugin bawaan `agents-md` dinonaktifkan di `/plugin`.
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
Poin utama
Anda dapat mempertahankan impor `@AGENTS.md` di `CLAUDE.md` dan tautan simbolisnya: file tidak akan dibaca dua kali dalam mode apa pun. Permintaan dalam teks untuk “membaca AGENTS.md” sebaiknya diganti dengan impor jika Anda mempertahankan `CLAUDE.md`. Sebelum menghapus file, simpan semua instruksi yang diperlukan dan periksa ketentuan mode yang dipilih. Jika beralih ke pembacaan langsung, hapus hook `SessionStart` apa pun yang mencetak isi `AGENTS.md` secara manual; jika tidak, salinan kedua file tersebut akan masuk ke konteks. Setelah itu, periksa pemuatan dalam sesi baru; cara pemeriksaannya bergantung pada versi dan ada tidaknya file penghalang.
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
Poin utama
Mulai versi 2.1.280, `AGENTS.md` yang dimuat melalui Project instructions muncul di `/memory` dan dalam daftar file Memory pada perintah `/context`. Dalam versi 2.1.277–2.1.279, file itu tidak muncul di sana, meskipun perintah tersebut berfungsi dan menampilkan `CLAUDE.md` yang dimuat serta file memori lainnya. Dalam versi-versi ini, jika tidak ada file penghalang, periksa baris `AGENTS.md loaded` saat startup sesi. Menanyakan isi instruksi kepada Claude hanyalah pemeriksaan yang lemah: jawabannya tidak dapat membedakan pembacaan langsung dari impor `@` dan mungkin mengandalkan teks yang ditambahkan oleh hook `SessionStart`. Karena itu, pertanyaan tersebut sebaiknya hanya diajukan dalam sesi baru setelah hook semacam itu dihapus.
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](https://ailoot.ai/blog/id/claude-md-template/). 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](https://ailoot.ai/blog/id/claude-code-second-brain/)—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.
### Sumber
- [Claude Code, commit CHANGELOG.md dengan entri 2.1.277 di GitHub (18 September 2026)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3)
- [Dokumentasi Claude Code: Cara Claude mengingat proyek Anda - bagian AGENTS.md](https://code.claude.com/docs/en/memory)
[Panduan Ailoot](https://ailoot.ai/docs/)
[Kunjungi Ailoot](https://ailoot.ai/)
## Pertanyaan tentang Claude Code Kini Membaca AGENTS.md: Apa yang Berubah di 2.1.277
### Mengapa AGENTS.md tidak dimuat meskipun filenya ada?
Dalam mode default, CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md pada direktori kerja atau direktori induk menghalangi pemilihan AGENTS.md otomatis. Periksa juga versi Claude Code, ketersediaan fitur, dan mode Project instructions pada /config.
### Bagaimana memverifikasi pemuatan langsung setelah menghapus hook manual?
Buka sesi baru agar keluaran SessionStart lama tidak ada. Pada versi 2.1.280 atau lebih baru, periksa /memory atau daftar Memory files di /context; pada 2.1.277–2.1.279, baris pemuatan saat startup berlaku jika tidak ada file CLAUDE.md penghalang. Parafrasa dari Claude saja merupakan bukti lemah.
## Ailoot · Perusahaan dan portofolio proyeknya
Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan.
Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan.
Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.