Subagent là gì? Hiểu trợ lý con trong Claude Code qua ví dụ

Làm một việc lớn với Claude Code, bạn sẽ thấy nó hay "chia việc" cho các subagent (trợ lý con). Đọc xong bài này, bạn sẽ hiểu trợ lý con là gì, vì sao nó tồn tại, cách tự tạo một trợ lý con đơn giản, và lúc nào nên để Claude tự làm thay vì giao đi.

Phạm vi bài: "subagent" ở đây là tính năng subagents của Claude Code. Claude Code là công cụ AI của Anthropic làm việc trực tiếp với các tệp trong một thư mục trên máy bạn, thường dùng qua cửa sổ dòng lệnh (terminal). Một số công cụ AI khác có ý tưởng tương tự, nhưng tên gọi và cách tạo khác nhau. Thông tin tính năng trong bài theo tài liệu chính thức, kiểm tra ngày 25/10/2026.

Hiểu nhanh trong một câu

Subagent là một trợ lý AI chuyên một việc, được Claude giao một phần công việc, tự làm trong "không gian riêng", rồi chỉ gửi lại bản tóm tắt kết quả.

Mỗi trợ lý con có ba thứ của riêng nó: cửa sổ ngữ cảnh riêng (phần "bộ nhớ làm việc" mà AI nhìn thấy cùng lúc, xem bài Cửa sổ ngữ cảnh là gì), lời dặn riêng, và danh sách công cụ được phép dùng.

Ví dụ đời thường: trưởng phòng giao việc

Hình dung bạn là trưởng phòng, cần nộp báo cáo quý cho giám đốc. Bạn không tự đọc hết 40 tệp hoá đơn, 12 bảng lương và 300 email. Bạn giao:

• Nhân viên A đọc hoá đơn, chỉ ghi lại các khoản bất thường.
• Nhân viên B đối chiếu bảng lương, báo chỗ lệch.
• Nhân viên C lọc email, tóm tắt 5 việc khách phàn nàn nhiều nhất.

Mỗi người làm ở bàn riêng. Xong việc, họ không đổ cả chồng giấy lên bàn bạn, chỉ nộp một trang tóm tắt. Bạn đọc ba trang đó rồi viết báo cáo.

Trong Claude Code, Claude chính (cuộc trò chuyện bạn đang gõ) là trưởng phòng, còn các trợ lý con là nhân viên.

Trợ lý con cũng là một dạng AI agent: nó tự đọc tệp, tự dùng công cụ, tự quyết định bước tiếp theo. Điểm khác là nó làm một phần việc do agent chính giao, rồi báo cáo lại.

Vì sao cần trợ lý con?

1. Giữ cuộc trò chuyện chính gọn

Đây là lý do quan trọng nhất. Khi Claude tự đọc 30 tệp, toàn bộ nội dung đó nằm lại trong cửa sổ ngữ cảnh của cuộc trò chuyện. Cửa sổ đầy dần, câu trả lời có thể chậm hơn và dễ "quên" lời bạn dặn từ đầu.

Giao cho trợ lý con thì phần đọc tệp, kết quả tìm kiếm, nhật ký lỗi nằm trong ngữ cảnh riêng của nó. Cuộc trò chuyện chính chỉ nhận bản tóm tắt.

2. Chạy song song

Những việc không phụ thuộc nhau (như ba nhân viên A, B, C ở trên) có thể chạy cùng lúc. Theo tài liệu, trợ lý con do Claude tạo từ cuộc trò chuyện chính mặc định chạy nền, nên bạn vẫn trò chuyện tiếp được trong lúc chờ.

3. Chuyên môn hoá

Mỗi trợ lý con có lời dặn riêng cho đúng một việc: soát chính tả theo quy tắc của công ty, kiểm số liệu theo một bảng tiêu chí. Lời dặn tập trung thì kết quả thường ổn định hơn một lời dặn ôm đồm mọi thứ.

4. Giới hạn quyền dùng công cụ

Bạn quyết định trợ lý con được làm gì. Một trợ lý "soát chính tả" chỉ cần đọc tệp, không cần quyền sửa hay chạy lệnh. Cấp ít quyền thì nếu nó hiểu sai, thiệt hại cũng nhỏ.

