Claude Code Kini Mendukung AGENTS.md: Cara Menggunakannya Bersama CLAUDE.md

Claude Code AGENTS.md support telah hadir di v2.1.277: pada proyek tanpa CLAUDE.md, Claude Code kini membaca AGENTS.md Anda sebagai instruksi proyek. Anda tidak perlu import, symlink, maupun pengaturan apa pun. Jika repo Anda memiliki kedua file tersebut, Claude hanya membaca CLAUDE.md, kecuali Anda mengubah pengaturan Project instructions di /config untuk memuat keduanya.

Jika tim Anda menggunakan berbagai coding agent, AGENTS.md yang sama—yang sudah dibaca oleh Codex dan Cursor—kini juga mengarahkan Claude Code. Panduan ini membahas urutan prioritas, migrasi, serta AGENTS.md yang mengajarkan agent mana pun untuk menguji API Anda dengan Apidog CLI.

Apa itu AGENTS.md di Claude Code?

AGENTS.md adalah file Markdown biasa yang berisi instruksi untuk coding agent: perintah build, perintah test, gaya kode, dan aturan proyek. Sejak v2.1.277, Claude Code membacanya melalui plugin bawaan, sehingga repositori yang sudah disiapkan untuk agent lain bisa langsung dipakai dengan Claude Code tanpa file tambahan. Format ini tidak memerlukan field wajib atau sintaks khusus.

Formatnya sendiri bersifat terbuka. Situs AGENTS.md menyebutnya sebagai “format sederhana dan terbuka untuk memandu coding agent,” yang digunakan lebih dari 60.000 proyek open source dan kini dikelola oleh Agentic AI Foundation di bawah Linux Foundation. OpenAI Codex dan Cursor sama-sama mendokumentasikan dukungan AGENTS.md, dan Claude Code adalah satu-satunya yang tertinggal hingga rilis ini.

Baru mengenal format ini? Mulailah dengan cara menulis file AGENTS.md untuk tim pengembangan API.

Berikut jejak rilis dari changelog resmi Claude Code:

Jalankan claude --version sebelum mengandalkan fitur ini. Pada versi lebih lama dari 2.1.277, Claude Code hanya membaca file CLAUDE.md.

CLAUDE.md vs AGENTS.md: mana yang menang?

Secara default, CLAUDE.md yang menang. Claude Code hanya membaca AGENTS.md jika tidak ada CLAUDE.md di direktori kerja Anda maupun direktori di atasnya. Dokumentasi memori Claude Code menjelaskan tiga kasus berikut:

Tidak semua file diperhitungkan dalam pemeriksaan ini. Tiga file berikut memblokir AGENTS.md:

• CLAUDE.md di direktori kerja atau di atasnya
• .claude/CLAUDE.md di direktori kerja atau di atasnya
• CLAUDE.local.md di direktori kerja atau di atasnya

File berikut tidak memblokirnya dan tetap dimuat bersama AGENTS.md: file pengguna Anda di ~/.claude/CLAUDE.md, CLAUDE.md terkelola organisasi Anda, serta file di bawah .claude/rules/.

Waspadai jebakan CLAUDE.local.md: begitu menambahkan satu untuk catatan pribadi yang tidak di-commit, Claude berhenti membaca AGENTS.md tim untuk Anda.

Apa yang dimuat Claude Code, dan kapan

Ketika tidak ada yang memblokir, Claude Code membaca:

1. Saat sesi dimulai: semua AGENTS.md dan .claude/AGENTS.md di direktori kerja serta direktori di atasnya. Sesi interaktif mencetak baris seperti no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md.
2. Di subdirektori: AGENTS.md milik subdirektori, setelah Claude membuka file di sana dengan tool Read dan folder tersebut tidak memiliki CLAUDE.md sendiri.
3. Import: import @path di dalam AGENTS.md diekspansi, dan pola claudeMdExcludes diterapkan.

Claude Code tidak membaca AGENTS.local.md, AGENTS.override.md, maupun apa pun di bawah .agents/. Jika Anda berbagi repo dengan Codex—yang mendokumentasikan AGENTS.override.md—ingat hal ini.

