Nội dung
- 1. 1. Tự đoán khi yêu cầu mơ hồ
- 2. 2. Đổi đường dẫn (URL) cũ
- 3. 3. Đưa khóa bí mật vào mã nguồn
- 4. 4. Thêm thư viện không cần thiết
- 5. 5. Dùng tính năng không hợp với cách triển khai
- 6. 6. Giao diện đúng trên máy tính, vỡ trên điện thoại
- 7. 7. SEO thiếu hoặc trùng
- 8. 8. "Sửa" bằng cách tắt kiểm tra
- 9. 9. Báo "đã xong" khi chưa kiểm chứng
- 10. 10. Tự làm việc không quay lại được
- 11. Bộ kiểm tra mình dùng cho mọi dự án
- 12. Kết luận
AI agent như Claude Code viết mã rất nhanh, nhưng nhanh không có nghĩa là đúng. Sau một năm làm website cùng AI agent, mình thấy lỗi lặp lại theo những kiểu khá giống nhau: đoán khi yêu cầu không rõ, làm "cho chạy được" thay vì làm đúng, và bỏ qua những thứ không ai nhắc. Tin tốt là phần lớn phòng được bằng cách viết yêu cầu rõ và có bước kiểm tra cố định.
Dưới đây là 10 lỗi mình gặp nhiều nhất và cách mình xử lý.
1. Tự đoán khi yêu cầu mơ hồ
Biểu hiện: bảo "làm trang liên hệ", nhận về form gửi đi đâu đó không rõ, hoặc thêm cả bản đồ, mạng xã hội mà bạn không cần.
Cách phòng: nêu kết quả mong muốn và giới hạn ngay từ đầu. "Form liên hệ gồm tên, email, nội dung; gửi về một địa chỉ email duy nhất; chống spam bằng Turnstile; không lưu dữ liệu vào cơ sở dữ liệu."
2. Đổi đường dẫn (URL) cũ
Biểu hiện: khi dựng lại website, agent đặt URL "đẹp hơn" theo ý nó, làm mất thứ hạng Google của các trang cũ.
Cách phòng: ghi rõ trong file quy tắc dự án (CLAUDE.md): "Giữ nguyên URL cũ. Đổi URL thì phải thêm chuyển hướng 301." Kèm một script kiểm tra danh sách URL cũ sau mỗi lần build. Chi tiết ở bài chuyển website không mất SEO.
3. Đưa khóa bí mật vào mã nguồn
Biểu hiện: để cho chạy nhanh, agent dán khóa API, mật khẩu email vào file cấu hình rồi đẩy lên GitHub.
Cách phòng: quy tắc cứng "không đưa mật khẩu, token, khóa bí mật vào repo hay chat", dùng GitHub Secrets hoặc Secret Manager. Không bao giờ dán khóa thật vào cửa sổ trò chuyện. Bật quét bí mật (secret scanning) trên GitHub.
4. Thêm thư viện không cần thiết
Biểu hiện: cần một hiệu ứng nhỏ, agent cài nguyên một thư viện lớn. Website nặng dần lên mà không ai để ý.
Cách phòng: yêu cầu "ưu tiên dùng những gì dự án đã có, hỏi trước khi thêm thư viện mới". Khi duyệt, xem file package.json có gì mới.
5. Dùng tính năng không hợp với cách triển khai
Biểu hiện: website xuất thành trang tĩnh (static export) nhưng agent viết API route, middleware hoặc dùng tối ưu ảnh tự động của Next.js, những thứ cần máy chủ. Chạy thử trên máy thì được, build thật thì lỗi.
Cách phòng: ghi rõ trong quy tắc dự án: "Site tĩnh, không dùng tính năng cần máy chủ Next." Luôn chạy build thật, không chỉ chạy chế độ dev. Xem thêm: Deploy Next.js lên Firebase Hosting.
6. Giao diện đúng trên máy tính, vỡ trên điện thoại
Biểu hiện: agent dựng theo thiết kế desktop, phần điện thoại bị chữ tràn, nút quá nhỏ, cuộn ngang.
Cách phòng: yêu cầu kiểm tra ở các chiều rộng cụ thể (375px, 768px, 1280px). Chụp màn hình tự động bằng trình duyệt không giao diện ở các kích thước này để soát nhanh.
7. SEO thiếu hoặc trùng
Biểu hiện: mọi trang cùng một tiêu đề, thiếu mô tả, ảnh không có alt, thiếu canonical, sitemap không cập nhật.
Cách phòng: đưa quy tắc SEO vào file quy tắc dự án: tiêu đề tối đa 60 ký tự, mô tả 120–160 ký tự, một H1 mỗi trang, ảnh có alt mô tả. Sau khi build, xem mã nguồn vài trang ngẫu nhiên.
8. "Sửa" bằng cách tắt kiểm tra
Biểu hiện: test hoặc kiểm tra kiểu dữ liệu báo lỗi, agent tắt kiểm tra đó hoặc thêm ngoại lệ để vượt qua, thay vì sửa nguyên nhân.
Cách phòng: quy tắc "không bỏ qua, tắt hay xóa test để cho qua". Khi duyệt thay đổi, để ý những dòng bị xóa trong test và cấu hình.
9. Báo "đã xong" khi chưa kiểm chứng
Biểu hiện: agent báo hoàn thành, nhưng chưa chạy build, chưa mở trang thử.
Cách phòng: yêu cầu bằng chứng: kết quả build, kết quả test, ảnh chụp trang. Với mình, mọi thay đổi đều qua Pull Request có link xem thử, mình tự mở trên điện thoại trước khi merge.
10. Tự làm việc không quay lại được
Biểu hiện: xóa file, đổi DNS, xóa máy chủ, gửi email ra ngoài khi chưa được hỏi.
Cách phòng: giữ chế độ hỏi quyền cho các lệnh rủi ro. Những bước như đổi DNS, tắt máy chủ cũ, thanh toán, mình luôn tự làm sau khi đã kiểm tra.
Bộ kiểm tra mình dùng cho mọi dự án
- File
CLAUDE.mdcó quy tắc: công nghệ, URL, bí mật, SEO, những điều cấm - Build thật thành công, không chỉ chạy dev
- Script kiểm tra URL cũ và link hỏng
- Ảnh chụp trang ở 375px, 768px, 1280px
- Xem
package.jsonvà các file cấu hình bị đổi - Không có khóa bí mật trong thay đổi
- Duyệt trên link xem thử trước khi merge
Kết luận
AI agent giống một đồng nghiệp làm rất nhanh nhưng mới vào dự án: giỏi, nhưng chưa biết luật nhà. Viết luật nhà ra giấy và kiểm tra theo một danh sách cố định là hai việc giúp mình dùng AI agent an toàn cho website của khách.
Bạn muốn áp dụng AI agent vào quy trình làm web của đội mình? Nhắn cho mình. Đọc thêm: Quy trình làm website 2026: Figma, Claude Code, Firebase.
