Prompt cho Claude Code: mẫu tiếng Việt làm web, sửa lỗi

•
•
Khoảng 11 phút đọc

Cùng một công cụ, người này nhận về trang web chạy được, người kia nhận về đống file rối. Khác biệt thường nằm ở cách viết prompt cho Claude Code. Bài này đưa công thức 5 phần và 3 mẫu bằng tiếng Việt cho việc hay gặp nhất: làm web, sửa lỗi, thêm tính năng, kèm lý do mỗi mẫu hiệu quả để bạn tự sửa cho dự án của mình. Cập nhật tháng 11/2026; các tên lệnh và tính năng của Claude Code được soát lại ngày 18/11/2026, vì công cụ này thay đổi nhanh nên bạn nên đối chiếu thêm với tài liệu chính thức khi dùng.

Prompt cho Claude Code là gì và vì sao viết kỹ lại khác biệt?

Prompt cho Claude Code là đoạn yêu cầu bạn gõ để công cụ này đọc mã, sửa file và chạy lệnh ngay trong thư mục dự án. Khác với chat thông thường, nó thật sự thay đổi file của bạn, nên yêu cầu mơ hồ cho ra thay đổi mơ hồ.

Claude Code không biết bạn bán gì, khách là ai, cần tránh từ ngữ nào. Nó chỉ biết những gì nằm trong thư mục và trong câu bạn viết, cộng với file ghi nhớ CLAUDE.md nếu bạn có tạo. Cách công cụ đọc file này được mô tả trong tài liệu chính thức của Anthropic về bộ nhớ Claude Code. Vì vậy một prompt tốt giống bản giao việc cho nhân viên mới: nói rõ mục tiêu, phạm vi và cách kiểm tra xong. Nếu chưa từng dùng, bạn nên đọc trước lộ trình học Claude Code cho người mới để biết cách cài và làm quen.

Công thức 5 phần cho mọi prompt gồm những gì?

Một prompt đủ dùng gồm 5 phần: bối cảnh, mục tiêu, phạm vi file, điều cấm và cách kiểm tra. Thiếu phần nào thì Claude Code tự đoán phần đó, và chỗ đoán thường là chỗ sai. Công thức này hiệu quả vì mỗi phần chặn đúng một kiểu sai: bối cảnh chặn việc hiểu nhầm dự án, phạm vi chặn việc sửa lan sang file khác, còn cách kiểm tra buộc AI chạy thử thay vì báo xong cho có.

  1. Bối cảnh: dự án là gì, dùng công nghệ nào, khách hàng là ai.
  2. Mục tiêu: một việc cụ thể, nói bằng kết quả nhìn thấy được.
  3. Phạm vi: được sửa file nào, thư mục nào.
  4. Điều cấm: không cài thêm thư viện, không đổi giao diện phần khác, không xoá dữ liệu.
  5. Cách kiểm tra: chạy lệnh nào, mở trang nào, thấy gì thì coi là xong.

Phần kiểm tra đặc biệt quan trọng. Khi bạn ghi rõ lệnh hoặc bước cần chạy, Claude Code có thể tự chạy rồi sửa tiếp nếu chưa đạt, thay vì báo xong cho có. Phần điều cấm quan trọng không kém: các ràng buộc như từ ngữ cần tránh, thư viện không được thêm hay thư mục không được chạm là thứ AI không thể tự suy ra từ mã. Bạn nên viết những ràng buộc này ngay từ lần đầu, vì sửa sau lúc kết quả đã lan sang nhiều file luôn tốn công hơn nhiều so với một dòng dặn trước.

Công thức 5 phần của prompt cho Claude Code
5 phần nên có trong mỗi prompt giao cho Claude Code.

Mẫu prompt cho Claude Code khi làm web

Khi làm web, prompt cần nêu đối tượng khách, nội dung từng phần và những gì phải tránh. Đừng chỉ gõ “làm cho tôi landing page đẹp”, vì “đẹp” không kiểm tra được. Hãy mô tả cấu trúc và ràng buộc, như mẫu dưới đây (đây là mẫu minh hoạ do chúng tôi soạn để bạn sửa lại, không phải prompt copy từ một dự án cụ thể).

