Claude Code Projects: người điều phối, các luồng và hạn chế của bản beta

Gần đây, Anthropic đã thiết kế lại Projects trong Claude Code. Giờ đây, đây là một cuộc trò chuyện điều phối duy nhất, khởi chạy các phiên trên đám mây song song — các luồng — để thực hiện tác vụ và nhận báo cáo từ chúng. Bạn nên tạo một dự án khi công việc có mục tiêu kéo dài hơn một phiên và tạo ra các tác vụ mới — chẳng hạn như phát triển một kho lưu trữ GitHub trong vài tuần. Chỉ riêng nhu cầu làm việc song song là chưa đủ. Nếu bạn cần nhanh chóng sửa một tệp ngay lúc này, một phiên thông thường là đủ.

Người điều phối dẫn dắt công việc — đó là một cuộc trò chuyện kéo dài, trong đó Claude quyết định nội dung nào trong tin nhắn của bạn sẽ được chuyển thành tác vụ cho một luồng. Các luồng viết mã: mỗi luồng là một phiên Claude Code trên đám mây riêng biệt, hoạt động trên nhánh kho lưu trữ riêng. Nhiều luồng có thể chạy cùng lúc, mỗi luồng có ngữ cảnh và nhánh riêng. Người điều phối thấy báo cáo của một luồng khi luồng hoàn thành, nhưng không thấy mọi bước mà luồng thực hiện. Người điều phối báo cho bạn về các yêu cầu kéo đã hoàn thành (yêu cầu hợp nhất các thay đổi) và theo chỉ dẫn của bạn, yêu cầu một luồng chỉnh sửa hoặc hợp nhất chúng. Dưới đây là tổng quan dựa trên tài liệu chính thức của Anthropic: cần cấu hình gì, công việc được tổ chức ra sao và bản beta có những hạn chế nào.

Bản beta đang được triển khai dần, bắt đầu với các tài khoản Pro và Max đã sử dụng phiên Claude Code trên đám mây nhưng chưa tạo dự án trong cuộc trò chuyện thông thường hoặc Cowork. Nếu bạn chưa thấy mục Projects, bạn có thể đăng ký danh sách chờ.

Claude Code Projects là gì, nói đơn giản#

Dự án là một cuộc trò chuyện duy nhất, kéo dài lâu dài với người điều phối, đi kèm các kho lưu trữ, bộ nhớ và hướng dẫn. Bạn nhắn cho người điều phối, rồi người này quyết định trả lời ngay hay khởi chạy một luồng. Bạn không cần tự mở phiên mới cho từng tác vụ.

Luồng là một phiên Claude Code trên đám mây đầy đủ: luồng có ngữ cảnh và nhánh kho lưu trữ riêng, đồng thời mở một yêu cầu kéo khi cần. Người điều phối có thể duy trì nhiều luồng cùng lúc — chẳng hạn, một luồng sửa lỗi, luồng khác viết kiểm thử và luồng thứ ba cập nhật tài liệu — trong khi trả lời câu hỏi của bạn ở cuộc trò chuyện chính.

Để so sánh, hãy hình dung nhiều thẻ, mỗi thẻ là một phiên Claude Code cục bộ trong bản sao làm việc riêng của một kho lưu trữ. Bản sao như vậy được gọi là worktree — một thư mục riêng cho một nhánh để các phiên cục bộ không ảnh hưởng lẫn nhau. Bạn tự chuyển đổi giữa các phiên và quyết định giao việc gì cho từng phiên. Các luồng trên đám mây không cần worktree: mỗi luồng sao chép các kho lưu trữ vào môi trường đám mây biệt lập của riêng nó. Projects đảm nhiệm việc điều phối, quyết định khi nào cần tạo luồng mới và khi nào không cần.

Dự án có bộ nhớ và hướng dẫn dùng chung mà mỗi luồng mới nhận được. Phần thiết lập giải thích nên lưu nội dung gì trong đó và cách chuyển chúng cho các luồng.

Khác gì so với phiên thông thường và nhóm tác nhân#

Nếu bạn đã chạy các tác nhân con lồng nhau trong một phiên Claude Code, bạn nên phân biệt chúng với nhóm tác nhân và các luồng dự án. Nhóm tác nhân là một cách giao việc khác: một phiên khởi chạy các phiên đồng đội để thực hiện một tác vụ cụ thể. Bạn có thể chạy nhóm này trên máy của mình hoặc bên trong một phiên trên đám mây.

