Claude Code อ่าน AGENTS.md แล้ว: มีอะไรเปลี่ยนไปใน 2.1.277

เมื่อวันที่ 18 กันยายน 2026 มีการเพิ่มการรองรับ AGENTS.md ใน Claude Code 2.1.277 หากฟีเจอร์นี้พร้อมใช้งานในเซสชันและในไดเรกทอรีทำงาน และไม่มี CLAUDE.md, .claude/CLAUDE.md หรือ CLAUDE.local.md อยู่ที่ใดก็ตามในลำดับไดเรกทอรีด้านบน Claude Code จะอ่าน AGENTS.md โดยค่าเริ่มต้นโดยไม่ต้องนำเข้าด้วยตนเอง ก่อนหน้านี้ทำได้โดยนำเข้า @AGENTS.md ใน CLAUDE.md หรือใช้ลิงก์สัญลักษณ์จาก CLAUDE.md ไปยัง AGENTS.md—ดูรายละเอียดเพิ่มเติมได้ในบทความเกี่ยวกับไฟล์คำสั่งไฟล์เดียวสำหรับหลายเอเจนต์

หากคุณใช้ Claude Code และเครื่องมืออื่นอีกหนึ่งหรือสองตัวในรีโพซิทอรีเดียวกัน โหมด Project instructions ที่คุณเลือกจะกำหนดว่า Claude Code อ่านไฟล์คำสั่งใดบ้าง ด้านล่างนี้คือเงื่อนไขของแต่ละโหมดทั้งสี่แบบและขั้นตอนการเปลี่ยนจากการตั้งค่าแบบเดิม

มีเอกสารเพิ่มเติมเกี่ยวกับการกำหนดค่าเครื่องมือในเอกสารของ Ailoot

มีอะไรเปลี่ยนไปในเวอร์ชัน 2.1.277?#

ไฟล์ CHANGELOG.md อย่างเป็นทางการของโปรเจกต์ Claude Code บน GitHub ระบุไว้ดังนี้:

กล่าวคือ มีการเพิ่มการรองรับ AGENTS.md—ในโปรเจกต์ที่ไม่มี CLAUDE.md ตอนนี้ Claude Code จะอ่าน AGENTS.md แทน โดยสามารถสลับได้ใน “Project instructions” ที่ /config (ยังไม่พร้อมใช้งานบน Bedrock, Vertex หรือ Foundry)

ก่อนเวอร์ชันนี้ การไม่มี CLAUDE.md, .claude/CLAUDE.md และ CLAUDE.local.md ในโฟลเดอร์ทำงานและไดเรกทอรีด้านบน ไม่ได้ทำให้มีการอ่าน AGENTS.md โดยอัตโนมัติ ต้องนำเข้าอย่างชัดเจน ใช้ลิงก์สัญลักษณ์ หรือใช้ hook ด้วยตนเอง ตอนนี้เมื่อฟีเจอร์พร้อมใช้งาน เอเจนต์จะอ่านไฟล์นี้โดยอัตโนมัติ

ไฟล์ใดบ้างที่ขัดขวางการอ่าน AGENTS.md โดยอัตโนมัติ#

หากคุณมี ~/.claude/CLAUDE.md ส่วนตัวที่กำหนดรูปแบบการเขียนโค้ดไว้ ไฟล์นี้จะไม่ขัดขวาง Claude Code จากการอ่าน AGENTS.md ของโปรเจกต์ แต่ CLAUDE.local.md ใด ๆ ในโฟลเดอร์ทำงาน—แม้จะไม่ได้เพิ่มเข้า Git และใช้จดบันทึกส่วนตัว—จะขัดขวางการอ่าน AGENTS.md โดยอัตโนมัติในโหมดเริ่มต้น การนำเข้าอย่างชัดเจนยังคงทำงานได้ หากต้องการอ่านทั้งสองไฟล์โดยตรง คุณต้องเปลี่ยนโหมด

