Claude Code mở chế độ chiến đội! Bạn nhất định phải dùng Agent teams!

Claude Code lại tung ra một chiêu lớn: Agent Teams, có thể hiểu là phiên bản siêu cường hóa của Sub Agents～ Hình dưới đây là so sánh giữa Agent Teams và Subagents:

Tôi đã "dùng trước làm kính" rồi! (Rất đã! Rất đã! Rất đã!)

Điều kiện để mở Agent Teams: 
1. Cập nhật Claude Code lên phiên bản mới nhất (claude update) 

2. Trong settings.json thêm một dòng:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Khởi động lại Claude Code～  

4. Sau đó trực tiếp dùng ngôn ngữ tự nhiên để Claude Code tạo một Agent Teams (tất nhiên, phải nói rõ ràng để Agent Teams làm gì)  

Ngoài ra, các mô hình khác không ảnh hưởng đến công việc của Agent Teams (tôi dùng KIMi for coding)

Chi tiết hơn về Agent Teams xem bên dưới (bài viết chính thức của Anthropic)!

Agent Teams cho phép bạn phối hợp nhiều phiên bản Claude Code cùng làm việc. Một phiên làm trưởng, điều phối công việc, phân công nhiệm vụ, tổng hợp kết quả. Các thành viên làm việc độc lập, mỗi người trong cửa sổ ngữ cảnh của mình, còn có thể trực tiếp trò chuyện với nhau.

Khác với đại lý con (Subagents) (đại lý con chạy trong một phiên duy nhất, chỉ có thể báo cáo cho đại lý chính), bạn còn có thể trực tiếp tương tác với từng thành viên, không cần thông qua trưởng.

Tài liệu này bao gồm:

• • Khi nào dùng Agent Teams, bao gồm các trường hợp sử dụng tốt nhất và so sánh với đại lý con

• • Khởi động đội

• • Kiểm soát các thành viên, bao gồm chế độ hiển thị, phân công nhiệm vụ và ủy quyền

• • Thực hành tốt nhất cho công việc song song

Khi nào dùng Agent Teams

Agent Teams hiệu quả nhất trong các nhiệm vụ mà việc khám phá song song có thể tăng thêm giá trị thực sự. Các trường hợp sử dụng mạnh nhất bao gồm:

• • Nghiên cứu và xem xét —— Nhiều thành viên có thể đồng thời điều tra các khía cạnh khác nhau của vấn đề, sau đó chia sẻ và thách thức phát hiện của nhau

• • Mô-đun hoặc tính năng mới —— Các thành viên có thể sở hữu các phần độc lập, không can thiệp lẫn nhau

• • Gỡ lỗi với giả thuyết cạnh tranh —— Các thành viên kiểm tra song song các lý thuyết khác nhau, tìm ra câu trả lời nhanh hơn

• • Phối hợp xuyên tầng —— Thay đổi xuyên qua front-end, back-end và kiểm thử, mỗi phần do một thành viên khác nhau phụ trách

Agent Teams tăng thêm chi phí điều phối (Bạn dám dùng Opus4.6 mở Agent Teams không🤣), tiêu thụ token tăng đáng kể so với dùng một phiên duy nhất. Chúng hoạt động tốt nhất khi nhóm có thể vận hành độc lập. Đối với nhiệm vụ tuần tự, chỉnh sửa cùng một tệp hoặc công việc có nhiều phụ thuộc, một phiên duy nhất hoặc đại lý con hiệu quả hơn.

So sánh với đại lý con

Agent Teams và đại lý con đều cho phép bạn làm việc song song, nhưng cách vận hành khác nhau. Chọn dựa trên việc người làm việc của bạn có cần giao tiếp với nhau không:

Đại lý con

Agent Teams

Ngữ cảnh

Cửa sổ ngữ cảnh riêng; kết quả trả về cho người gọi

Cửa sổ ngữ cảnh riêng; hoàn toàn độc lập

Giao tiếp

Chỉ báo cáo kết quả cho đại lý chính

Các thành viên trực tiếp gửi tin nhắn cho nhau

