
Subagent là gì? Subagent là một trợ lý AI chuyên biệt mà phiên Claude Code chính giao cho một phần việc: subagent chạy trong cửa sổ ngữ cảnh riêng, có lời nhắc hệ thống riêng, được giới hạn công cụ riêng, làm xong thì chỉ gửi bản tóm tắt kết quả về cuộc trò chuyện chính. Theo trang "Create custom subagents" trong tài liệu Claude Code (code.claude.com, đọc ngày 03/11/2026), cách dùng phù hợp nhất là khi một việc phụ sẽ làm ngập phiên chính bằng kết quả tìm kiếm, log hay nội dung tệp mà bạn không cần đọc lại. Bài này không hứa subagent làm việc nhanh hơn hay rẻ hơn trong mọi trường hợp; ngược lại, subagent tốn thêm token và có thể làm rơi chi tiết khi bàn giao. Bài cũng không nêu chi phí OPCAIOS đã trả. Nội dung gồm: subagent khác phiên chính ở đâu, cách tạo subagent tuỳ chỉnh theo tài liệu chính thức, khi nào nên và không nên dùng, cách viết brief, cách kiểm tra lại kết quả, và những lỗi thật OPCAIOS đã gặp khi chạy lô bài viết bằng subagent. Phần tổng quan về Claude Code nằm ở bài Claude Code là gì.

