Quản lý nhiều agent với agent view

Chú ý

Agent view đang ở giai đoạn research preview, yêu cầu Claude Code v2.1.139 trở lên. Giao diện và phím tắt có thể thay đổi khi tính năng phát triển thêm. Kiểm tra phiên bản bằng claude --version.

Agent view, mở bằng claude agents, là một màn hình duy nhất cho tất cả background session (phiên chạy nền) của bạn: cái nào đang chạy, cái nào cần bạn trả lời, cái nào đã xong. Bạn dispatch (giao) phiên mới, theo dõi trạng thái nhanh thay vì cuộn qua transcript, và chỉ can thiệp khi có phiên cần bạn. Mỗi background session là một hội thoại Claude Code đầy đủ, tiếp tục chạy dù không có terminal nào gắn vào - bạn có thể mở, trả lời, rồi rời đi bất cứ lúc nào.

Dùng agent view khi bạn có nhiều việc độc lập mà Claude có thể tự làm mà không cần bạn theo dõi từng bước: dispatch một fix bug, một review PR, một điều tra flaky test - mỗi cái một dòng - rồi quay lại làm việc khác và kiểm tra khi có dòng nào báo cần bạn hoặc đã có kết quả.

Quick start

1. Mở agent view: chạy claude agents từ shell. Nhấn Esc bất cứ lúc nào để quay lại shell.
2. Dispatch một phiên: gõ một prompt mô tả việc cần làm rồi Enter. Một background session mới bắt đầu, hiện thành một dòng cho biết đang làm, đang chờ bạn, hay đã xong. Gõ tiếp một prompt khác và Enter sẽ tạo phiên thứ hai song song, không phải gửi follow-up cho phiên cũ.
3. Peek và trả lời: chọn một dòng bằng phím mũi tên, nhấn Space để mở panel xem nhanh (peek). Panel hiện output gần nhất hoặc câu hỏi phiên đang chờ. Gõ trả lời và Enter để gửi mà không cần rời agent view.
4. Attach và detach: nhấn Enter hoặc → trên một dòng để attach - phiên chiếm toàn bộ terminal như một session tương tác đầy đủ. Nhấn ← khi prompt trống để detach quay lại bảng danh sách.
5. Đưa phiên đang mở vào agent view: chạy /bg (hoặc alias /background) trong một phiên claude thường, hoặc nhấn ← khi prompt trống để vừa background phiên vừa mở agent view trong một bước.

Bạn có thể dùng claude agents như điểm vào chính thay cho claude: dispatch mọi việc từ agent view, attach khi cần hội thoại đầy đủ, ← để quay lại bảng.

Theo dõi phiên

Chạy claude agents mở toàn màn hình, liệt kê mọi phiên theo nhóm trạng thái, phiên cần bạn và đã pin nằm trên cùng. Mặc định danh sách hiện mọi background session bạn từng tạo, ở mọi project. Muốn thu hẹp về một project, thêm --cwd:

claude agents --cwd ~/projects/my-app

Đọc trạng thái phiên

Mỗi dòng bắt đầu bằng một icon cho biết trạng thái:

Trạng thái	Icon	Ý nghĩa
Working	Animated	Claude đang chạy tool hoặc sinh phản hồi
Needs input	Vàng	Claude đang chờ thứ chỉ bạn cung cấp được: trả lời câu hỏi, quyết định permission, cảnh báo sandbox…
Idle	Mờ	Phiên không có việc gì để làm, sẵn sàng nhận prompt tiếp theo
Completed	Xanh lá	Việc đã hoàn thành
Failed	Đỏ	Việc kết thúc bằng lỗi
Stopped	Xám	Phiên bị dừng bằng Ctrl+X hoặc claude stop

Riêng hình dạng icon cho biết tiến trình bên dưới còn sống hay không: ✻/animated ✽ là tiến trình còn sống, ∙ là tiến trình đã thoát (vẫn peek/reply/attach được, Claude sẽ khởi động lại từ chỗ dừng), ✢ là phiên /loop đang ngủ giữa các lần lặp.