Điều phối

Đại lý chính quản lý tất cả công việc

Danh sách nhiệm vụ chia sẻ, tự điều phối

Phù hợp nhất

Nhiệm vụ tập trung chỉ quan tâm đến kết quả

Công việc phức tạp cần thảo luận và hợp tác

Chi phí Token

Thấp hơn: kết quả tổng hợp trở lại ngữ cảnh chính

Cao hơn: mỗi thành viên là một phiên bản Claude độc lập

Dùng đại lý con khi bạn cần người làm việc nhanh, tập trung báo cáo kết quả. Dùng Agent Teams khi nhóm cần chia sẻ phát hiện, thách thức lẫn nhau và tự điều phối.

Bật Agent Teams

Agent Teams mặc định bị tắt. Bật bằng cách đặt biến môi trường CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS thành 1, có thể trong môi trường shell hoặc thông qua settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Khởi động Agent Team đầu tiên của bạn

Sau khi bật Agent Teams, hãy bảo Claude tạo một Agent Team, dùng ngôn ngữ tự nhiên mô tả nhiệm vụ và cấu trúc đội bạn muốn. Claude dựa trên gợi ý của bạn để tạo đội, tạo thành viên và điều phối công việc.

Ví dụ này hoạt động tốt vì ba vai trò độc lập, có thể khám phá vấn đề mà không cần chờ đợi nhau:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Tạo một Agent Team để khám phá điều này từ các góc độ khác nhau: một thành viên phụ trách UX, một phụ trách kiến trúc kỹ thuật, một đóng vai trò người bênh vực cho cái xấu.)

Từ đó, Claude tạo một đội với danh sách nhiệm vụ chia sẻ, tạo thành viên cho mỗi góc nhìn, để họ khám phá vấn đề, tổng hợp phát hiện, và cố gắng dọn dẹp đội sau khi hoàn thành.

Terminal của trưởng liệt kê tất cả thành viên và nội dung công việc của họ. Dùng Shift+Up/Down để chọn thành viên và trực tiếp gửi tin nhắn cho họ.

Kiểm soát Agent Team của bạn

Dùng ngôn ngữ tự nhiên bảo trưởng bạn muốn gì. Nó xử lý điều phối đội, phân công nhiệm vụ và ủy quyền dựa trên chỉ dẫn của bạn.

Chọn chế độ hiển thị

Agent Teams hỗ trợ hai chế độ hiển thị:

• • Chế độ trong tiến trình —— Tất cả thành viên chạy trong terminal chính của bạn. Dùng Shift+Up/Down để chọn thành viên và trực tiếp nhập gửi tin nhắn. Phù hợp với mọi terminal, không cần thiết lập thêm.

• • Chế độ chia màn hình —— Mỗi thành viên có khung riêng. Bạn có thể đồng thời thấy đầu ra của mọi người, nhấp vào khung để tương tác trực tiếp. Cần tmux hoặc iTerm2.

Mặc định là "auto", nếu bạn đang chạy trong phiên tmux thì dùng chia màn hình, ngược lại dùng chế độ trong tiến trình.

Để bắt buộc dùng chế độ trong tiến trình cho một phiên duy nhất, truyền cờ:

claude --teammate-mode in-process

Chỉ định thành viên và mô hình

Claude quyết định tạo bao nhiêu thành viên dựa trên nhiệm vụ của bạn, hoặc bạn có thể chính xác chỉ định bạn muốn gì:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Tạo một đội 4 thành viên để tái cấu trúc song song các mô-đun này. Dùng Sonnet cho mỗi thành viên.)

Yêu cầu thành viên phê duyệt kế hoạch

Đối với nhiệm vụ phức tạp hoặc có rủi ro, bạn có thể yêu cầu thành viên lập kế hoạch trước khi thực hiện. Thành viên làm việc ở chế độ kế hoạch chỉ đọc, cho đến khi trưởng phê duyệt phương pháp của họ:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Tạo một thành viên kiến trúc sư để tái cấu trúc mô-đun xác thực. Yêu cầu phê duyệt kế hoạch trước khi họ thực hiện bất kỳ thay đổi nào.)

