Subagent trong Claude Code: chia việc cho Claude nhỏ, khi nào đáng dùng

Tóm tắt nhanh
Subagent là một phiên Claude phụ chạy riêng, đọc nhiều file rồi chỉ gửi bản tóm tắt về chat chính, nên cuộc trò chuyện của bạn không bị ngập. Nó vẫn tốn token, nên chỉ đáng dùng khi phải rà nhiều tài liệu; sửa một câu thì giao thẳng cho Claude chính.
Subagent là một “Claude nhỏ” chạy trong phiên làm việc riêng của nó: nhận một nhiệm vụ, tự đi đọc file, rồi chỉ gửi về cho Claude chính một bản tóm tắt. Nhờ vậy cuộc trò chuyện chính của bạn không bị ngập bởi hàng chục lượt đọc file. Cái giá là nó vẫn tốn token, và nếu giao việc sai cách thì bạn tốn tiền mà kết quả còn kém.
Điều này đáng quan tâm vì hầu hết người mới gặp cùng một vấn đề: trò chuyện càng dài, Claude càng dễ quên chỗ đầu, câu trả lời càng lan man. Nguyên nhân thường không phải do bạn hỏi dở, mà do chat chính đã bị nhồi đầy nội dung thô của những file chỉ cần liếc qua một lần. Subagent sinh ra để giải đúng chỗ đó.
Bài này giúp bạn hiểu subagent chạy thế nào, tạo một subagent đầu tiên bằng lệnh /agents, viết lời giao việc không bị thiếu bối cảnh, và quan trọng nhất là biết lúc nào nên dùng, lúc nào đừng. Bạn xem video ngắn bên dưới trước cũng được, bài này đi sâu hơn phần video có thể nói.
I.Bản chất của subagent: một phiên làm việc tách riêng
A.Nó là gì và chạy thế nào
Khi bạn trò chuyện với Claude Code, mọi thứ xảy ra đều nằm trong một “bộ nhớ làm việc” gọi là ngữ cảnh. Lời bạn nói, câu trả lời của Claude, nội dung từng file Claude đã đọc, kết quả từng lệnh đã chạy: tất cả cộng dồn vào đó. Ngữ cảnh có giới hạn. Càng đầy, Claude càng khó giữ được những điều quan trọng từ đầu cuộc trò chuyện.
Subagent có ngữ cảnh riêng. Claude chính giao một việc, subagent mở một phiên mới trắng tinh, tự đọc, tự tìm, tự suy luận. Xong việc, nó chỉ trả về kết luận. Hàng chục file nó đã đọc nằm lại trong phiên của nó rồi biến mất, chat chính chỉ nhận vài đoạn tóm tắt.
Hãy hình dung bạn là trưởng phòng. Bạn không ngồi tự đọc 40 bản hợp đồng. Bạn nhờ một bạn nhân viên đọc rồi báo lại: “Có 3 hợp đồng sắp hết hạn, đây là tên file.” Bàn làm việc của bạn vẫn gọn, và đầu óc bạn dành cho quyết định chứ không phải cho việc lục giấy tờ.
B.Khác gì cách làm quen thuộc
Cách quen thuộc là bảo Claude: “Đọc hết thư mục này rồi cho mình biết…”. Claude đọc từng file trong chính chat của bạn. Mỗi file đọc xong nằm lại đó. Sau 20 file, chat đã đầy nội dung thô, và những câu hỏi tiếp theo của bạn phải “chen” vào đống đó.
Với subagent, phần đọc nặng được đẩy ra ngoài. Chat chính nhận kết quả đã lọc. Đổi lại, bạn phải nghĩ kỹ hơn về việc giao: nói rõ cần gì, ở đâu, trả về dạng nào. Đó là điểm khác biệt lớn nhất, và cũng là chỗ người mới hay vấp.
C.Cái giá phải trả
Video nói thẳng: subagent vẫn tốn token. Lý do đơn giản. Subagent vẫn phải đọc đủ các file đó, nên phần đọc không rẻ đi. Bạn chỉ chuyển chỗ đọc từ chat chính sang chỗ khác. Thêm vào đó, mỗi lần giao việc còn có chi phí khởi động: viết lời giao, subagent làm quen với nhiệm vụ, rồi viết báo cáo.
Vậy cái bạn mua được là sự gọn gàng của chat chính, không phải sự tiết kiệm. Nếu việc quá nhỏ, chi phí khởi động lớn hơn lợi ích. Chuyện này sẽ rõ hơn ở phần cuối của bài.
II.Làm thế nào: tạo subagent đầu tiên bằng /agents
- Mở menuTrong Claude Code, gõ /agents để mở menu quản lý subagent
- Tạo mớiChọn Create new agent, rồi chọn phạm vi dùng (chỉ dự án này hay mọi dự án)
- Mô tả nhiệm vụViết rõ subagent này chuyên làm việc gì, khi nào được gọi
- Giới hạn công cụChỉ bật Read, Grep, Glob nếu nó chỉ cần đọc và tìm
- Chọn modelChọn model phù hợp với độ khó của việc
- Thử giao việcGiao một nhiệm vụ thật, kèm thư mục, mục tiêu, dạng đầu ra
A.Mở menu và chọn phạm vi
Trong thư mục dự án, gõ claude để vào Claude Code, rồi gõ /agents. Một menu hiện ra, chọn Create new agent. Bước đầu tiên là chọn phạm vi: subagent này chỉ dùng cho dự án hiện tại, hay dùng ở mọi dự án của bạn.
Gợi ý cho người mới: subagent gắn với một loại tài liệu cụ thể (ví dụ thư mục hợp đồng của công ty) thì chọn phạm vi dự án. Subagent mang tính tổng quát (ví dụ “người rà soát tài liệu”) thì chọn phạm vi dùng chung. Subagent được lưu thành một file văn bản trong thư mục .claude/agents của dự án, nên bạn mở ra đọc, sửa, hoặc đưa cho đồng nghiệp đều được.
B.Mô tả nhiệm vụ: câu quan trọng nhất
Menu sẽ hỏi bạn mô tả subagent làm gì. Đây không phải thủ tục. Claude chính dựa vào mô tả này để quyết định có giao việc cho subagent hay không. Mô tả mơ hồ như “giúp việc chung” thì subagent hiếm khi được gọi đúng lúc. Mô tả cụ thể sẽ tốt hơn nhiều.
Ví dụ một mô tả tốt:
Rà soát các file trong thư mục tài liệu, tìm thông tin theo câu hỏi được giao.
Chỉ đọc, không sửa file. Trả về danh sách kết luận ngắn,
mỗi kết luận kèm tên file làm nguồn.Có ba thứ trong mô tả đó: việc gì, giới hạn gì (chỉ đọc), trả về dạng nào (kết luận kèm nguồn). Ba thứ này lặp lại ở lúc giao việc thật.
C.Giới hạn công cụ: chỉ bật Read, Grep, Glob
Video nhấn mạnh bước này. Subagent chỉ cần đọc và tìm thì chỉ bật ba công cụ: Read (đọc file), Grep (tìm theo nội dung), Glob (tìm theo tên file). Không bật công cụ sửa file hay chạy lệnh.
Vì sao nên làm vậy:
- An toàn: subagent không có quyền sửa thì không thể lỡ tay sửa hay xoá file của bạn.
- Tập trung: ít công cụ nghĩa là ít cách đi lạc. Nó sẽ làm đúng việc đọc.
- Dễ tin: khi biết nó chỉ đọc, bạn yên tâm cho nó chạy trên thư mục có tài liệu quan trọng.
Quy tắc chung: cấp quyền tối thiểu đủ để làm xong việc. Cần thêm thì bật sau.
D.Chọn model theo độ khó
Bước cuối là chọn model. Việc đọc và tìm thông tin đơn giản thường không cần model mạnh nhất; chọn loại nhẹ hơn thì nhanh hơn và nhẹ lượt dùng hơn. Việc cần suy luận phức tạp, ví dụ so sánh các điều khoản mâu thuẫn nhau, thì nên chọn loại mạnh hơn. Bạn không cần nhớ tên model cụ thể, vì menu liệt kê sẵn và tên thay đổi theo thời gian. Chỉ cần tự hỏi: việc này đọc-và-gom, hay đọc-và-phán-xét?
E.Lúc giao việc: đừng thiếu bối cảnh
Đây là cái bẫy video gọi tên: giao “rà như vừa bàn”. Câu đó nghe rất tự nhiên với con người, nhưng subagent không thấy chat trước. Nó là một phiên mới tinh. Bạn đã bàn gì, đã loại trừ gì, đã chốt gì, nó không biết.
Vì vậy lời giao việc phải tự đủ ý, gồm ba thứ:
- Thư mục: đọc ở đâu.
- Mục tiêu: tìm gì, để làm gì.
- Đầu ra: trả về dạng nào, kèm gì.
Video còn dặn thêm: yêu cầu kèm tên file. Nếu báo cáo chỉ nói “có 2 đề xuất chưa được duyệt” mà không nói ở file nào, bạn không có cách kiểm lại, và buộc phải tin hoặc làm lại từ đầu.
III.Dùng vào việc thật: ba tình huống cụ thể
A.Kế toán rà các đề xuất nhiều file
Bối cảnh: chị Lan làm kế toán ở một công ty nhỏ. Cuối quý, chị cần biết đề xuất chi nào đã được duyệt, đề xuất nào chưa. Thông tin nằm rải rác trong các file kế hoạch và các file báo cáo tiến độ trong một thư mục.
Video có một ví dụ giả định cùng kiểu: file kế hoạch ghi một đề xuất là “đã duyệt”, nhưng file tiến độ lại ghi cùng đề xuất đó là “chưa duyệt”. Muốn bắt được chỗ lệch này phải đọc chéo nhiều file, đúng loại việc nên tách.
Lời giao việc mẫu:
Hãy rà thư mục de-xuat-quy-3 (gồm các file kế hoạch và file tiến độ).
Mục tiêu: tìm các đề xuất mà trạng thái duyệt ghi KHÁC NHAU giữa các file
(ví dụ file này ghi đã duyệt, file kia ghi chưa duyệt).
Chỉ đọc, không sửa gì.
Trả về một danh sách: tên đề xuất, trạng thái ở từng file,
và TÊN FILE cùng số dòng hoặc đoạn trích để mình kiểm lại.
Nếu không chắc, ghi rõ là không chắc, đừng đoán.Kết quả nhận được: một danh sách ngắn các đề xuất bị lệch, mỗi mục có tên file. Chat chính của chị Lan không bị nhồi nội dung của hàng chục file.
Chỗ cần kiểm lại: mở đúng file được nêu và đọc đoạn tương ứng. Với mỗi mục lệch, chị tự xác minh trước khi báo cho sếp. Subagent chỉ giúp thu hẹp chỗ cần nhìn, người ký vẫn là chị.
B.Chủ shop tìm các chính sách bị mâu thuẫn
Bối cảnh: anh Minh bán đồ gia dụng online. Anh có nhiều file: chính sách đổi trả, mẫu tin nhắn trả lời khách, hướng dẫn cho nhân viên chốt đơn. Qua thời gian anh sửa chỗ này chỗ kia, và nghi ngờ các file nói khác nhau về thời hạn đổi trả.
Hãy rà thư mục chinh-sach-shop (các file đổi trả, mẫu tin nhắn, hướng dẫn nhân viên).
Mục tiêu: liệt kê MỌI chỗ nhắc đến thời hạn đổi trả hoặc điều kiện đổi trả.
Chỉ đọc, không sửa.
Trả về bảng gồm: tên file, câu nguyên văn, và thời hạn/điều kiện được nêu.
Cuối cùng, chỉ ra các chỗ không khớp nhau.Kết quả nhận được: một bảng gom mọi chỗ nhắc đến thời hạn đổi trả, kèm nguồn. Anh Minh nhìn một lượt là thấy file nào còn ghi số ngày cũ.
Chỗ cần kiểm lại: subagent có thể bỏ sót một file đặt tên lạ hoặc một cách diễn đạt khác (ví dụ “hoàn hàng” thay vì “đổi trả”). Anh nên thử tìm thêm vài từ khoá khác để chắc không sót.
C.Dev mới tìm hiểu một dự án lạ
Bối cảnh: Hà là lập trình viên mới vào một dự án có sẵn code. Cô cần biết chức năng đăng nhập nằm ở những file nào và chúng gọi nhau ra sao, trước khi dám sửa.
Trong thư mục src của dự án này, hãy tìm toàn bộ code liên quan đến đăng nhập
(gợi ý từ khoá: login, auth, session, token).
Chỉ đọc, không sửa.
Trả về: danh sách file liên quan, vai trò của từng file trong một câu,
và thứ tự các file được gọi khi người dùng bấm Đăng nhập.
Kèm tên file và tên hàm để mình mở ra đọc lại.Kết quả nhận được: một bản đồ ngắn về luồng đăng nhập. Hà có điểm bắt đầu rõ ràng, và chat chính của cô vẫn sạch để tiếp tục hỏi những câu sâu hơn.
Chỗ cần kiểm lại: bản đồ này là tóm tắt, không phải sự thật tuyệt đối. Trước khi sửa code, Hà nên mở các file chính và tự đọc. Tóm tắt giúp định hướng, không thay thế việc hiểu code.
IV.Góc nhìn khách quan
A.Điểm mạnh thật sự
Điểm mạnh lớn nhất là chat chính giữ được sự tập trung. Những việc mang tính “đọc nhiều, lấy ít” (rà tài liệu, tìm chỗ không khớp, lập bản đồ code) tạo ra rất nhiều chữ thô nhưng chỉ cần vài dòng kết luận. Đẩy phần chữ thô ra phiên riêng giúp cuộc trò chuyện chính dài hơn mà vẫn mạch lạc.
Điểm mạnh thứ hai là quyền hạn tách bạch. Một subagent chỉ có Read, Grep, Glob là một người rà soát không thể làm hỏng gì. Bạn có thể giao nó thư mục quan trọng với tâm thế nhẹ nhàng hơn.
Điểm mạnh thứ ba là tái sử dụng. Đã tạo một subagent “rà tài liệu” tốt thì lần sau chỉ cần giao việc mới, không phải viết lại cách làm.
Subagent không làm Claude rẻ đi, nó làm chat của bạn gọn đi. Hãy trả cái giá đó khi việc đáng.
Ông T
B.Giới hạn và rủi ro
Chi phí lượt dùng. Subagent đọc đủ file như bình thường, cộng thêm chi phí khởi động và báo cáo. Giao một việc nhỏ cho subagent là trả thêm phí mà không được gì. Nếu bạn dùng gói có giới hạn lượt, nhiều subagent chạy liên tục có thể dùng hết lượt nhanh hơn bạn nghĩ.
Thiếu bối cảnh. Đây là rủi ro hay gặp nhất. Subagent không thấy chat trước. Giao “làm như vừa bàn” thì nó làm theo phỏng đoán của nó, và kết quả có thể đi chệch mà trông vẫn rất tự tin.
Tóm tắt có thể sai hoặc sót. Bạn chỉ nhận bản tóm tắt, không thấy quá trình đọc. Nếu subagent hiểu nhầm một file, lỗi đó đi thẳng vào chat chính của bạn. Vì vậy mới cần bắt nó kèm tên file để kiểm lại.
Quyền truy cập file và dữ liệu. Subagent đọc được những gì công cụ của nó cho phép. Trỏ nó vào thư mục có dữ liệu khách hàng, lương, hợp đồng nhạy cảm thì bạn cần cân nhắc như khi cho Claude chính đọc. Nội dung các file đó vẫn được gửi đi để Claude xử lý, và cần có mạng để làm việc.
Trước khi giao subagent đọc một thư mục, hãy tự hỏi: có file nào chứa mật khẩu, số tài khoản, dữ liệu cá nhân của khách không? Nếu có, hãy tách các file đó ra khỏi thư mục hoặc không giao việc đó. Với subagent chỉ đọc, hãy luôn kiểm tra danh sách công cụ đã bật trước khi chạy.
C.Khi nào nên chọn cách khác
Video chốt rất gọn: sửa một câu thì giao thẳng; rà nhiều tài liệu mới đáng tách.
Sửa một câu, đổi một lỗi chính tả, hỏi một điều ngắn về file bạn đang mở: cứ nói thẳng với Claude chính. Tách ra chỉ thêm bước, thêm chi phí, và còn làm mất bối cảnh mà Claude chính đang có.
Cũng cân nhắc cách khác khi việc cần trao đổi qua lại nhiều lượt. Subagent làm một mạch rồi trả kết quả, nên không hợp với việc phải vừa làm vừa bàn. Với những việc cần bạn chỉnh liên tục, chat chính phù hợp hơn.
Nếu bạn quen dùng công cụ khác như ChatGPT, Codex CLI, Gemini CLI, Cursor hay GitHub Copilot, nguyên tắc vẫn dùng được: tách việc đọc nặng khỏi cuộc trò chuyện chính khi cuộc trò chuyện sắp đầy. Cách làm cụ thể sẽ tuỳ công cụ, bạn nên xem tài liệu của từng công cụ.
Một cách tự kiểm đơn giản trước khi giao: việc này cần đọc nhiều hơn khoảng năm file, và kết quả mình cần ngắn hơn nhiều so với những gì phải đọc không? Nếu cả hai đều đúng, subagent đáng cân nhắc. Nếu không, đừng tách.
V.Lỗi hay gặp và cách tránh
Giao việc kiểu “rà như vừa bàn”. Subagent không thấy chat trước. Cách tránh: viết lời giao việc như gửi email cho người chưa biết gì: nêu thư mục, mục tiêu, dạng đầu ra, và điều đã loại trừ nếu có.
Bật quá nhiều công cụ. Người mới hay để mặc định bật hết cho tiện. Subagent chỉ cần đọc mà có quyền sửa file thì rủi ro không đáng. Cách tránh: chỉ bật Read, Grep, Glob cho việc rà soát, và chỉ mở thêm khi thật sự cần.
Không yêu cầu nguồn. Báo cáo không có tên file thì bạn không kiểm lại được, và buộc phải tin hoặc làm lại. Cách tránh: luôn thêm dòng “kèm tên file và đoạn trích” vào lời giao việc. Khi nhận kết quả, mở thử vài mục để kiểm.
Dùng subagent cho việc quá nhỏ. Sửa một câu mà cũng tách ra thì tốn lượt hơn là làm thẳng. Cách tránh: áp dụng quy tắc “đọc nhiều, lấy ít”. Không đạt thì giao thẳng cho Claude chính.
Mô tả subagent quá chung chung. Viết “giúp mình làm việc” thì Claude chính khó biết khi nào nên gọi nó. Cách tránh: mô tả rõ việc gì, giới hạn gì, trả về gì. Sau khi tạo, thử một nhiệm vụ nhỏ để xem nó có làm đúng ý không rồi sửa mô tả.
VI.Dự phóng: chủ đề này sẽ đi về đâu
Dưới đây là nhận định của Ông T dựa trên hướng đi chung của AI agent và công cụ lập trình bằng AI, không phải thông báo chính thức của hãng nào.
Chia việc cho nhiều agent nhỏ sẽ phổ biến hơn. Mức chắc chắn: khả năng cao. Ngữ cảnh luôn có giới hạn, còn khối lượng tài liệu của công việc thì cứ tăng. Tách việc đọc nặng ra phiên riêng là lời giải tự nhiên, nên cách làm này khó biến mất. Bạn nên chuẩn bị bằng cách tập viết lời giao việc đầy đủ ngay từ bây giờ, vì kỹ năng này dùng được bất kể công cụ nào.
Việc chọn model theo độ khó sẽ thành thói quen. Mức chắc chắn: khả năng cao. Việc đọc và gom thông tin không cần mạnh như việc suy luận khó, và người dùng ngày càng để ý đến chi phí lượt dùng. Bạn nên chuẩn bị bằng cách phân loại việc của mình thành “đọc-và-gom” và “đọc-và-phán-xét”, rồi thử xem loại nhẹ hơn đã đủ cho việc đầu chưa.
Subagent sẽ được kết hợp với tự động hoá. Mức chắc chắn: có thể. Khi bạn đã có subagent làm tốt một việc lặp lại, bước hợp lý tiếp theo là cho nó chạy theo lịch hoặc theo sự kiện, không cần ngồi canh. Video cuối tập cũng gợi hướng này với Hooks. Bạn nên chuẩn bị bằng cách ghi lại những việc rà soát bạn lặp đi lặp lại hằng tuần, đó sẽ là ứng viên đầu tiên.
Kiểm chứng kết quả của agent sẽ thành bước bắt buộc. Mức chắc chắn: còn bỏ ngỏ về hình thức, nhưng nhu cầu thì rõ. Khi nhiều agent cùng làm, người dùng chỉ thấy bản tóm tắt, nên cách kiểm lại nguồn sẽ quan trọng hơn. Chưa ai biết hình thức cuối cùng sẽ ra sao. Bạn nên chuẩn bị bằng thói quen đòi nguồn trong mọi báo cáo và tự mở kiểm vài mục.
VII.Bắt đầu từ đâu
Subagent không phải phép màu, nó là một cách chia việc. Làm đúng thì chat chính gọn và bạn tập trung hơn; làm sai thì tốn lượt và nhận về kết quả khó tin. Hãy bắt đầu nhỏ, với một việc đọc-nhiều-lấy-ít mà bạn đang làm tay.
Ba việc bạn làm được ngay hôm nay:
- Gõ
claudetrong một thư mục có nhiều tài liệu, rồi gõ/agents, chọn Create new agent và tạo một subagent “rà tài liệu” chỉ bật Read, Grep, Glob. - Chọn một việc thật bạn đang làm tay (ví dụ tìm chỗ không khớp giữa hai ba file) và giao cho subagent bằng lời giao có đủ thư mục, mục tiêu, đầu ra, kèm yêu cầu ghi tên file.
- Mở ít nhất ba mục trong báo cáo để kiểm lại nguồn. Nếu đúng, bạn có một subagent đáng giữ. Nếu sai, sửa mô tả hoặc lời giao rồi thử lại.
Và nếu bạn muốn máy tự báo khi Claude làm xong việc, mời bạn theo dõi tập sau của Ông T về Hooks.
Câu hỏi thường gặp
Subagent trong Claude Code là gì?
Subagent là một phiên Claude phụ có ngữ cảnh riêng. Claude chính giao một nhiệm vụ, subagent tự đọc file và làm việc, rồi chỉ trả về bản tóm tắt. Nhờ vậy chat chính không bị ngập nội dung thô của nhiều file.
Dùng subagent có tiết kiệm token không?
Thường là không. Subagent vẫn phải đọc đủ các file, lại thêm chi phí giao việc và báo cáo. Cái bạn được là chat chính gọn và tập trung, không phải bớt chi phí. Với việc nhỏ như sửa một câu, giao thẳng cho Claude chính sẽ đỡ tốn hơn.
Subagent có thấy nội dung tôi đã trò chuyện trước đó không?
Không nên mặc định là có. Subagent chạy trong phiên riêng nên bạn phải nêu rõ thư mục, mục tiêu và dạng đầu ra trong lời giao việc. Giao kiểu “rà như vừa bàn” là cái bẫy hay gặp khiến kết quả đi chệch.
Tạo subagent như thế nào?
Trong Claude Code, gõ /agents để mở menu, chọn Create new agent, chọn phạm vi (dự án hay dùng chung), mô tả nhiệm vụ, chọn công cụ và model. Với việc chỉ đọc và tìm, bạn chỉ cần bật Read, Grep, Glob. Subagent được lưu thành file văn bản nên bạn có thể mở ra chỉnh sau.
Khi nào nên dùng subagent, khi nào không?
Nên dùng khi phải rà nhiều tài liệu mà kết quả cần chỉ là vài dòng kết luận, ví dụ tìm chỗ không khớp giữa nhiều file. Không nên dùng khi chỉ sửa một câu hoặc việc cần trao đổi qua lại nhiều lượt. Cách tự kiểm: đọc nhiều, lấy ít thì đáng tách.
Làm sao biết báo cáo của subagent có đáng tin?
Bạn nên yêu cầu nó kèm tên file và đoạn trích cho từng kết luận, rồi tự mở vài mục để kiểm lại. Báo cáo là bản tóm tắt nên có thể sót hoặc hiểu nhầm. Đừng dùng nó làm căn cứ cuối cùng cho việc quan trọng khi chưa kiểm nguồn.
Cho subagent đọc thư mục có dữ liệu nhạy cảm có an toàn không?
Nên cân nhắc như khi cho Claude chính đọc, vì nội dung file vẫn được gửi đi để xử lý. Hãy tránh thư mục có mật khẩu, số tài khoản hay dữ liệu cá nhân của khách. Giới hạn công cụ ở mức chỉ đọc giúp tránh sửa nhầm, nhưng không thay cho việc cân nhắc dữ liệu.


