CLAUDE.md — ทำให้ Claude รู้จักโปรเจคของคุณ

CLAUDE.md คือไฟล์ที่ Claude Code อ่านทุกครั้งที่เริ่ม session ใน folder นั้น เหมือนการ briefing เพื่อนร่วมงานใหม่ที่เพิ่งเข้ามาทำงานในโปรเจค

ฟังดูธรรมดา แต่จริงๆ มันเปลี่ยนคุณภาพการทำงานของ Claude ในโปรเจคของคุณคนละเรื่อง

ก่อน vs หลังมี CLAUDE.md

ก่อนมี — Claude ไม่รู้ว่าโปรเจคทำอะไร ผมต้องอธิบายทุกครั้งที่เปิดแชทใหม่ บางทีมันใช้ convention คนละแบบกับเรา ผลลัพธ์ไม่สม่ำเสมอ

หลังมี — Claude เข้าใจบริบททันที ทำงานตาม convention ของบริษัท ผลลัพธ์เหมือนเดิมทุกครั้ง

3 ระดับของ CLAUDE.md

Project CLAUDE.md — [project]/CLAUDE.md
อ่านเมื่อรัน claude ใน folder นั้น (หรือ subfolder)

User CLAUDE.md — ~/.claude/CLAUDE.md
อ่านทุกครั้งทุกโปรเจค ผมใส่ความชอบส่วนตัวไว้ที่นี่ เช่น "ตอบเป็นภาษาไทย"

Local CLAUDE.md — CLAUDE.local.md
เหมือน project แต่ไม่ commit เข้า git ใช้ใส่บริบทส่วนตัว

สร้าง CLAUDE.md อัตโนมัติ

ที่ root โปรเจค

claude

แล้วพิมพ์

/init

Claude วิเคราะห์ทั้งโปรเจคแล้วสร้าง CLAUDE.md เริ่มต้นให้ — ดีกว่าเขียนเองจาก 0

โครงที่ผมใช้

# [ชื่อโปรเจค]

## Overview
[1-2 บรรทัดบอกว่าโปรเจคนี้คืออะไร]

## Tech Stack
- Framework: ...
- Database: ...
- Styling: ...

## Project Structure
- src/components/ — UI
- src/lib/ — utilities
- ...

## Conventions
- [Convention 1]
- [Convention 2]

## Commands
- npm run dev — dev server
- npm test — run tests
- ...

## Things to Remember
- [กฎสำคัญ 1 — เช่น "อย่า hardcode ราคา ดึงจาก DB เสมอ"]
- [pitfalls ที่เคยเจอ]

ตัวอย่างจริง — โปรเจค Workflow ของบริษัทรับเหมา

อันนี้คือ CLAUDE.md ที่ผมใช้กับโปรเจครวบสคริปต์ในบริษัท

# Construction Workflow Scripts

## Overview
สคริปต์และ workflow อัตโนมัติของบริษัทรับเหมาก่อสร้าง [ชื่อ]
ใช้ภายในออฟฟิศเท่านั้น

## Folder Structure
- scripts/    — Python scripts สำหรับงานประจำ
- templates/  — Template ใบเสนอราคา / สัญญา
- data/       — CSV ลีดลูกค้า / โครงการ / supplier
- reports/    — Output รายงานรายสัปดาห์

## Conventions
- ภาษา: Python 3.11+
- Format วันที่: YYYY-MM-DD เสมอ
- Encoding: UTF-8 (เพราะภาษาไทย)
- Script ใหม่ต้องมี:
  - Docstring ภาษาไทยอธิบายหน้าที่
  - Error handling
  - Log ลง logs/

## Commands
- python scripts/daily-summary.py — สรุปวันนี้
- python scripts/sync-suppliers.py — sync supplier list
- python scripts/lead-segment.py — แบ่งกลุ่มลีด

## Business Context
- บริษัทรับสร้างบ้านเดี่ยว 3-8 ล้าน
- ทีมมี 4 คน ผม + ช่างหลัก 2 + admin 1
- ลูกค้า 70% มาจาก referral, 30% จาก Facebook
- High season ก่อนหน้าฝน (ก.พ.-เม.ย.) งานเยอะที่สุด
- ใช้ LINE OA เป็นช่องทางหลักในการคุยลูกค้า

## Things to Remember
- ราคาวัสดุไม่อัปเดตอัตโนมัติ — ดึงจาก suppliers.csv ที่ตอน manual
- ชื่อลูกค้าในระบบใช้ "คุณ[ชื่อจริง]" ไม่ใช่ชื่อเต็ม
- LINE OA ของบริษัทคือ @[id] ไม่ใช่ของผมส่วนตัว
- รายงานทุกอันต้องมี header "บริษัท [ชื่อ]"

ยาว 30-40 บรรทัด เพียงพอที่ Claude เข้าใจบริษัทผม

เคล็ดเขียน CLAUDE.md ที่ดี

ใส่

• บริบทที่ไม่อยู่ในโค้ด — business rules, history
• Conventions ที่คนใหม่ทุกคนต้องรู้
• ข้อผิดพลาดที่เคยเจอ — "อย่าทำ X เพราะ Y"
• Commands ที่ใช้บ่อย

อย่าใส่

• สิ่งที่ดูโค้ดแล้วรู้เอง (รายชื่อไฟล์ ฟังก์ชัน)
• ข้อมูลที่เปลี่ยนบ่อย (ชื่อคน deadline)
• Secrets, API key — เก็บใน .env เท่านั้น

ความยาวที่เหมาะ 100-300 บรรทัด ยาวเกินกิน context สั้นเกินไม่มีประโยชน์

ลองใช้

ดูโปรเจคนี้แล้วสร้าง CLAUDE.md ตามโครงสร้าง:
- Overview
- Tech Stack ถ้ามี
- Project Structure
- Conventions ที่เห็นจากโค้ด
- Commands
- Things to Remember

ถ้าไม่แน่ใจเรื่องไหน ถามผมก่อน อย่าเดา