Claude Code · Ghi chú Kỹ thuật
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.
§ 01 — Vì sao nên ủy thác
Một tác vụ phụ không nên làm ngập cuộc 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.
Subagent là gì
def · 001Mộ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 một tác vụ khớp với description của subagent, Claude ủy thác, subagent làm việc một mình, và 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.
Năm lợi ích subagent mang lại
index · 00501
Giữ sạch ngữ cảnh
Đưa việc 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 hoặc quy trình 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.
Bốn cách chạy công việc song song
compare · 004Phương pháp
Bạn nhận được gì
Dùng khi
Subagents
Trợ lý được ủy thác trong một phiên, trả về bản tóm tắt.
Tác vụ phụ sẽ làm ngập luồng chính bằng output.
Agent view
Một màn hình để điều phối & giám sát các phiên chạy nền.
Bạn giao tác vụ độc lập rồi quay lại kiểm tra sau.
Agent teams
Các phiên phối hợp với danh sách tác vụ chung & nhắn tin.
Claude nên chia, giao và đồng bộ một nhóm trợ lý.
Dynamic workflows
Một script chạy nhiều subagent, đối chiếu chéo kết quả.
Công việc vượt quá vài agent hoặc cần kiểm chứng.
Các subagent tích hợp sẵn
registry · 005Tê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.
Cấu trúc một file subagent
.claude/agents/*.mdMộ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.
Các trường frontmatter đáng biết
config · 8 / 15Trườ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.
Subagent nằm ở đâu & cái nào thắng
phạm vi · ưu tiênƯ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
Chọn model
thứ tự phân giảiTrườ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.
1
Biến môi trường
CLAUDE_CODE_SUBAGENT_MODEL, khi đặt bằng alias hoặc ID.
2
Theo lần gọi
Tham số model Claude truyền cho lần gọi cụ thể đó.
3
Frontmatter
Trường model trong định nghĩa của chính subagent.
→ nếu không: model chínhKiểm soát những gì subagent được làm
tools · permissionsTruy 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).
Gọi một subagent
kiểm soát tăng dầnClaude 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-reviewerMẫu dùng & khi nào nên chọn
thực hànhCá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.
Điều đọng lại
Ủ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ô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.
Nhờ Claude, hoặc sửa
.claude/agents/ trực tiếp.
Nguồncode.claude.com
/docs/en/agents
/docs/en/sub-agents
/docs/en/agents
/docs/en/sub-agents