• Nhóm tác nhân — các phiên đồng đội cho một tác vụ cụ thể, có thể khởi chạy cục bộ hoặc trên đám mây. Đây không phải là các luồng dự án riêng biệt.
• Dự án và các luồng của dự án — công việc chạy trên đám mây. Mỗi luồng là một phiên riêng trên nhánh riêng và tiếp tục chạy ngay cả sau khi bạn đóng máy tính xách tay. Một phiên cục bộ không thể thuộc về dự án.
• Chế độ xem tác nhân — màn hình để theo dõi nhiều phiên cục bộ trên máy của bạn. Chế độ này không có người điều phối: bạn quyết định giao việc gì cho từng phiên.

Tài liệu chính thức của Anthropic nhấn mạnh một điểm riêng: chỉ làm việc song song không phải là lý do để tạo dự án. Trong một dự án, Claude tự khởi chạy các phiên và nhận báo cáo từ chúng; tất cả các phiên đều bắt đầu với kho lưu trữ, hướng dẫn và bộ nhớ dùng chung. Công việc luôn nằm trên đám mây trong suốt quá trình thực hiện tác vụ.

Một cách tiếp cận tương tự — người điều phối phân công tác vụ cho các tác nhân — được triển khai trong một công cụ khác, được đề cập trong bài viết về Cursor Projects. Cơ chế khác nhau, nhưng người điều phối cũng quyết định giao việc gì cho ai.

Cần cấu hình gì trước khi tạo dự án đầu tiên#

Trước khi tạo dự án, hãy kiểm tra ba điều.

1. Tài khoản GitHub và Claude GitHub App. Nếu bạn đã kết nối GitHub qua /web-setup, mã thông báo đó cho phép các phiên trên đám mây thông thường truy cập kho lưu trữ. Nhưng như vậy chưa đủ cho các luồng dự án: bạn cần một tài khoản GitHub đã kết nối có quyền push vào kho lưu trữ và Claude GitHub App được cài đặt cho kho lưu trữ đó. Nếu không có các quyền này, luồng không thể sao chép kho lưu trữ hoặc mở yêu cầu kéo.

2. Hướng dẫn dự án. Hướng dẫn dự án là văn bản dài tối đa 16 000 ký tự, được gửi cho mỗi luồng mới và chính người điều phối. Hãy lưu tại đây những thông tin mà nếu không, bạn sẽ phải giải thích lại trong từng phiên: cấu trúc kho lưu trữ, quy ước viết mã và các bước kiểm tra cần thực hiện trước khi mở yêu cầu kéo.

3. Mô hình và mức độ nỗ lực. Theo mặc định, dự án mới chạy mỗi luồng bằng mô hình Opus với mức nỗ lực cao, còn người điều phối ở mức nỗ lực thấp. Tài liệu cho biết cài đặt này “tiêu hao hạn mức gói của bạn nhanh nhất” (bản dịch; nguyên văn: draws on your plan fastest). Nếu tác vụ của bạn đơn giản, bạn có thể chọn mô hình ít tốn kém hơn hoặc giảm mức nỗ lực trong Project settings > General. Cài đặt cho luồng và người điều phối được thay đổi riêng; tài liệu mô tả các lựa chọn tiết kiệm hơn.

Bộ nhớ dự án được lưu dưới dạng các tệp thông thường, với một tệp chỉ mục tên là MEMORY.md. Mỗi luồng mới đọc tệp này khi khởi động và truy cập các tệp khác khi cần. Những phát hiện được một luồng lưu vào bộ nhớ sẽ sẵn có cho luồng tiếp theo mà không cần kể lại.

Cần làm gì nếu các luồng thay đổi cùng một phần mã#

Mỗi luồng làm việc trên nhánh riêng và tự mở yêu cầu kéo nếu công việc cần đến. Tuy nhiên, người điều phối không đảm bảo rằng các tác vụ sẽ không bao giờ trùng lặp: nếu nhiều luồng cùng làm một khu vực trong mã, bạn có thể yêu cầu luồng liên quan xử lý xung đột qua giao diện. Nút Resolve conflicts bên cạnh yêu cầu kéo sẽ gửi chỉ dẫn đến luồng dưới dạng tin nhắn từ bạn.

