Bỏ qua đến nội dung chính

What are subagents?

                        (Show All)_ · **Bài 1/4** · [🌐 English](../../en/01-what-are-subagents/en.md)

Bài trước: — · 📋 Mục lục khoá · Bài sau →

What are subagents?

👨‍💻 Track: Developer Track · 📚 Course: Introduction to Subagents · 🧭 Path C

📖 Nội dung bài học

Subagent là các trợ lý chuyên biệt mà Claude Code có thể ủy thác nhiệm vụ. Hãy coi chúng như những người giúp việc tập trung: mỗi subagent chạy trong context window (cửa sổ ngữ cảnh) riêng, hoàn thành việc và trả về bản tóm tắt cho luồng chính. Các bước trung gian -- như đọc file, tìm kiếm và gọi tool -- được giữ riêng biệt và không bao giờ làm rối cuộc hội thoại chính của bạn.

Tại sao Subagent lại quan trọng

Mỗi khi bạn chat với Claude Code, bạn đang làm đầy context window chính. Mọi tool call, mọi lần đọc file, mọi kết quả tìm kiếm đều được lưu trữ ở đó. Không gian này là hữu hạn, và khi nó đầy, Claude bắt đầu mất dấu các phần trước của cuộc hội thoại.

Subagent giải quyết vấn đề này bằng cách khởi tạo một context window riêng biệt. Subagent nhận được hai thứ:

  • Một system prompt (lời nhắc hệ thống) tùy chỉnh từ file cấu hình của bạn để định nghĩa vai trò và hành vi của subagent.
  • Một task description (mô tả nhiệm vụ) do agent cha viết dựa trên yêu cầu của bạn.

Sau đó, subagent tự làm việc. Nó đọc file, chạy tìm kiếm, chỉnh sửa code -- bất cứ điều gì cần thiết. Khi xong, chỉ có bản tóm tắt được gửi về cuộc hội thoại chính. Toàn bộ cuộc hội thoại của subagent sau đó sẽ bị hủy bỏ.

Điều này giúp context chính của bạn luôn sạch sẽ. Bạn nhận được câu trả lời mà không bị nhiễu bởi quá trình tìm kiếm. Đổi lại, bạn sẽ mất đi khả năng quan sát chi tiết cách subagent đưa ra kết luận.

Ví dụ thực tế

Giả sử bạn đang khám phá một codebase lạ và muốn biết service nào xử lý hoàn tiền (refund). Nếu không có subagent, Claude có thể phải đọc 15 file, chạy nhiều lệnh tìm kiếm và truy vết qua hàng loạt hàm. Tất cả những thứ đó làm đầy context window của bạn, dù bạn chỉ cần một thông tin duy nhất.

Với subagent, trải nghiệm sẽ gọn gàng hơn nhiều. Bạn đặt câu hỏi, subagent Explore khởi chạy, thực hiện việc tìm kiếm trong context riêng và trả về câu trả lời trọng tâm.

Context window chính của bạn chỉ ghi lại câu hỏi và bản tóm tắt -- không phải 15 file đã đọc trong quá trình đó.

Subagent có sẵn

Claude Code đi kèm với một số subagent tích hợp sẵn mà bạn có thể dùng ngay:

  • General purpose subagent (Subagent đa năng) -- cho các nhiệm vụ nhiều bước yêu cầu cả khám phá và hành động.
  • Explore -- để tìm kiếm nhanh và điều hướng codebase.
  • Plan -- được dùng trong plan mode (chế độ lập kế hoạch) để nghiên cứu và phân tích codebase trước khi trình bày kế hoạch.

Custom Subagents

Ngoài các tùy chọn có sẵn, bạn có thể tạo subagent riêng với system prompt và quyền truy cập tool tùy chỉnh. Điều này cho phép bạn định nghĩa các agent chuyên biệt phù hợp với quy trình làm việc -- như một người review code, người viết test, trình tạo tài liệu, hoặc bất cứ thứ gì bạn cần.

Các điểm chính cần nhớ

Subagent mang lại cho bạn ba lợi ích chính:

  • Chúng chia nhỏ công việc thành các phần tập trung, cho phép mỗi subagent chuyên tâm vào một nhiệm vụ cụ thể.
  • Chúng giữ cho context window chính sạch sẽ bằng cách cô lập các bước trung gian.
  • Chúng chỉ trả về thông tin bạn cần dưới dạng tóm tắt súc tích.

