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 trackerAGENTS.md คือไฟล์คำแนะนำที่พกพาได้ซึ่งเอเจนต์การเขียนโค้ด AI ของคุณอ่านก่อนที่จะสัมผัสโค้ดของคุณ ว่าควรใส่อะไรในนั้น มันแตกต่างจาก CLAUDE.md อย่างไร และจะรักษาบริบทเดียวกันระหว่าง Codex, Antigravity และ Claude ได้อย่างไร
โค้ดไม่ใช่ปัญหาหลักอีกต่อไป แต่การสื่อสารคือ นี่คือวิธีการพูดคุยกับ AI agents ของคุณ Claude, Codex, Antigravity และ Grok Build เพื่อให้ส่งมอบได้เร็วขึ้น แม่นยำขึ้น และใช้โทเคนให้น้อยลง
แพ็กเกจสมาชิก Claude ของคุณไม่ได้คิดเป็นโทเค็น จึงไม่มีหน้าจอไหนแสดงยอดโทเค็นคงเหลือ นี่คือสิ่งที่ระบบวัดจริง สองหน้าจอที่แสดงค่านั้นจริง ๆ และเหตุผลที่โควตาลดลงแม้ในเวลาที่คุณไม่ได้พิมพ์อะไรเลย และการเปลี่ยนแปลงช่วงเวลารายสัปดาห์ในเดือนกันยายน 2026 ส่งผลต่อสัปดาห์ของคุณอย่างไร
ดาวน์โหลด AgentsRoom และใช้ตัวแก้ไข CLAUDE.md ที่มีในตัวเพื่อให้เอเจนต์ของคุณมีบริบทที่พวกเขาต้องการ คำแนะนำที่ดีกว่า โค้ดที่ดีกว่า
แอปคู่หู: ตรวจสอบเอเจนต์ของคุณได้ทุกที่
นำของคุณเอง: Claude, Codex, Antigravity CLI, หรือผู้ให้บริการ AI อื่น ๆ
ส่งข้อบกพร่องและคำขอไปยังแบ็คล็อกสาธารณะของคุณโดยตรง
มองเห็น AgentsRoom ในการทำงาน