Claude Code Best Practice(Too Long; Didn’t Read)

TL;DR

• Dùng file CLAUDE.md: Hardcode các chuẩn code (OOP, SOLID, tech stack) của project vào file này ở root. Claude sẽ tự động apply cho mọi session.
• Tạo Self-Feedback Loop: Không bao giờ yêu cầu "viết code". Hãy yêu cầu "viết code, chạy test/linter, và tự fix lỗi" (vd: claude "fix bug X, run npm test, fix any errors").
• Workflow 3 bước (Khảo sát → Plan → Implement): Yêu cầu phân tích file, lập kế hoạch, chờ bạn duyệt rồi mới code. Tránh prompt chung chung gây hỏng cấu trúc.
• Quản lý Context nghiêm ngặt: Dùng @filename để chỉ định đúng file. Dùng pipe (cat log | claude) để nạp data. Thường xuyên clear context.

Solution: Các Best Practice Thực Chiến

1. Tối ưu Môi trường & Context (Setup)

• Quy chuẩn hóa với CLAUDE.md: Tạo file CLAUDE.md tại thư mục root. Viết rõ ràng các rule để tránh việc phải nhắc lại nhiều lần. Ví dụ nội dung: "Project dùng Java Spring Boot và React. Bắt buộc tuân thủ nguyên tắc SOLID. Sử dụng functional component cho JS. Khi viết REST API, luôn bao gồm error handling chuẩn."
• Tạo Alias tăng tốc (Local Dev): Nếu bạn hiểu rõ project và muốn bỏ qua các prompt xác nhận quyền (file read/write), cấu hình alias trong ~/.zshrc hoặc ~/.bashrc:

  alias cc='claude --dangerously-skip-permissions'
  

• Nạp Context trực tiếp: Sử dụng ký hiệu @ để trỏ thẳng vào file, hoặc truyền output của terminal vào Claude Code qua pipe.

  # Thay vì copy paste log lỗi:
  cat error.log | claude "Phân tích root cause và đưa ra cách fix dựa trên @src/services/PaymentService.java"
  

2. Tối ưu Quy trình Lập trình (Agile / TDD)

• Bước 1: Khảo sát (Explore): Yêu cầu AI đọc codebase trước khi làm. Prompt: Đọc @src/auth. Phân tích luồng JWT token hiện tại và chỉ ra các rủi ro bảo mật tiềm ẩn.
• Bước 2: Lập kế hoạch (Plan): Yêu cầu đưa ra giải pháp trước khi viết code để kiểm soát kiến trúc. Prompt: Viết step-by-step plan để thêm tính năng MFA. Chỉ rõ các file cần tạo mới/sửa đổi. Đợi tôi duyệt trước khi implement.
• Bước 3: Code & Verify (TDD Workflow): Kết hợp các command line tool để AI tự kiểm tra chéo. Prompt: Viết unit test cho MFA theo plan. Chạy npm run test. Sau đó implement logic. Tiếp tục lặp lại việc sửa code và chạy test cho đến khi test pass 100%.

3. Tích hợp CI/CD & Scale (Sản xuất)

• Headless / CI Pipeline: Bạn có thể tích hợp Claude Code vào Jenkins hoặc GitHub Actions để tự động hóa review PR hoặc triage bug.

  claude "Review the uncommitted changes. Check for performance bottlenecks and OOP violations. Output a summary report."
  

• Chạy song song (Parallel Workflows): Mở nhiều terminal. Dùng một file markdown trung gian (ví dụ ticket-123.md) để làm "bộ nhớ chung". Tab 1 (làm backend) sẽ ghi kết quả API contract vào file, Tab 2 (làm frontend UI) sẽ đọc file đó để implement mà không bị nhiễu context của nhau.

Đánh đổi & Lưu ý (Trade-offs & Edge Cases)

• Tốc độ vs. An toàn: Dùng --dangerously-skip-permissions giúp tiết kiệm 30% thời gian gõ phím, nhưng bắt buộc phải đảm bảo code đã được commit sạch sẽ (git status clean) trước khi chạy, đề phòng AI ghi đè nhầm file quan trọng.
• Chi phí Context: Đừng nạp toàn bộ thư mục (vd: @src/). Điều này làm tăng độ trễ (latency), tốn token và khiến AI bị "loãng" trọng tâm. Chỉ trỏ đích danh các file liên quan trực tiếp. Dùng lệnh /compact thường xuyên để dọn dẹp bộ nhớ của session hiện tại.
• Edge Case UI Testing: Với Frontend (JS/React), unit test đôi khi không đủ. Hãy tích hợp MCP (Model Context Protocol) với Playwright để Claude Code có thể tự động bật trình duyệt, click thử và verify UI tự động thay vì chỉ check logic code.