CLAUDE.md คืออะไร คู่มือคำสั่งสำหรับ Claude Code
ทำความรู้จักไฟล์ CLAUDE.md คู่มือคำสั่งในรูปแบบ Markdown ที่ช่วยให้ Claude Code จดจำบริบท กฎ และคำสั่งโปรเจกต์ได้ในทุกเซสชัน
ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง
- CLAUDE.md เป็นไฟล์ Markdown ที่เก็บบริบทและคำสั่งสำหรับ Claude Code ในทุกเซสชัน
- การสร้างไฟล์เริ่มต้นทำได้ง่ายๆ ด้วยคำสั่ง /init ในเครื่องมือ
- ไฟล์สามารถรองรับการนำเข้าไฟล์อื่นผ่านคำสั่ง @path/to/file ได้ลึกสูงสุด 4 ชั้น
- การจัดการความขัดแย้งของกฎในไฟล์ต้องอาศัยการตรวจสอบด้วยตนเองเพราะไม่มีระบบทับซ้อน
ในทุกครั้งที่คุณเริ่มใช้งานเซสชันใหม่ของ Claude Code ระบบจะเริ่มต้นด้วยหน้าต่างบริบทที่ว่างเปล่า การรักษาความต่อเนื่องของข้อมูลจึงอาศัยสองส่วนหลัก ได้แก่ ไฟล์ CLAUDE.md ที่คุณเขียนขึ้นเองเพื่อระบุคำสั่ง กฎ และข้อตกลงของโปรเจกต์ และระบบบันทึกความจำอัตโนมัติที่ Claude เขียนบันทึกจากคำแนะนำของคุณ ทั้งสองส่วนนี้จะถูกโหลดเข้ามาทำงานพร้อมกันในทุกครั้งที่เริ่มต้นเซสชันใหม่
ทางเอกสารของ Anthropic ระบุว่าไฟล์ CLAUDE.md ทำหน้าที่เป็นพื้นที่สำหรับบันทึกสิ่งที่คุณอาจจะต้องคอยอธิบายซ้ำๆ ให้ AI ฟัง โดย Claude จะพยายามอ่านและปฏิบัติตามคำแนะนำเหล่านั้น แม้ว่าในทางเทคนิคแล้วมันจะเป็นเพียงบริบทและไม่ใช่การบังคับตั้งค่าระบบโดยตรง หากมีคำสั่งใดที่จำเป็นต้องทำงานทุกครั้ง เช่น การตรวจสอบโค้ดก่อนทำการ commit เอกสารแนะนำให้ใช้งานระบบ hooks แทน ส่วนการตั้งค่าสิทธิ์หรือตัวแปรสภาพแวดล้อมควรเก็บไว้ในไฟล์ตั้งค่าอย่าง .claude/settings.json มากกว่า
สำหรับการเริ่มต้นใช้งาน คุณสามารถรันคำสั่ง /init เพื่อให้ระบบตรวจสอบฐานโค้ดและสร้างไฟล์ CLAUDE.md ที่มีคำสั่งสร้างโปรเจกต์ คำสั่งทดสอบ และข้อตกลงต่างๆ ให้โดยอัตโนมัติ และหากมีไฟล์ดังกล่าวอยู่แล้ว คำสั่ง /init จะทำหน้าที่เสนอแนะแนวทางปรับปรุงแทนที่จะเขียนทับไฟล์เดิมทันที
ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง
ไฟล์ CLAUDE.md สามารถจัดวางได้ใน 4 ตำแหน่งที่แตกต่างกัน ซึ่งแต่ละตำแหน่งจะมีขอบเขตการทำงานเฉพาะตัว ระบบของ Claude Code จะทำการโหลดไฟล์จากไดเรกทอรีการทำงานปัจจุบันและไดเรกทอรีทั้งหมดที่อยู่เหนือขึ้นไป โดยจะทำการเชื่อมต่อเนื้อหาจากทุกไฟล์เข้าด้วยกัน แทนที่จะใช้ระบบไฟล์ใดไฟล์หนึ่งไปทับไฟล์อื่น ลำดับการอ่านจะเริ่มจากภาพกว้างไปยังภาพแคบสุด ได้แก่ ระดับจัดการ ระดับผู้ใช้ และระดับโปรเจกต์
เนื่องจากไม่มีการทับซ้อนของไฟล์ ความรับผิดชอบในการจัดการข้อขัดแย้งจึงตกเป็นของผู้พัฒนา หากมีกฎสองข้อขัดแย้งกันเอง Claude อาจเลือกปฏิบัติตามข้อใดข้อหนึ่งโดยไม่มีกฎตายตัว นอกจากนี้ หากโปรเจกต์ของคุณมีไฟล์ AGENTS.md สำหรับเครื่องมือเขียนโค้ดตัวอื่น Claude Code จะอ่านไฟล์ดังกล่าวก็ต่อเมื่อไม่พบไฟล์ CLAUDE.md หรือ CLAUDE.local.md ในไดเรกทอรีปัจจุบันหรือเหนือขึ้นไป
การทำความเข้าใจลำดับการโหลดและการรวมไฟล์ของ CLAUDE.md ถือเป็นหัวใจสำคัญในการบริหารจัดการโปรเจกต์ขนาดใหญ่ การที่ระบบไม่ทับซ้อนไฟล์แต่ใช้วิธีต่อท้ายเนื้อหา ช่วยให้ทีมพัฒนาสามารถกำหนดกฎระเบียบส่วนกลางแล้วค่อยเจาะจงรายละเอียดลงในแต่ละโฟลเดอร์ย่อยได้ยืดหยุ่นมากขึ้น แต่อย่างไรก็ตาม นักพัฒนาต้องระมัดระวังเรื่องกฎที่ขัดแย้งกันเองภายในไฟล์ที่ถูกโหลดรวมกัน
คุณยังสามารถดึงเนื้อหาจากไฟล์อื่นเข้ามาใช้งานได้ผ่านการใช้คำสั่ง @path/to/file โดยเส้นทางสัมพัทธ์จะอ้างอิงจากไฟล์ที่มีการเรียกใช้งานนั้น และการนำเข้าสามารถซ้อนกันได้สูงสุด 4 ชั้น การนำเข้าวิธีนี้ช่วยจัดระเบียบเนื้อหาให้สะอาดตา แต่จะไม่ช่วยประหยัดพื้นที่บริบทเนื่องจากไฟล์ที่ถูกดึงมาจะถูกโหลดพร้อมกับไฟล์หลักทันทีในขั้นตอนเริ่มต้น
ที่มา: Dev.to
พบข้อมูลผิดพลาดในบทความนี้? แจ้งปัญหาบทความนี้
ความคิดเห็น
แสดงความคิดเห็น