Làm app cùng AI agent

Giao diện

Thông tin kiểm chứng ngày 2026-10-24T00:00:00.000Z

Subagent ​

Subagent (agent con) là agent phụ có ngữ cảnh riêng: nhận một việc, làm xong, trả về kết quả gọn cho agent chính.

Giải quyết vấn đề gì ​

Một phiên làm quá nhiều việc thì ngữ cảnh đầy rác: log test dài, nội dung file đã đọc, những hướng đã thử và bỏ. Agent bắt đầu lẫn lộn, quên quy ước ở đầu phiên, chất lượng tụt.

Subagent tách việc ra:

  • Agent chính giữ bức tranh lớn (spec, plan, task nào xong).
  • Mỗi subagent nhận một task, đọc đúng những file cần, làm, rồi chỉ báo lại kết quả. Rác ở lại trong ngữ cảnh của nó.
  • Việc độc lập có thể chạy song song.

Đây là thứ làm nấc 3 (xem Hiện trạng) khả thi: plugin Superpowers giao mỗi task trong plan cho một subagent riêng, rồi một subagent khác review.

Khi nào cần ​

  • Thực thi một plan có nhiều task: giao mỗi task cho một subagent (Superpowers làm sẵn, xem Workflow chính).
  • Tìm kiếm rộng trong codebase lạ: để subagent đọc nhiều file, chỉ trả kết luận.
  • Review độc lập: một agent không viết code thì nhìn code khách quan hơn.
  • Chưa cần tự viết subagent riêng khi mới bắt đầu. Dùng subagent có sẵn và của plugin trước.

Hành vi mặc định hiện nay (10/2026):

  • Chạy nền mặc định (từ W27, 29/6–3/7/2026): bạn vẫn gõ tiếp trong lúc subagent làm. Tắt bằng biến môi trường CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1.
  • Fork mode bật mặc định: subagent dạng fork kế thừa ngữ cảnh của phiên hiện tại. Bật cho phiên tương tác từ W33; từ v2.1.302 bật cả trong claude -p, Agent SDK, desktop, VS Code. Tắt bằng CLAUDE_CODE_FORK_SUBAGENT=0.
  • Xem mọi phiên trên một màn hình: claude agents. Chạy một việc ở nền: claude --bg "task" (không dùng chung với -p).

Agent teams vẫn là experimental

Agent teams (đội agent: nhiều phiên Claude nhắn tin và chia việc cho nhau) đang experimental, tắt mặc định. Bật bằng CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. Khi bật, subagent nào được Claude đặt tên sẽ chạy thành teammate. Không chạy trong -p/SDK. Khóa học này không dùng agent teams.

Ví dụ tối thiểu ​

Starter không có subagent tự viết; lab dùng subagent của Superpowers. Nếu muốn tự viết, đây là dạng tối thiểu. Đặt ở .claude/agents/ (dự án) hoặc ~/.claude/agents/ (cá nhân); chỉ name và description là bắt buộc:

markdown
---
name: test-reviewer
description: Đọc diff và các file test liên quan, chỉ ra trường hợp biên chưa có test. Dùng sau khi xong một task có logic nghiệp vụ.
tools: Read, Grep, Glob
---

Bạn là người review test. Đọc diff hiện tại và các file `*.test.ts` liên quan.
Liệt kê trường hợp biên chưa được test (số 0, danh sách rỗng, chia không hết...).
Không sửa code. Trả về danh sách ngắn, mỗi dòng một trường hợp.

Các trường tùy chọn khác: model, permissionMode, skills, mcpServers, hooks, background, isolation... tools hẹp (chỉ đọc) là cách đơn giản nhất để một subagent review không lỡ tay sửa code.

Bên Codex ​

Codex cũng có subagent. Agent teams thì chưa có tương đương trực tiếp. Xem bảng đối chiếu ở chương 7.

Nguồn ​