CLAUDE.md คือไฟล์เดียวที่กำหนดว่า Claude เข้าใจโครงการของคุณอย่างไร การเขียนที่ดีหมายถึงการแก้ไขน้อยลง โค้ดที่ดีกว่า และเอเจนต์ที่รู้ว่าพวกเขากำลังทำงานอะไรจริงๆ
คู่มือนี้จะพาคุณผ่านทุกส่วนของไฟล์ CLAUDE.md ตั้งแต่การประกาศเทคสแต็กไปจนถึงคำแนะนำเฉพาะสำหรับเอเจนต์ ติดตามและสร้างของคุณทีละขั้นตอน
CLAUDE.md คือไฟล์ markdown ที่คุณวางไว้ที่รากของโครงการของคุณ เมื่อ Claude Code เริ่มเซสชัน มันจะอ่านไฟล์นี้เป็นไฟล์แรก ทุกอย่างภายในจะกลายเป็นส่วนหนึ่งของบริบทของ Claude: เทคสแต็กของคุณ โครงสร้างไฟล์ของคุณ ข้อกำหนดของทีมของคุณ และคำแนะนำเฉพาะใดๆ ที่คุณต้องการให้เอเจนต์ทุกคนปฏิบัติตาม
คิดว่าเป็นเอกสารการบรีฟ โดยไม่มีมัน Claude ต้องเดาว่าโครงการของคุณจัดระเบียบอย่างไร ด้วยไฟล์ที่ดี Claude จะรู้แล้วว่าสิ่งต่างๆ อยู่ที่ไหน รูปแบบใดที่ควรปฏิบัติตาม และสิ่งใดที่ควรหลีกเลี่ยง ความแตกต่างในคุณภาพของผลลัพธ์นั้นมีนัยสำคัญ
“การลงทุน 10 นาทีใน CLAUDE.md ช่วยประหยัดเวลาหลายชั่วโมงในการแก้ไขโค้ดที่สร้างโดย AI ซึ่งไม่ตรงกับรูปแบบของโครงการของคุณ”
สังเกตเห็นได้จากโครงการ Claude Code หลายร้อยโครงการ
โครงสร้างและความเฉพาะเจาะจงของ CLAUDE.md ของคุณมีผลโดยตรงต่อประสิทธิภาพของ Claude ในฐานข้อมูลโค้ดของคุณ
CLAUDE.md ที่มีโครงสร้างดีครอบคลุมพื้นที่ทั้งหกนี้ แต่ละส่วนให้ข้อมูลที่ชัดเจนแก่ Claude ที่สามารถดำเนินการได้ทันที
ระบุเฟรมเวิร์ก ไลบรารี และเวอร์ชันของพวกเขาอย่างชัดเจน รวมถึงตัวจัดการแพ็กเกจ เวอร์ชัน Node และข้อกำหนดการรันไทม์ใดๆ Claude ใช้สิ่งนี้ในการสร้างโค้ดที่เข้ากันได้โดยไม่ต้องเดา
อธิบายไดเรกทอรีหลักของคุณและสิ่งที่อยู่ในแต่ละไดเรกทอรี ส่วนประกอบ, สโตร์, บริการ, เส้นทาง API, ประเภท ไดอะแกรมต้นไม้สั้น ๆ พร้อมคำอธิบายหนึ่งบรรทัดต่อโฟลเดอร์ทำงานได้ดี
บันทึกแพทเทิร์นการตั้งชื่อของคุณ (camelCase สำหรับไฟล์, PascalCase สำหรับส่วนประกอบ), วิธีการจัดการข้อผิดพลาด, การจัดลำดับการนำเข้า, และกฎเฉพาะของโปรเจกต์ใด ๆ สิ่งนี้จะทำให้ผลลัพธ์ของ Claude สอดคล้องกับโค้ดที่มีอยู่ของคุณ
รวมคำสั่งพัฒนา, สร้าง, ทดสอบ, และลินต์ของคุณ เมื่อ Claude ต้องการตรวจสอบว่าสิ่งใดทำงานได้หรือแนะนำสคริปต์ มันจะใช้คำสั่งที่โปรเจกต์ของคุณคาดหวังอย่างแม่นยำ
หากคุณใช้ตัวแทนหลายตัว (QA, frontend, backend, DevOps) ให้เพิ่มส่วนที่อธิบายว่าบทบาทแต่ละบทควรให้ความสำคัญกับอะไร สิ่งนี้มีประโยชน์โดยเฉพาะกับการตั้งค่าหลายตัวแทนของ AgentsRoom
บอก Claude ว่าสิ่งใดที่ไม่ควรทำ อย่าแก้ไขไฟล์ config, อย่าเปลี่ยนระบบการตรวจสอบสิทธิ์, อย่าปรับโครงสร้างชั้นฐานข้อมูล ขอบเขตที่ชัดเจนจะป้องกันไม่ให้ตัวแทนทำการเปลี่ยนแปลงที่ไม่ต้องการ
คุณไม่จำเป็นต้องเขียนทุกอย่างในครั้งเดียว เริ่มต้นด้วยพื้นฐานและขยายเมื่อคุณค้นพบสิ่งที่ Claude ต้องรู้
เปิด package.json ของคุณและระบุกรอบงาน, ไลบรารี, และเครื่องมือทุกตัวที่โปรเจกต์ของคุณใช้ ระบุเวอร์ชัน ตรวจสอบความต้องการในการทำงานของคุณ (เวอร์ชัน Node, เวอร์ชัน Python, ฐานข้อมูล) สิ่งนี้จะกลายเป็นส่วนเทคสแต็กของคุณ
package.json + เวอร์ชันการทำงาน + ฐานข้อมูล
รันต้นไม้ด่วนของไดเรกทอรี src ของคุณ ระบุโฟลเดอร์ระดับสูงสุดและเขียนคำอธิบายหนึ่งบรรทัดของแต่ละโฟลเดอร์ มุ่งเน้นไปที่ที่ส่วนประกอบ, สโตร์, บริการ, ประเภท, และเส้นทาง API ตั้งอยู่
src/ ต้นไม้พร้อมคำอธิบายวัตถุประสงค์
ดูโค้ดที่มีอยู่ของคุณและบันทึกแพทเทิร์น: คุณตั้งชื่อไฟล์อย่างไร, คุณจัดการข้อผิดพลาดอย่างไร, คุณจัดโครงสร้างการนำเข้าอย่างไร, คุณใช้การส่งออกแบบเริ่มต้นหรือแบบชื่อหรือไม่ เขียนสิ่งเหล่านี้ลงเป็นกฎสั้น ๆ
การตั้งชื่อ, การนำเข้า, การจัดการข้อผิดพลาด, การส่งออก
หากคุณทำงานกับตัวแทนเฉพาะ ให้เพิ่มพื้นที่โฟกัสสำหรับแต่ละบทบาท ตัวแทน frontend ควรรู้จักไลบรารีส่วนประกอบของคุณ ตัวแทน DevOps ควรรู้จักท่อการปรับใช้ของคุณ ตัวแทน QA ควรรู้จักกรอบการทดสอบของคุณ
พื้นที่โฟกัสตามบทบาท + พื้นที่หลีกเลี่ยง
AgentsRoom ถูกสร้างขึ้นรอบ ๆ CLAUDE.md ในฐานะแนวคิดระดับหนึ่ง ไม่ใช่สิ่งที่คิดขึ้นภายหลัง
แก้ไข CLAUDE.md ของคุณโดยตรงภายใน AgentsRoom พร้อมการเน้นไวยากรณ์และการบันทึกแบบสด ไม่ต้องสลับไปยังโปรแกรมแก้ไขข้อความหรือ IDE ของคุณ
ดูว่าตัวแทนแต่ละตัวตีความ CLAUDE.md ของคุณอย่างไรในเวลาจริง ดูผลลัพธ์ในเทอร์มินัลเพื่อตรวจสอบว่าตัวแทนปฏิบัติตามแนวทางของคุณและเคารพพื้นที่หลีกเลี่ยงของคุณ
แต่ละโปรเจกต์ใน AgentsRoom มีไฟล์ CLAUDE.md ของตัวเอง สลับระหว่างโปรเจกต์และแต่ละเอเจนต์จะโหลดไฟล์บริบทที่ถูกต้องสำหรับโค้ดเบสโดยอัตโนมัติ
14 บทบาทเอเจนต์ของ AgentsRoom เชื่อมโยงโดยตรงกับส่วนต่างๆ ของ CLAUDE.md กำหนดพื้นที่ที่มุ่งเน้นและหลีกเลี่ยงพื้นที่ตามบทบาท และแต่ละเอเจนต์จะรับคำแนะนำที่เหมาะสมสำหรับมันโดยเฉพาะ
CLAUDE.md is prepended to every Claude turn. A bloated CLAUDE.md silently inflates Claude Code token usage on every message. AgentsRoom puts a per-session token meter on each agent so you can see exactly how much your CLAUDE.md is costing you, with a live cache hit rate to confirm it stays cached.
See the Claude Code token usage trackerดาวน์โหลด AgentsRoom และใช้ตัวแก้ไข CLAUDE.md ที่มีในตัวเพื่อให้เอเจนต์ของคุณมีบริบทที่พวกเขาต้องการ คำแนะนำที่ดีกว่า โค้ดที่ดีกว่า
แอปคู่หู: ตรวจสอบตัวแทนของคุณได้ทุกที่
นำของคุณเอง: Claude, Codex, Antigravity CLI, หรือผู้ให้บริการ AI อื่น ๆ
ส่งข้อบกพร่องและคำขอไปยังแบ็คล็อกสาธารณะของคุณโดยตรง
มองเห็น AgentsRoom ในการทำงาน