chính subagent
Claude Code Ghi chú Kỹ thuật · Vol. 02
Chạy agent song song

Subagent
trong Claude Code

Những trợ lý được ủy thác xử lý tác vụ phụ trong ngữ cảnh riêng — và chỉ trả về bản tóm tắt.

trong Claude Code · 21.07.2026
01 / 14
// 01 — vì sao nên ủy thácthe case

Một tác vụ phụ không nên làm ngập hội thoại chính của bạn.

Kết quả tìm kiếm, log và nội dung file bạn sẽ chẳng dùng lại cứ chất đống trong ngữ cảnh. Subagent xử lý phần việc đó trong một cửa sổ riêng biệt và chỉ trả về điều quan trọng — nhờ vậy luồng bạn đang điều khiển luôn gọn gàng và tiết kiệm.

← → để chuyển slide 02 / 14
// 02 — cơ chếhow delegation works

Subagent là gì

Một trợ lý chuyên biệt chạy trong cửa sổ ngữ cảnh riêng với system prompt tùy chỉnh, quyền truy cập công cụ cụ thể và quyền độc lập. Khi tác vụ khớp với description của nó, Claude ủy thác, subagent làm việc một mình, rồi kết quả trả về luồng chính.

Hội thoại chính
Gặp tác vụ phù hợp và ủy thác nó.
ỦY THÁC
Subagent
Ngữ cảnh mới. Prompt, công cụ & quyền riêng. Gánh phần việc nặng.
TÓM TẮT
Hội thoại chính
Chỉ nhận bản tóm tắt — ngữ cảnh vẫn sạch.
← → để chuyển slide 03 / 14
// 03 — lợi íchwhy delegate

Năm lợi ích subagent mang lại

01
Giữ sạch ngữ cảnh
Đưa khám phá và triển khai ra khỏi cửa sổ hội thoại chính.
02
Áp đặt ràng buộc
Giới hạn chính xác những công cụ mà subagent được phép dùng.
03
Tái sử dụng cấu hình
Dùng chung subagent cấp người dùng trên mọi dự án trong máy.
04
Chuyên biệt hành vi
System prompt tập trung, tinh chỉnh cho một lĩnh vực cụ thể.
05
Kiểm soát chi phí
Định tuyến tác vụ rẻ, giới hạn sang model nhanh hơn như Haiku.
← → để chuyển slide 04 / 14
// 04 — so sánhways to parallelize

Bốn cách chạy công việc song song

Subagents
Nhận: trợ lý được ủy thác trong một phiên, trả về bản tóm tắt.
Dùng khi: tác vụ phụ sẽ làm ngập luồng chính bằng output.
Agent view
Nhận: một màn hình để điều phối & giám sát các phiên chạy nền.
Dùng khi: bạn giao tác vụ độc lập rồi quay lại kiểm tra sau.
Agent teams
Nhận: các phiên phối hợp với danh sách tác vụ chung & nhắn tin.
Dùng khi: Claude nên chia, giao và đồng bộ một nhóm trợ lý.
Dynamic workflows
Nhận: một script chạy nhiều subagent, đối chiếu chéo kết quả.
Dùng khi: công việc vượt quá vài agent hoặc cần kiểm chứng.
← → để chuyển slide 05 / 14
// 05 — registrybuilt-in agents

Các subagent tích hợp sẵn

Tên
Model
Mục đích & công cụ
Explore
inherit ≤ opus
Tìm kiếm code nhanh, chỉ đọc. Chặn Write & Edit; bỏ qua CLAUDE.md cho nhanh.
Plan
inherit
Nghiên cứu chỉ đọc trong chế độ plan. Chặn Write & Edit.
General-purpose
inherit
Việc phức tạp, nhiều bước cần cả khám phá lẫn hành động. Đủ mọi công cụ.
statusline-setup
sonnet
Cấu hình thanh trạng thái khi bạn chạy /statusline.
claude-code-guide
haiku
Trả lời câu hỏi về các tính năng của Claude Code.
← → để chuyển slide 06 / 14
// 06 — ví dụ.claude/agents/*.md

Cấu trúc một file subagent

Một file Markdown với YAML frontmatter. Frontmatter là phần cấu hình; phần thân trở thành system prompt. Chỉ name và description là bắt buộc.

--- name: code-reviewer description: Rà soát code về chất lượng và best practice. Dùng chủ động sau khi sửa. tools: Read, Glob, Grep model: sonnet --- Bạn là chuyên gia rà soát code. Khi được gọi, hãy phân tích code và đưa ra phản hồi cụ thể, khả thi về chất lượng, bảo mật và best practice.
Frontmatter = cấu hình · phần thân = system prompt 07 / 14
// 07 — cấu hìnhfrontmatter fields

