Làm chủ quy trình làm việc chuyên nghiệp với Claude Code theo hướng dẫn chính thức: khám phá – lập kế hoạch – viết mã – commit, cùng CLAUDE.md, skills, hooks, subagents và MCP.
- Quy trình khám phá → lập kế hoạch → viết mã → commit
- Viết CLAUDE.md ngắn gọn, hiệu quả
- Skills, hooks, subagents: dùng khi nào
- Quản lý ngữ cảnh và kiểm chứng kết quả
Cơ sở lý thuyết
Hướng dẫn "Best practices for Claude Code" của Anthropic chỉ ra lỗi phổ biến nhất: để Claude lao vào viết mã ngay có thể giải sai vấn đề. Giải pháp là tách khám phá khỏi thực thi bằng chế độ lập kế hoạch (plan mode) – nhấn Shift+Tab đến khi thanh trạng thái hiện "plan mode on"; khi đó Claude chỉ đọc và trả lời, không sửa tệp.
| Giai đoạn | Chế độ | Việc làm |
|---|---|---|
| Khám phá | Plan mode | Đọc mã liên quan, giải thích luồng xử lý |
| Lập kế hoạch | Plan mode | Kế hoạch chi tiết; có thể mở ra sửa trực tiếp |
| Viết mã | Mặc định | Thực hiện theo kế hoạch, tự kiểm tra |
| Commit | Mặc định | Thông điệp commit mô tả rõ, tạo pull request |
| Cơ chế | Bản chất | Dùng khi |
|---|---|---|
| CLAUDE.md | Hướng dẫn mang tính khuyến nghị, nạp mỗi phiên | Lệnh build, quy ước mã, cấu trúc dự án |
| Skills | Quy trình chuyên biệt, nạp khi cần | Quy trình lặp lại: viết migration, review bảo mật |
| Hooks | Kịch bản chạy chắc chắn tại các thời điểm cố định | Việc bắt buộc mọi lần: chạy formatter, chặn sửa tệp .env |
| Subagents | Tác tử con có ngữ cảnh riêng | Tìm kiếm rộng, review độc lập, chạy song song |
| MCP | Kết nối công cụ ngoài | Đọc ticket Jira, tài liệu Drive, CSDL |
- Khác biệt quan trọng: CLAUDE.md là khuyến nghị, hooks là tất định – việc gì bắt buộc luôn xảy ra thì dùng hook.
- Giữ CLAUDE.md ngắn, cụ thể, có thể kiểm chứng; tỉa bớt thường xuyên.
- Cho Claude cách tự kiểm chứng: kiểm thử, ảnh chụp màn hình, lệnh build – vòng phản hồi tốt là yếu tố lớn nhất quyết định chất lượng.
- Dùng
/cleargiữa các việc không liên quan để ngữ cảnh không bị loãng.
Ví dụ CLAUDE.md
# Dự án QLSV (Laravel 12, PHP 8.3, MySQL)
## Lệnh
- Chạy kiểm thử: php artisan test
- Kiểm tra mã: ./vendor/bin/pint --test
## Quy ước
- Controller mỏng, logic nghiệp vụ trong app/Services
- Mọi truy vấn qua Eloquent, không dùng SQL nối chuỗi
- Thông báo cho người dùng bằng tiếng Việt
## Lưu ý
- Không sửa thư mục database/migrations đã chạy trên production; tạo migration mới
Ứng dụng thực tế
Bài toán: nhóm phát triển cổng thông tin sinh viên muốn mọi thay đổi đều qua kiểm thử và không ai vô tình làm lộ tệp cấu hình. Thiết lập: CLAUDE.md mô tả quy ước; hook chạy kiểm thử sau mỗi lần sửa tệp PHP và chặn mọi thao tác ghi vào .env; subagent "reviewer" rà soát bảo mật trước khi tạo pull request; connector MCP đọc yêu cầu từ hệ thống quản lý công việc. Kết quả: Claude làm việc lâu hơn mà vẫn tin cậy, người duyệt chỉ cần xem kế hoạch và diff cuối.
Không bật chế độ tự động chấp nhận mọi thao tác trên kho mã quan trọng khi chưa có kiểm thử và sao lưu.
- Bật plan mode, yêu cầu Claude giải thích một mô-đun và lập kế hoạch sửa lỗi.
- Viết CLAUDE.md dưới 40 dòng cho dự án của bạn.
- Thử tạo một skill hoặc hook đơn giản theo tài liệu chính thức.
Nguồn chính: Best practices for Claude Code, Claude Code docs. Tính năng và giá có thể thay đổi; hãy đối chiếu với trang chính thức.
- Khám phá → kế hoạch → mã → commit.
- CLAUDE.md khuyến nghị, hooks bắt buộc.
- Cho Claude cách tự kiểm chứng.

