CLAUDE.md (Claude Code): ตำแหน่งไฟล์และวิธีที่เครื่องมืออ่าน

CLAUDE.md คือไฟล์หน่วยความจำที่ Claude Code โหลดเมื่อเริ่มทำงาน โดยอ่านจาก home directory, โปรเจกต์ และโฟลเดอร์แม่ทุกระดับ กฎที่กำหนดขอบเขตตาม path ใน .claude/rules/ จะให้คำแนะนำเพิ่มเติม ซึ่งโหลดเฉพาะเมื่ออ่านไฟล์ที่ตรงกับเงื่อนไข

ตำแหน่งไฟล์

• โปรเจกต์: ./CLAUDE.md หรือ ./.claude/CLAUDE.md ซึ่ง commit ไว้และแชร์กับทีม
• เฉพาะเครื่อง: ./CLAUDE.local.md สำหรับบันทึกส่วนตัวที่ไม่ต้องการเก็บใน git
• ผู้ใช้: ~/.claude/CLAUDE.md ใช้กับทุกโปรเจกต์
• กฎ: ./.claude/rules/**/*.md และ ~/.claude/rules/**/*.md โดยเลือกกำหนดขอบเขตด้วย frontmatter ของ paths ได้
• นโยบายที่จัดการจากส่วนกลาง: /Library/Application Support/ClaudeCode/CLAUDE.md บน macOS, C:\Program Files\ClaudeCode\CLAUDE.md บน Windows หรือคีย์ claudeMd ใน managed-settings.json

รูปแบบ

Markdown ไฟล์ใน .claude/rules/ อาจเริ่มด้วย YAML frontmatter ซึ่งคีย์ paths ใช้ระบุ globs สำหรับนำไปใช้ ดึงไฟล์อื่นเข้ามาด้วย @path/to/file ได้ โดยซ้อนกันได้สูงสุด 4 ระดับ ไม่มีการระบุขีดจำกัดขนาดไฟล์ แต่ Anthropic แนะนำให้แต่ละไฟล์มีไม่เกิน 200 บรรทัด

คีย์ Frontmatter: paths

@AGENTS.md

# Claude Code notes

- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.

## API

- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.

ลำดับความสำคัญและการผสาน

ไม่มีไฟล์ใดเขียนทับไฟล์อื่น: ไฟล์ที่ค้นพบทั้งหมดจะถูกรวมต่อกัน โดยโหลดนโยบายที่จัดการจากส่วนกลางก่อน แล้วโหลดไฟล์จาก root ของระบบไฟล์ลงมาถึงไดเรกทอรีที่ใช้เปิดใช้งาน ทำให้ไฟล์ในตำแหน่งที่ใกล้กว่าถูกอ่านทีหลัง ภายในไดเรกทอรีเดียวกัน CLAUDE.local.md จะตามหลัง CLAUDE.md ไฟล์ในไดเรกทอรีย่อยจะโหลดตามต้องการเมื่อ Claude อ่านไฟล์ในไดเรกทอรีนั้น และไม่สามารถยกเว้นนโยบายที่จัดการจากส่วนกลางด้วย claudeMdExcludes ได้

เครื่องมือที่อ่านไฟล์นี้

เคล็ดลับ

• หากมี CLAUDE.md ให้เริ่มไฟล์ด้วย @AGENTS.md มิฉะนั้น Claude Code จะไม่อ่าน AGENTS.md เมื่อใช้การตั้งค่าเริ่มต้น
• ย้ายคำแนะนำเฉพาะส่วนไปไว้ใน .claude/rules/ พร้อม frontmatter ของ paths เพื่อให้โหลดเฉพาะเมื่อใช้งานกับไฟล์เหล่านั้น
• การนำเข้าไฟล์ช่วยจัดระเบียบไฟล์ แต่ยังใช้ context เพราะมีการโหลดข้อความจากไฟล์ที่นำเข้าด้วย
• เรียกใช้ /doctor เพื่อตรวจสอบ CLAUDE.md, CLAUDE.local.md, AGENTS.md, rules และ skills ในครั้งเดียว

ไฟล์คำสั่งอื่น ๆ