Khi có pull request được mở, nhãn #N xuất hiện ở cuối dòng, màu theo trạng thái PR: vàng (đang chờ check/review), xanh lá (check pass), tím (đã merge), xám (draft/closed).

Peek và trả lời

Nhấn Space trên dòng đã chọn để mở peek panel - hiện câu hỏi chính xác (nếu đang chờ), kết quả (nếu đã xong), hoặc câu trạng thái đầy đủ (nếu đang chạy). Gõ trả lời rồi Enter để gửi; nếu Claude hỏi có lựa chọn định sẵn, panel hiện danh sách đánh số để bạn chọn bằng phím số. Prefix ! để gửi lệnh Bash thay vì trả lời thường.

Attach vào một phiên

Nhấn Enter hoặc → để attach - agent view được thay bằng phiên tương tác đầy đủ, Claude tóm tắt nhanh những gì xảy ra trong lúc bạn vắng mặt. Khi đang attach, mọi command, phím tắt, tính năng hoạt động bình thường. Nhấn ← khi prompt trống, hoặc /exit, để detach quay lại agent view - detach không bao giờ dừng phiên chạy nền.

Sắp xếp danh sách

Ctrl+S chuyển giữa nhóm theo trạng thái và theo thư mục. Trong một nhóm: Ctrl+T để pin lên đầu, Shift+↑/Shift+↓ để sắp xếp lại, Ctrl+R để đổi tên, Enter trên header nhóm để thu gọn. Ctrl+X để dừng, Ctrl+X lần nữa trong 2 giây để xoá phiên khỏi danh sách (xoá cả worktree Claude tạo cho phiên đó nếu an toàn).

Lọc phiên

Gõ vào ô dispatch để lọc thay vì tạo phiên mới: a:<tên> (agent cụ thể), s:<trạng thái> (ví dụ s:working, hoặc s:blocked cho mọi phiên đang chờ bạn), #<số> hoặc URL PR, hoặc bất kỳ URL nào khớp với prompt đầu tiên của phiên.

Phím tắt chính

Phím	Hành động
↑/↓	Di chuyển giữa các dòng
Enter	Attach (hoặc dispatch nếu ô nhập có text)
Space	Mở/đóng peek panel
Shift+Enter	Dispatch và attach ngay
→	Attach
Ctrl+S	Chuyển cách nhóm (trạng thái/thư mục)
Ctrl+T	Pin/unpin
Ctrl+R	Đổi tên
Ctrl+X	Dừng phiên; nhấn lần nữa trong 2s để xoá
Esc	Đóng panel, xoá input, hoặc thoát

Dispatch agent mới

Bạn có thể dispatch từ agent view, gửi/copy phiên tương tác đang mở sang chạy nền, hoặc khởi động thẳng từ shell.

Từ agent view

Gõ prompt ở ô input dưới cùng, Enter để tạo phiên mới - tên được sinh tự động, đổi lại bằng Ctrl+R. Một số cú pháp đặc biệt:

Nhập	Hiệu ứng
<tên-subagent> <prompt>	Chạy subagent đó làm main agent của phiên
@<tên-subagent>	Mention một subagent bất kỳ đâu trong prompt để chạy nó làm main agent
@<repo>	Chạy phiên trong repo đó
/<command>	Gợi ý skill/command để dispatch làm prompt
! <command>	Chạy lệnh shell như một job nền thay vì phiên Claude
#<số> hoặc URL PR	Chọn phiên đang làm PR đó thay vì tạo mới
Shift+Enter	Dispatch và attach ngay lập tức

Từ trong một phiên

• /background (alias /bg): chuyển hội thoại hiện tại vào chạy nền, giải phóng terminal.
• /fork: copy hội thoại hiện tại vào một background session mới trong khi bản gốc vẫn tiếp tục chạy. Từ thời điểm đó hai phiên độc lập hoàn toàn.

