วิธีที่ Claude จดจำโปรเจกต์ของคุณ

ให้คำสั่งถาวรกับ Claude ผ่านไฟล์ CLAUDE.md และให้ Claude สะสมการเรียนรู้โดยอัตโนมัติด้วย auto memory

แต่ละ Claude Code session เริ่มต้นด้วย context window ใหม่ สองกลไกช่วยส่งความรู้ข้าม sessions:

• ไฟล์ CLAUDE.md: คำสั่งที่คุณเขียนเพื่อให้ Claude มีบริบทถาวร
• Auto memory: บันทึกที่ Claude เขียนเองตามการแก้ไขและความชอบของคุณ

CLAUDE.md เทียบกับ Auto Memory

	ไฟล์ CLAUDE.md	Auto memory
ใครเขียน	คุณ	Claude
เนื้อหา	คำสั่งและกฎ	การเรียนรู้และ patterns
ขอบเขต	Project, user หรือ org	ต่อ repository
โหลดเข้า	ทุก session	ทุก session (200 บรรทัดแรกหรือ 25KB)
ใช้สำหรับ	มาตรฐานโค้ด, workflows, สถาปัตยกรรม	คำสั่ง build, insights การ debug

ไฟล์ CLAUDE.md

ไฟล์ CLAUDE.md เป็นไฟล์ markdown ที่ให้คำสั่งถาวรสำหรับ project, workflow ส่วนตัว หรือ organization ทั้งหมด

เมื่อใดควรเพิ่มใน CLAUDE.md

เพิ่มเมื่อ:

• Claude ทำผิดพลาดเดิมซ้ำ
• Code review ค้นพบสิ่งที่ Claude ควรรู้เกี่ยวกับ codebase นี้
• คุณพิมพ์การแก้ไขหรือคำชี้แจงเดิมทุก session
• สมาชิกทีมใหม่ต้องการบริบทเดียวกันเพื่อทำงานได้

เลือกตำแหน่งไฟล์ CLAUDE.md

ขอบเขต	ตำแหน่ง	วัตถุประสงค์	แชร์กับ
Managed policy	macOS: /Library/Application Support/ClaudeCode/CLAUDE.md	คำสั่งทั่วทั้งองค์กร	ผู้ใช้ทุกคนในองค์กร
User instructions	~/.claude/CLAUDE.md	ความชอบส่วนตัวสำหรับทุกโปรเจกต์	เฉพาะคุณ
Project instructions	./CLAUDE.md หรือ ./.claude/CLAUDE.md	คำสั่งที่แชร์กับทีมสำหรับโปรเจกต์	สมาชิกทีมผ่าน source control
Local instructions	./CLAUDE.local.md	ความชอบส่วนตัวเฉพาะโปรเจกต์	เฉพาะคุณ

ตั้งค่า Project CLAUDE.md

สร้างไฟล์นี้พร้อมคำสั่งที่ใช้กับทุกคนที่ทำงานในโปรเจกต์: คำสั่ง build และ test, มาตรฐานโค้ด, การตัดสินใจด้านสถาปัตยกรรม

tip

รัน /init เพื่อสร้าง CLAUDE.md เริ่มต้นโดยอัตโนมัติ Claude วิเคราะห์ codebase ของคุณและสร้างไฟล์ที่มีคำสั่ง build, คำสั่ง test และ conventions ที่ค้นพบ

เขียนคำสั่งที่มีประสิทธิภาพ

ขนาด: เป้าหมายใต้ 200 บรรทัดต่อไฟล์ CLAUDE.md ไฟล์ที่ยาวกว่าใช้ context มากขึ้นและลดการปฏิบัติตาม

โครงสร้าง: ใช้ markdown headers และ bullets เพื่อจัดกลุ่มคำสั่งที่เกี่ยวข้อง

ความเฉพาะเจาะจง: เขียนคำสั่งที่เป็นรูปธรรมพอที่จะตรวจสอบได้:

