The 4 Lines Every CLAUDE.md Needs
Nếu bạn đang dùng Claude để code, research hoặc automate workflow, thì khả năng cao bạn đã từng gặp tình huống này:
- Claude trả lời không consistent
- Lúc thì rất thông minh
- Lúc lại “quên sạch context” 😄
Và đây chính là lý do nhiều người bắt đầu dùng CLAUDE.md.
CLAUDE.md là gì?
CLAUDE.md có thể hiểu là:
Một file hướng dẫn giúp Claude hiểu cách bạn muốn nó làm việc trong project.
Nó giống:
- System prompt riêng cho repo
- Rulebook cho AI
- Memory layer cho workflow
Khi setup đúng:
- Claude hiểu context tốt hơn
- Output consistent hơn
- Ít phải nhắc lại nhiều lần
Điều thú vị: chỉ cần 4 dòng là đã khác rất nhiều
Bài viết nhấn mạnh rằng:
Bạn không cần:
- Prompt dài 500 dòng
- Rule cực phức tạp
Chỉ cần 4 thứ quan trọng.
1. Project Goal
Claude cần hiểu:
“Project này thực sự đang làm gì?”
Ví dụ:
# Goal
This project is a finance tracking Android app built with Jetpack Compose.
Nghe đơn giản, nhưng cực kỳ quan trọng.
Nếu không có context này:
- Claude dễ generate sai architecture
- Hoặc suggest solution không liên quan
2. Tech Stack
Claude cần biết:
- Framework gì
- Library gì
- Convention gì
Ví dụ:
# Stack
- Kotlin
- Jetpack Compose
- Clean Architecture
- Hilt
- Room
Điều này giúp:
-
Suggest code đúng ecosystem
-
Tránh:
“React mindset trong Android project” 😄
3. Coding Rules
Đây là phần nhiều người bỏ qua nhất.
Ví dụ:
# Rules
- Avoid using LiveData
- Prefer StateFlow
- Use immutable UI state
- Keep ViewModels thin
👉 Claude sẽ bắt đầu:
- Follow style của team
- Viết code consistent hơn
Thay vì mỗi lần generate:
- một kiểu architecture khác nhau 😄
4. Response Style
Đây là phần rất đáng giá.
Bạn có thể yêu cầu:
# Response Style
- Keep answers concise
- Show only changed code
- Explain tradeoffs briefly
Kết quả:
- Claude bớt “nói nhiều”
- Output usable hơn rất nhiều
Vì sao 4 dòng này hiệu quả?
Một insight rất hay trong bài:
Claude không cần:
- Quá nhiều instruction
Claude cần:
- Đúng context
- Đúng boundary
- Đúng expectation
👉 Chất lượng output tăng mạnh không phải vì prompt dài hơn. 👉 Mà vì context rõ ràng hơn.
Sai lầm phổ biến khi viết CLAUDE.md
1. Viết quá dài
Nhiều người biến nó thành:
- Documentation full project 😄
Kết quả:
- Noise nhiều hơn signal
2. Rule mâu thuẫn nhau
Ví dụ:
- “Keep code simple”
- Nhưng:
- “Always use advanced abstraction”
👉 Claude rất dễ confused.
3. Thiếu architecture direction
Nếu không nói rõ:
- MVI?
- MVVM?
- Clean architecture?
Claude sẽ:
- Tự đoán 😄
Và đôi khi đoán… rất sáng tạo.
Một pattern rất đáng học
Bài viết có một insight khá hay:
CLAUDE.md tốt thường:
- Ngắn
- Rõ
- Deterministic
- Opinionated vừa đủ
Không phải:
“viết mọi thứ có thể nghĩ ra”
Mà là:
“định nghĩa cách project vận hành”.
Ví dụ hoàn chỉnh
# Goal
Android expense tracking app for freelancers.
# Stack
Kotlin, Jetpack Compose, Room, Hilt, Clean Architecture.
# Rules
Use StateFlow over LiveData.
Keep UI state immutable.
Avoid business logic in Composables.
# Response Style
Be concise.
Prefer code examples over explanations.
Show only modified code when possible.
Một insight quan trọng
Nhiều người nghĩ AI coding hiệu quả phụ thuộc vào:
- model mạnh hơn
Nhưng thực tế:
Context quality thường quan trọng hơn model quality.
Một model rất mạnh nhưng không hiểu project:
- vẫn generate code lệch hướng.
Tổng kết
Một CLAUDE.md tốt giúp:
- Claude hiểu project nhanh hơn
- Output consistent hơn
- Giảm prompt lặp lại
- Workflow ổn định hơn
Và đôi khi:
chỉ cần đúng 4 dòng là đã khác biệt rất lớn.
Kết luận
AI không thực sự “đọc được suy nghĩ của team”.
CLAUDE.md chính là cách bạn biến:
- expectation
- convention
- workflow
thành thứ AI có thể hiểu được.
Nguồn :
https://levelup.gitconnected.com/the-4-lines-every-claude-md-needs-2717a46866f6
All Rights Reserved
