Bài 4.115 phút · 5 thẻ · 8 bài tập · 1 nhiệm vụ

Khi nào chia việc

Giao việc nhiều output cho subagent để giữ hội thoại gọn: khi nào nên, khi nào không, giao việc sao cho rõ, chạy song song và fork.

Bạn nhờ Claude chạy toàn bộ test của todo-api rồi đọc log để tìm lỗi. Việc xong, nhưng hàng trăm dòng log giờ nằm trong hội thoại, chiếm chỗ ở mọi lượt sau dù bạn không bao giờ đọc lại. Bài này nói về cách giao những việc như vậy cho một subagent: nó làm ở chỗ riêng và chỉ mang về kết luận. Quan trọng hơn, bài này giúp bạn biết lúc nào nên chia việc, và lúc nào chia việc chỉ làm chậm và tốn thêm.

Subagent là gì

Mỗi phiên Claude Code có một ngữ cảnh (context window: toàn bộ những gì Claude đang "nhớ" trong phiên, gồm tin nhắn, file đã đọc, output lệnh). Ngữ cảnh có giới hạn, và càng đầy thì Claude càng dễ lạc.

Subagent là một trợ lý chạy trong ngữ cảnh riêng của nó, có hướng dẫn, công cụ và quyền riêng. Claude giao cho nó một nhiệm vụ; nó tự tìm, đọc, chạy lệnh; xong việc thì gửi về một bản tóm tắt. Mọi thứ nó đọc dọc đường ở lại bên nó, không tràn vào hội thoại của bạn.

Hai điều nên biết ngay từ đầu:

  • Subagent không miễn phí. Nó gửi request riêng và tính vào cùng hạn mức sử dụng với phiên của bạn.
  • Bạn không cần gõ lệnh gì đặc biệt. Claude tự quyết định giao việc dựa vào yêu cầu của bạn và mô tả của các subagent đang có. Bạn cũng có thể nói thẳng: "dùng một subagent để…".

Khi nào nên chia việc, khi nào không

Docs đưa ra một phép thử đơn giản. Dùng subagent khi:

  • việc đó tạo ra nhiều output bạn không cần giữ: chạy cả bộ test, đọc log, tìm khắp codebase;
  • bạn muốn giới hạn công cụ hay quyền, ví dụ chỉ cho đọc;
  • việc tự đủ, làm xong thì tóm tắt lại được.

Ở lại hội thoại chính khi:

  • việc cần trao đổi qua lại nhiều lần để chỉnh dần;
  • các bước dùng chung nhiều bối cảnh, như lên kế hoạch, viết code rồi test cùng một tính năng;
  • đó chỉ là một sửa đổi nhỏ, nhanh;
  • bạn cần kết quả ngay: subagent bắt đầu từ con số không, phải mất thời gian tự tìm hiểu lại.

Hai lựa chọn khác hay bị nhầm với subagent:

  • Muốn hỏi nhanh về điều đã có trong hội thoại ("lúc nãy mình chọn mã lỗi nào nhỉ?") thì dùng /btw. Nó không dùng công cụ và câu trả lời không vào lịch sử.
  • Muốn một quy trình dùng lại chạy ngay trong hội thoại chính thì viết skill (cấp 3).

Một cách nghĩ dễ nhớ: subagent giống việc nhờ đồng nghiệp đi tra giúp một chuyện rồi về báo lại. Đáng nhờ khi việc tra cứu dài và bạn chỉ cần kết luận. Không đáng nhờ khi bạn phải giải thích lâu hơn tự làm.

Ba subagent có sẵn

Claude Code có sẵn vài subagent và Claude tự dùng khi hợp:

  • Explore: chỉ đọc (không được sửa file), chuyên tìm và phân tích code. Khi giao việc, Claude chọn mức kỹ: nhanh, vừa hoặc rất kỹ.
  • Plan: cũng chỉ đọc, dùng trong plan mode để tìm hiểu code trước khi đưa ra kế hoạch.
  • general-purpose: có mọi công cụ dành cho subagent, dùng cho việc nhiều bước vừa tìm hiểu vừa sửa.

Ngoài ra còn vài agent hỗ trợ như claude-code-guide, được gọi khi bạn hỏi về chính Claude Code.

Một chi tiết quan trọng: Explore và Plan bắt đầu không có CLAUDE.md và không có trạng thái git, để chạy nhanh và rẻ. Các subagent khác thì nạp cả hai. Bạn tự định nghĩa subagent riêng như thế nào là chủ đề của bài 4.2.

Subagent bắt đầu với những gì

Đây là chỗ hay vấp nhất. Subagent (trừ fork, ở mục cuối) bắt đầu với ngữ cảnh trống. Nó không thấy lịch sử hội thoại, không biết bạn vừa gọi skill nào, không biết Claude đã đọc file nào. Nó chỉ nhận lời giao việc do Claude viết, cộng với CLAUDE.md (trừ Explore và Plan).