Khi thành viên hoàn thành kế hoạch, họ gửi yêu cầu phê duyệt kế hoạch cho trưởng. Trưởng xem xét kế hoạch và phê duyệt hoặc từ chối và cung cấp phản hồi.

Sử dụng chế độ ủy quyền

Không có chế độ ủy quyền, trưởng đôi khi tự bắt đầu thực hiện nhiệm vụ, thay vì chờ thành viên hoàn thành. Chế độ ủy quyền ngăn điều này bằng cách giới hạn trưởng chỉ dùng công cụ điều phối. Nhấn Shift+Tab để chuyển sang chế độ ủy quyền.

Trực tiếp trò chuyện với thành viên

Mỗi thành viên là một phiên Claude Code đầy đủ, độc lập. Bạn có thể trực tiếp gửi tin nhắn cho bất kỳ thành viên nào:

• • Chế độ trong tiến trình: Dùng Shift+Up/Down để chọn thành viên, sau đó nhập gửi tin nhắn. Nhấn Enter để xem phiên của thành viên, sau đó nhấn Escape để ngắt lượt hiện tại của họ. Nhấn Ctrl+T để chuyển đổi danh sách nhiệm vụ.

• • Chế độ chia màn hình: Nhấp vào khung của thành viên để tương tác trực tiếp với phiên của họ.

Phân công và nhận nhiệm vụ

Danh sách nhiệm vụ chia sẻ điều phối công việc của đội. Trưởng tạo nhiệm vụ, thành viên hoàn thành. Nhiệm vụ có ba trạng thái: đang chờ, đang tiến hành, đã hoàn thành. Nhiệm vụ cũng có thể phụ thuộc vào nhiệm vụ khác.

Trưởng có thể phân công nhiệm vụ rõ ràng, hoặc thành viên có thể tự nhận sau khi hoàn thành nhiệm vụ.

Tắt thành viên

Để kết thúc phiên của thành viên một cách duyên dáng:

Ask the researcher teammate to shut down
(Yêu cầu thành viên nghiên cứu tắt)

Trưởng gửi yêu cầu tắt. Thành viên có thể phê duyệt và thoát duyên dáng, hoặc từ chối và giải thích lý do.

Dọn dẹp đội

Sau khi hoàn thành, hãy bảo trưởng dọn dẹp:

Clean up the team
(Dọn dẹp đội)

Điều này loại bỏ tài nguyên đội chia sẻ. Khi trưởng chạy dọn dẹp, nó kiểm tra các thành viên đang hoạt động, nếu còn đang chạy thì thất bại, vì vậy cần tắt họ trước.

Agent Teams hoạt động như thế nào

Kiến trúc

Agent Team bao gồm:

• • Trưởng: Phiên Claude Code chính tạo đội, tạo thành viên và điều phối công việc

• • Thành viên: Các phiên bản Claude Code độc lập xử lý nhiệm vụ được phân công

• • Danh sách nhiệm vụ: Danh sách chia sẻ các mục công việc mà thành viên nhận và hoàn thành

• • Hộp thư: Hệ thống tin nhắn để các đại lý giao tiếp với nhau

Hệ thống tự động quản lý sự phụ thuộc nhiệm vụ. Đội và nhiệm vụ lưu trữ cục bộ:

• • Cấu hình đội: ~/.claude/teams/{team-name}/config.json

• • Danh sách nhiệm vụ: ~/.claude/tasks/{team-name}/

Ngữ cảnh và giao tiếp

Mỗi thành viên có cửa sổ ngữ cảnh riêng. Khi được tạo, thành viên tải ngữ cảnh dự án giống như phiên thông thường: CLAUDE.md, máy chủ MCP và kỹ năng. Lịch sử hội thoại của trưởng không được truyền qua.

Thành viên chia sẻ thông tin như thế nào:

• • Truyền tin nhắn tự động: Khi thành viên gửi tin nhắn, tự động truyền cho người nhận

