AgentValley để theo dõi Claude Code trên Mac

AgentValley dùng để làm gì? Giải thích dễ hiểu

AgentValley là ứng dụng Mac miễn phí, mã nguồn mở, tập hợp các phiên Claude Code cục bộ vào bảng dưới tai thỏ màn hình. Nói đơn giản, đây là một bảng theo dõi nhỏ giúp biết tác tử nào đang làm việc và tác tử nào chờ bạn trả lời khi bạn dùng ứng dụng khác. Mỗi tác tử có một hàng và nhân vật pixel riêng, kể cả tác tử con được phiên gọi ra. Cần có Claude Code và macOS 15 trở lên.

Cài đặt và theo dõi phiên đầu tiên

1. Tải DMG chính thức, kéo AgentValley vào Applications rồi mở. Có thể dùng Homebrew: brew install --cask morsechimwai/tap/agent-valley.
2. Chạy một phiên Claude Code, đưa con trỏ vào tai thỏ và kiểm tra dự án cùng hành động gần nhất.
3. Từ ứng dụng khác, nhấn Control–Option–Command–A, dùng phím mũi tên chọn hàng và Return để quay về phiên.
4. Muốn trả lời yêu cầu quyền trong bảng, bật “Answer from the notch”, chạy lệnh cài plugin được hiển thị trong phần cài đặt và khởi động lại Claude Code. Đọc yêu cầu trước khi chọn “Allow once” hoặc “Deny”.

Plugin trả lời là lựa chọn bổ sung phải cài thủ công, tách khỏi việc xem trạng thái.

Tìm tác tử đang chờ bạn phản hồi

Các phiên được nhóm theo dự án, bao gồm worktree của dự án đó. Thẻ phiên hiển thị nhiệm vụ, mô hình và bước gần nhất; hàng tác tử con có thêm số bước đã thực hiện. Nhờ vậy bạn dễ phân biệt phần tìm kiếm được giao với công việc chính.

Khi có câu hỏi hoặc yêu cầu quyền, một số đếm màu đỏ xuất hiện cạnh tai thỏ. Mở bảng để đọc nội dung rồi chuyển tới ứng dụng tương ứng. “Go to the session’s tab” giúp Terminal và iTerm2 mở đúng tab. Với Ghostty, hai phiên dùng chung thư mục có thể gây nhầm lẫn khi xác định tab. Âm thanh bật sẵn, có thể tắt hoặc đổi sang tiếng báo đơn giản.

Đọc chi phí, token và giới hạn sử dụng

Nút biểu đồ mở History. Chọn ngày, tuần hoặc tháng rồi xem từng giờ hay các phiên của một dự án. Số tiền được tính theo giá API, hữu ích để so sánh mức tiêu thụ nhưng không tự động là hóa đơn thuê bao. Có thể xuất PDF cho tất cả dự án hoặc một dự án. Lịch sử còn trên Mac ngay cả khi Claude Code dọn tệp cũ.

Bảng cũng hiển thị token trong năm giờ gần nhất và hôm nay, kèm biểu đồ mười hai giờ. “Plan limits” tắt theo mặc định; bật lên sẽ có hạn mức năm giờ, hàng tuần và thời gian đặt lại. Kiểm tra ngày 25 tháng 10 năm 2026: ứng dụng miễn phí, tài trợ tự nguyện. Điều kiện truy cập Claude Code được áp dụng riêng.

Dữ liệu cục bộ và các lựa chọn bổ sung

Mô tả công khai cho biết ứng dụng đọc ~/.claude/projects, ~/.claude/sessions, tiến trình và thông tin Git của dự án. Dữ liệu riêng nằm trong ~/Library/Application Support/AgentValley. Chỉ khi bật “Plan limits”, ứng dụng mới đọc đăng nhập Claude Code từ Keychain và gửi tới api.anthropic.com. Có thể tắt việc kiểm tra cập nhật GitHub hằng ngày.

Dòng trạng thái terminal tùy chọn thay đổi ~/.claude/settings.json, cài phông chữ và thêm một dòng cấu hình Ghostty khi cần. Lệnh gỡ bỏ sẽ hoàn tác các phần bổ sung đó. Dùng tệp cục bộ không đồng nghĩa mọi cấu hình đều không kết nối mạng.

Ai nên dùng công cụ này?

Phù hợp với lập trình viên chạy nhiều phiên cục bộ và thường phải tìm terminal đang chờ. Có thể chuyển bảng sang màn hình được kết nối trong phần cài đặt. Trạng thái “quiet” chỉ nói rằng không có hoạt động ghi trong hai phút, không xác nhận bị treo hay phần trăm hoàn thành. Phạm vi được mô tả là Claude Code trên Mac. Mã ứng dụng dùng giấy phép MIT và dự án độc lập với Anthropic.

Câu hỏi thường gặp

AgentValley có miễn phí không?

Có. Ứng dụng miễn phí và mã nguồn mở; tài trợ là tự nguyện. Điều này không thay thế các điều kiện sử dụng Claude Code.

Chi phí hiển thị có phải hóa đơn không?

Không. History ước tính theo giá API. Khoản thanh toán thực tế phụ thuộc gói và cách tính phí của tài khoản.

Có cần plugin để xem phiên làm việc không?

Không cần cho việc xem thông thường. Plugin được cài thủ công khi muốn cho phép hoặc từ chối yêu cầu từ bảng.

Tải xuống và hỗ trợ chính thức

• Bản phát hành và tải xuống chính thức
• Mã nguồn và hướng dẫn thiết lập
• Báo lỗi và đề xuất qua GitHub Issues