Bối cảnh: đây là thư mục landing page cho một spa chăm sóc da, viết bằng HTML và CSS thuần. Khách là phụ nữ 25–40 tuổi, xem chủ yếu trên điện thoại.
Mục tiêu: tạo trang index.html gồm 5 phần: banner, 3 gói dịch vụ, quy trình 4 bước, đánh giá khách hàng, form đặt lịch (họ tên, số điện thoại, giờ mong muốn). Nội dung bằng tiếng Việt có dấu.
Điều cấm: không dùng từ “điều trị”, thay bằng “chăm sóc da mụn”. Không dùng ảnh nhân viên mặc blouse trắng. Không cài thư viện ngoài.
Kiểm tra: mở trang ở chiều rộng 375px, không bị cuộn ngang, nút đặt lịch thấy được mà không cần cuộn quá 2 màn hình.

Phần điều cấm trong mẫu bắt nguồn từ một tình huống chúng tôi từng gặp khi làm landing page cho một spa: khách yêu cầu tránh từ ngữ y khoa như “điều trị” và không dùng ảnh nhân viên mặc blouse trắng, vì nội dung quảng cáo ngành làm đẹp nên tránh cam kết kiểu y tế. Những yêu cầu kiểu này nằm trong đầu chủ doanh nghiệp, không nằm trong mã nguồn. Nếu không ghi ra, AI không có cách nào biết, và bạn sẽ phải tự rà từng đoạn chữ sau khi nó viết xong. Một dòng điều cấm ở đầu rẻ hơn nhiều so với việc rà lại cả trang.

Làm xong, bạn có thể nhờ tiếp: “Tối ưu từng ảnh xuống dưới 200 KB và thêm thuộc tính tải chậm”. Nếu trang vẫn chậm, xem cách khắc phục landing page bị chậm để biết điểm nghẽn thường nằm ở đâu. Trường hợp bạn cần trang chạy quảng cáo hoàn chỉnh mà không muốn tự làm, bên chúng tôi nhận thiết kế landing page trực tiếp.

Prompt làm landing page bằng Claude Code trên điện thoại
Prompt làm web cần nêu rõ khách, bố cục và điều cấm.

Mẫu prompt sửa lỗi: đưa triệu chứng hay đưa kết luận?

Nên đưa triệu chứng: điều bạn thấy, điều bạn mong đợi và cách tái hiện. Đừng đoán nguyên nhân rồi bắt AI sửa theo đoán của bạn, vì nếu đoán sai, nó sẽ sửa rất đúng chỗ sai. Triệu chứng là dữ kiện có thật, còn nguyên nhân chỉ là suy đoán, và để AI tự đi từ dữ kiện đến nguyên nhân thường cho kết quả chính xác hơn.

Lỗi: bấm nút “Gửi” ở form đặt lịch (file contact.html) thì trang tải lại và không thấy thông báo thành công.
Mong đợi: hiện dòng “Đã nhận yêu cầu” và không tải lại trang.
Cách tái hiện: điền đủ 3 ô, bấm Gửi. Console báo lỗi đỏ, tôi dán nguyên văn bên dưới.
Yêu cầu: đọc code, nói cho tôi nguyên nhân trước, chưa sửa vội. Sau khi tôi đồng ý mới sửa, chỉ sửa file liên quan, rồi chạy lại các bước tái hiện để xác nhận.