Từ shell

claude --bg "investigate the flaky SettingsChangeDetector test"

Dùng --agent để chỉ định subagent làm main agent, --name để đặt tên hiển thị:

claude --bg --name "flaky-test-fix" "investigate the flaky test"

Chạy lệnh shell như job nền (không dùng model) bằng --exec:

claude --bg --exec 'pytest -x'

Cách ly file edit

Mỗi background session, trước khi sửa file, tự chuyển vào một git worktree cách ly dưới .claude/worktrees/, để các phiên song song đọc chung checkout nhưng ghi vào chỗ riêng. Bỏ qua worktree khi phiên đã ở trong worktree sẵn, thư mục không phải git repo, hoặc ghi ngoài working directory. Tắt cách ly bằng worktree.bgIsolation: "none" trong .claude/settings.json.

Một phiên đã cách ly công việc trong worktree sẽ tự commit, push nhánh riêng, và mở draft pull request mà không cần hỏi trước - không bao giờ push vào main/master, không force-push hay merge.

Đặt model, permission mode

Model mặc định cho các phiên dispatch từ agent view lấy từ setting model của bạn; đổi bằng /model trong dispatch input hoặc trong picker. Permission mode phụ thuộc cách bạn khởi động: background một phiên sẵn có bằng /bg/← giữ nguyên mode hiện tại, còn dispatch từ input hoặc claude --bg dùng defaultMode của project đó.

Đặt mặc định cho cả phiên agent view:

claude agents --permission-mode plan --model opus --effort high

Quản lý phiên từ shell

Lệnh	Mục đích
claude agents	Mở agent view
claude agents --json	In danh sách phiên dạng JSON
claude attach <id>	Attach vào phiên trong terminal này
claude logs <id>	In output gần nhất
claude stop <id>	Dừng phiên (alias claude kill)
claude respawn <id>	Khởi động lại phiên, giữ nguyên hội thoại
claude rm <id>	Xoá phiên khỏi danh sách
claude daemon status	In trạng thái supervisor

Cơ chế hoạt động (tóm tắt)

Background session được host bởi một supervisor process riêng, tách khỏi terminal và agent view, tự khởi động khi bạn background phiên đầu tiên. Supervisor giữ sẵn một worker “pre-warmed” để dispatch không bị delay cold-start. Một phiên đã hoàn thành và không ai attach khoảng một giờ sẽ bị supervisor dừng tiến trình để giải phóng tài nguyên (trừ phiên đã pin) - attach lại sẽ khởi động tiến trình mới từ đúng chỗ dừng.

Chú ý

Chi tiết kỹ thuật sâu (biến môi trường, cách carry-over công việc nền qua restart, cấu trúc ~/.claude/jobs/…) thay đổi khá nhanh qua các bản Claude Code. Nếu cần chính xác tuyệt đối, kiểm tra lại tài liệu gốc.

Tắt agent view

Đặt setting disableAgentView: true hoặc biến môi trường CLAUDE_CODE_DISABLE_AGENT_VIEW. Quản trị viên có thể ép qua managed settings.

Giới hạn hiện tại

• Rate limit áp dụng bình thường: background session tiêu quota giống phiên tương tác - chạy 10 agent song song tốn quota nhanh gấp ~10 lần.
• Chạy local: các phiên chạy trên máy bạn, được giữ nguyên qua sleep, nhưng dừng khi máy tắt.
• Worktree do Claude tạo bị xoá cùng phiên trong agent view: commit trước khi xoá phiên đã sửa file trong worktree riêng. Worktree có commit chưa push sẽ được giữ lại cùng phiên.

Xem thêm

• Chạy nhiều agent song song: so sánh agent view với subagent, agent team, worktree.
• Agent team: nhiều phiên phối hợp nhắn tin qua lại.

Nguồn

Dịch và biên soạn từ Manage multiple agents with agent view.