claude-code-best-practice

TL;DR

Tổng hợp cách xài các feature của Claude Code như Commands, Sub-Agents, Skills, Memory để tăng năng suất dev. Bao gồm tips từ team Claude và Boris Cherny — có cả workflow mẫu, cách debug, và những câu hỏi chưa có answer.

Bài này dành cho ai?

1. Dev muốn xài AI assistant hiệu quả hơn

Vấn đề: Xài Claude Code nhưng không biết các feature nâng cao, cứ gõ prompt từ đầu mỗi lần

Khi nào cần: Khi muốn setup workflow tái sử dụng, hoặc làm việc với AI agent trong dự án lớn

Được gì: Biết cách dùng Commands, Sub-Agents, Skills để automation mà không phải viết lại prompt mỗi lần

2. Team lead / Architect muốn setup quy trình cho team

Vấn đề: Team chưa có standard cách dùng AI trong dev workflow

Khi nào cần: Khi muốn onboarding nhanh, hoặc setup shared configs cho cả team

Được gì: Template CLAUDE.md, cách organize rules, workflow mẫu từ các founder

3. AI product builder

Vấn đề: Không biết Claude Code có những feature gì để tham khảo cho sản phẩm mình

Khi nào cần: Khi đang build AI coding tool hoặc developer tools

Được gì: Map đầy đủ các feature, cả những câu hỏi chưa ai trả lời được

Các điểm chính

1. CLAUDE.md nên dưới 200 dòng, tốt nhất là 60 dòng Instruction quá nhiều thì Claude bỏ qua. Trước khi thêm cái mới, hỏi “Cái này dùng cho 80% sessions hông?” → Làm gì: Viết CLAUDE.md ngắn gọn, chia rules ra file riêng nếu cần

2. Dùng Commands thay vì Sub-Agents cho workflow Commands invoke nhanh hơn, đỡ tốn context hơn. Sub-Agents chỉ dùng khi cần extra context cho feature cụ thể → Làm gì: Ưu tiên Commands cho reusable workflows

3. Plan mode là bắt buộc cho task lớn Dùng plan mode để Claude interview mình, tạo gated plan với từng phase có tests riêng → Làm gì: Gõ /plan hoặc để Claude hỏi câu hỏi trước khi bắt đầu

4. Dùng /compact khi context trên 50%, /clear khi đổi task Để tránh “agent dumb zone” — Claude bắt đầu làm kém khi context đầy → Làm gì: Gõ /compact thường xuyên, /clear khi chuyển sang task mới

5. Vanilla Claude Code tốt hơn workflow phức tạp cho task nhỏ Đừng overkill bằng workflow với task đơn giản → Làm gì: Cân nhắc — task này có cần workflow không, hay chỉ cần prompt trực tiếp

6. Commit mỗi giờ, dùng /rewind khi Claude đi sai Checkpointing tự động git-based. Esc Esc hoặc /rewind để undo khi Claude đi lệch hướng → Làm gì: Commit ngay khi task hoàn thành, dùng /rewind thay vì cố fix trong context đầy

7. Git Worktrees + Agent Teams cho parallel development Mỗi agent có working copy riêng, dev không bị conflict → Làm gì: Dùng git worktrees khi cần nhiều agent chạy song song

8. Voice Mode thay thế Wispr Flow, Remote Control thay thế OpenClaw Bài viết liệt kê những startup bị Claude Code feature native thay thế → Làm gì: Nếu đang xài mấy tool này, cân nhắc chuyển sang feature có sẵn

9. 10 câu hỏi chưa có answer — “Billion Dollar Questions” Những câu hỏi như: CLAUDE.md nên có gì / không có gì? Khi nào dùng command vs agent vs skill? Tại sao Claude vẫn ignore instructions dù có MUST in caps? → Làm gì: Đọc để biết những vấn đề còn open, thử experiment

10. Có 8 báo cáo kỹ thuật trong repo Agent SDK vs CLI system prompts, Browser MCP comparison, Global vs project settings, LLM day-to-day degradation… → Làm gì: Đọc những phần liên quan khi gặp vấn đề cụ thể

Quick Start

1. Tạo CLAUDE.md trong project — viết dưới 60 dòng, tập trung instructions quan trọng nhất

2. Thử orchestration workflow mẫu — gõ claude rồi /weather-orchestrator để xem Command → Agent → Skill hoạt động

3. Dùng plan mode trước mọi task lớn — gõ /plan hoặc để Claude hỏi câu hỏi trước