Tài liệu chính thức gợi ý nêu rõ sở thích về số lượng luồng trong hướng dẫn dự án: chẳng hạn, yêu cầu người điều phối không chạy quá hai luồng cùng lúc hoặc dùng lại một luồng hiện có cho các tác vụ mới trong cùng khu vực. Đây là sở thích mà người điều phối cố gắng làm theo, chứ không phải giới hạn cứng. Tự nó không đảm bảo các luồng sẽ không xung đột trong cùng một tệp — cần xử lý riêng xung đột đã phát sinh. Với các tác vụ liên quan trong cùng khu vực, bạn có thể dùng lại một luồng đang hoạt động hoặc đang rảnh. Nếu luồng đã rảnh hơn một giờ, luồng sẽ đọc lại toàn bộ lịch sử khi nhận tin nhắn mới, điều này ảnh hưởng đến mức sử dụng hạn mức gói đăng ký.

Các tác vụ càng được phân tách rõ theo tệp hoặc mô-đun thì càng dễ làm việc song song. Một bài viết riêng trình bày cách chia một tác vụ lớn thành các phần độc lập: cách giao việc lập trình cho hàng nghìn tác nhân. Quy mô ở đó khác nhau, nhưng nguyên tắc chia nhỏ công việc vẫn giống nhau.

Khi bộ nhớ đệm cuộc trò chuyện còn hoạt động (trên gói Pro và Max, trong vòng một giờ, nếu giới hạn gói của bạn cho phép), luồng dùng ít token hơn từ hạn mức gói đăng ký để xử lý lại lịch sử. Khi bộ nhớ đệm hết hạn, luồng đọc lại toàn bộ lịch sử mỗi khi nhận tin nhắn mới, trước khi bắt đầu làm việc. Với một tác vụ độc lập mới, yêu cầu người điều phối tạo luồng mới có thể tiết kiệm hơn: cách này có thể dùng ít token hơn từ cùng hạn mức gói đăng ký so với việc tiếp tục một phiên cũ có lịch sử dài sau khi bộ nhớ đệm hết hạn.

Những hạn chế của bản beta cần biết trước#

Trước khi tạo dự án cho một tác vụ quan trọng, hãy kiểm tra các hạn chế của bản beta:

• Chỉ khả dụng trên Pro và Max. Team và Enterprise chưa được hỗ trợ.
• Giới hạn 200 luồng mới mỗi ngày cho mỗi tài khoản, tính gộp trên tất cả dự án.
• Dự án thuộc về một người dùng. Bạn không thể chia sẻ quyền truy cập dự án hoặc một luồng riêng lẻ với người khác; bản beta cũng không có cài đặt tổ chức dành cho nhóm.
• Chỉ truy cập được qua claude.ai/code, ứng dụng máy tính để bàn và ứng dụng di động. Projects không hoạt động trong CLI của terminal, qua Amazon Bedrock, Google Cloud Agent Platform hoặc Microsoft Foundry.
• Dự án không thể truy cập tệp và công cụ cục bộ. Các luồng làm việc với kho lưu trữ GitHub, tệp đã tải lên và thư mục Google Drive, nhưng không làm việc được với những thứ chỉ có trên máy của bạn.

Nếu bạn cần truy cập terminal hoặc các công cụ chỉ có trên máy của mình, hãy dùng một phiên cục bộ hoặc chế độ xem tác nhân để theo dõi nhiều phiên như vậy. Nếu nhiều người cần cộng tác trong cùng một không gian làm việc, Anthropic có sản phẩm riêng dành cho nhóm trên Team và Enterprise: Claude Tag. Sản phẩm này hoạt động trong một kênh Slack; bất kỳ thành viên nào cũng có thể giao việc cho Claude, và mọi người trong kênh đều có thể xem và chỉ đạo công việc. Dự án hoạt động khác: chỉ thuộc về bạn. Nếu bạn chỉ cần một số tệp cục bộ cụ thể, bạn có thể tải chúng lên dự án, rồi mỗi luồng sẽ có quyền truy cập vào chúng. Việc này không cung cấp quyền truy cập vào các công cụ cục bộ.

Tiếp theo nên làm gì#

Trước khi chuyển quy trình làm việc sang Projects, hãy thử tạo một dự án thử nghiệm trên một kho lưu trữ không quan trọng: kết nối GitHub App, viết hướng dẫn ngắn, giao cho người điều phối một tác vụ độc lập và xem cách người này xử lý. Lần chạy đầu tiên sẽ cho thấy bạn có hiểu giao diện của người điều phối và luồng hay không. Lần thử này không kiểm tra công việc song song, xung đột hoặc mức sử dụng hạn mức giữa nhiều tác vụ — những nội dung đó cần được kiểm tra riêng.