Điểm hiệu quả là câu “nói nguyên nhân trước, chưa sửa vội”. Bạn được đọc chẩn đoán, và nếu nó lệch hướng thì chặn được trước khi file bị đổi. Dán nguyên văn thông báo lỗi cũng tốt hơn mô tả lại bằng lời, vì một chữ trong thông báo có thể chỉ thẳng ra dòng gây lỗi. Sau khi sửa xong, hãy yêu cầu AI nêu rõ đã đổi dòng nào, ở file nào và vì sao, để bạn đối chiếu với chẩn đoán ban đầu. Nếu website của bạn đang dùng WordPress và lỗi nằm ở phía máy chủ hoặc plugin, bạn có thể nhờ dịch vụ sửa lỗi website WordPress nhanh thay vì tự thử nhiều lần.

Mẫu prompt thêm tính năng: chia nhỏ và duyệt từng bước

Với tính năng mới, hãy yêu cầu Claude Code lập kế hoạch trước (chế độ plan mode, được mô tả trong tài liệu chính thức của Anthropic về các quy trình làm việc thường gặp), rồi làm từng bước nhỏ và dừng báo cáo sau mỗi bước. Giao một lần “thêm hệ thống đặt lịch đầy đủ” thường cho ra khối mã lớn khó kiểm tra, còn chia nhỏ thì mỗi bước bạn xem được và quay lại được.

Mục tiêu: thêm trang “Tìm kiếm sản phẩm” cho dự án này. Trước khi làm, tạo nhánh git mới tên tim-kiem-san-pham.
Bước 1: đọc cấu trúc thư mục, đề xuất kế hoạch gồm danh sách file sẽ tạo hoặc sửa. Chưa viết code.
Điều cấm: không sửa các file lõi của dự án, không cài thư viện mới, không chạm vào cơ sở dữ liệu.
Sau khi tôi duyệt kế hoạch, làm từng bước một và dừng lại báo cáo sau mỗi bước.

Mẫu này an toàn vì hai lớp: phạm vi bị giới hạn bằng điều cấm, và mọi thay đổi nằm trên một nhánh git riêng. Chính git mới là thứ đảm bảo quay lại được, vì bạn xem được toàn bộ thay đổi và bỏ nhánh khi kết quả không ưng. Nếu dự án là WordPress, hãy đặt phần việc trong theme con để khỏi sửa theme gốc, nhưng theme con chỉ tách mã của bạn khỏi bản cập nhật, không thay cho git hay bản sao lưu. Với website dùng Flatsome, bài thiết kế web bằng Flatsome giải thích vì sao nên giữ tuỳ biến ở lớp riêng.

Các bước thêm tính năng bằng Claude Code an toàn
Chia nhỏ việc, duyệt từng bước và làm trên nhánh riêng.

Khi nào không nên giao thẳng cho Claude Code?

Không nên giao thẳng khi việc đụng đến dữ liệu thật, tiền, mật khẩu hoặc máy chủ đang chạy. Với những việc này, hãy để Claude Code đọc và đề xuất, còn bước thực thi do bạn hoặc kỹ thuật viên duyệt từng lệnh.

  • Xoá hoặc sửa hàng loạt dữ liệu trong cơ sở dữ liệu đang chạy.
  • Đổi cấu hình máy chủ, quyền thư mục, tài khoản quản trị.
  • Xử lý website đã nhiễm mã độc: việc này cần rà tài khoản admin, mật khẩu hosting và nhiều thứ ngoài file mã.
  • Đẩy bản lên môi trường thật khi chưa có bản sao lưu.

Lý do cho việc mã độc: chúng tôi từng dọn một hosting dùng chung có khoảng 28 website nhiễm nhiều họ mã độc cùng lúc, và 2 tuần sau website tái nhiễm vì còn sót các tài khoản quản trị cửa hậu. Quét và xoá file là chưa đủ, phải rà cả tài khoản và mật khẩu, nên đừng kỳ vọng một prompt “dọn sạch giúp tôi” xử lý được. Với tình huống này, xem quy trình xoá mã độc website WordPress. Với việc dọn dẹp máy chủ, hãy luôn ghi rõ thư mục nào được động tới, và kiểm tra dung lượng ổ đĩa trước, vì ổ VPS đầy gần hết cũng đủ làm backup và cập nhật thất bại âm thầm mà không ai hay.

