# Claude Code Kini Membaca AGENTS.md: Perkara yang Berubah dalam 2.1.277
> Pada 18 September 2026, Claude Code 2.1.277 mendapat sokongan terus untuk AGENTS.md: bila fail itu dimuatkan, cara memilih 1 daripada 4 mod dan perkara yang perlu dilakukan tentang import.
Source: https://ailoot.ai/blog/ms/claude-code-agents-md-support/
Canonical: https://ailoot.ai/blog/ms/claude-code-agents-md-support/
Language: ms
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-041
Revision: sha256-ba97b3776f0db91e34bb5b6dcc6bc6dff8b49ab8c763619bc8d0a08096b99904
Pada 18 September 2026, sokongan untuk `AGENTS.md` ditambahkan dalam Claude Code 2.1.277. Jika ciri ini tersedia dalam sesi dan tiada `CLAUDE.md`, `.claude/CLAUDE.md` atau `CLAUDE.local.md` di mana-mana dalam rantaian direktori di atas direktori kerja, Claude Code membaca `AGENTS.md` secara lalai tanpa import manual. Sebelum ini, hal ini dilakukan melalui import `@AGENTS.md` dalam `CLAUDE.md` atau pautan simbolik `CLAUDE.md` ke `AGENTS.md`—untuk butiran lanjut, lihat artikel [tentang satu fail arahan untuk beberapa ejen](https://ailoot.ai/blog/ms/agents-md-claude-md-one-instruction-file/).
Jika anda menggunakan Claude Code dan satu atau dua alat lain dalam repositori yang sama, mod Project instructions yang anda pilih menentukan fail arahan yang dibaca oleh Claude Code. Di bawah ialah syarat bagi setiap satu daripada empat mod dan langkah untuk beralih daripada persediaan lama.
Bahan lanjut tentang mengkonfigurasi alat tersedia dalam [dokumentasi Ailoot](https://ailoot.ai/docs/).
[Panduan Ailoot](https://ailoot.ai/docs/)
## Apakah yang berubah dalam versi 2.1.277?
Inti utama
Mulai 18 September 2026, Claude Code membaca `AGENTS.md` secara lalai jika tiada `CLAUDE.md`, `.claude/CLAUDE.md` atau `CLAUDE.local.md` di mana-mana dalam rantaian direktori dari direktori kerja ke atas. Jika fail sedemikian wujud, pembacaan automatik `AGENTS.md` melalui Project instructions tidak diaktifkan. Import eksplisit `@AGENTS.md` daripada `CLAUDE.md` tetap berfungsi. `~/.claude/CLAUDE.md` peringkat pengguna, `CLAUDE.md` yang diurus organisasi dan `.claude/rules/` dimuatkan secara berasingan daripada pilihan antara fail projek. Mod ditukar melalui `/config`. Ciri ini belum tersedia di Bedrock, Vertex atau Foundry.
Fail CHANGELOG.md projek Claude Code rasmi di GitHub menerangkannya begini:
Sokongan AGENTS.md ditambahkan: dalam projek tanpa CLAUDE.md, Claude Code membaca AGENTS.md sebagai gantinya; ubahnya di bawah "Project instructions" dalam /config (belum tersedia di Bedrock, Vertex atau Foundry)
— Anthropic, commit ca02e7d CHANGELOG.md claude-code, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
Terjemahan: sokongan untuk `AGENTS.md` telah ditambahkan—dalam projek tanpa `CLAUDE.md`, Claude Code kini membaca `AGENTS.md` sebagai gantinya; tetapan ini boleh diubah dalam “Project instructions” di `/config` (belum tersedia di Bedrock, Vertex atau Foundry).
Sebelum versi ini, ketiadaan `CLAUDE.md`, `.claude/CLAUDE.md` dan `CLAUDE.local.md` dalam direktori kerja dan direktori di atasnya sahaja tidak membolehkan `AGENTS.md` dibaca. Import eksplisit, pautan simbolik atau hook manual diperlukan. Kini, apabila ciri ini tersedia, ejen mengambil fail itu secara automatik.
## Fail yang menghalang pembacaan automatik AGENTS.md
Inti utama
Dalam mod lalai, `CLAUDE.md`, `.claude/CLAUDE.md` dan `CLAUDE.local.md` diperiksa dalam direktori kerja dan direktori di atasnya. `~/.claude/CLAUDE.md` peribadi, `CLAUDE.md` yang diurus organisasi dan fail `.claude/rules/` tidak menghalang pembacaan `AGENTS.md` dan dimuatkan bersamanya.
Jika anda mempunyai `~/.claude/CLAUDE.md` peribadi dengan tetapan gaya pengekodan, fail itu tidak akan menghalang Claude Code daripada membaca `AGENTS.md` projek. Namun, sebarang `CLAUDE.local.md` dalam direktori kerja—termasuk yang tidak ditambahkan ke Git dan digunakan untuk nota peribadi—menghalang pembacaan automatik `AGENTS.md` dalam mod lalai. Import eksplisit tetap berfungsi; untuk membaca kedua-dua fail secara langsung, anda perlu menukar mod.
Jika mod pembacaan langsung dipilih di bawah Project instructions (lihat “4 mod Project instructions—yang mana perlu dipilih” di bawah) dan tiada `CLAUDE.md`, `.claude/CLAUDE.md` atau `CLAUDE.local.md` dalam direktori kerja atau direktori di atasnya, Claude Code membaca setiap `AGENTS.md` dan `.claude/AGENTS.md` dalam direktori tersebut apabila sesi bermula. Bagi keadaan tanpa fail yang menghalang, dokumentasi menunjukkan baris seperti ini dalam sesi interaktif:
```
no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md
```
Fail `AGENTS.md` dalam subdirektori dimuatkan apabila Claude membuka fail di situ menggunakan alat Read. Dalam mod `claude-md-or-agents-md`, ini berlaku hanya jika subdirektori itu tidak mempunyai `CLAUDE.md`, `.claude/CLAUDE.md` atau `CLAUDE.local.md` sendiri. Bagi `claude-md-and-agents-md`, dokumentasi menerangkan peraturan umum: `CLAUDE.md` dan `AGENTS.md` dibaca bersama, dengan `CLAUDE.md` dahulu dan kemudian `AGENTS.md` dalam setiap direktori. `AGENTS.local.md`, `AGENTS.override.md` dan apa-apa dalam direktori `.agents/` tidak dibaca secara automatik.
Bahan tentang mengkonfigurasi ruang kerja ejen AI, termasuk fail arahan yang mengandungi konteks projek, tersedia dalam [dokumentasi Ailoot](https://ailoot.ai/docs/).
[Panduan Ailoot](https://ailoot.ai/docs/)
## 4 mod Project instructions—yang mana perlu dipilih
Inti utama
Dalam bahagian Project instructions bagi arahan `/config`, terdapat empat nilai: `claude-md-or-agents-md` (lalai—salah satu daripada dua fail), `claude-md-and-agents-md` (kedua-duanya bersama), `claude-md` (hanya `CLAUDE.md` dibaca secara automatik, walaupun projek hanya mempunyai `AGENTS.md`) dan `managed-only` (semasa permulaan—hanya `CLAUDE.md` yang diurus organisasi dan memori automatik, tanpa fail projek atau peribadi). Perubahan berkuat kuasa mulai mesej seterusnya yang dihantar dan dalam setiap sesi baharu.
Tingkah laku mod dalam jadual diterangkan dalam dokumentasi Anthropic. Lajur kanan memberikan cadangan tentang masa untuk memilih setiap mod:
| Nilai | Perkara yang dibaca Claude Code | Bila hendak digunakan |
|----|----|----|
| `claude-md-or-agents-md` | `CLAUDE.md`, atau `AGENTS.md` jika tiada `CLAUDE.md`, `.claude/CLAUDE.md` atau `CLAUDE.local.md` dalam direktori kerja atau direktori di atasnya | Lalai, jika repositori hanya menggunakan salah satu daripada dua fail itu dan tiada fail yang menghalang di atasnya |
| `claude-md-and-agents-md` | Kedua-dua fail bersama: dalam setiap direktori, `CLAUDE.md` dahulu, kemudian `AGENTS.md` | Anda memerlukan `AGENTS.md` bersama untuk semua alat serta `CLAUDE.md` ringkas khusus untuk Claude; atau anda perlu membaca `AGENTS.md` apabila `CLAUDE.local.md` wujud |
| `claude-md` | Hanya `CLAUDE.md`; pembacaan automatik `AGENTS.md` melalui Project instructions dinyahdayakan, walaupun `AGENTS.md` satu-satunya fail (import eksplisit `@AGENTS.md` daripada `CLAUDE.md` tetap berfungsi) | `AGENTS.md` ditulis untuk alat lain dan mungkin mengelirukan Claude |
| `managed-only` | Pada permulaan sesi—hanya `CLAUDE.md` yang diurus organisasi dan memori automatik; fail `CLAUDE.md` projek, setempat dan pengguna, `.claude/rules/` serta semua fail `AGENTS.md` dikecualikan daripada set awal. Walau bagaimanapun, fail `CLAUDE.md` dan `.claude/rules/` dalam subdirektori masih dimuatkan kemudian apabila Claude membuka fail di situ. Mod ini mengehadkan set awal dan tidak memberikan pengasingan penuh daripada fail projek | Untuk organisasi yang mengambil berat tentang set arahan yang digunakan Claude Code untuk memulakan sesi, tanpa mengira sama ada projek itu mengandungi `CLAUDE.md` atau `AGENTS.md` |
Anda juga boleh memilih mod tanpa antara muka, melalui `settings.json`:
```json
{
"pluginConfigs": {
"agents-md@builtin": {
"options": {
"instructionFiles": "claude-md-and-agents-md"
}
}
}
}
```
Claude Code mengabaikan nilai ini dalam tetapan `project` dan `local`. Menurut dokumentasi Anthropic, nilai ini boleh ditetapkan dalam `~/.claude/settings.json`, dalam fail `--settings` atau dalam tetapan yang diurus organisasi.
Jika anda sudah mengkonfigurasi fail arahan bersama untuk beberapa alat AI dalam satu repositori, [arahan untuk versi sebelum 2.1.277](https://ailoot.ai/blog/ms/agents-md-claude-md-one-instruction-file/) menerangkan cara import `@` berfungsi. Kaedah ini masih berfungsi sekarang.
## Mengapa Project instructions tiada dalam /config
Inti utama
Menurut dokumentasi Anthropic, bahagian Project instructions mungkin tiada atas sebab berikut:
- Claude Code menggunakan versi lebih lama daripada 2.1.277.
- Sesi tidak menerima bendera ciri daripada Anthropic—contohnya, apabila menggunakan Bedrock, penyedia pihak ketiga yang lain atau apabila telemetri dinyahdayakan.
- Ini ialah sesi pertama sejurus selepas pemasangan atau kemas kini daripada versi lama. Jika ini satu-satunya sebab, ciri tersebut akan muncul dalam sesi seterusnya. `AGENTS.md` sendiri hanya akan dimuatkan jika syarat mod yang dipilih dipenuhi.
- Pemalam terbina dalam `agents-md` dinyahdayakan dalam `/plugin`.
Mula-mula, semak versi dengan arahan `claude --version`. Jika versinya lebih lama daripada 2.1.277, kemas kini Claude Code. Jika versinya sesuai tetapi bahagian itu masih tidak muncul, semak sebab-sebab lain yang disenaraikan di atas. Selagi ciri ini belum tersedia, import `@AGENTS.md` dalam `CLAUDE.md` kekal sebagai alternatif yang berfungsi.
## Perkara yang perlu dilakukan dengan import @AGENTS.md lama
Inti utama
Anda boleh mengekalkan import `@AGENTS.md` dalam `CLAUDE.md` dan pautan simbolik: fail itu tidak akan dibaca dua kali dalam mana-mana mod. Permintaan bertulis untuk “membaca AGENTS.md” patut digantikan dengan import jika anda mengekalkan `CLAUDE.md`. Sebelum memadamkan fail, simpan semua arahan yang diperlukan dan semak syarat mod yang dipilih. Jika anda beralih kepada pembacaan langsung, buang sebarang hook `SessionStart` yang mencetak kandungan `AGENTS.md` secara manual; jika tidak, salinan kedua fail itu akan masuk ke dalam konteks. Selepas itu, semak pemuatan dalam sesi baharu; cara menyemaknya bergantung pada versi dan sama ada fail yang menghalang wujud.
Langkah seterusnya bergantung pada persediaan lama. Mula-mula, pastikan ciri ini tersedia dalam sesi anda seperti yang diterangkan dalam bahagian sebelumnya.
- **`CLAUDE.md` dengan import `@AGENTS.md`.** Anda boleh membiarkannya seperti sedia ada—Claude Code tidak akan membaca fail itu dua kali dengan mana-mana nilai Project instructions. Memadamkan `CLAUDE.md` adalah pilihan: import itu sudah memberikan Claude akses kepada kandungan `AGENTS.md`. Teruskan menyemak pemuatan melalui import menggunakan `/memory`; soalan terus kepada Claude tentang kandungan arahan hanyalah semakan yang lemah.
- **`CLAUDE.md` yang meminta secara bertulis supaya `AGENTS.md` dibaca.** Permintaan sedemikian bukan import dan dengan sendirinya tidak menjamin fail itu akan dimuatkan. Gantikan perkataan itu dengan import `@AGENTS.md` jika anda mahu mengekalkan `CLAUDE.md` (contohnya, untuk alat yang turut membacanya). Jika anda memutuskan untuk memadamkan `CLAUDE.md` sepenuhnya dan mod `claude-md-or-agents-md` dipilih, semak dahulu bahawa `CLAUDE.md` tidak mengandungi arahan unik dan tiada `CLAUDE.md`, `.claude/CLAUDE.md` atau `CLAUDE.local.md` lain dalam direktori kerja atau direktori di atasnya; jika tidak, Claude Code akan terus membaca fail yang masih ada itu dan bukannya `AGENTS.md`. Selepas memadamkannya, pastikan peralihan telah berlaku: apabila tiada lagi fail yang menghalang, baris `AGENTS.md loaded` muncul dalam sesi interaktif. Jika `CLAUDE.md` dikekalkan dan kedua-dua fail dibaca dalam mod `claude-md-and-agents-md`, semak `/memory` (dalam versi 2.1.280+). Soalan terus kepada Claude tidak dapat membezakan pembacaan langsung daripada import.
- **Pautan simbolik `CLAUDE.md` ke `AGENTS.md`.** Anda boleh mengekalkannya: tiada pembacaan berganda dalam mana-mana mod. Sebelum memadamkan pautan dalam mod `claude-md-or-agents-md`, semak bahawa arahan yang diperlukan telah dikekalkan dan tiada `CLAUDE.md`, `.claude/CLAUDE.md` atau `CLAUDE.local.md` lain dalam direktori kerja atau direktori di atasnya. Semak pemuatan dengan cara yang sama: melalui baris `AGENTS.md loaded` pada permulaan sesi apabila tiada fail yang menghalang, atau melalui `/memory` (2.1.280+). Jika `CLAUDE.md` dikekalkan dalam mod `claude-md-and-agents-md`, soalan terus kepada Claude hanyalah semakan yang lemah. Ketiadaan ralat tidak cukup untuk mengesahkan pemuatan.
- **Hook `SessionStart` yang mencetak kandungan `AGENTS.md` secara manual.** Apabila fail dibaca secara langsung, hook sedemikian menambahkan salinan kedua ke dalam konteks. Semasa hook berjalan, soalan “apakah kandungan arahan anda?” tidak mengesahkan pembacaan langsung: Claude mungkin menjawab berdasarkan teks yang ditambahkan oleh hook. Beralih mengikut urutan ini:
1. Semak bahawa ciri ini tersedia: versi 2.1.277 atau lebih baharu, sesi menerima bendera ciri, pemalam didayakan dan sesi pertama selepas pemasangan atau kemas kini telah selesai. Pilih mod pembacaan langsung—bukan `claude-md` atau `managed-only`. Untuk mod lalai, semak juga bahawa tiada fail yang menghalang.
2. Buang hook.
3. Tutup sesi dan buka sesi baharu. Hook `SessionStart` menambahkan teksnya semasa permulaan, jadi kandungannya kekal dalam konteks sesi yang sudah terbuka. Jawapan Claude tentang kandungan arahan dalam sesi sedemikian tidak mengesahkan pembacaan langsung.
4. Semak pemuatan dalam sesi baharu. Dalam versi 2.1.280+, laluan ke `AGENTS.md` kelihatan dalam `/memory`. Dalam versi 2.1.277–2.1.279, jika tiada fail yang menghalang, cari baris `AGENTS.md loaded` semasa permulaan: dokumentasi menerangkannya khusus untuk keadaan apabila tiada `CLAUDE.md` ditemui. Jika anda mengekalkan `CLAUDE.md` dan menggunakan mod `claude-md-and-agents-md`, pemeriksaan adalah terhad: `/memory` tidak menunjukkan `AGENTS.md` dalam versi ini, dokumentasi tidak menerangkan baris pemuatan untuk keadaan ini, dan parafrasa arahan tidak dapat membezakan pembacaan langsung daripada import `@` dalam `CLAUDE.md`. Dalam keadaan itu, kemas kini kepada versi 2.1.280+ dan semak `/memory`.
## Cara menyemak sama ada AGENTS.md telah dimuatkan
Inti utama
Mulai versi 2.1.280, `AGENTS.md` yang dimuatkan melalui Project instructions muncul dalam `/memory` dan senarai Memory files bagi arahan `/context`. Dalam versi 2.1.277–2.1.279, ia tidak muncul di situ, walaupun arahan itu sendiri berfungsi dan menunjukkan `CLAUDE.md` serta fail memori lain yang telah dimuatkan. Dalam versi ini, jika tiada fail yang menghalang, semak baris `AGENTS.md loaded` pada permulaan sesi. Bertanya kepada Claude tentang kandungan arahan hanyalah semakan yang lemah: jawapannya tidak dapat membezakan pembacaan langsung daripada import `@` dan mungkin bergantung pada teks yang ditambahkan oleh hook `SessionStart`. Oleh itu, pertanyaan sedemikian hanya wajar dibuat dalam sesi baharu selepas hook itu dibuang.
Terdapat dua lagi perbezaan berbanding `CLAUDE.md` biasa: hook `InstructionsLoaded` tidak dicetuskan untuk jenis `AGENTS.md` ini (hook tersebut berfungsi untuk `AGENTS.md` yang diimport melalui sintaks `@` daripada `CLAUDE.md` atau disambungkan melalui pautan simbolik `CLAUDE.md`); direktori yang ditambahkan dengan bendera `--add-dir` bersama pemboleh ubah `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` hanya memuatkan `CLAUDE.md` direktori itu—`AGENTS.md` di situ tidak disertakan.
Jika anda perlu menyemak kandungan fail arahan projek yang besar, lihat analisis berasingan [tentang cara mengkonfigurasi CLAUDE.md tanpa menjadikannya terlalu panjang](https://ailoot.ai/blog/ms/claude-md-template/). Analisis itu membincangkan struktur arahan, manakala syarat untuk memuatkan `AGENTS.md` diterangkan di atas. Untuk nota kerja antara sesi, lihat analisis [tentang otak kedua dalam Claude Code](https://ailoot.ai/blog/ms/claude-code-second-brain/)—mengenai memori peribadi yang ditambah di atas arahan projek.
## Apa seterusnya
Ciri ini dikeluarkan pada 18 September 2026 dalam versi 2.1.277. Anthropic mungkin menjelaskan butiran mod dalam keluaran akan datang, jadi sebelum mengubah tetapan dalam projek penting, bandingkan artikel ini dengan `/config` semasa dan changelog rasmi.
### Sumber
- [Claude Code, commit CHANGELOG.md yang mengandungi entri 2.1.277 di GitHub (18 September 2026)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3)
- [Dokumentasi Claude Code: Cara Claude mengingati projek anda - bahagian AGENTS.md](https://code.claude.com/docs/en/memory)
[Panduan Ailoot](https://ailoot.ai/docs/)
[Pergi ke Ailoot](https://ailoot.ai/)
## Soalan lazim: Claude Code Kini Membaca AGENTS.md: Perkara yang Berubah dalam 2.1.277
### Mengapakah AGENTS.md tidak dimuatkan walaupun fail itu wujud?
Dalam mod lalai, CLAUDE.md, .claude/CLAUDE.md atau CLAUDE.local.md dalam direktori kerja atau direktori induk menyekat pemilihan AGENTS.md automatik. Semak juga versi Claude Code, ketersediaan ciri dan mod Project instructions dalam /config.
### Bagaimanakah saya mengesahkan pemuatan langsung selepas membuang hook manual?
Buka sesi baharu supaya output SessionStart lama tiada. Dalam versi 2.1.280 atau lebih baharu, periksa /memory atau senarai Memory files dalam /context; pada 2.1.277–2.1.279, baris pemuatan permulaan terpakai apabila tiada fail CLAUDE.md yang menyekat. Parafrasa Claude sahaja ialah bukti lemah.
## Ailoot · Syarikat dan portfolio projeknya
Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.
Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.
Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.