Claude Code Kini Membaca AGENTS.md: Perkara yang Berubah dalam 2.1.277

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.

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.

Apakah yang berubah dalam versi 2.1.277?#

Fail CHANGELOG.md projek Claude Code rasmi di GitHub menerangkannya begini:

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#

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.

4 mod Project instructions—yang mana perlu dipilih#

Tingkah laku mod dalam jadual diterangkan dalam dokumentasi Anthropic. Lajur kanan memberikan cadangan tentang masa untuk memilih setiap mod:

Anda juga boleh memilih mod tanpa antara muka, melalui settings.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 menerangkan cara import @ berfungsi. Kaedah ini masih berfungsi sekarang.

Mengapa Project instructions tiada dalam /config#

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#

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#

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. 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—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.