Dù bạn dùng subagent có sẵn hay tự tạo, chúng là cách thực tế để tối ưu hóa các phiên làm việc dài với Claude Code. Context chính càng ít nhiễu, bạn càng có thể làm việc lâu hơn và hiệu quả hơn.

🎬 Bản ghi video

Source video: jKErNxuxPXg

📜 Mở rộng bản ghi (đã chỉnh sửa + dịch AI)

Giới thiệu về Subagent trong Claude Code

Subagent là các trợ lý chuyên biệt mà Claude Code có thể ủy thác nhiệm vụ. Mỗi subagent hoạt động trong một cửa sổ context window riêng với một system prompt tùy chỉnh do bạn thiết lập. Khi hoàn tất, nó sẽ trả về một bản tóm tắt cho luồng chính, trong khi toàn bộ quá trình thực hiện trung gian vẫn được giữ tách biệt.

Cách thức hoạt động của Subagent

Subagent nhận hai đầu vào chính: một system prompt tùy chỉnh từ tệp cấu hình của bạn và một mô tả nhiệm vụ được viết bởi agent cha dựa trên yêu cầu của bạn. Sau khi được kích hoạt, subagent sẽ làm việc tự chủ. Khi nó đọc tệp, chỉnh sửa tệp hoặc thực hiện tool use, không có hành động nào trong số này xuất hiện trong cuộc hội thoại chính; chỉ có kết quả tóm tắt được gửi về. Sau khi nhiệm vụ hoàn thành, toàn bộ cuộc hội thoại của subagent sẽ bị xóa bỏ hoàn toàn.

Quản lý việc sử dụng Context Window

Một trong những ưu điểm chính của subagent là giúp quản lý việc sử dụng context window. Khi bạn trò chuyện với Claude Code, mỗi tương tác đều thêm ngữ cảnh vào cửa sổ chính. Mọi lượt gọi tool use và kết quả của chúng đều được lưu trữ tại đó.

Bằng cách sử dụng subagent, một cửa sổ riêng biệt sẽ được khởi tạo. Điều này ngăn cửa sổ ngữ cảnh chính bị lấp đầy bởi các bước trung gian. Đây là yếu tố then chốt để duy trì hiệu suất và hiệu quả trong các phiên làm việc kéo dài.

Ví dụ thực tế: Tìm hiểu Codebase

Hãy xem xét một nhiệm vụ như tìm hiểu cách hệ thống thanh toán hoạt động trong một codebase lạ. Bạn có thể sử dụng Claude Code để xác định service nào xử lý việc hoàn tiền.

  • Không có subagent: Claude có thể phải đọc 15 tệp, thực hiện nhiều lệnh tìm kiếm và truy vết qua hàng loạt lời gọi hàm. Tất cả ngữ cảnh đó sẽ lấp đầy context window chính của bạn, ngay cả khi bạn chỉ cần một thông tin duy nhất: service nào xử lý hoàn tiền.
  • Có subagent: Bạn nhận được câu trả lời mà không cần quan tâm đến "hành trình" tìm kiếm. Subagent sẽ tự khám phá, tìm ra câu trả lời và trả về một bản tóm tắt trọng tâm, giữ cho ngữ cảnh chính của bạn luôn sạch sẽ.

Tuy nhiên, cần lưu ý rằng cửa sổ chính sẽ không còn khả năng quan sát cách subagent đưa ra kết luận hoặc những gì nó đã khám phá được trong quá trình thực hiện.

Subagent tích hợp sẵn và tùy chỉnh

Claude Code bao gồm một số subagent tích hợp sẵn mà bạn có thể sử dụng ngay lập tức:

  • General Purpose Subagent: Dùng cho các nhiệm vụ nhiều bước, yêu cầu cả việc khám phá và thực thi.
  • Explore Subagent: Dùng để tìm kiếm nhanh trong codebase.
  • Plan Subagent: Được sử dụng trong "plan mode" để nghiên cứu và phân tích codebase trước khi trình bày một kế hoạch cụ thể.

Ngoài những loại này, bạn cũng có thể tạo subagent của riêng mình với các system prompt tùy chỉnh và quyền truy cập tool use cụ thể. Subagent cho phép Claude Code chia nhỏ công việc thành các phần tập trung, giữ cho context window chính luôn gọn gàng và mang lại chính xác những gì bạn cần. Dù bạn sử dụng các tùy chọn có sẵn hay tự tạo mới, đây đều là cách thực tế để tối ưu hóa các phiên làm việc dài với Claude Code.

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?