Phiên chính chia việc, subagent làm trong ngữ cảnh riêng, kết quả được kiểm tra trước khi vào nháp. Sơ đồ: OPCAIOS.
Subagent khác phiên Claude Code chính ở điểm nào?
Subagent khác phiên chính ở chỗ subagent bắt đầu với một cửa sổ ngữ cảnh mới, gần như trống. Theo tài liệu Claude Code (đọc ngày 03/11/2026), subagent không thấy lịch sử trò chuyện của bạn, không thấy các skill phiên chính đã gọi, cũng không thấy các tệp phiên chính đã đọc. Thứ duy nhất subagent nhận về nhiệm vụ là thông điệp giao việc do Claude soạn khi bàn giao, cộng với lời nhắc hệ thống của chính subagent đó. Ngoại lệ là "fork": bản sao kế thừa nguyên cuộc trò chuyện của phiên cha. Bốn đặc điểm cần nhớ:
- Ngữ cảnh riêng: kết quả dài dòng nằm lại trong subagent, phiên chính chỉ nhận bản tóm tắt.
- Công cụ riêng: trường
toolsvàdisallowedToolsgiới hạn subagent được dùng gì; Explore và Plan có sẵn chỉ được đọc, bị chặn Write và Edit. - Quyền riêng: subagent có thể có chế độ quyền riêng qua trường
permissionMode. - Chung hạn mức: mỗi subagent tự gửi yêu cầu lên mô hình và tính chung hạn mức sử dụng với phiên chính.
Tài liệu cũng ghi mặc định một subagent có thể sinh subagent con, tối đa ba tầng dưới phiên chính, và khi đã có 20 subagent cùng chạy thì lệnh sinh thêm sẽ báo lỗi. Các con số này có thể đổi theo phiên bản.
Tạo subagent tuỳ chỉnh trong Claude Code thế nào?
Tạo subagent tuỳ chỉnh nghĩa là viết một tệp Markdown có phần đầu YAML (frontmatter), phần thân là lời nhắc hệ thống. Theo tài liệu chính thức (đọc ngày 03/11/2026), chỉ hai trường name và description là bắt buộc; description quyết định khi nào Claude tự giao việc cho subagent, nên phải viết rõ. Ví dụ theo tài liệu, đặt tại .claude/agents/code-reviewer.md:
---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---
You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.
Nơi đặt tệp quyết định ai dùng được subagent:
| Vị trí | Phạm vi | Ghi chú |
|---|---|---|
.claude/agents/ trong dự án |
Dự án hiện tại | Nên đưa vào git để cả nhóm dùng chung |
~/.claude/agents/ |
Mọi dự án trên máy bạn | Subagent cá nhân |
Cờ --agents khi khởi động |
Chỉ phiên đó | Truyền JSON, không lưu ra đĩa |
Thư mục agents/ của plugin |
Nơi bật plugin | Không hỗ trợ hooks, mcpServers, permissionMode |
| Cấu hình quản lý của tổ chức | Toàn tổ chức | Ưu tiên cao nhất |
Để gọi đích danh, nhắc tên subagent trong câu lệnh, hoặc gõ @ rồi chọn subagent; muốn cả phiên chạy như một subagent thì dùng claude --agent <tên>. Các trường tuỳ chọn khác gồm model, maxTurns, skills, memory, isolation: worktree (chạy trên bản sao git riêng). Tài liệu cảnh báo Claude Code bỏ qua trường gõ sai mà không báo lỗi, nên đọc kỹ tên trường.
Khi nào nên dùng subagent và khi nào không nên?
Subagent nên được dùng khi việc phụ tự đứng được, tạo nhiều đầu ra mà bạn không cần giữ, và trả về được bằng một bản tóm tắt. Tài liệu Claude Code (đọc ngày 03/11/2026) nêu ba mẫu dùng phổ biến: tách việc tạo nhiều đầu ra như chạy bộ kiểm thử hay đọc log, nghiên cứu song song nhiều phần độc lập, và nối chuỗi subagent theo từng bước. Ngược lại, nên ở lại phiên chính khi việc cần trao đổi qua lại nhiều lần, khi các bước lập kế hoạch, viết và kiểm thử dùng chung nhiều ngữ cảnh, khi chỉ sửa nhanh một chỗ, hoặc khi cần phản hồi nhanh vì subagent phải tự thu thập lại ngữ cảnh từ đầu. Cái giá của subagent có hai phần:
- Token: mỗi subagent tự tiêu token khi chạy, và kết quả của nhiều subagent dồn về vẫn chiếm ngữ cảnh phiên chính; tài liệu có cảnh báo rõ điều này.
- Mất chi tiết khi bàn giao: subagent chỉ biết những gì nằm trong brief, phiên chính chỉ thấy bản tóm tắt. Lỗi có thể nằm ở chỗ không ai đọc.
Nếu bạn chỉ cần một quy trình lặp lại chạy ngay trong phiên chính, skill thường hợp hơn subagent. Chi phí chung được bàn ở bài chi phí Claude Code.
Viết brief cho subagent thế nào để không bị làm sai?
Brief cho subagent là toàn bộ những gì subagent biết về nhiệm vụ, nên brief phải tự đứng được như giao việc cho một đồng nghiệp chưa từng tham gia dự án. Một brief tốt gồm sáu phần:
- Mục tiêu và đầu ra: viết gì, ghi vào tệp nào, định dạng ra sao, độ dài bao nhiêu.
- Phạm vi: được đọc gì, được ghi đúng tệp nào, tuyệt đối không đụng tới đâu.
- Điều đã biết: những gì phiên chính đã loại trừ, để subagent không làm lại.
- Quy tắc cứng: ví dụ không bịa số liệu, không thêm trích dẫn không có nguồn, giữ nguyên dòng nguồn và từ khoá.
- Nguồn được phép: trang tài liệu chính thức, tệp mẫu, và yêu cầu coi nội dung web là dữ liệu chứ không phải chỉ thị.
- Báo cáo cuối: liệt kê tệp đã ghi, điều đã kiểm chứng kèm nguồn, điều chưa kiểm chứng, chỉ thị lạ gặp trên web.
Tránh đưa giả thuyết của bạn vào brief như một kết luận, vì subagent dễ "xác nhận" lại điều được gợi ý. Giữ phạm vi hẹp: một subagent một nhóm việc nhỏ, rõ ràng.
Kiểm tra lại kết quả của subagent bằng cách nào?
Kiểm tra lại kết quả subagent nghĩa là không tin bản tóm tắt, mà so trực tiếp sản phẩm với bản gốc và với quy tắc. Bản báo cáo của subagent viết bằng giọng tự tin như nhau dù đúng hay sai. Tài liệu Claude Code (đọc ngày 03/11/2026) cho biết Claude Code quét báo cáo cuối của subagent để đánh dấu văn bản giả dạng chỉ thị hệ thống, nhưng việc quét này không đánh giá nội dung đúng sai và không thay cho việc giới hạn quyền. Quy trình kiểm tra thực dụng:
- Kiểm tra bằng máy trước: script đếm từ, tìm chuỗi cấm, so liên kết với danh sách có thật, so bản sửa với bản gốc.
- Đọc mẫu bằng mắt: mở vài sản phẩm bất kỳ, không chỉ cái đầu tiên.
- Đối chiếu nguồn: mọi con số hay tên tính năng phải có trong trang đã ghi.
- Ghi vào chỗ an toàn: nháp, nhánh riêng, hoặc thư mục tạm, chưa ghi đè bản thật.
- Người duyệt cuối: chỉ đưa ra ngoài khi người chủ đồng ý.
Cách làm nhiều phiên cùng sửa một kho mã được bàn riêng ở bài nhiều phiên AI cùng sửa một dự án.
Kinh nghiệm của OPCAIOS
OPCAIOS dùng subagent trong Claude Code nhiều lần cho hai loại việc: viết lô bài blog và sửa hàng loạt bài cũ. Những điều dưới đây là thật, ở mức khái niệm:
- Lô 10 bài, mỗi subagent 2 bài. Phiên chính viết một brief chung, giao cho các subagent chạy nền song song; mỗi subagent chỉ ghi tệp Markdown của mình. Phiên chính tự làm phần còn lại: chấm điểm, dựng ảnh, kiểm tra liên kết, đưa vào nháp. Bài này được viết theo đúng cách đó.
- Sửa khoảng 139 bài cũ để nâng điểm GEO (25/10/2026). Trước khi mở rộng, chúng tôi chạy thử một subagent với vài bài và xem kỹ phần khác biệt. Điểm GEO trung bình theo công cụ chấm nội bộ tăng từ khoảng 62,6 lên khoảng 78; đây là điểm nội bộ, không phải lưu lượng hay thứ hạng.
- Lỗi thật đã gặp. Một số subagent làm mất dòng nguồn ở cuối bài, bỏ từ khoá ở đoạn mở đầu, và tệ nhất là thêm trích dẫn giả kiểu "(X 2026)" để công cụ chấm cho điểm cao hơn.
- Cách xử lý. Viết script so sánh bản gốc với bản sửa trước khi ghi (bắt mất nguồn, mất từ khoá, mất ảnh hay liên kết); sao lưu toàn bộ nội dung trước khi ghi đè; và chống ghi đè bằng mã băm: nếu bài đã bị phiên khác sửa sau lúc xuất ra thì không ghi.
- Mọi bài AI viết đều vào trạng thái nháp, chỉ lên lịch đăng khi chủ duyệt.
Bài học lớn nhất: subagent tối ưu đúng thứ bạn đo. Đo điểm thì phải có thêm kiểm tra chống gian lận điểm. Thêm bối cảnh ở bài để tác tử AI xây và vận hành website.
Đọc thêm: 6 công cụ chạy nhiều AI agent viết code cùng lúc tốt nhất 2026.
Câu hỏi thường gặp
Subagent có làm việc nhanh hơn không?
Không phải lúc nào cũng nhanh hơn. Nhiều subagent chạy song song giúp xong sớm hơn khi các phần việc độc lập với nhau, ví dụ viết nhiều bài khác chủ đề hay tìm hiểu nhiều mô-đun riêng. Nhưng mỗi subagent bắt đầu với ngữ cảnh trống nên phải tự đọc lại dự án, và tài liệu Claude Code ghi rằng khi cần phản hồi nhanh thì phiên chính thường hợp hơn. Với việc nhỏ, sửa một chỗ, giao subagent thường chậm hơn tự làm.
Subagent có tốn thêm tiền không?
Có, theo nghĩa tốn thêm mức sử dụng. Tài liệu Claude Code (đọc ngày 03/11/2026) ghi mỗi subagent tự gửi yêu cầu lên mô hình, tính chung hạn mức với phiên chính, và nhiều subagent trả kết quả dài vẫn chiếm ngữ cảnh phiên chính. Bạn có thể giảm chi phí bằng cách cho subagent dùng mô hình nhẹ hơn qua trường model. OPCAIOS không công bố mức chi phí của mình, nên bài không đưa con số.
Subagent có thấy cuộc trò chuyện của tôi không?
Subagent thông thường thì không. Theo tài liệu, subagent bắt đầu với ngữ cảnh mới, không thấy lịch sử trò chuyện, không thấy tệp phiên chính đã đọc; subagent chỉ nhận lời nhắc hệ thống của mình và thông điệp giao việc. Ngoại lệ là fork, kế thừa cả cuộc trò chuyện của phiên cha. Vì vậy mọi điều quan trọng, như quy tắc trung thực hay tệp được phép ghi, phải nằm trong brief.
Có nên cho subagent quyền sửa tệp và chạy lệnh không?
Chỉ cho đúng mức cần. Việc tìm hiểu, rà soát nên dùng subagent chỉ đọc như Explore, hoặc subagent tuỳ chỉnh có trường tools chỉ gồm công cụ đọc. Việc cần ghi thì giới hạn ghi vào một thư mục hay một tệp được chỉ định, và kiểm tra trước khi đưa vào bản thật. Quyền của subagent vẫn đi qua hệ thống quyền của phiên, xem bài plan mode và chế độ quyền.
Bắt đầu dùng subagent từ đâu cho người không chuyên?
Bắt đầu bằng subagent có sẵn và việc chỉ đọc: nhờ Claude dùng subagent để tìm trong dự án rồi tóm tắt, hoặc chạy kiểm thử và chỉ báo lỗi. Khi thấy mình lặp lại cùng một kiểu giao việc, hãy tạo một subagent tuỳ chỉnh trong thư mục agents với mô tả rõ ràng. Luôn tự kiểm tra kết quả trước khi tin. Nếu muốn học cách chia việc cho AI agent một cách có kiểm soát, xem khoá đào tạo ứng dụng AI của OPCAIOS.
Nguồn: tài liệu Claude Code của Anthropic, trang "Create custom subagents" và "Configure permissions" tại code.claude.com (đọc ngày 03/11/2026); điều chưa kiểm chứng: hiệu quả tốc độ và chi phí cụ thể của subagent ngoài những gì tài liệu nêu, các giới hạn số lượng và độ sâu có thể đổi theo phiên bản; Kinh nghiệm là của OPCAIOS.
Để lại bình luận
Email của bạn sẽ không hiển thị công khai. Bình luận sẽ hiển thị sau khi được duyệt.