Ngoài ra, bạn có thể cho trợ lý con dùng mô hình nhanh và rẻ hơn (như Haiku) cho việc đơn giản, để tiết kiệm hạn mức.

Bạn chưa tạo gì, Claude Code vẫn có vài trợ lý con dựng sẵn, ví dụ Explore (chỉ đọc, chuyên tìm kiếm trong thư mục), Plan (nghiên cứu khi lập kế hoạch) và general-purpose (đa năng). Vì vậy bạn hay thấy Claude tự giao việc dù chưa cài thêm gì.

Cách tạo một trợ lý con đơn giản

Một trợ lý con là một tệp .md (tệp văn bản Markdown) gồm hai phần: phần đầu khai báo tên, mô tả, công cụ; phần dưới là lời dặn.

Đặt tệp ở một trong hai chỗ:

• .claude/agents/ trong thư mục dự án: chỉ dùng cho dự án đó, có thể chia sẻ cho cả nhóm.
• ~/.claude/agents/ (trên Windows là C:\Users\<tên bạn>\.claude\agents\): dùng cho mọi dự án trên máy bạn.

Cách 1: nhờ Claude tạo giúp

Đây là cách tài liệu chính thức hướng dẫn đầu tiên. Bạn gõ yêu cầu bằng lời thường, Claude viết tệp cho bạn, rồi bạn mở tệp ra đọc lại.

Tạo một subagent tên soat-chinh-ta trong ~/.claude/agents/.
Nhiệm vụ: soát lỗi chính tả và dấu tiếng Việt trong bài viết.
Chỉ được đọc tệp, không được sửa. Trả về danh sách lỗi kèm câu gợi ý sửa.

Cách 2: tự viết tệp

Ví dụ trợ lý con soát chính tả, lưu thành soat-chinh-ta.md:

---
name: soat-chinh-ta
description: Soát lỗi chính tả, dấu tiếng Việt và câu tối nghĩa trong bài viết. Dùng khi bài viết xong và cần kiểm tra trước khi gửi.
tools: Read, Grep, Glob
---
 
Bạn là biên tập viên tiếng Việt cẩn thận.
 
1. Đọc bài được giao, tìm lỗi chính tả, sai dấu, lặp từ, câu quá dài.
2. Không tự sửa tệp.
3. Trả về bảng: dòng số mấy, chữ sai, gợi ý sửa, lý do ngắn.
4. Không chắc thì ghi "cần người xem lại", đừng đoán.

Ý nghĩa từng dòng ở phần đầu:

Phần dưới đường --- thứ hai là lời dặn của trợ lý con, viết như khi giao việc cho một nhân viên mới: vai trò, các bước, cách trình bày kết quả.

Thêm một ví dụ: trợ lý con kiểm số liệu bảng tính. Bạn có thể đặt description: Kiểm tra bảng số liệu CSV: tổng cộng có khớp không, có dòng trùng hay ô trống không, và dặn nó chỉ báo lỗi, không sửa số. Với tệp .xlsx, Claude Code thường phải chạy thêm một đoạn mã để đọc, nghĩa là trợ lý con cần thêm quyền chạy lệnh; muốn giữ quyền thấp thì xuất bảng ra CSV trước.

Gọi trợ lý con làm việc

• Để Claude tự chọn: Claude đọc description của các trợ lý con và giao việc khi thấy khớp. Mô tả càng rõ "dùng khi nào" thì càng dễ được chọn đúng.
• Gọi tên: gõ thẳng "Dùng subagent soat-chinh-ta kiểm tra bài nay.md".
• Nhắc bằng @: gõ @ rồi chọn trợ lý con trong danh sách gợi ý, giống khi nhắc tên tệp. Cách này bảo đảm đúng trợ lý đó được chạy, thay vì để Claude tự chọn.

Nếu vừa tạo thư mục agents lần đầu mà Claude chưa thấy trợ lý con mới, hãy khởi động lại Claude Code.

Khi nào nên dùng, khi nào không?

Theo hướng dẫn của Anthropic, trợ lý con hợp khi:

• việc sinh ra nhiều nội dung thô bạn không cần giữ (đọc nhiều tệp, chạy kiểm tra dài);
• bạn muốn giới hạn quyền cho một việc cụ thể;
• việc tự đứng được, làm xong chỉ cần nộp bản tóm tắt;
• có vài việc độc lập chạy song song được.