Cara mengubah file instruksi mana yang dimuat Claude Code

Ketik /config dalam sesi dan atur Project instructions ke salah satu dari empat nilai berikut:

Untuk sebagian besar tim campuran, claude-md-and-agents-md adalah pengaturan yang tepat. Ia mempertahankan CLAUDE.local.md pribadi Anda sekaligus tetap memuat AGENTS.md bersama.

Anda juga bisa mengaturnya lewat file settings. Claude Code membaca entri ini dari ~/.claude/settings.json, file --settings, atau managed settings, dan mengabaikannya di file settings proyek dan lokal:

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

Sebelum v2.1.285, ID plugin-nya adalah agents-md@builtin. Versi 2.1.285 ke atas membaca kedua ID, jadi gunakan yang lama jika instalasi lama ikut memakai file tersebut. Perubahan berlaku mulai pesan Anda berikutnya.

Jika Project instructions tidak muncul di /config, sesi Anda tidak bisa memuat AGENTS.md: Anda berada di versi sebelum 2.1.277, Anda menonaktifkan plugin bawaan melalui /plugin, atau ini sesi pertama Anda setelah upgrade (mulai berfungsi dari sesi berikutnya).

Cara migrasi dari workaround AGENTS.md lama

Banyak tim menyambungkan AGENTS.md ke Claude Code secara manual sebelum rilis ini. Dokumentasi merekomendasikan:

Pertahankan import @AGENTS.md jika ada anggota tim yang masih menjalankan versi lebih lama dari 2.1.277. Ini satu-satunya setup yang berfungsi di semua versi.

Import atau symlink?

Jika Anda butuh aturan khusus Claude di atas file bersama, gunakan import. Claude membaca file yang diimpor lebih dulu, lalu sisanya:

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

Jika tidak perlu apa pun yang khusus Claude, symlink juga bisa:

ln -s AGENTS.md CLAUDE.md

Dua catatan penting: tool Edit dan Write milik Claude tidak akan menulis melalui symlink, dan Git di Windows men-checkout symlink yang di-commit sebagai file teks satu baris kecuali core.symlinks diaktifkan. Jika ada anggota tim yang memakai Windows, pilih import.

Apa pun pilihan Anda, jalankan /context all pada sesi berikutnya dan pastikan CLAUDE.md muncul di bawah Memory files.

Satu AGENTS.md untuk Codex, Cursor, dan Claude Code

Keuntungannya adalah satu sumber kebenaran. Letakkan perintah build, perintah test, dan konvensi Anda di AGENTS.md pada root repo. Codex, Cursor, dan Claude Code semuanya membacanya.

Struktur yang terbukti efektif dalam praktik:

• AGENTS.md di root: semua yang dibutuhkan setiap agent. Perintah, peta folder, aturan gaya, hal-hal yang tidak boleh disentuh.
• AGENTS.md di subfolder besar: aturan yang hanya berlaku di sana, misalnya services/payments/AGENTS.md. Claude Code memuatnya sesuai permintaan saat membaca file di folder tersebut.
• CLAUDE.md opsional: hanya jika Anda butuh perilaku khusus Claude, seperti plan mode atau hook. Mulailah dengan @AGENTS.md.

Satu catatan: AGENTS.md yang dimuat melalui pengaturan tidak memicu hook InstructionsLoaded, dan tidak dimuat dari direktori --add-dir. Jika Anda bergantung pada salah satunya, gunakan jalur import @AGENTS.md.

Ajari agent Anda menguji API dengan Apidog CLI di AGENTS.md

Tulis aturan pengujian API Anda sekali saja, dan agent mana pun yang membuka repo akan menjalankan test dengan cara yang sama. Apidog CLI memberi agent output JSON terstruktur yang bisa dibaca, sehingga siklusnya tetap berlangsung di terminal.

Lakukan setup sekali per mesin:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Jalan pintas: katakan ke agent Anda “Read https://apidog.com/apidog-cli-installation-guide.md and set up Apidog CLI”. Panduan itu ditulis untuk agent dan mencakup instalasi, login, dan skill-nya.

