Claude Code, alat coding dari Anthropic, kini mendukung AGENTS.md mulai versi 2.1.277. Aturannya sederhana: saat sebuah folder tidak punya CLAUDE.md, Claude Code akan mencari AGENTS.md di folder yang sama dan membacanya sebagai instruksi proyek ke dalam konteks. Folder yang sudah punya CLAUDE.md tetap hanya memakai file itu, seperti sebelumnya.
Versi ini dirilis di GitHub pada 18 September. Thariq, anggota tim Claude Code, mengumumkan perubahan ini di media sosial:
Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md.
Intinya, mulai versi 2.1.277 yang dirilis hari itu, jika sebuah folder tidak punya CLAUDE.md, Claude akan mencari dan memakai AGENTS.md.
Empat level sakelar
Dukungan AGENTS.md dibuat sebagai plugin bawaan, dengan kode yang dipublikasikan di repositori GitHub Claude Code. Pengguna mengganti mode ini lewat "Project instructions" di /config, dengan total empat level:
| Mode | Perilaku |
|---|---|
| claude-md | Hanya membaca CLAUDE.md — secara efektif mematikan fitur ini |
| claude-md-or-agents-md (default) | Jika folder yang sama punya CLAUDE.md, AGENTS.md di situ diabaikan; kalau tidak ada, AGENTS.md yang dibaca |
| claude-md-and-agents-md | Membaca kedua jenis file di seluruh pohon direktori |
| managed-only | Membuang file instruksi yang di-commit ke repo maupun yang bersifat pribadi, hanya menyisakan file dan memori yang didistribusikan terpusat oleh organisasi |
Level default ini bersifat "fallback", bukan "penggabungan". Repo yang sudah punya CLAUDE.md untuk Claude Code perilakunya tidak berubah setelah upgrade; hanya repo yang belum pernah menulis CLAUDE.md — dan sebelumnya cuma menyiapkan AGENTS.md untuk tool lain — yang untuk pertama kalinya akan membaca file itu. File yang sama tidak akan dimuat dua kali kalau dinilai duplikat berdasarkan path atau isinya.
Masih ada beberapa perbedaan dengan CLAUDE.md
Dokumentasi plugin ini menyebutkan beberapa perbedaan dengan CLAUDE.md. AGENTS.md di subdirektori hanya ikut terbawa saat Agent membaca file teks di direktori itu dengan tool Read — pilihan di IDE, notebook, gambar, dan PDF tidak memicunya. File yang ikut terbawa ini tidak tercatat sebagai "sudah dibaca", jadi tidak otomatis kembali setelah konteks dikompresi. Perintah /memory dan quick-memory dengan # juga tidak menyentuh AGENTS.md; direktori yang ditambahkan lewat --add-dir tidak ikut menyumbang AGENTS.md; dan path symlink dibandingkan apa adanya, tidak di-resolve.
Dari sisi jalur akses, AWS Bedrock, Google Vertex, dan Microsoft Foundry belum mendukung fitur ini. Versi yang sama juga membawa satu perubahan lain terkait file instruksi: saat start lewat SDK dan mode headless, giliran pertama tidak lagi menunggu pencarian CLAUDE.md selesai.
Satu repo, beberapa Agent
AGENTS.md pada dasarnya adalah README yang ditulis untuk Agent coding: cara build, cara menjalankan test, aturan gaya kode, direktori mana yang tidak boleh disentuh. Format ini awalnya didorong bersama oleh OpenAI Codex dan beberapa tool lain pada 2025, lalu pengelolaannya diserahkan ke Agentic AI Foundation di bawah Linux Foundation, dan kini dikenali oleh Cursor, GitHub Copilot, dan lainnya. Claude Code selama ini hanya mengenali CLAUDE.md miliknya sendiri, sehingga tim yang memakai beberapa tool sekaligus terpaksa menjaga dua file yang isinya nyaris sama — cara yang umum dipakai adalah symlink yang membuat keduanya menunjuk ke file yang sama.
Tim di China biasanya memakai kombinasi tool yang lebih beragam lagi: selain Claude Code, yang umum dipakai juga Kimi Code, Qwen Code, Cursor, dan Codex, dan beberapa di antaranya secara default membaca AGENTS.md atau mengizinkan nama file instruksi diganti. Di level default, repo lama tidak perlu diubah sama sekali. Tim yang ingin hanya menjaga satu AGENTS.md bisa menghapus CLAUDE.md dan memusatkan instruksi ke sana, tapi perlu mengecek dulu batasan-batasan di atas, terutama soal instruksi subdirektori yang tidak otomatis kembali setelah sesi panjang dikompresi.
Level managed-only ditujukan untuk admin enterprise. File instruksi yang di-commit ke repo akan dieksekusi oleh Agent sebagai instruksi, yang membuatnya sendiri menjadi celah yang bisa disusupi; admin bisa memakai level ini agar hanya aturan yang didistribusikan terpusat oleh organisasi yang diizinkan. Belum ada data publik soal seberapa baik level ini bekerja di tim besar.
Sumber: catatan rilis GitHub Claude Code, CocoLoop, unggahan publik insinyur Anthropic Thariq; dokumentasi plugin agents-md dicek untuk empat mode, urutan pemuatan, dan batasannya.