• • Thông báo nhàn rỗi: Khi thành viên hoàn thành và dừng, tự động thông báo cho trưởng

• • Danh sách nhiệm vụ chia sẻ: Tất cả đại lý có thể thấy trạng thái nhiệm vụ và nhận công việc có sẵn

Sử dụng Token

Agent Teams tiêu thụ token tăng đáng kể so với một phiên duy nhất. Mỗi thành viên có cửa sổ ngữ cảnh riêng, lượng sử dụng token tăng theo số thành viên đang hoạt động. Đối với công việc nghiên cứu, xem xét và tính năng mới, token bổ sung thường đáng giá. Đối với nhiệm vụ thông thường, một phiên duy nhất hiệu quả hơn về chi phí.

Ví dụ trường hợp sử dụng

Chạy xem xét mã song song

Người xem xét đơn lẻ có xu hướng tập trung vào một loại vấn đề cùng lúc. Chia tiêu chuẩn xem xét thành các lĩnh vực độc lập có nghĩa là an ninh, hiệu suất và phủ sóng kiểm thử đồng thời được chú ý kỹ lưỡng.

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings.
(Tạo một Agent Team để xem xét PR #142. Tạo ba người xem xét: một tập trung vào tác động an ninh, một kiểm tra tác động hiệu suất, một xác thực phủ sóng kiểm thử. Để họ mỗi người xem xét và báo cáo phát hiện.)

Điều tra với giả thuyết cạnh tranh

Khi nguyên nhân gốc rễ không rõ ràng, một đại lý đơn lẻ có xu hướng tìm một giải thích có vẻ hợp lý rồi ngừng tìm kiếm.

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

Thực hành tốt nhất

Cung cấp đủ ngữ cảnh cho thành viên

Thành viên tự động tải ngữ cảnh dự án, nhưng không kế thừa lịch sử hội thoại của trưởng. Bao gồm chi tiết cụ thể cho nhiệm vụ trong gợi ý tạo.

Điều chỉnh kích thước nhiệm vụ phù hợp

• • Quá nhỏ: Chi phí điều phối vượt quá lợi ích

• • Quá lớn: Thành viên làm việc quá lâu không kiểm tra, tăng rủi ro lãng phí nỗ lực

• • Vừa đủ: Đơn vị tự chứa, tạo ra sản phẩm giao rõ ràng

Chờ thành viên hoàn thành

Đôi khi trưởng tự bắt đầu thực hiện nhiệm vụ, thay vì chờ thành viên hoàn thành. Nếu bạn nhận thấy điều này:

Wait for your teammates to complete their tasks before proceeding
(Chờ các thành viên của bạn hoàn thành nhiệm vụ trước khi tiếp tục)

Tránh xung đột tệp

Hai thành viên chỉnh sửa cùng một tệp có thể dẫn đến ghi đè. Chia công việc để mỗi thành viên sở hữu một tập tệp khác nhau.

Giám sát và hướng dẫn

Kiểm tra tiến độ của thành viên, chuyển hướng phương pháp không hiệu quả, và tổng hợp phát hiện khi tiến triển.

Hạn chế

Agent Teams là thử nghiệm. Hạn chế hiện tại:

• • Thành viên trong tiến trình không hỗ trợ khôi phục phiên: /resume và /rewind sẽ không khôi phục thành viên trong tiến trình

• • Trạng thái nhiệm vụ có thể chậm: Thành viên đôi khi không thể đánh dấu nhiệm vụ hoàn thành

• • Tắt có thể chậm: Thành viên hoàn thành yêu cầu hiện tại trước khi tắt

• • Một đội mỗi phiên: Một trưởng chỉ có thể quản lý một đội cùng lúc

• • Không hỗ trợ đội lồng nhau: Thành viên không thể tạo đội riêng của họ

• • Trưởng cố định: Phiên tạo đội là trưởng trong suốt vòng đời của nó

• • Chia màn hình cần tmux hoặc iTerm2: Không hỗ trợ terminal tích hợp VS Code, Windows Terminal hoặc Ghostty