หากเลือกโหมดอ่านโดยตรงใน Project instructions (ดู “โหมด Project instructions 4 แบบ—ควรเลือกแบบใด” ด้านล่าง) และไม่มี CLAUDE.md, .claude/CLAUDE.md หรือ CLAUDE.local.md ในไดเรกทอรีทำงานหรือไดเรกทอรีด้านบน Claude Code จะอ่าน AGENTS.md และ .claude/AGENTS.md ทุกไฟล์ในไดเรกทอรีเหล่านั้นเมื่อเริ่มเซสชัน สำหรับกรณีที่ไม่มีไฟล์ขัดขวาง เอกสารแสดงบรรทัดลักษณะนี้ในเซสชันแบบโต้ตอบ:

no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md

ระบบจะโหลดไฟล์ AGENTS.md ในไดเรกทอรีย่อยเมื่อ Claude เปิดไฟล์ในไดเรกทอรีนั้นโดยใช้เครื่องมือ Read ในโหมด claude-md-or-agents-md จะเกิดขึ้นเฉพาะเมื่อไดเรกทอรีย่อยนั้นไม่มี CLAUDE.md, .claude/CLAUDE.md หรือ CLAUDE.local.md ของตัวเอง สำหรับ claude-md-and-agents-md เอกสารอธิบายกฎทั่วไปว่าให้อ่าน CLAUDE.md และ AGENTS.md ด้วยกัน โดยอ่าน CLAUDE.md ก่อน แล้วจึงอ่าน AGENTS.md ในแต่ละไดเรกทอรี ระบบจะไม่อ่าน AGENTS.local.md, AGENTS.override.md และสิ่งใดก็ตามในไดเรกทอรี .agents/ โดยอัตโนมัติ

มีเอกสารเกี่ยวกับการกำหนดค่าเวิร์กสเปซของเอเจนต์ AI รวมถึงไฟล์คำสั่งที่มีบริบทของโปรเจกต์ในเอกสารของ Ailoot

โหมด Project instructions 4 แบบ—ควรเลือกแบบใด#

พฤติกรรมของโหมดในตารางอธิบายไว้ในเอกสารของ Anthropic คอลัมน์ขวาสุดให้คำแนะนำในการเลือก:

คุณยังเลือกโหมดได้โดยไม่ต้องใช้ส่วนติดต่อ ผ่าน settings.json:

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

Claude Code จะไม่ใช้ค่านี้ใน project และ local settings ตามเอกสารของ Anthropic สามารถกำหนดค่าได้ใน ~/.claude/settings.json, ไฟล์ --settings หรือการตั้งค่าที่องค์กรจัดการ

หากคุณตั้งค่าไฟล์คำสั่งที่ใช้ร่วมกันสำหรับเครื่องมือ AI หลายตัวในรีโพซิทอรีเดียวกันไว้แล้ว คำแนะนำสำหรับเวอร์ชันก่อน 2.1.277 อธิบายวิธีนำเข้าไฟล์ด้วย @ วิธีนี้ยังใช้งานได้ในปัจจุบัน

เหตุใดจึงไม่มี Project instructions ใน /config#

เริ่มจากตรวจสอบเวอร์ชันด้วยคำสั่ง claude --version หากต่ำกว่า 2.1.277 ให้อัปเดต Claude Code หากเวอร์ชันเหมาะสมแต่ส่วนนี้ยังไม่ปรากฏ ให้ตรวจสอบสาเหตุอื่น ๆ ที่ระบุไว้ข้างต้น ระหว่างที่ฟีเจอร์ยังใช้งานไม่ได้ การนำเข้า @AGENTS.md ใน CLAUDE.md ยังคงเป็นวิธีสำรองที่ใช้ได้

ควรทำอย่างไรกับการนำเข้า @AGENTS.md แบบเดิม#

ขั้นตอนถัดไปขึ้นอยู่กับการตั้งค่าเดิม ก่อนอื่น ตรวจสอบให้แน่ใจว่าฟีเจอร์พร้อมใช้งานในเซสชันของคุณตามที่อธิบายไว้ในหัวข้อก่อนหน้า