Các trường frontmatter đáng biết

Trường
Điều khiển gì
tools
Danh sách công cụ được phép; kế thừa tất cả nếu bỏ trống.
disallowedTools
Danh sách chặn, loại khỏi tập kế thừa hoặc đã chỉ định.
model
sonnet · opus · haiku · fable · một ID đầy đủ · hoặc inherit (mặc định).
permissionMode
default · acceptEdits · auto · dontAsk · bypassPermissions · plan.
skills
Nạp sẵn toàn bộ nội dung skill vào ngữ cảnh khi khởi động.
memory
Phạm vi bền vững — user · project · local — để học xuyên phiên.
isolation
Đặt worktree để có bản sao repo riêng biệt.
cùng hooks · mcpServers · maxTurns · effort · background · color … 08 / 14
// 08 — phạm viwho wins

Subagent nằm ở đâu & cái nào thắng

Ưu tiên
Vị trí
Phạm vi
1 · cao nhất
managed settings
Toàn tổ chức
2
--agents CLI flag
Chỉ phiên hiện tại
3
.claude/agents/
Dự án hiện tại · lưu vào VCS
4
~/.claude/agents/
Mọi dự án của bạn
5 · thấp nhất
plugin agents/
Nơi plugin được bật
Trùng tên ở hai nơi → ưu tiên cao hơn thắng 09 / 14
// 09 — modelresolution order

Chọn model

Trường model nhận một alias, một ID đầy đủ, hoặc inherit. Khi Claude gọi subagent, model được phân giải theo thứ tự cố định — khớp đầu tiên thắng.

bước 01
Biến môi trường
CLAUDE_CODE_SUBAGENT_MODEL, khi đặt bằng alias hoặc ID.
bước 02
Theo lần gọi
Tham số model Claude truyền cho lần gọi cụ thể đó.
bước 03
Frontmatter
Trường model trong định nghĩa của chính subagent.
→ nếu không: model chính
Đòn bẩy chi phí: định tuyến tác vụ giới hạn sang haiku 10 / 14
// 10 — kiểm soáttools · permissions

Kiểm soát những gì subagent được làm

Truy cập công cụ
  • tools là danh sách cho phép; bỏ trống để kế thừa tất cả.
  • disallowedTools là danh sách chặn, áp dụng trước.
  • Mẫu như mcp__github áp cho toàn bộ server.
  • Liệt kê Agent để cho phép tạo subagent lồng nhau.
Chế độ quyền
  • default — hỏi quyền tiêu chuẩn.
  • acceptEdits — tự chấp nhận sửa file trong thư mục làm việc.
  • plan — khám phá chỉ đọc.
  • bypassPermissions — bỏ qua hỏi quyền (dùng cẩn thận).
Chế độ bypass/acceptEdits của phiên cha được ưu tiên 11 / 14
// 11 — gọiescalating control

Gọi một subagent

Claude tự động ủy thác dựa trên yêu cầu của bạn và description của subagent. Khi tự động chưa đủ, ba cách tăng dần từ một gợi ý đến mặc định cho cả phiên.

01
Ngôn ngữ tự nhiên
Gọi tên nó trong prompt; Claude tự quyết có ủy thác hay không.
Dùng subagent test-runner…
02
@-mention
Đảm bảo đúng subagent đó chạy cho một tác vụ.
@"code-reviewer (agent)"
03
Cả phiên
Cả phiên áp dụng prompt, công cụ & model của nó.
claude --agent code-reviewer
← → để chuyển slide 12 / 14
// 12 — thực hànhwhen to use

Mẫu dùng & khi nào nên chọn

Các mẫu phổ biến
  • Cô lập output lớn — chạy test, chỉ báo phần lỗi.
  • Nghiên cứu song song các module độc lập, rồi tổng hợp.
  • Nối chuỗi subagent — reviewer tìm, optimizer sửa.
Ưu tiên luồng chính khi
  • Tác vụ cần trao đổi qua lại liên tục.
  • Các giai đoạn dùng chung nhiều ngữ cảnh.
  • Là thay đổi nhanh, nhắm đích, hoặc độ trễ quan trọng.
Lồng tối đa 5 cấp · tối đa 200 subagent mỗi phiên 13 / 14
// điều đọng lạitakeaways

Ủy thác phần nhiễu.
Giữ lại tín hiệu.

Nó là gìNgữ cảnh riêng biệt.
Công cụ & prompt riêng.
Trả về bản tóm tắt.
Cách tạo một cáiMarkdown + YAML.
Nhờ Claude, hoặc sửa
.claude/agents/ trực tiếp.
Nguồncode.claude.com
/docs/en/agents
/docs/en/sub-agents
Claude Code · Ghi chú Kỹ thuật 14 / 14