Làm việc song song với Claude Code: worktree, Agent và Workflows
MarkdownBốn lớp làm việc song song với Claude Code, cách ly bằng git worktree, xác minh kết quả, công cụ GUI và giới hạn về khối lượng công việc cùng token.
Đọc toàn bộ bài viết
Điểm chính
Claude Code có bốn cách để chia công việc cho nhiều agent: subagents trong một phiên, skills kèm hướng dẫn, agent teams có trưởng nhóm và các cửa sổ riêng, và Dynamic Workflows dưới dạng tập lệnh JavaScript do runtime chạy. Nếu muốn chạy hơn năm phiên bản Claude Code song song trên cùng một máy, hãy dùng git worktree để cách ly tệp. Giới hạn chính thức của runtime là 16 agent cùng lúc, tổng cộng 1000 agent mỗi lần chạy. Cạm bẫy chính không nằm ở mã nguồn. “Tôi có 50 agent đang làm việc” thường có nghĩa là “50 agent đang tạo ra những thứ vô nghĩa song song mà không ai kiểm tra”. Outcomes — một bộ tiêu chí đánh giá và agent phản biện độc lập — giúp giải quyết việc này.
Tài liệu thực tiễn về cách làm việc song song với các agent: tài liệu Ailoot.
Hướng dẫn này tập hợp kinh nghiệm thực tế và bản đồ cho biết các công cụ phù hợp với những tình huống nào. Bài viết trình bày bốn thành phần chính thức của Claude Code, bản đồ ứng dụng, và một khung chống thổi phồng để xác định một vibe coder thực sự cần bao nhiêu agent chạy song song. Tất cả số liệu và trích dẫn đều liên kết đến nguồn sơ cấp từ Anthropic.
Multi-agent trong Claude Code là gì, và vì sao không phải “1000 agent”
Điểm chính
Multi-agent trong Claude Code là mọi tình huống có nhiều luồng công việc cùng xử lý một nhiệm vụ thay vì chỉ có một cuộc hội thoại. Có thể là nhiều phiên trong các cửa sổ khác nhau, một trưởng nhóm cùng các agent cấp dưới trong một phiên, hoặc một tập lệnh do runtime điều phối. “1000 agent” là giới hạn kỹ thuật trên cùng cho một lần chạy Dynamic Workflow. Đây là hàng rào bảo vệ để ngăn vòng lặp runtime chạy mất kiểm soát, không phải khuyến nghị về khối lượng công việc.
Thiết lập multi-agent là cách chia một nhiệm vụ thành nhiều luồng công việc độc lập, mỗi luồng phụ trách phần việc riêng và trả về kết quả. Ví dụ đơn giản nhất: bạn viết frontend trong một cửa sổ Claude Code, còn backend trong một cửa sổ khác trên cùng máy, với một kho git dùng chung. Như vậy đã là multi-agent rồi, dù gọi đó là “orchestration” thì không cần thiết.
Một thiết lập phức tạp hơn: trong một phiên Claude Code, bạn khởi chạy năm subagent với các vai trò khác nhau (nhà phát triển frontend, nhà phát triển backend, người đánh giá bảo mật, người kiểm thử, người viết tài liệu), và mỗi agent trả phần kết quả của mình về cuộc hội thoại chung. Đây vẫn là cách tiếp cận multi-agent, chỉ có một điểm điều khiển.
Phức tạp hơn nữa: bạn bảo Claude “thực hiện kiểm tra bảo mật hàng tuần trên toàn bộ 500 tệp trong dự án của tôi”, rồi Claude viết một tập lệnh điều phối JavaScript. Runtime khởi chạy vài chục agent chạy nền, mỗi agent kiểm tra phần riêng, sau đó các agent độc lập kiểm tra phát hiện của nhau, và bạn nhận được một báo cáo. Đó là Dynamic Workflows, được Anthropic phát hành ngày 28 tháng 5 năm 2026. Phần phân tích tính năng chi tiết có trong hướng dẫn riêng về Dynamic Workflows.
Khác biệt giữa ba tình huống này không nằm ở số lượng agent. Khác biệt là ai quyết định agent tiếp theo sẽ làm gì. Ở tình huống đầu tiên, đó là bạn. Ở tình huống thứ hai, Claude quyết định khi cuộc hội thoại diễn tiến. Ở tình huống thứ ba, đó là tập lệnh JavaScript do Claude viết.
Nhân tiện, “1000 agent” là con số có thật. Đó là giới hạn trên cho một lần chạy Dynamic Workflow trong Claude Code. Tài liệu chính thức của Anthropic cho biết:
Tối đa 16 agent chạy đồng thời, ít hơn trên máy có CPU hạn chế. Tổng cộng 1000 agent mỗi lần chạy — để ngăn các vòng lặp mất kiểm soát.
Nói cách khác, đây là biện pháp bảo vệ kỹ thuật nhằm ngăn hoạt động mất kiểm soát, không phải khối lượng công việc được khuyến nghị. Trên thực tế, 95% nhiệm vụ được xử lý bằng 2–8 luồng công việc song song. Nếu dự định dùng nhiều hơn, trước tiên hãy tự hỏi chúng sẽ làm gì.
4 thành phần Claude Code: subagents, skills, agent teams và workflows
Điểm chính
Tài liệu chính thức của Claude Code mô tả bốn lớp làm việc multi-agent riêng biệt. Subagents là các tác nhân tạm thời trong một phiên. Skills là hướng dẫn để Claude làm theo. Agent teams là các “đồng nghiệp” thường trực trong những cửa sổ riêng, có một trưởng nhóm. Workflows là các tập lệnh được runtime điều phối. Mỗi loại có giới hạn chạy đồng thời và nơi lưu kết quả trung gian riêng.
Claude Code có bốn thành phần chính thức để chia một nhiệm vụ cho nhiều agent. Anthropic đã tổng hợp chúng thành bảng so sánh trong tài liệu Dynamic Workflows. Sau đây là phần so sánh bằng ngôn ngữ đơn giản:
| Subagents | Skills | Agent Teams | Workflows | |
|---|---|---|---|---|
| Là gì | Tác nhân do Claude khởi chạy | Hướng dẫn Claude làm theo | Trưởng nhóm cùng đội trong các cửa sổ riêng | Tập lệnh do runtime thực thi |
| Ai quyết định các bước | Claude theo diễn tiến cuộc hội thoại | Claude dựa trên hướng dẫn | Trưởng nhóm | Chính tập lệnh |
| Kết quả nằm ở đâu | Trong cửa sổ ngữ cảnh của Claude | Trong cửa sổ ngữ cảnh | Trong danh sách nhiệm vụ dùng chung | Trong các biến của tập lệnh |
| Có thể tái sử dụng | Mô tả tác nhân | Chính các hướng dẫn | Mô tả đội | Toàn bộ quá trình điều phối |
| Quy mô | Vài tác nhân mỗi lần | Số lượng tương đương | Vài đồng nghiệp thường trực | Hàng chục hoặc hàng trăm mỗi lần chạy |
| Điều gì xảy ra khi bị gián đoạn | Khởi động lại lượt | Khởi động lại lượt | Đồng nghiệp tiếp tục | Tiếp tục trong cùng phiên |
Mỗi thành phần giải quyết một vấn đề khác nhau. Subagents phù hợp để giao 2–3 lượt kiểm tra trong một nhiệm vụ. Skills phù hợp khi bạn đã có hướng dẫn để Claude làm theo (chẳng hạn “đánh giá PR theo checklist này”). Agent teams phù hợp khi các phần khác nhau của sản phẩm nằm trong những cửa sổ khác nhau và bạn cần một người điều phối. Workflows phù hợp khi nhiệm vụ quá lớn so với một cửa sổ ngữ cảnh.
Subagents được trình bày chi tiết trong hướng dẫn Claude Code Subagents 2026. Cây quyết định “dùng gì cho một nhiệm vụ cụ thể” nằm trong hướng dẫn Skills, Subagents, MCP, Plugins. Hướng dẫn này tập trung vào cách ghép chúng thành một thiết lập multi-agent trên git worktree.
Cấp độ 1: subagents trong một phiên — điểm bắt đầu dễ nhất
Điểm chính
Subagent là một “tác nhân” tạm thời bên trong phiên Claude. Bạn bảo agent chính “khởi chạy bốn subagent: nhà phát triển frontend, nhà phát triển backend, người kiểm thử, người viết tài liệu”, mỗi agent xử lý phần riêng rồi gửi kết quả về cuộc hội thoại chung. Số lượng chạy đồng thời: 2–5 subagent, tất cả trong cùng một ngữ cảnh chung.
Subagent là cách đơn giản nhất để chia một nhiệm vụ. Cuộc hội thoại chính đóng vai trò điều phối viên. Subagent là những tác nhân tạm thời mà agent chính khởi chạy trong quá trình làm việc.
Một ví dụ cụ thể từ dự án được mô tả. Sau bản nháp đầu tiên của một hướng dẫn, việc đánh giá được thiết lập như sau: Claude nhận yêu cầu “khởi chạy sáu subagent song song — agent thứ nhất kiểm tra dấu hiệu AI, agent thứ hai kiểm tra thuật ngữ pháp lý, agent thứ ba kiểm tra giọng điệu và cách diễn đạt, agent thứ tư kiểm tra sự kiện bằng WebFetch, agent thứ năm đánh giá cấu trúc SEO, agent thứ sáu kiểm tra độ chính xác của liên kết nội bộ”. Mỗi agent gửi báo cáo, sau đó các chỉnh sửa được áp dụng.
Về mặt kỹ thuật, cách này dùng các tệp trong .claude/agents/[subagent-name].md để mô tả vai trò và công cụ. Lệnh gọi được thực hiện qua công cụ Agent trong cuộc hội thoại chính. Claude quyết định khi nào gửi yêu cầu cho subagent.
Phù hợp ở đâu. Các nhiệm vụ cần 3–7 lượt kiểm tra song song trên một sản phẩm (mã, văn bản, thiết kế). Mỗi lượt kiểm tra độc lập. Kết quả vừa với cửa sổ ngữ cảnh chính.
Khi nào bắt đầu quá tải. Nếu có hơn 50 tệp hoặc mỗi lượt kiểm tra cần ngữ cảnh riêng 50K token, cửa sổ chính sẽ đầy. Bạn cần workflows hoặc agent teams.
Rủi ro chính. Mỗi subagent tiêu thụ token riêng. Nếu khởi chạy sáu agent trên dự án 200 tệp và mỗi agent đọc lại cả 200 tệp, bạn phải trả gấp 6 lần. Vì vậy, bạn PHẢI chỉ rõ chính xác subagent cần kiểm tra những tệp nào. Xem chi tiết trong hướng dẫn Token được dùng vào đâu trong Claude Code.
Cấp độ 2: git worktree — cách ly tệp giữa các phiên chạy song song
Điểm chính
Subagents dùng chung một phiên và một hệ thống tệp. Nếu muốn có hai phiên bản Claude Code đầy đủ trong các terminal khác nhau cùng chỉnh sửa một dự án, chúng cần các bản sao làm việc riêng. Git worktree cung cấp điều đó miễn phí: một nguồn dữ liệu chuẩn trong .git, hai thư mục độc lập trên đĩa.
Khi subagents không đủ và bạn cần hai phiên bản Claude Code đầy đủ trong các terminal khác nhau làm việc trên cùng repository, một vấn đề quen thuộc sẽ xuất hiện. Cả hai bắt đầu sửa cùng một tệp; một phiên lưu trước, còn phiên kia ghi đè lên. Tuần trước, một khách hàng hỏi nhóm hỗ trợ: “5 cái đang ghi đè lên nhau cùng lúc”.
Giải pháp là git worktree. Đây là tính năng tích hợp sẵn của git, cho phép bạn có nhiều bản sao làm việc của cùng một repository, mỗi bản trên một branch riêng nhưng dùng chung repository .git. Một nguồn gốc, các thư mục khác nhau trên đĩa và không có tệp nào chồng lấn nhau. Cơ chế này được mô tả chi tiết trong hướng dẫn Git worktree trong Claude Code.
Các lệnh thiết lập trong năm phút:
# From the main project directory
cd ~/projects/my-app
# Create a worktree for feature/auth
git worktree add ../my-app-auth feature/auth
# Create a worktree for feature/billing
git worktree add ../my-app-billing feature/billing
# Open two terminal windows
cd ~/projects/my-app-auth && claude # first Claude Code
cd ~/projects/my-app-billing && claude # second Claude Code
Mỗi bản sao nằm trên branch riêng. Mỗi phiên bản Claude Code ghi vào thư mục riêng của mình. Khi hoàn thành, chạy git push từ branch đó rồi chạy git worktree remove ../my-app-auth.
Điều cần biết. Worktree không sao chép node_modules, .venv hoặc các tệp khác trong .gitignore. Nếu cần dependencies độc lập (mỗi branch dùng một phiên bản thư viện khác nhau), hãy chạy npm install riêng trong thư mục mới sau worktree add.
Mỗi người nên có bao nhiêu worktree. Theo các khảo sát nhóm năm 2026, mức tối đa thực tế là 4–8 worktree song song cho mỗi nhà phát triển. Yếu tố giới hạn không phải Claude, mà là khả năng của một người trong việc đánh giá và chấp nhận kết quả. Nếu có 10 worktree, chúng sẽ phải chờ được đánh giá.
Trong thực tế được mô tả, mọi người thường dùng 2–3 worktree song song. Một worktree chính cho công việc đang triển khai, một worktree dự phòng cho hotfix khẩn cấp, và một worktree cho thử nghiệm (một tính năng mới mà bạn chưa chắc chắn). Không cần nhiều hơn.
Cấp độ 3: agent teams — nhiều cửa sổ, một agent dẫn dắt
Điểm chính
Agent teams là nhiều phiên bản Claude Code trong các cửa sổ khác nhau cùng làm việc như một đội: một agent dẫn dắt theo dõi danh sách nhiệm vụ dùng chung, các agent khác báo cáo cho nó và trao đổi qua hệ thống tệp chung. Đây là mức orchestration nằm giữa “subagents trong một cuộc hội thoại” và “Dynamic Workflows dưới dạng mã”.
Agent teams là một thành phần tương đối mới. Ý tưởng là một agent dẫn dắt giữ kế hoạch chung dưới dạng danh sách nhiệm vụ, còn một số phiên đồng cấp trong các cửa sổ riêng đảm nhận nhiệm vụ do trưởng nhóm giao. Tất cả làm việc trên cùng hệ thống tệp và có thể thấy các sản phẩm trung gian của nhau.
Cách này hữu ích khi một nhiệm vụ chia thành 3–5 luồng công việc lớn, mỗi luồng kéo dài hàng giờ (di chuyển một module lớn, viết lại một hệ thống con, thực hiện kiểm tra bảo mật toàn diện). Trong trường hợp đó, tác nhân trưởng giữ kế hoạch ở một tệp tác vụ chung có đường tuyệt đối ngoài worktree. Worker đọc đường đó, báo kết quả; chỉ trưởng cập nhật trạng thái để tránh ghi cạnh tranh.
Về mặt kỹ thuật, agent teams là nhiều cửa sổ chạy trên git worktree với một điểm lập kế hoạch chung. Trên thực tế, 80% mọi người quản lý agent teams thủ công (như mô tả ở trên với worktree) và không dùng “framework teams” chuyên biệt nào. Như vậy cũng ổn.
Nếu không chắc mình có cần framework hay không, gần như chắc chắn là không. Hãy dùng worktree thủ công và một agent dẫn dắt trong thư mục chính.
Cấp độ 4: Dynamic Workflows — Claude viết tập lệnh orchestration bằng JS
Điểm chính
Dynamic Workflow là tập lệnh JavaScript do Claude viết cho nhiệm vụ của bạn và được runtime thực thi ở chế độ nền. Runtime khởi chạy tối đa 16 agent cùng lúc (1000 agent mỗi lần chạy), trong khi phiên vẫn phản hồi. Có thể kích hoạt bằng từ khóa workflow trong prompt, cài đặt /effort ultracode, hoặc lệnh tích hợp sẵn /deep-research. Phát hành ngày 28 tháng 5 năm 2026; yêu cầu Claude Code v2.1.154+.
Cả ba cấp độ trên đều giữ kế hoạch trong một cuộc hội thoại: trong đầu agent chính hoặc trong danh sách nhiệm vụ của agent dẫn dắt. Dynamic Workflows đưa kế hoạch vào trong mã. Claude biểu diễn nhiệm vụ bằng tập lệnh JavaScript, runtime chạy tập lệnh trong môi trường biệt lập, kết quả trung gian nằm trong các biến của tập lệnh thay vì trong ngữ cảnh của bạn, và phiên vẫn phản hồi trong khi các agent làm việc ở chế độ nền.
Một ví dụ cụ thể từ tài liệu chính thức. Bạn nói:
ultracode: audit every API endpoint under src/routes/ for missing auth checks
Claude viết một tập lệnh JavaScript với logic gần như sau: “lấy tất cả tệp từ src/routes/, chia thành các nhóm gồm 30 endpoint, chạy một agent trên mỗi nhóm với cùng một lượt kiểm tra, sau đó chạy hai grader agent độc lập để kiểm tra các phát hiện và tổng hợp báo cáo cuối cùng”. Tập lệnh chạy. Bạn nhận được một bảng kết quả và danh sách endpoint chắc chắn cần được xem xét.
Phù hợp với những việc sau:
- Kiểm tra toàn bộ dự án để tìm một vấn đề (bảo mật, kiểu dữ liệu, API đã bị loại bỏ).
- Các đợt di chuyển lớn (hơn 500 tệp chịu sự điều chỉnh của cùng một quy tắc).
- Câu hỏi nghiên cứu cần được kiểm tra từ nhiều góc độ độc lập (Anthropic dùng cách này trong lệnh
/deep-researchtích hợp sẵn).
Phần phân tích chi tiết về Dynamic Workflows, giới hạn và cách ultracode hoạt động có trong hướng dẫn riêng về Dynamic Workflows trong Claude Code.
Khi nào KHÔNG nên dùng. Khi nhiệm vụ tuyến tính và rõ ràng. Không cần workflow cho việc như “hoàn thành component này”. Workflow hữu ích khi nhiệm vụ chia thành hơn 10 tiểu nhiệm vụ độc lập và cần kiểm tra chéo giữa chúng.
Hạn chế chính. Workflow tiêu thụ nhiều token hơn đáng kể so với phiên thông thường. Anthropic khuyến nghị trong tài liệu của họ:
Dynamic workflows có thể sử dụng nhiều token hơn đáng kể so với một phiên Claude Code thông thường, vì vậy chúng tôi khuyến nghị bắt đầu với một nhiệm vụ có phạm vi giới hạn.
Nói cách khác, hãy chạy workflow đầu tiên trên một thư mục, không phải toàn bộ dự án. Xem chi phí rồi quyết định có nên mở rộng hay không.
Outcomes: bộ tiêu chí đánh giá và agent phản biện độc lập
Điểm chính
Vấn đề chính của multi-agent là các agent tạo ra sản phẩm TRÔNG có vẻ hoàn chỉnh. Một câu trích dẫn có vẻ đúng, một báo cáo có vẻ đầy đủ. Outcomes của Anthropic là agent thứ hai trong ngữ cảnh mới, đọc rubric rồi kiểm tra công việc của agent đầu tiên. Ra mắt ngày 6 tháng 5 năm 2026 tại Code with Claude. Tính năng này giúp tăng mức độ hoàn thành nhiệm vụ 6× tại Harvey và giảm 50% thời gian đánh giá tại Wisedocs.
Điều nguy hiểm nhất khi làm việc với multi-agent là tin vào kết quả của agent. Mỗi agent trả về nội dung trông như công việc đã hoàn tất. Một câu trích dẫn có vẻ đúng, báo cáo có vẻ đầy đủ, quá trình di chuyển có vẻ xong. Khi chỉ có một agent, bạn có thể tự kiểm tra. Khi có 10 agent, bạn không thể — bạn sẽ không có thời gian.
Anthropic giải quyết vấn đề này bằng Outcomes, một tính năng của Managed Agents ra mắt ngày 6 tháng 5 năm 2026. Ý tưởng đơn giản: phiên có thêm agent THỨ HAI (grader), với nhiệm vụ duy nhất là đối chiếu công việc của agent đầu tiên với một rubric nghiêm ngặt.
Cách hoạt động về mặt kỹ thuật: bạn viết một rubric — tài liệu markdown liệt kê chi tiết thế nào là “hoàn tất”, cần kiểm tra nguồn nào và cần dùng nhãn nào. Nền tảng tự động tạo một grader agent trong cửa sổ ngữ cảnh mới. Agent này chỉ nhận rubric và kết quả, không nhận gì khác. Sau mỗi lần agent chính (người viết) thử thực hiện, grader sẽ đọc lại kết quả rồi thông qua hoặc gửi danh sách chi tiết những gì còn thiếu.
Trích dẫn từ Anthropic Cookbook:
Agent giỏi tạo ra những thứ TRÔNG có vẻ hoàn chỉnh. Hãy yêu cầu một agent tạo báo cáo nghiên cứu có trích dẫn, bạn sẽ nhận được một tài liệu trau chuốt kèm chú thích cuối trang. Nhưng nếu xem kỹ hơn, bạn sẽ thấy chủ đề chỉ được đề cập hời hợt, một câu trích dẫn đã lệch khỏi nguồn, hoặc nguồn dẫn đến thông cáo báo chí thay vì tài liệu gốc.
Số liệu tác động thực tế: sau khi tích hợp Outcomes vào Claude Managed Agents, tỷ lệ hoàn thành nhiệm vụ của công ty AI Harvey tăng khoảng 6×. Tại Wisedocs (tài liệu y tế), thời gian đánh giá một tài liệu giảm 50%. Các số liệu này lấy từ thông báo tính năng chính thức.
Điều quan trọng với vibe coder hơn là với doanh nghiệp: Outcomes là một mô hình làm việc, không chỉ là một tính năng cụ thể. Bạn có thể tự tạo grader agent bằng cách mô tả các tiêu chí tương tự trong .claude/agents/grader.md rồi yêu cầu agent chính chạy nó sau mỗi lần thử. Cách này hoạt động với mọi thiết lập multi-agent, không chỉ Managed Agents.
Quy tắc chính khi viết rubric trong cookbook là chỉ định điều có thể xác minh, không phải điều chung chung. Đừng viết “kiểm tra xem bản tóm tắt có đề cập đến thanh toán hay không”, mà hãy viết “mở bản tóm tắt, tìm phần về thanh toán và xác nhận phần đó nêu một khoản tiền bằng $ hoặc tỷ lệ phần trăm doanh thu”. Hướng dẫn đầu cho phép grader đọc lướt rồi đánh dấu. Hướng dẫn thứ hai buộc grader mở tài liệu và tìm một con số cụ thể.
Anti-pattern: “50 agent đang làm chuyện vô nghĩa”
Điểm chính
Sai lầm chính trong mọi thiết lập chạy song song là khởi chạy nhiều agent mà không hiểu mỗi agent đang làm gì. Trên thực tế, trong quá trình tạo một agent AI, suốt 3–4 giờ có tối đa 2–3 luồng công việc song song. Khi một vibe coder khoe “50 agent chạy song song”, điều đó thường có nghĩa là “50 agent đang tạo ra rác song song mà không ai kiểm tra”. Dấu hiệu nhận biết là bạn không thể giải thích trong 30 giây nhiệm vụ cụ thể mà mỗi agent đang giải quyết.
Đây là anti-pattern cốt lõi của multi-agent. Ai đó biết Claude Code có thể chạy 16 agent cùng lúc và Dynamic Workflows có thể chạy 1000 agent mỗi lần, thế là họ ngồi xuống và khởi chạy hết. Kết quả: bằng không. Mức tiêu thụ token: gấp 10 lần một phiên thông thường.
Một phép thử đơn giản. Lấy một tờ giấy và vẽ một ô cho mỗi agent. Trong mỗi ô, hãy ghi:
- Chính xác nó làm gì (một câu).
- Nó tác động đến những tệp nào.
- Nó trả về gì.
- Ai kiểm tra nó.
Nếu không thể trả lời dù chỉ một câu hỏi trong vòng 30 giây thì bạn không nên có agent đó. Quy tắc này áp dụng ở mọi cấp độ: subagents, agent teams, Dynamic Workflows.
Anti-pattern thứ hai là chạy song song công việc đáng lẽ phải làm tuần tự. Nếu frontend cần backend hoàn tất trước vì nó đọc API schema, đừng chạy chúng song song. Làm backend trước rồi đến frontend. Chỉ nên chạy song song những nhiệm vụ độc lập.
Anti-pattern thứ ba là dùng multi-agent để tăng tốc. Cách này chỉ hiệu quả đến một mức nhất định. Nếu chia nhiệm vụ thành bốn luồng công việc độc lập, chúng sẽ hoàn thành trong khoảng thời gian cần cho một luồng (cộng thêm một chút thời gian điều phối). Nhưng nếu có 50 luồng trên cùng một máy, mỗi luồng sẽ chạy chậm hơn vì chúng cùng chia sẻ CPU. Giới hạn thực tế trên laptop là 4–6 phiên bản Claude Code chạy đồng thời; vượt quá mức đó thì bắt đầu bị giảm tốc.
Chi phí là bao nhiêu, và làm thế nào để tránh dùng cạn hạn mức?
Điểm chính
Thiết lập multi-agent tiêu thụ token theo bội số. Subagents: gấp 2×–4× một phiên thông thường. Agent teams: gấp 3×–6×. Dynamic Workflows: gấp 10×–30×. Các quy tắc tiết kiệm chính: chỉ định tệp cho từng agent, đừng chạy workflow trên toàn bộ dự án ngay từ đầu, và kiểm tra chi phí trên một phần nhỏ.
Trong tháng 5–6 năm 2026, ngành công nghiệp phải đối mặt với thực tế rằng lập trình bằng AI tốn kém hơn dự kiến.
Một phiên trò chuyện Claude Code thông thường có chi phí tương đối hợp lý. Bật Dynamic Workflows cho toàn bộ repository thì hóa đơn sẽ cao gấp 20 lần. Từ tài liệu chính thức của Anthropic:
Workflow chạy nhiều agent, vì vậy một lần chạy có thể tiêu thụ nhiều token hơn đáng kể so với việc hoàn thành cùng nhiệm vụ trong một cuộc hội thoại thông thường. Để biết trước chi phí của một lần chạy lớn, hãy thử workflow trên một phần nhỏ.
Thực tế nên làm gì? Sau đây là các quy tắc tiết kiệm từ kinh nghiệm được mô tả.
Chỉ định chính xác tệp cho từng agent. Đừng nói “xem qua dự án và tìm vấn đề”, hãy nói “xem
src/auth/*.tsvà kiểm tra xem mọi hàm có xác thựcuserIdhay không”. Prompt thứ hai sẽ mang lại chính xác công việc mà bạn đang trả tiền để thực hiện.Luôn thử workflow trên một thư mục trước. Đừng bắt đầu với toàn bộ
src/. Hãy bắt đầu từsrc/auth/. Nếu hài lòng với kết quả và hiểu chi phí, bạn có thể triển khai rộng hơn.Mặc định dùng
/effort high, chỉ dùngultracodekhi đã cân nhắc./effort ultracodenghĩa là xhigh cộng với orchestration tự động. Chi phí rất cao. Hãy dùng khi nhiệm vụ thực sự cần nhiều luồng công việc song song.Chuyển subagents sang mô hình nhỏ hơn khi có thể. Nếu sáu subagent đang đánh giá một hướng dẫn, agent QA kiểm tra dấu hiệu AI và agent kiểm tra liên kết nội bộ đều không cần Opus. Sonnet là đủ. Cách này giảm mức sử dụng 3–5 lần.
Xem phân tích chi tiết về tiết kiệm token trong hướng dẫn Token được dùng vào đâu trong Claude Code và Cách không dùng cạn hạn mức Claude Code.
Bắt đầu từ đâu hôm nay: checklist 30 phút
Điểm chính
Không cần nhảy ngay sang Dynamic Workflows. Một thiết lập multi-agent cơ bản mất 30 phút: hai worktree, hai terminal và một checklist chính trong tasks.md. Chừng đó là đủ cho 80% tình huống. 20% còn lại (kiểm tra hoặc di chuyển hệ thống lớn) sẽ đến tự nhiên sau vài tuần.
Cập nhật Claude Code lên v2.1.154+
Đây là phiên bản tối thiểu hỗ trợ Dynamic Workflows. Chạy
claude updatetrong terminal.Bật Dynamic Workflows trong /config
Tính năng này bị tắt theo mặc định trong gói Pro. Mở
/config, tìm dòng “Dynamic workflows” và bật lên. Tính năng đã được bật trong các gói Max, Team và Enterprise.Tạo worktree đầu tiên
Trong thư mục dự án chính, chạy
git worktree add ../<project>-experiment <branch>. Mở một cửa sổ terminal thứ hai trong thư mục đó. Chạyclaude.Thêm danh sách nhiệm vụ dùng chung
Dùng một đường tuyệt đối ngoài mọi worktree.
tasks.mdtrong mỗi worktree là tệp riêng, không tự đồng bộ. Chỉ phiên trưởng ghi; worker đọc danh sách chung và báo kết quả.Tạo thư mục phối hợp và danh sách một lần:
mkdir -p "$HOME/projects/my-app-coordination" printf '%s\n' '# Tasks' '- Auth: assigned to the auth worktree' '- Billing: assigned to the billing worktree' > "$HOME/projects/my-app-coordination/tasks.md"Trong terminal đầu:
cd "$HOME/projects/my-app-auth" printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md" claudeTrong terminal thứ hai:
cd "$HOME/projects/my-app-billing" printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md" claudeCấp cho cả hai tác nhân cùng đường tuyệt đối đã mở rộng được in trên: “Đọc danh sách chung, chỉ làm tác vụ và tệp được giao. Không sửa danh sách; báo hoàn thành và vướng mắc cho trưởng sở hữu cập nhật.” Xác nhận cả hai đọc được đúng tệp trước làm; giải quyết yêu cầu quyền cho đường đó. Danh sách phối hợp trạng thái, mã vẫn ở worktree riêng.
Làm việc theo cách này trong một tuần
Đừng cài GUI wrapper ngay. Hãy làm thủ công với hai worktree trong một tuần. Bạn sẽ thấy còn thiếu gì; sau đó chọn một công cụ để giải quyết một vấn đề cụ thể.
Chỉ sau đó mới bật `/effort ultracode`
Chọn một nhiệm vụ, chẳng hạn “tìm tất cả API endpoint trong src/routes/ không có kiểm tra auth”. Bật
/effort ultracode. Xem workflow Claude viết ra, chi phí bao nhiêu và tạo ra kết quả gì. Đó là Dynamic Workflow đầu tiên của bạn.
Tiếp theo: memory giữa các phiên, Code Review và Multi-Agent v2
Điểm chính
Một thiết lập multi-agent cơ bản xử lý được 80% nhiệm vụ. Ba tính năng tiếp theo đang được kỳ vọng là Managed Agents với Dreaming (memory giữa các phiên), Code Review do một đội agent thực hiện trên mỗi PR, và Multi-Agent Orchestration v2 trong Claude Agent SDK. Tất cả đều đang ở giai đoạn research preview, public beta hoặc mới được công bố với quyền truy cập giới hạn.
Những gì xuất hiện trong tháng 5–6 năm 2026 và hướng phát triển của multi-agent trong Claude Code.
Managed Agents với Dreaming. Ra mắt ngày 6 tháng 5 năm 2026 tại Code with Claude. Đây là một tiến trình theo lịch, đọc transcript trước đó của agent giữa các phiên, xác định các mẫu lặp lại và cập nhật memory của agent. Tỷ lệ hoàn thành nhiệm vụ của công ty AI pháp lý Harvey tăng gấp sáu lần cụ thể sau khi có Dreaming. Vẫn đang ở giai đoạn research preview.
Outcomes như một tính năng Managed Agents. Đã mô tả ở trên. Có thể dùng qua Claude Agent SDK, không có sẵn trực tiếp trong Claude Code CLI. Bạn có thể áp dụng thủ công mô hình tương tự bằng grader subagent ngay bây giờ.
Multi-Agent Orchestration v2 trong Claude Agent SDK. Agent dẫn dắt tự giao việc cho subagents qua hệ thống tệp dùng chung. Đây là bước chuyển từ “tự khởi chạy N subagent” sang “mô tả nhiệm vụ rồi để agent dẫn dắt tự quyết định giao cho ai và giao như thế nào”. Nếu mới học subagents, chưa cần lo về v2. Hãy học cách làm truyền thống — “một agent chính + 3–5 subagent có vai trò riêng” — rồi chuyển sang v2 tự nhiên trong 3–6 tháng.
Code Review do một đội agent thực hiện. Anthropic công bố tại Code with Claude tính năng tự động đánh giá mã khi mở PR. Một đội agent AI kiểm tra diff song song, tìm lỗi, xác minh phát hiện lẫn nhau và xếp hạng theo mức độ nghiêm trọng. Có trong gói Team và Enterprise, chưa có trong Pro.
Plugin Marketplace. Ra mắt ngày 23 tháng 5 năm 2026 trên các phiên bản v2.1.128-136. Một số plugin trên marketplace là các thiết lập multi-agent làm sẵn (parallel-review, security-audit, migration-helper). Bạn có thể cài chúng bằng /plugin install <name>@claude-plugins-official và xem chúng được cấu thành thế nào — đây là cách hay để học cách viết plugin của riêng mình.
Multi-agent trong Claude Code vẫn là tập hợp các thành phần ở những mức độ trưởng thành khác nhau. Subagents và git worktree ổn định, đã được chứng minh và hoạt động ở mọi nơi. Agent teams tự động hóa một nửa, thủ công một nửa. Dynamic Workflows đang ở giai đoạn research preview và thay đổi nhanh chóng. Managed Agents v2 chỉ dành cho doanh nghiệp. Điều đó có nghĩa là trong năm tới, thiết lập tối ưu cho một vibe coder sẽ không phải là bản phát hành mới nhất, mà là thiết lập tối thiểu cần thiết cho nhiệm vụ cụ thể. Hai worktree và một grader subagent là đủ cho một tháng làm việc tích cực. Chỉ tăng độ phức tạp khi bạn bắt đầu cảm thấy bị giới hạn.
Một thiết lập hiệu quả cho vibe coding
Điểm chính
Thiết lập multi-agent chỉ hoạt động khi dựa trên việc quản lý ngữ cảnh có chủ đích. Nếu thiếu điều này, mọi hình thức orchestration song song đều biến thành anti-pattern “50 agent làm chuyện vô nghĩa”.
Tài liệu thực tiễn: tài liệu Ailoot.
Nguồn
- Anthropic - Orchestrate subagents at scale with dynamic workflows (tài liệu chính thức)
- Anthropic - Introducing Dynamic Workflows in Claude Code
- Anthropic Cookbook - Outcomes: các agent tự xác minh công việc của mình
- Anthropic - New in Claude Managed Agents (Dreaming, Outcomes, Multi-Agent v2)
- Claude Code - Chạy agent song song (tài liệu về subagents và agent teams)
Tài liệu và công cụ khác: Ailoot.
Xem thêm chi tiết
Câu hỏi thường gặp
Vì sao hai worktree thấy tasks.md khác nhau?
Mỗi worktree có tệp riêng. Đặt danh sách phối hợp tại một đường tuyệt đối ngoài cả hai, cấp cùng đường đã mở rộng cho mỗi tác nhân và xác minh cả hai đọc được trước khi bắt đầu.
Ai nên cập nhật danh sách tác vụ chung?
Chỉ định một phiên trưởng là writer duy nhất. Worker đọc, chỉ sửa tệp worktree được giao, báo kết quả hoặc vướng mắc cho trưởng; chung đường không tự ngăn ghi đồng thời.