• CLAUDE.md ที่นำเข้า @AGENTS.md คุณปล่อยไว้ตามเดิมได้—Claude Code จะไม่อ่านไฟล์ซ้ำไม่ว่าคุณจะเลือกค่า Project instructions ใด การลบ CLAUDE.md เป็นทางเลือก: การนำเข้าก็ทำให้ Claude เข้าถึงเนื้อหาของ AGENTS.md อยู่แล้ว ตรวจสอบการโหลดผ่านการนำเข้าต่อไปด้วย /memory; การถาม Claude โดยตรงเกี่ยวกับเนื้อหาคำสั่งเป็นเพียงการตรวจสอบที่ไม่ชัดเจนนัก
• CLAUDE.md ที่เขียนขอให้อ่าน AGENTS.md คำขอเช่นนี้ไม่ใช่การนำเข้า และไม่ได้รับประกันด้วยตัวเองว่าไฟล์จะถูกโหลด หากต้องการเก็บ CLAUDE.md ไว้ (เช่น สำหรับเครื่องมืออื่นที่อ่านไฟล์นี้ด้วย) ให้แทนข้อความนั้นด้วยการนำเข้า @AGENTS.md หากตัดสินใจลบ CLAUDE.md ทั้งหมดและเลือกโหมด claude-md-or-agents-md ให้ตรวจสอบก่อนว่า CLAUDE.md ไม่มีคำสั่งเฉพาะที่จำเป็น และไม่มี CLAUDE.md, .claude/CLAUDE.md หรือ CLAUDE.local.md อื่นในไดเรกทอรีทำงานหรือด้านบน มิฉะนั้น Claude Code จะยังอ่านไฟล์ที่เหลืออยู่แทน AGENTS.md หลังลบแล้ว ให้ตรวจสอบว่าการเปลี่ยนผ่านเกิดขึ้นแล้ว: เมื่อไม่มีไฟล์ขัดขวางเหลืออยู่ บรรทัด AGENTS.md loaded จะปรากฏในเซสชันแบบโต้ตอบ หากเก็บ CLAUDE.md ไว้และอ่านทั้งสองไฟล์ในโหมด claude-md-and-agents-md ให้ตรวจสอบ /memory (ในเวอร์ชัน 2.1.280 ขึ้นไป) คำถามโดยตรงถึง Claude ไม่สามารถแยกแยะการโหลดโดยตรงออกจากการนำเข้าได้
• ลิงก์สัญลักษณ์จาก CLAUDE.md ไปยัง AGENTS.md คุณเก็บไว้ได้: ไม่มีโหมดใดอ่านซ้ำ ก่อนลบลิงก์ในโหมด claude-md-or-agents-md ให้ตรวจสอบว่าคำสั่งที่จำเป็นยังคงอยู่ครบ และไม่มี CLAUDE.md, .claude/CLAUDE.md หรือ CLAUDE.local.md อื่นในไดเรกทอรีทำงานหรือด้านบน ตรวจสอบการโหลดด้วยวิธีเดียวกัน: ดูบรรทัด AGENTS.md loaded ตอนเริ่มเซสชันเมื่อไม่มีไฟล์ขัดขวาง หรือดู /memory (2.1.280 ขึ้นไป) หากยังมี CLAUDE.md ในโหมด claude-md-and-agents-md การถาม Claude โดยตรงเป็นเพียงการตรวจสอบที่ไม่ชัดเจนนัก การไม่มีข้อผิดพลาดไม่เพียงพอที่จะยืนยันว่าไฟล์ถูกโหลดแล้ว
• hook SessionStart ที่พิมพ์เนื้อหา AGENTS.md ด้วยตนเอง เมื่ออ่านไฟล์โดยตรง hook เช่นนี้จะเพิ่มสำเนาที่สองเข้าไปในบริบท ขณะ hook ทำงาน คำถาม “ในคำสั่งของคุณมีอะไรบ้าง?” ไม่ยืนยันว่าโหลดไฟล์โดยตรง: Claude อาจตอบจากข้อความที่ hook เพิ่มเข้ามา เปลี่ยนตามลำดับนี้:
  1. ตรวจสอบว่าฟีเจอร์พร้อมใช้งาน: เวอร์ชัน 2.1.277 ขึ้นไป เซสชันได้รับ feature flags ปลั๊กอินเปิดใช้งานแล้ว และเซสชันแรกหลังติดตั้งหรืออัปเดตเสร็จสมบูรณ์ เลือกโหมดอ่านโดยตรง—ไม่ใช่ claude-md หรือ managed-only สำหรับโหมดเริ่มต้น ให้ตรวจสอบเพิ่มเติมว่าไม่มีไฟล์ขัดขวาง
  2. ลบ hook
  3. ปิดเซสชันแล้วเปิดใหม่ hook SessionStart เพิ่มข้อความเมื่อเริ่มต้น ดังนั้นเนื้อหาของ hook จะยังอยู่ในบริบทของเซสชันที่เปิดไว้แล้ว คำตอบของ Claude เกี่ยวกับเนื้อหาคำสั่งในเซสชันดังกล่าวจะยืนยันการโหลดโดยตรงไม่ได้
  4. ตรวจสอบการโหลดในเซสชันใหม่ ในเวอร์ชัน 2.1.280 ขึ้นไป เส้นทางไปยัง AGENTS.md จะปรากฏใน /memory ในเวอร์ชัน 2.1.277–2.1.279 หากไม่มีไฟล์ขัดขวาง ให้มองหาบรรทัด AGENTS.md loaded ตอนเริ่มต้น: เอกสารระบุบรรทัดนี้ไว้โดยเฉพาะสำหรับกรณีที่ไม่พบ CLAUDE.md หากเก็บ CLAUDE.md ไว้และใช้โหมด claude-md-and-agents-md การตรวจสอบมีข้อจำกัด: /memory ไม่แสดง AGENTS.md ในเวอร์ชันเหล่านี้ เอกสารไม่ได้อธิบายบรรทัดแจ้งการโหลดสำหรับกรณีนี้ และการถอดความคำสั่งไม่สามารถแยกการอ่านโดยตรงออกจากการนำเข้า @ ภายใน CLAUDE.md ในกรณีนี้ให้อัปเดตเป็น 2.1.280 ขึ้นไปแล้วตรวจสอบด้วย /memory

