Bài này dành cho bạn đã có VPS, đã cài xong Claude Code trên đó, và đang có (hoặc sắp dựng) một website WordPress affiliate. Mục tiêu: nạp file luật CLAUDE.md vào đúng thư mục dự án và làm việc với Claude theo một quy trình an toàn.

Nếu chưa cài Claude Code, làm bước cài trước rồi quay lại bài này.

Vì sao phải có file CLAUDE.md Claude Code tự đọc file CLAUDE.md ở thư mục bạn mở phiên làm việc, mỗi phiên, trước khi làm bất cứ việc gì. Đây là chỗ bạn đặt luật một lần để không phải nhắc lại mỗi lần chat: giọng văn, cấm bịa số liệu, cấm claim tự test, quy tắc affiliate disclosure, quy tắc code.

Không có file này thì mỗi phiên Claude làm theo mặc định của nó, và bạn sẽ thấy bài viết lúc thì đúng ý lúc thì không, code lúc sạch lúc bừa.

Bước 1: SSH vào VPS và vào đúng thư mục dự án ssh root@IP_VPS Tìm thư mục gốc của website. Tuỳ cách dựng, thường là một trong các đường dẫn sau:

ls /opt/sites/ # nếu chạy Docker theo từng site ls /var/www/ # nếu chạy LEMP hoặc LAMP truyền thống Vào đúng thư mục đó và xác nhận:

cd /opt/sites/ten-site # thay bằng đường dẫn thật của bạn pwd ls -la Bạn đang đứng đúng chỗ nếu thấy docker-compose.yml, hoặc thấy wp-config.php và wp-content/.

Đây là bước hay sai nhất. Claude Code chỉ đọc và sửa file trong thư mục bạn mở phiên. Mở ở ~ hay ở / thì nó không thấy dự án của bạn, còn mở ở wp-content/themes/child-theme thì nó không thấy phần còn lại của site. Mở ở thư mục gốc dự án.

Bước 2: Nạp file CLAUDE.md vào dự án Đứng tại thư mục gốc dự án, chạy một lệnh duy nhất:

curl -fsSL https://affiliatecms.com/wp-content/uploads/CLAUDE-template.md
| awk '/^# CLAUDE.md, /{f=1} f' > CLAUDE.md Lệnh này tải bản mẫu về và cắt bỏ phần hướng dẫn ở đầu file, chỉ giữ đúng phần luật, ghi thành CLAUDE.md.

Kiểm tra ngay:

head -5 CLAUDE.md # dòng đầu phải là: # CLAUDE.md, {{BRAND}} wc -l CLAUDE.md # khoảng 146 dòng Nếu head in ra <!DOCTYPE html> hoặc một đống thẻ HTML thì file chưa tải được (sai URL, bị chặn, hoặc trả về trang 404). Xem mục xử lý sự cố ở cuối bài.

Cách thay thế nếu curl không được: tải file về máy cá nhân, rồi đẩy lên VPS:

chạy trên MÁY CÁ NHÂN, không phải trên VPS

scp CLAUDE-template.md root@IP_VPS:/opt/sites/ten-site/CLAUDE.md Bước 3: Điền placeholder File mẫu có các chỗ trống dạng {{BRAND}}, {{DOMAIN}}, {{NICHE}}. Phải điền hết, để nguyên thì Claude sẽ làm việc với thông tin rỗng.

Xem còn chỗ nào chưa điền:

grep -n "{{" CLAUDE.md Sửa bằng nano CLAUDE.md (Ctrl+O để lưu, Ctrl+X để thoát), hoặc nhanh hơn là nhờ chính Claude điền. Mở Claude Code rồi gõ:

Mở CLAUDE.md. Hỏi tôi lần lượt từng placeholder {{...}} còn trống, tôi trả lời tới đâu bạn điền tới đó. Không sửa gì khác trong file. Riêng mục 2 "Trạng thái hiện tại" thì tự điền theo tình hình thật: đang ở giai đoạn nào, có bao nhiêu bài, đang làm dở việc gì.

Bước 4: Mở Claude Code và kiểm tra nó đã đọc file claude Việc đầu tiên, kiểm tra Claude thật sự đọc được file luật:

Đọc CLAUDE.md rồi nói lại 3 rule quan trọng nhất trong đó. Chưa làm gì khác. Nếu Claude nhắc đúng các rule bạn vừa điền thì xong phần thiết lập. Nếu nó nói không thấy file, bạn đang mở sai thư mục: thoát ra bằng /exit, cd vào đúng chỗ, mở lại.

Bước 5: Quy trình một phiên làm việc Mở đầu bằng yêu cầu lên plan, đừng bảo nó code luôn:

Đọc CLAUDE.md trước. Hôm nay tôi cần: [mô tả việc]. Lên plan trước, nêu rõ sẽ sửa file nào và rủi ro gì, chờ tôi duyệt rồi mới làm. Đọc plan rồi mới duyệt. Chỗ nào thấy nó định sửa file không liên quan thì nói thẳng "không đụng vào file đó". Đây là lúc rẻ nhất để chặn sai sót, sửa sau khi nó đã chạy 20 lệnh thì tốn hơn nhiều.

Kiểm tra kết quả, đừng tin báo cáo suông. Nó nói xong rồi thì bạn tự mở lại trang web, tự chạy lại lệnh, tự nhìn file.

Đổi việc thì gõ /clear. Ngữ cảnh cũ để lẫn vào việc mới làm chất lượng giảm rõ rệt.

Khi Claude làm sai rule, nhắc thẳng tên rule, ví dụ "vi phạm rule H1, không được inline CSS". Nếu rule viết mơ hồ thì bảo nó sửa lại rule đó trong CLAUDE.md cho rõ hơn. File này là file sống, càng dùng càng chuẩn.

Lưu ý riêng khi làm trên VPS production Đây là phần khác biệt lớn nhất so với chạy trên máy cá nhân: mọi thứ đều là thật và không có nút undo.

Backup trước khi làm việc lớn. Dump database và nén source lại. Một lệnh sai trên production đắt hơn nhiều so với 2 phút backup. Đừng tắt cơ chế hỏi quyền trên production. Chế độ tự động chấp nhận mọi lệnh chỉ nên dùng ở môi trường thử nghiệm, nơi hỏng thì dựng lại được. Đọc kỹ lệnh trước khi bấm đồng ý, nhất là lệnh có rm, DROP, TRUNCATE, chmod -R, mv trên thư mục lớn. Không dán mật khẩu, API key, thông tin thẻ vào khung chat. Để trong file .env và đảm bảo .env đã nằm trong .gitignore trước khi tạo. Site đang có traffic thì làm trên bản staging trước, chạy ổn mới đưa lên production. Sửa file PHP xong phải xoá cache (OPcache, object cache, page cache), nếu không bạn sẽ thấy như code không ăn rồi sửa lung tung tiếp. Kiểm tra git status trước mỗi lần commit, đừng git add -A khi chưa nhìn danh sách file. Xử lý sự cố thường gặp head in ra HTML thay vì nội dung file. URL sai, file chưa upload xong, hoặc bị tường lửa chặn. Kiểm tra bằng cách mở đúng URL đó trên trình duyệt máy cá nhân xem có tải về được không.

CLAUDE-template.md dành cho website Affiliate

chạy trên MÁY CÁ NHÂN, không phải trên VPS

Keep reading