Hoàn thành bài "Bài 1: Cài đặt & khởi động Claude Code" trước để mở khoá bài này.Đến bài trước

Giới thiệu

Claude Code là một agent lập trình chạy trong terminal — nó đọc prompt của bạn, suy luận ngữ cảnh, rồi thực thi chuỗi hành động trên codebase thật. Vì vậy, chất lượng prompt ảnh hưởng trực tiếp đến kết quả: một prompt mơ hồ dẫn đến code sai, code thừa, hoặc agent phải hỏi lại nhiều lần. Bài này tập trung vào các kỹ thuật viết prompt cụ thể để Claude Code hiểu đúng ý định ngay lần đầu.

Nguyên tắc cốt lõi: rõ ràng hơn ngắn gọn

Nhiều người mắc lỗi cố viết prompt thật ngắn vì nghĩ AI sẽ "tự hiểu". Với Claude Code, điều ngược lại đúng hơn: thông tin ngữ cảnh đủ sẽ cho kết quả tốt hơn prompt kiệm chữ.

Hãy so sánh hai prompt sau:

Prompt yếu: "Sửa bug trong file auth"

Prompt mạnh: "Trong file src/auth/login.ts, hàm validateToken đang trả về true cho token hết hạn. Sửa lại để kiểm tra trường exp trong JWT payload và throw AuthError nếu token đã hết hạn."

Prompt thứ hai chỉ định rõ file, tên hàm, triệu chứng lỗi, hành vi mong đợi, và loại lỗi cần throw. Claude Code không cần đoán mò.

sơ đồ so sánh 2 luồng xử lý: prompt mơ hồ dẫn đến agent hỏi lại nhiều vòng, prompt rõ ràng dẫn đến kết quả đúng ngay lần đầu

Cấu trúc một prompt hiệu quả

Một prompt tốt cho Claude Code thường có đủ 4 thành phần: ngữ cảnh, yêu cầu, ràng buộc, và kết quả mong đợi. Không nhất thiết phải viết thành 4 mục riêng — miễn là thông tin có mặt trong prompt.

Ví dụ thực tế cho một tác vụ thêm tính năng:

text
Context: Project dùng Express.js + TypeScript, database là PostgreSQL qua Prisma ORM.
Yêu cầu: Thêm endpoint POST /api/users/:id/deactivate để soft-delete user (set trường isActive = false, không xóa record).
Ràng buộc: Chỉ admin mới gọi được endpoint này — dùng middleware isAdmin đã có ở src/middleware/auth.ts. Không thay đổi schema Prisma.
Kết quả: Tạo handler trong src/routes/users.ts, thêm route vào src/app.ts, viết 1 integration test cơ bản.

Prompt dạng này không cần cú pháp đặc biệt — chỉ cần văn xuôi hoặc gạch đầu dòng, miễn là thông tin đủ.

Kỹ thuật nâng cao: định hướng bằng ví dụ

Khi muốn Claude Code viết code theo một phong cách nhất định — ví dụ theo convention của codebase hiện tại — cách hiệu quả nhất là trỏ thẳng đến file mẫu.

text
Viết unit test cho hàm calculateDiscount trong src/pricing/discount.ts.
Dùng cùng cấu trúc test như trong src/pricing/tax.test.ts: describe block theo tên hàm, test case dùng it(), mock bằng jest.fn().

Cách này tốt hơn nhiều so với mô tả dài dòng về phong cách vì Claude Code sẽ đọc file mẫu và tự suy ra pattern.

Một kỹ thuật khác là chia nhỏ tác vụ lớn thành nhiều prompt tuần tự thay vì gộp tất cả vào một lần:

text
Bước 1: Chỉ phân tích file src/payment/processor.ts và liệt kê các hàm hiện có, đừng sửa gì.

Sau khi Claude Code báo cáo kết quả phân tích, mới đưa prompt bước 2. Cách này giúp bạn kiểm soát từng bước và tránh agent đi quá xa so với ý định ban đầu.

sơ đồ luồng tác vụ lớn được chia thành 3 bước tuần tự: phân tích, lên kế hoạch, thực thi

Lỗi thường gặp

Lỗi 1: Dùng từ ngữ mơ hồ như "tối ưu", "cải thiện", "làm sạch" mà không nói rõ theo tiêu chí nào. Thay bằng: "giảm số lần gọi database trong vòng lặp ở hàm fetchUserOrders" hoặc "đổi tên biến trong file X cho đúng với camelCase convention".

Lỗi 2: Không nêu ràng buộc kỹ thuật. Nếu bạn không muốn Claude Code cài thêm package mới, hãy viết rõ: "Không dùng thư viện ngoài, chỉ dùng những gì đã có trong package.json". Agent không tự đoán được giới hạn này.

Lỗi 3: Yêu cầu quá nhiều thứ trong một prompt. Khi một prompt bao gồm cả refactor, thêm tính năng, và viết test cùng lúc, Claude Code có thể ưu tiên sai hoặc bỏ sót phần nào đó. Tách ra thành nhiều phiên làm việc.

Lỗi 4: Không xác nhận scope. Nếu tác vụ chỉ liên quan một module, hãy ghi rõ: "Chỉ thay đổi trong thư mục src/billing/, đừng chạm vào các phần khác."

Tổng kết

Viết prompt hiệu quả cho Claude Code không đòi hỏi kỹ thuật phức tạp — chỉ cần cung cấp đủ ngữ cảnh, nêu rõ ràng buộc, và chia nhỏ tác vụ khi cần. Nguyên tắc đơn giản nhất để nhớ: nếu một lập trình viên mới vào team đọc prompt của bạn và không hiểu rõ phải làm gì, Claude Code cũng sẽ không hiểu. Hãy viết như đang giao việc cho đồng nghiệp — cụ thể, đủ ngữ cảnh, và rõ ràng về tiêu chí hoàn thành.

Luyện tập sau buổi học

Bài kiểm tra cuối bài

Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.

0/1
Đã trả lời · 0/1