CLAUDE.md คืออะไร — ไฟล์โน้ตประจำโปรเจกต์ที่ AI อ่านทุกครั้ง
รู้จัก CLAUDE.md ไฟล์บันทึกกฎและวิธีทำงานของโปรเจกต์ที่ Claude Code อ่านก่อนเริ่มงานทุกครั้ง พร้อมวิธีสร้างด้วย /init และทิปเขียนให้กระชับ
ลองนึกภาพว่าคุณจ้างผู้ช่วยเก่ง ๆ มาคนหนึ่ง แต่ทุกเช้าเขาลืมหมดว่าโปรเจกต์นี้ทำงานยังไง ต้องคอยบอกซ้ำทุกวันว่าใช้คำสั่งอะไรรัน ห้ามแตะไฟล์ไหน เหนื่อยแค่ไหนลองคิดดู นี่คือปัญหาที่ CLAUDE.md เข้ามาแก้ ไฟล์นี้คือ "โน้ตประจำโปรเจกต์" ที่ AI อ่านทุกครั้งก่อนเริ่มงาน จะได้ไม่ต้องเริ่มนับหนึ่งใหม่ตลอด
CLAUDE.md คืออะไร
CLAUDE.md คือไฟล์ข้อความธรรมดา ที่วางไว้ในโฟลเดอร์โปรเจกต์ของคุณ เมื่อคุณเปิด Claude Code ขึ้นมาทำงาน มันจะ อ่านไฟล์นี้เป็นอย่างแรกโดยอัตโนมัติ เหมือนพนักงานใหม่ที่เปิดคู่มือประจำร้านอ่านก่อนลงมือทำงาน
พูดง่าย ๆ คือมันเป็น บันทึกความจำถาวร ของโปรเจกต์ สิ่งที่คุณจดไว้ในนี้ AI จะจำได้ทุกครั้งที่เริ่มงานใหม่ ไม่ว่าจะเปิดใช้วันนี้ พรุ่งนี้ หรืออีกเดือน ต่างจากการพิมพ์บอกในแชตซึ่งพอปิดหน้าต่างไปก็หายหมด
ในนั้นควรมีอะไรบ้าง
CLAUDE.md ที่ดีไม่ได้ยาว แต่ครบประเด็นที่ AI ต้องรู้เพื่อทำงานถูก ลองใส่สิ่งเหล่านี้
- คำสั่งสำคัญ เช่น คำสั่งรันโปรเจกต์ คำสั่งเทสต์ คำสั่ง build ที่ต้องใช้ก่อนส่งงาน จะได้ไม่ต้องบอกซ้ำ
- โครงสร้างโปรเจกต์ สั้น ๆ ว่าโฟลเดอร์ไหนเก็บอะไร ไฟล์หลักอยู่ตรงไหน
- สไตล์โค้ด เช่น ใช้ย่อหน้ากี่ช่อง ตั้งชื่อตัวแปรแบบไหน ชอบใช้เครื่องมืออะไร
- กฎของทีม เช่น ต้องเขียนเทสต์ทุกครั้ง หรือห้ามแก้ไฟล์บางไฟล์
- สิ่งที่ห้ามทำ เป็นส่วนสำคัญมาก เช่น "ห้าม push ขึ้น main ตรง ๆ" หรือ "ห้ามลบไฟล์ในโฟลเดอร์ data"
ยิ่งข้อห้ามชัด AI ยิ่งพลาดน้อย เพราะมันจะเลี่ยงสิ่งที่คุณบอกว่าอย่าทำ
สร้างง่าย ๆ ด้วย /init
ข่าวดีคือคุณไม่ต้องนั่งเขียนไฟล์นี้เองตั้งแต่ศูนย์ Claude Code มีคำสั่งช่วยชื่อ /init
แค่พิมพ์ /init ในโปรเจกต์ AI จะ สำรวจไฟล์ทั้งหมดในโปรเจกต์ แล้วร่าง CLAUDE.md ให้อัตโนมัติ ทั้งโครงสร้าง คำสั่งที่เจอ และเทคโนโลยีที่ใช้ จากนั้นคุณค่อยอ่านทวนแล้วแก้เพิ่มตามจริง เร็วกว่าเขียนเองเยอะ ถ้าอยากรู้จักคำสั่งพื้นฐานตัวอื่น ๆ ลองอ่าน 5 คำสั่ง Claude Code ที่มือใหม่ต้องรู้ เพิ่มเติมได้
ทิปเขียนให้กระชับและได้ผล
CLAUDE.md ไม่ใช่เรียงความ ยิ่งสั้นและตรงประเด็นยิ่งดี เพราะ AI ต้องอ่านทุกครั้ง ลองยึดหลักนี้
- เขียนเป็นข้อ ๆ อ่านง่ายกว่าย่อหน้ายาว และ AI จับประเด็นได้ไว
- บอกเป็นคำสั่งชัด ๆ เช่น "ใช้
npm run buildก่อน commit เสมอ" ดีกว่าเขียนอ้อม ๆ - ตัดสิ่งที่ไม่จำเป็น อย่าใส่ประวัติโปรเจกต์ยืดยาว เอาเฉพาะสิ่งที่ช่วยให้ทำงานถูก
- จดกฎเมื่อ AI ทำพลาด ถ้าเห็นมันทำอะไรผิดซ้ำ ให้เพิ่มกฎนั้นลงไป ครั้งต่อไปมันจะไม่พลาดอีก
ช่วยประหยัด token ยังไง
จุดที่หลายคนมองข้ามคือ CLAUDE.md ช่วยประหยัดค่าใช้จ่าย ด้วย ทุกครั้งที่คุณพิมพ์อธิบายโปรเจกต์ใหม่ในแชต ข้อความนั้นถูกนับเป็น token ที่ต้องจ่าย ยิ่งอธิบายซ้ำบ่อย ยิ่งเปลือง
พอมี CLAUDE.md คุณจดกฎครั้งเดียว AI ก็รู้ตลอด ไม่ต้องพิมพ์อธิบายซ้ำทุกครั้ง ประหยัดทั้งเวลาและ token ถ้าอยากเข้าใจเรื่องการประหยัดค่าใช้จ่ายให้ลึกขึ้น ลองอ่าน วิธีประหยัด token เมื่อใช้ AI ควบคู่กันได้
สรุป
CLAUDE.md คือไฟล์โน้ตประจำโปรเจกต์ที่ AI อ่านทุกครั้งก่อนเริ่มงาน ทำหน้าที่เป็นความจำถาวรของโปรเจกต์ เก็บทั้งโครงสร้าง คำสั่งสำคัญ สไตล์โค้ด กฎทีม และสิ่งที่ห้ามทำ สร้างได้เร็วด้วยคำสั่ง /init แล้วปรับให้กระชับเป็นข้อ ๆ ผลที่ได้คือ AI ทำงานถูกทางมากขึ้น พลาดน้อยลง และคุณไม่ต้องเสียเวลาอธิบายซ้ำ ประหยัดทั้งแรงและ token ลองเปิด /init ในโปรเจกต์ของคุณวันนี้แล้วเริ่มจดกฎแรกดู
คำถามที่พบบ่อย
CLAUDE.md ต้องเขียนเป็นภาษาอะไร?
ภาษาไหนก็ได้ที่คุณและ AI เข้าใจตรงกัน จะเป็นไทยหรืออังกฤษก็ได้ ขอแค่ชัดเจนและกระชับ เพราะ AI อ่านได้ทั้งสองภาษา หลายทีมนิยมเขียนอังกฤษเพื่อให้สั้นและประหยัดพื้นที่
ต้องอัปเดต CLAUDE.md บ่อยไหม?
อัปเดตเมื่อกฎหรือวิธีทำงานเปลี่ยน เช่น เปลี่ยนคำสั่ง build หรือเพิ่มข้อห้ามใหม่ ไม่ต้องแก้ทุกวัน แต่ถ้าเห็น AI ทำผิดซ้ำ ๆ นั่นคือสัญญาณว่าควรจดกฎนั้นลงไป