Ví dụ: bạn vừa bàn với Claude 20 phút rằng route /admin sắp bị bỏ, đừng quan tâm. Rồi bạn bảo: "dùng subagent tìm mọi route chưa có test". Subagent báo về cả /admin, vì nó không nghe cuộc bàn bạc đó. Claude thường tóm tắt bối cảnh khi giao việc, nhưng không có gì bảo đảm.

Vì vậy, khi nhờ chia việc, hãy viết yêu cầu như giao cho người mới vào dự án:

  • Việc gì: "chạy npm test".
  • Trả về gì: "chỉ báo các test lỗi kèm thông báo lỗi".
  • Điều kiện bắt buộc: "bỏ qua route /admin, nó sắp bị xóa".

Câu "chỉ báo các test lỗi" rất đáng giá. Nó giữ cho bản tóm tắt mang về ngắn, và đó chính là lý do bạn chia việc.

Chạy nền và chạy song song

Mặc định, subagent Claude tạo ra chạy nền: bạn gõ tiếp, hỏi tiếp trong lúc nó làm. Mỗi subagent hiện thành một dòng trong panel dưới ô nhập. Khi xong, kết quả quay về hội thoại như một thông báo. Nếu bạn hỏi tiến độ trước đó, Claude sẽ nói nó vẫn đang chạy.

Khi một subagent chạy nền cần quyền, ví dụ chạy một lệnh chưa được cho phép, câu hỏi hiện ở phiên chính, kèm tên subagent. Đồng ý thì nó làm tiếp; nhấn Esc thì chỉ lần gọi đó bị từ chối, subagent vẫn chạy và tìm cách khác.

Vì chạy nền, bạn có thể giao nhiều việc độc lập cùng lúc. Thử với todo-api:

Use two subagents in parallel. One runs npm test and reports only
failing tests with their error messages. The other lists every route
in src/ with the status codes it can return. Then give me a short
combined summary.

Khi chúng tôi thử, Claude tạo hai subagent một lúc: general-purpose để chạy test, và tự chọn Explore cho việc liệt kê route vì việc đó chỉ cần đọc. Hội thoại chính chỉ nhận hai bản tóm tắt. Bản tổng hợp chỉ ra test đều đạt nhưng xóa một todo hai lần trả về 500, một lỗi mà bộ test không bắt được.

Vài giới hạn:

  • Song song chỉ có lợi khi các việc không phụ thuộc nhau. Việc B cần kết quả việc A thì cứ để chạy lần lượt.
  • Mỗi bản tóm tắt vẫn vào ngữ cảnh chính, và mỗi subagent tốn token riêng. Mười subagent trả về mười báo cáo dài thì chẳng tiết kiệm được gì.
  • Mặc định tối đa 20 subagent chạy cùng lúc.

Gõ /tasks để xem việc đang chạy và mở lại transcript của subagent đã xong, khi bạn muốn biết nó đã làm gì để ra kết luận.

Fork: khi subagent cần cả câu chuyện

Có lúc việc phụ cần gần hết những gì bạn vừa bàn, và tóm tắt lại thì quá dài. Khi đó dùng fork: một subagent mang theo toàn bộ hội thoại tới thời điểm đó. Nó làm phần việc của mình ở chỗ riêng, và chỉ kết quả cuối quay về.

Gõ /subtask kèm nhiệm vụ:

/subtask draft tests for every 404 case in the route list above

Bạn tiếp tục làm trong hội thoại chính, fork chạy nền và gửi kết quả về khi xong. Trong panel, chọn dòng của fork rồi nhấn Enter để xem nó đang làm gì và nhắn thêm cho nó; nhấn x để dừng.

Fork còn rẻ hơn subagent mới cho việc cần cùng bối cảnh: nó dùng chung bộ nhớ đệm prompt (prompt cache) với hội thoại cha nên request đầu không phải xử lý lại từ đầu. Đừng nhầm với /fork: lệnh đó chép cả phiên sang một phiên nền riêng, không gửi kết quả về đây.

Tóm lại, trước khi chia việc hãy tự hỏi ba câu: việc này có tạo nhiều output mình không cần không? Nó có tự đủ không? Mình có giải thích được nó trong vài dòng không? Ba lần "có" thì giao cho subagent. Cần cả câu chuyện thì dùng /subtask. Còn lại, cứ làm trong hội thoại chính.

Bài sau: tự định nghĩa subagent của riêng bạn, với công cụ, model và phạm vi phù hợp.

Luyện tập bài 4.1

5 thẻ ghi nhớ, 8 bài tập chấm ngay trên trang, 1 nhiệm vụ làm trên máy.

Bắt đầu luyện tập

Tra cứu liên quan

Gõ để tìm trong tra cứu, mẫu cấu hình và bài học. Không dấu cũng được.