Lalu tambahkan bagian seperti ini ke AGENTS.md Anda:

## API testing (Apidog CLI)

- Apidog project ID: 123456. Staging environment ID: 7890.
- Never build Apidog JSON payloads from memory. Run
  `apidog cli-schema get <key>` first, then
  `apidog cli-schema validate <key> --file <path>`, and write only after it passes.
- After changing any handler under `src/routes/`, find its endpoint with
  `apidog endpoint list --project 123456` and its cases with
  `apidog test-case list --project 123456 --endpoint <endpointId>`.
- If a route has no test case, create one with
  `apidog test-case create --project 123456 --file case.json`.
- Run cases with
  `apidog run --test-case <caseId> --project 123456 -e 7890 -r cli,json`
  and summarize every failure before you say the task is done.
- Do not edit or delete endpoints in Apidog unless the task asks for it.

Kini satu prompt saja sudah menyelesaikan pekerjaan di Claude Code, Codex, atau Cursor:

I changed POST /orders to require a currency field. Update the Apidog test
case for it and run it against staging, following AGENTS.md.

Agent mengikuti aturan Anda dan menjalankan perintah seperti ini:

apidog endpoint list --project 123456
apidog test-case list --project 123456 --endpoint <endpointId>
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project 123456 --file case.json
apidog run --test-case <caseId> --project 123456 -e 7890 -r cli,json

Semua flag di atas berasal dari apidog <cmd> --help pada Apidog CLI 2.2.12. Baris apidog run yang sama dengan -r junit bisa langsung dipakai di CI, dan --upload-report mengirim ringkasan run ke aplikasi agar tim Anda bisa melihatnya. Untuk detail sisi Claude Code, lihat cara menggunakan Apidog CLI di Claude Code; pengguna Codex bisa mengikuti Apidog CLI di Codex. Apidog Free mencakup hingga 4 pengguna, jadi tim kecil bisa mencobanya hari ini.

Troubleshooting: AGENTS.md saya tidak dimuat

1. Cari CLAUDE.md di path. CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md di direktori kerja Anda atau di atasnya menang secara default. ~/.claude/CLAUDE.md Anda tidak diperhitungkan.
2. Periksa versi Anda. Jalankan claude --version. Anda butuh 2.1.277 atau lebih baru, dan 2.1.281 atau lebih baru di Bedrock, Vertex AI, Foundry, gateway, atau saat telemetry nonaktif.
3. Periksa pengaturannya. Buka /config dan pastikan Project instructions bukan claude-md atau managed-only.
4. Pastikan dimuat. Jalankan /memory dan cari path AGENTS.md di daftarnya.

FAQ

Apakah Claude Code sekarang membaca AGENTS.md? Ya, sejak v2.1.277. Tanpa CLAUDE.md di direktori kerja Anda atau di atasnya, Claude Code otomatis membaca AGENTS.md sebagai instruksi proyeknya.

Jika saya punya CLAUDE.md dan AGENTS.md sekaligus, mana yang dipakai Claude Code? Hanya CLAUDE.md, secara default. Atur Project instructions ke claude-md-and-agents-md di /config untuk memuat keduanya, CLAUDE.md lebih dulu.

Haruskah saya menghapus CLAUDE.md saya yang mengimpor @AGENTS.md? Tidak perlu. Import tersebut tidak pernah memuat AGENTS.md dua kali, dan tetap berfungsi untuk rekan tim di versi sebelum 2.1.277. Hapus hanya jika isinya tidak ada yang lain dan semua orang sudah upgrade.

Apakah Claude Code membaca AGENTS.override.md seperti Codex? Tidak. Claude Code mengabaikan AGENTS.override.md, AGENTS.local.md, dan apa pun di bawah .agents/.

Apakah AGENTS.md berfungsi di Amazon Bedrock atau Google Vertex AI? Ya, sejak v2.1.281. Versi lebih lama di Bedrock, Vertex AI, Foundry, gateway, atau dengan telemetry nonaktif hanya membaca CLAUDE.md; gunakan import @AGENTS.md di sana.