Nên để Claude chính tự làm khi:

• việc cần trao đổi qua lại nhiều lần, sửa từng chút;
• các bước dính chặt vào nhau, bước sau cần biết đầy đủ bước trước;
• việc nhỏ và nhanh: giao đi còn lâu hơn tự làm;
• nhiều trợ lý con cùng sửa một tệp, dễ giẫm chân nhau.

Hai cái giá phải trả

Tốn thêm lượt dùng. Mỗi trợ lý con tự gửi yêu cầu riêng tới mô hình, và theo tài liệu, phần này tính vào cùng hạn mức sử dụng với cuộc trò chuyện chính. Giao năm trợ lý con là năm phần việc cùng tiêu hạn mức. Bản tóm tắt gửi về cũng chiếm chỗ trong ngữ cảnh chính.

Mất chi tiết khi bàn giao. Trợ lý con bắt đầu với ngữ cảnh trống: nó không thấy những gì bạn và Claude đã bàn, chỉ nhận lời giao việc Claude viết (thường kèm tệp hướng dẫn chung CLAUDE.md của dự án, nếu có). Chiều về, Claude chính chỉ thấy bản tóm tắt, không thấy những gì trợ lý con đã đọc. Giống nhân viên chỉ nghe sếp dặn qua một mẩu giấy: mẩu giấy thiếu thì việc lệch.

Vì vậy, quy tắc nào bắt buộc (ví dụ "không đụng vào thư mục hợp đồng") thì nên nói rõ trong yêu cầu hoặc viết thẳng vào lời dặn của trợ lý con.

Trợ lý con và Skill khác nhau thế nào?

Hai thứ này hay bị lẫn. Skill là gói hướng dẫn mà Claude đọc và làm theo ngay trong cuộc trò chuyện chính. Trợ lý con là một "người" khác làm trong ngữ cảnh riêng rồi báo lại.

Tài liệu Claude Code gợi ý: muốn dùng lại một quy trình mà vẫn ở trong cuộc trò chuyện chính thì dùng Skill; muốn tách việc ra cho gọn, giới hạn quyền, chỉ nhận về bản tóm tắt thì dùng trợ lý con.

Kho trợ lý con có sẵn của cộng đồng

Bạn không nhất thiết phải tự viết. Trên GitHub có các kho tổng hợp sẵn, ví dụ (kiểm tra ngày 25/10/2026):

• VoltAgent/awesome-claude-code-subagents: hơn 100 trợ lý con chia theo nhóm, phần lớn cho lập trình, có cả nhóm kinh doanh, nghiên cứu thị trường. Giấy phép MIT.
• vijaythecoder/awesome-claude-agents: khoảng 24 trợ lý con mô phỏng một nhóm lập trình. Tác giả ghi đây là dự án thử nghiệm và tốn nhiều token.

Tóm lại

• Subagent (trợ lý con) là trợ lý AI chuyên một việc trong Claude Code: làm trong ngữ cảnh riêng, chỉ gửi về bản tóm tắt.
• Lợi ích chính: giữ cuộc trò chuyện chính gọn, chạy song song, chuyên môn hoá, giới hạn quyền.
• Tạo bằng một tệp .md trong .claude/agents/ hoặc ~/.claude/agents/, có name, description và nên có tools. Cách dễ nhất là nhờ Claude viết rồi bạn đọc lại.
• Đừng giao mọi thứ: trợ lý con tốn thêm hạn mức và có thể mất chi tiết khi bàn giao. Việc nhỏ, cần trao đổi qua lại thì để Claude chính làm.

Nguồn tham khảo

Kiểm tra ngày 25/10/2026.

• Create custom subagents: Anthropic, tài liệu chính thức Claude Code về subagent, gồm cách tạo, các trường khai báo, trợ lý con dựng sẵn, khi nào dùng, hạn mức sử dụng.
• How and when to use subagents in Claude Code: Anthropic (04/2026), khi nào nên và không nên giao cho trợ lý con.
• Extend Claude with skills: tài liệu Claude Code về Skill.
• VoltAgent/awesome-claude-code-subagents và vijaythecoder/awesome-claude-agents: kho trợ lý con cộng đồng, kèm lưu ý của chính tác giả.