Skip to main content
Điểm cốt lõi của bài này
Người dùng Claude Code giỏi nhất không phải người viết prompt đẹp nhất — mà là người biết khi nào dừng lại, kiểm chứng, và biết cách tổ chức hệ thống hợp với bộ não mình. Prompt tốt là prompt có thể kiểm chứng.

​
Mở đầu

Sau 5 bài, bạn đã hiểu Claude Code vận hành ra sao. Bài này là phần “kinh nghiệm đau”. 8 nguyên tắc đã được đúc kết từ hàng trăm phiên làm việc thực tế — tránh cho bạn những lỗi mà ai cũng mắc khi mới bắt đầu.

​
8 nguyên tắc cốt lõi

1. Ngữ cảnh là vua (Context is king)

Đặt quy tắc bền vững vào CLAUDE.md, không vào chat. File luôn có thể đọc lại; hội thoại sẽ bị nén mất khi cửa sổ ngữ cảnh đầy.

2. Lên kế hoạch trước khi thực thi

Với task lớn, dùng plan mode. Claude lên kế hoạch, bạn duyệt, rồi mới thực thi. Tiết kiệm nhiều hơn là viết lại.

3. Vòng lặp ngắn + kiểm chứng thắng vòng lặp dài + hy vọng

Sau mỗi bước quan trọng: đọc lại file, chạy test, xác nhận. Đừng giao 10 task cùng lúc rồi hy vọng tất cả đúng.

4. Uỷ quyền cho sub-agent với task cách ly nặng ngữ cảnh

Nghiên cứu codebase, phân tích dependency, dịch file dài — giao cho sub-agent. Cuộc trò chuyện chính của bạn không bị rác.

5. Không bao giờ tin đầu ra sai một cách tự tin

Đặc biệt: số liệu, URL, tên API, lời khuyên pháp lý/y tế. LLM luôn tự tin — đúng hay sai đều như nhau.

6. Giữ con người ở những quyết định phán xét

AI có thể soạn thảo chiến lược, thương hiệu, trust với khách hàng. Nhưng bạn là người phê duyệt. Đừng tự động hóa phán xét.

7. Commit thường, push ít hơn

Commit (lưu lại mốc) sau mỗi bước rõ ràng. Push (đẩy lên public) chỉ khi đã kiểm tra kỹ. Reversibility (khả năng quay lui) quan trọng.

8. Tổ chức theo CÁCH CỦA BẠN

Quy ước thư mục chính thức (.claude/agents/, .claude/skills/) là gợi ý, không phải luật. Nếu cấu trúc của bạn hợp hơn với bộ não bạn — dùng nó. Claude theo ý định, không theo quy ước.

​
Ví dụ thực: Bad prompt vs Good prompt

Sửa lỗi login.
Vấn đề: Claude không biết lỗi gì, ở file nào, hành vi mong muốn ra sao. Nó sẽ đoán, có thể đoán sai.

​
Anti-pattern phổ biến

Những lỗi dưới đây xuất hiện ở gần như mọi người mới bắt đầu. Nhận ra sớm, tránh được nhiều giờ làm lại:
  • Mơ hồ hóa: “làm cho nó tốt hơn” — tốt theo tiêu chí gì? Đo thế nào?
  • Uỷ quyền việc phán xét: “quyết định xem nên dùng React hay Vue” — đây là câu hỏi kiến trúc, con người phải trả lời.
  • Không kiểm chứng: giao task, nhận báo cáo “xong rồi”, không đọc lại → bug ngầm.
  • Cửa sổ ngữ cảnh bị bội thực: đọc quá nhiều file, trò chuyện quá dài → Claude “quên” quy tắc ban đầu.
  • Trust numbers blindly: “AI báo cáo đã dịch 45 file”, thực tế chỉ 40. Luôn đếm lại cho chắc.

​
Nguyên tắc vàng: “Verified > Done”

Nguyên tắc duy nhất quan trọng nhất của Claude Code: KIỂM CHỨNG QUAN TRỌNG HƠN HOÀN THÀNH. Một task “xong nhưng sai” tệ hơn một task “chưa xong”. Luôn xác nhận.
Sơ đồ trên là vòng lặp ra quyết định bạn nên chạy trong đầu mỗi task. Bốn điểm quyết định (diamond) chính là nơi gu thẩm mỹ và kỷ luật phân biệt người dùng giỏi với người dùng thất vọng.

​
Tự kiểm tra

Khi task có nhiều bước, khi bạn chưa chắc cách tiếp cận, khi rủi ro sai cao (ví dụ sửa file quan trọng). Với task nhỏ 1-2 bước, không cần.
Không mù quáng. Luôn: đọc lại file thay đổi, chạy test, xác nhận kết quả. Claude đôi khi báo cáo thiếu chính xác, đặc biệt với task phức tạp.
Không. Đó là convention chính thức, không phải luật. Bạn có thể đặt agent ở bất kỳ đâu. Claude đọc ý định qua prompt, không quét cấu trúc cứng.

​
Bài tập

1

Lấy một task thực tế của bạn

Đừng nghĩ ra giả. Ví dụ: “sửa lỗi trong file config.yaml”, “dịch bài blog mới nhất sang tiếng Anh”.
2

Viết prompt kém

Càng ngắn càng tốt, bỏ ngữ cảnh. Quan sát xem bạn có xu hướng viết gọn thế nào.
3

Viết prompt tốt

Đầy đủ vai trò, ngữ cảnh, task, ràng buộc, cách kiểm chứng. Dài hơn prompt kém 3-5 lần.
4

So sánh

Prompt tốt dài hơn, nhưng tiết kiệm thời gian tổng thể — ít phải làm lại.
5

Thử cả 2 prompt trên Claude Code

Quan sát khác biệt về độ chính xác, số lần bạn phải chỉnh lại, và thời gian hoàn thành.

​
Tiếp theo?