Những lỗi viết prompt hay gặp

Phần lớn kết quả tệ đến từ vài thói quen lặp lại, không phải từ việc công cụ kém. Có 5 lỗi gặp nhiều nhất: yêu cầu chung chung, không ghi điều cấm, giao nhiều việc một lần, thiếu cách kiểm tra và đoán nguyên nhân lỗi. Bảng dưới đây gom các lỗi này cùng hậu quả và cách sửa, bạn có thể đối chiếu với prompt của mình trước khi bấm gửi.

Lỗi hay gặpHậu quảCách sửa
Yêu cầu chung chung (“làm đẹp hơn”)AI tự chọn phong cáchNêu màu, bố cục, ví dụ cụ thể
Không ghi điều cấmĐổi cả phần không muốn đổiLiệt kê file và thư mục không được chạm
Giao nhiều việc một lầnKhó kiểm tra, khó quay lạiMỗi prompt một việc, duyệt xong mới làm tiếp
Không có cách kiểm traAI báo xong nhưng chưa chạy thửGhi lệnh hoặc bước mở trang để xác nhận
Đoán nguyên nhân lỗiSửa sai chỗMô tả triệu chứng, dán thông báo lỗi

Cách cải thiện bền nhất là lưu những prompt đã chạy tốt thành file mẫu, lần sau chỉ thay phần bối cảnh. Phần dùng lại giữa các lần (công nghệ của dự án, đối tượng khách, danh sách từ cần tránh, lệnh kiểm tra) nên ghi vào file CLAUDE.md đặt trong thư mục dự án để Claude Code đọc sẵn mỗi lần mở, khỏi gõ lại. Đây là cơ chế có trong tài liệu của Anthropic, bạn có thể bắt đầu bằng vài dòng rồi bổ sung dần mỗi khi thấy AI mắc cùng một lỗi. Nếu muốn học bài bản cách xây bộ mẫu riêng, bạn có thể xem trang khoá học Claude Code của HPB Media, hoặc tham khảo thêm trang khoá học AI nếu muốn nhìn rộng hơn.

Câu hỏi thường gặp

Viết prompt cho Claude Code bằng tiếng Việt có được không?

Được, bạn cứ viết yêu cầu bằng tiếng Việt. Tuy vậy nên giữ nguyên bản gốc tiếng Anh cho tên hàm, tên file và thông báo lỗi để tránh sai lệch. Với nội dung hiển thị cho khách, hãy ghi rõ “tiếng Việt có dấu” rồi đọc lại kết quả.

Prompt dài có tốt hơn prompt ngắn không?

Không hẳn. Điều quan trọng là đủ 5 phần, không phải độ dài. Một prompt 6 dòng có mục tiêu, phạm vi, điều cấm và cách kiểm tra thường tốt hơn một đoạn dài kể lể mà không có tiêu chí xong.

Có cần biết lập trình mới dùng được không?

Không bắt buộc cho việc đơn giản như làm landing page tĩnh. Nhưng bạn nên đọc được kế hoạch và biết kiểm tra kết quả trên trình duyệt. Với việc đụng máy chủ hoặc dữ liệu thật, hãy có người rành kỹ thuật duyệt.

Làm sao để AI không sửa lung tung phần khác?

Ghi rõ file được sửa và file không được chạm, yêu cầu làm từng bước nhỏ, và dùng git để xem lại thay đổi trước khi giữ. Mỗi việc một nhánh riêng thì bạn bỏ đi được ngay khi kết quả không ưng.

Muốn dùng Claude Code đúng cách cho công việc của bạn?

HPB Media hướng dẫn xây bộ prompt riêng cho website và quy trình của bạn, hoặc nhận làm trực tiếp nếu bạn không muốn tự làm. Báo giá chính xác sau khi xem yêu cầu.

Nhắn Zalo 0913 337 280 Gửi yêu cầu tư vấn

Chia sẻ bài viết:
Facebook Zalo

Gọi điện ngay

Liên hệ tư vấn