• "ใช้การเยื้อง 2 ช่อง" แทน "จัดรูปแบบโค้ดอย่างถูกต้อง"
• "รัน npm test ก่อน commit" แทน "ทดสอบการเปลี่ยนแปลง"

Import ไฟล์เพิ่มเติม

ไฟล์ CLAUDE.md สามารถ import ไฟล์เพิ่มเติมโดยใช้ไวยากรณ์ @path/to/import:

ดู @README สำหรับภาพรวมโปรเจกต์และ @package.json สำหรับคำสั่ง npm ที่ใช้ได้

# คำสั่งเพิ่มเติม
- git workflow @docs/git-instructions.md

จัดระเบียบกฎด้วย .claude/rules/

วาง markdown files ใน .claude/rules/ directory ของโปรเจกต์:

your-project/
├── .claude/
│   ├── CLAUDE.md
│   └── rules/
│       ├── code-style.md
│       ├── testing.md
│       └── security.md

กฎเฉพาะ Path

กฎสามารถกำหนดขอบเขตให้กับไฟล์เฉพาะโดยใช้ YAML frontmatter:

---
paths:
  - "src/api/**/*.ts"
---

# API Development Rules

- ทุก API endpoints ต้องมีการ validate input
- ใช้รูปแบบ error response มาตรฐาน

Auto Memory

Auto memory ให้ Claude สะสมความรู้ข้าม sessions โดยไม่ต้องเขียนอะไร

note

Auto memory ต้องใช้ Claude Code v2.1.59 หรือใหม่กว่า

เปิด/ปิด Auto Memory

Auto memory เปิดใช้งานโดยค่าเริ่มต้น ปิดผ่านตัวแปรสภาพแวดล้อม:

export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1

ตำแหน่งที่เก็บ

แต่ละโปรเจกต์มี memory directory ที่ ~/.claude/projects/<project>/memory/:

~/.claude/projects/<project>/memory/
├── MEMORY.md          # ดัชนีกระชับ โหลดทุก session
├── debugging.md       # บันทึกละเอียดเกี่ยวกับ patterns การ debug
└── api-conventions.md # การตัดสินใจออกแบบ API

วิธีทำงาน

200 บรรทัดแรกของ MEMORY.md หรือ 25KB แรก โหลดเมื่อเริ่มทุก conversation ไฟล์หัวข้อไม่โหลดเมื่อเริ่ม Claude อ่านเมื่อต้องการข้อมูล

ดูและแก้ไขด้วย /memory

คำสั่ง /memory แสดงไฟล์ CLAUDE.md, CLAUDE.local.md และ rules ทั้งหมดที่โหลดใน session ปัจจุบัน

แก้ปัญหา Memory

Claude ไม่ปฏิบัติตาม CLAUDE.md

• รัน /memory เพื่อยืนยันว่าไฟล์ถูกโหลด
• ตรวจสอบว่า CLAUDE.md อยู่ในตำแหน่งที่ถูกโหลดสำหรับ session นั้น
• ทำให้คำสั่งเฉพาะเจาะจงมากขึ้น
• ตรวจหาคำสั่งที่ขัดแย้งข้ามไฟล์ CLAUDE.md

CLAUDE.md ของฉันใหญ่เกินไป

ไฟล์ที่มีมากกว่า 200 บรรทัดใช้ context มากและอาจลดการปฏิบัติตาม ใช้ path-scoped rules เพื่อโหลดคำสั่งเฉพาะเมื่อ Claude ทำงานกับไฟล์ที่ตรงกัน

แหล่งข้อมูลที่เกี่ยวข้อง

• Debug การกำหนดค่า: วิเคราะห์ว่าทำไม CLAUDE.md หรือ settings ไม่มีผล
• Skills: แพ็คเกจ workflows ที่ใช้ซ้ำได้
• Settings: กำหนดค่าพฤติกรรม Claude Code