🤖 Claude Code SubAgent: Bí mật build đội quân AI chạy song song x3 tốc độ

Bạn có biết Claude Code giấu một tính năng mạnh khủng khiếp mà 90% dev chưa từng dùng? Đó là SubAgent, cho phép bạn spawn cả đội quân AI chạy song song ngay trong terminal, mỗi con có persona và tool riêng. Refactor 50K LOC từ 2 tiếng xuống 30 phút là chuyện thật.

🧠 SubAgent là gì và tại sao nó thay đổi cuộc chơi?

SubAgent là tính năng cho phép bạn tạo nhiều AI con chạy độc lập bên trong Claude Code chính. Mỗi sub-agent có persona riêng, danh sách tool riêng, và context riêng biệt, không bị nhiễu bởi cuộc trò chuyện chính.

Điểm mạnh nhất là chạy song song. Thay vì AI tuần tự làm 5 task mất 50 phút, bạn spawn 5 sub-agent cùng lúc, mỗi con xử lý 1 phần, tổng thời gian chỉ còn khoảng 10 phút. Tiết kiệm thời gian x3 đến x5 cho task multi-step phức tạp.

⚙️ Setup chỉ trong 2 phút

Tạo file tại đường dẫn .claude/agents/<tên-agent>.md với frontmatter YAML ở đầu và body markdown mô tả persona. Ví dụ một agent review code thực tế:

---
name: code-reviewer
description: Review code changes for bugs and style issues
tools: Read, Grep, Bash
---

# Code Reviewer Agent
You review code for bugs, style, and security issues.
Focus on: SQL injection, XSS, unhandled errors, dead code.
Report findings in priority order (critical, high, medium, low).

Lưu file xong là dùng được ngay, không cần restart, không cần config thêm. Trong Claude Code chính, bạn gọi Agent tool với subagent_type: "code-reviewer" kèm prompt chi tiết, sub-agent sẽ chạy độc lập rồi trả kết quả về.

🚀 3 pattern thực chiến giúp x3 productivity

Parallel research là pattern hiệu quả nhất. Spawn 5 sub-agent đi tìm 5 file khác nhau cùng lúc, tiết kiệm 80% thời gian so với cách tuần tự. Cực kỳ hợp khi explore codebase lạ.

Specialized roles giúp chia việc theo chuyên môn. Một agent đóng vai reviewer, một agent viết test, một agent viết docs, cả ba chạy song song. Output đa dạng, chất lượng cao hơn vì mỗi con focus một mục tiêu.

Isolation với worktree là chiêu cao thủ. Bật isolation: "worktree" để sub-agent code trong git worktree riêng, không đụng tới main branch. An toàn tuyệt đối, dù agent có sai cũng không làm hỏng workspace của bạn.

📋 Brief sub-agent đúng cách để khỏi flop

Quy tắc vàng: brief sub-agent như đồng nghiệp mới vào công ty. Nó không biết bạn đang làm gì, không thấy lịch sử chat, nên phải nói rõ mọi thứ từ đầu.

Đưa đường dẫn file cụ thể và số dòng chính xác, đừng bao giờ viết kiểu "based on findings" hay "như đã bàn ở trên". Sub-agent sẽ tịt vì không có context đó. Luôn cap độ dài output, ví dụ "report under 200 words", để tránh nhận về một bức tường chữ.

Với task chạy lâu, bật run_in_background: true để Claude tự thông báo khi xong, bạn rảnh tay làm việc khác.

📊 Con số thực tế biết nói

Một dev đã refactor codebase 50.000 dòng code từ 2 tiếng xuống còn 30 phút bằng cách spawn 4 sub-agent song song, mỗi con phụ trách 1 module. Đó là tăng tốc gấp 4 lần mà chất lượng code không hề giảm.

Áp dụng tương tự cho migration, viết test, review PR lớn, audit security, bạn sẽ thấy SubAgent không phải tính năng phụ, nó là vũ khí chính của dev hiện đại đang dùng AI nghiêm túc.

Bạn đã thử spawn sub-agent đầu tiên của mình chưa, hay vẫn đang code tuần tự một mình với Claude?

#VibeAICoder #ClaudeCode #SubAgent #AICoding #DevProductivity