วิธีตรวจสอบว่า AGENTS.md โหลดแล้ว#

ยังมีความแตกต่างอีกสองข้อเมื่อเทียบกับ CLAUDE.md ทั่วไป: hook InstructionsLoaded จะไม่ทำงานกับ AGENTS.md ที่โหลดด้วยวิธีนี้ (แต่ทำงานกับ AGENTS.md ที่นำเข้าผ่านไวยากรณ์ @ จาก CLAUDE.md หรือเชื่อมโยงด้วยลิงก์สัญลักษณ์ CLAUDE.md); ไดเรกทอรีที่เพิ่มด้วยแฟล็ก --add-dir พร้อมกับตัวแปร CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD จะโหลดเฉพาะ CLAUDE.md ของไดเรกทอรีนั้น—ไม่รวม AGENTS.md

หากต้องการทบทวนเนื้อหาของไฟล์คำสั่งโปรเจกต์ขนาดใหญ่ โปรดดูบทวิเคราะห์แยกต่างหากเกี่ยวกับวิธีกำหนดค่า CLAUDE.md โดยไม่ทำให้ไฟล์พองโต ซึ่งกล่าวถึงโครงสร้างของคำสั่ง ส่วนเงื่อนไขการโหลด AGENTS.md อธิบายไว้ข้างต้น สำหรับบันทึกการทำงานระหว่างเซสชัน โปรดดูบทวิเคราะห์เรื่องสมองส่วนที่สองใน Claude Code—เกี่ยวกับหน่วยความจำส่วนตัวที่ซ้อนทับอยู่บนคำสั่งของโปรเจกต์

ต่อไปควรทำอะไร#

ฟีเจอร์นี้เปิดตัวเมื่อวันที่ 18 กันยายน 2026 ในเวอร์ชัน 2.1.277 Anthropic อาจชี้แจงรายละเอียดของโหมดต่าง ๆ ในรุ่นต่อ ๆ ไป ดังนั้นก่อนเปลี่ยนการตั้งค่าในโปรเจกต์สำคัญ ให้เทียบบทความนี้กับ /config เวอร์ชันปัจจุบันและ changelog อย่างเป็นทางการ