Bài viết
Giới thiệu Deckhand: Biến Claude Code thành trung tâm điều phối các AI bên thứ ba
Deckhand là plugin nguồn mở dành cho Claude Code, bổ sung một thanh công cụ ngay phía trên ô nhập liệu: ủy thác tác vụ ở chế độ chỉ đọc sang Codex, Cursor agent, agy để lấy ý kiến thứ hai, phân bổ sub-agent chạy song song với Sub5, đồng thời cung cấp chỉ số mức sử dụng và chuyển đổi model. Bài viết này hướng dẫn cách cài đặt, cách dùng từng tính năng, luồng dữ liệu và các hạn chế đã biết.
· 8 phút đọc
Deckhand là một plugin dành cho Claude Code, bổ sung một thanh công cụ ngay phía trên ô nhập liệu. Claude vẫn đóng vai trò là agent chính; thanh công cụ cho phép chuyển giao tác vụ cho Codex, Cursor agent hoặc agy xử lý ở chế độ chỉ đọc (read-only), sau khi có kết quả trả về, Claude sẽ đánh giá lại rồi mới quyết định có áp dụng hay không.
Thanh công cụ cũng cung cấp các chỉ số mức sử dụng, chuyển đổi model, và Sub5 để chia nhỏ tác vụ cho nhiều sub-agent xử lý song song. Plugin hoạt động trên cả terminal lẫn Desktop App. Phiên bản hiện tại là 1.1.1, giấy phép MIT.
Minh bạch: Deckhand do tác giả trang web này phát triển.
Tổng quan tính năng#
| Khối |
Tính năng |
cL cS cA cR gF |
Chuyển giao tác vụ ở chế độ chỉ đọc cho một AI CLI khác, sau đó để Claude đánh giá lại câu trả lời |
Sub5 |
Chia tác vụ hiện tại thành tối đa 5 phần, giao cho các sub-agent xử lý song song trên từng git worktree riêng biệt |
O F S H |
Chuyển sang Opus, Fable, Sonnet hoặc Haiku |
| Chỉ số mức sử dụng |
Khung 5 giờ, khung hàng tuần theo từng model, khung hàng tuần tổng hợp của tất cả model, context window |
Recap |
Giải thích ngữ cảnh hiện tại ở khung bên cạnh |
⚙ |
Mở khung cài đặt |
Cài đặt và yêu cầu hệ thống#
Chạy các lệnh sau trong Claude Code:
/plugin marketplace add stephen-taipei/deckhand
/plugin install deckhand@deckhand
Nếu thanh công cụ không xuất hiện, hãy mở một phiên làm việc mới.
Yêu cầu:
- macOS hoặc Linux. Windows hiện chưa được kiểm thử.
- Claude Code có hỗ trợ module plugin hook, đã kiểm thử trên 2.1.288.
- Python 3.9 trở lên.
- Tùy chọn: Tính năng giám sát cần
gh; các nút ủy thác cần CLI của codex, Cursor agent hoặc agy. Nút tương ứng sẽ bị ẩn nếu CLI chưa được cài đặt.
Ủy thác: Ý kiến thứ hai ở chế độ chỉ đọc#
Khi nhấn nút ủy thác, Deckhand sẽ chuyển giao tác vụ cho CLI tương ứng. CLI này chỉ có quyền đọc, không thể chỉnh sửa, sau khi xuất câu trả lời sẽ gửi lại cho Claude đánh giá.
Các mục tiêu ủy thác mặc định:
| Nút |
CLI |
Model |
Effort |
cL |
Codex |
GPT-6 Luna |
max |
cS |
Codex |
GPT-6.1 Sol |
medium |
cA |
Codex |
GPT-6 Astra |
medium |
cR |
Cursor agent |
Grok 4.7 |
high |
gF |
agy |
Gemini 3.8 Flash |
high |
Nhãn, CLI, model ID, effort và tên hiển thị đều có thể tùy chỉnh trong phần cài đặt.
Chế độ chỉ đọc được thực thi nghiêm ngặt thông qua flag hoặc mode của từng CLI:
- Codex:
-s read-only
- Cursor agent:
--mode ask
- agy: headless mode, các lệnh gọi tool sẽ tự động bị từ chối
Trước khi gửi đi, Deckhand sẽ quét qua mô tả tác vụ; nếu phát hiện có token, API key hoặc mật khẩu thì sẽ từ chối gửi. Mô tả tác vụ và câu trả lời được lưu trữ trong thư mục tạm riêng tư và tự động xóa sau 3 ngày.
Trong lúc lệnh ủy thác đang chạy, phía trên thanh mức sử dụng sẽ xuất hiện thêm một dòng hiển thị nhãn, CLI, model và thời gian đã thực thi. Lệnh /delegates liệt kê các tác vụ ủy thác trong 3 ngày gần nhất; bạn có thể mở, sao chép hoặc đưa từng câu trả lời trở lại ô nhập liệu, đồng thời xem số lượng token do CLI báo cáo.
Việc ủy thác sẽ gửi mô tả tác vụ đến nhà cung cấp dịch vụ đứng sau CLI đó.
Sub5: Sub-agent song song#
Sub5 chia tác vụ hiện tại thành tối đa 5 hạng mục độc lập nhau, mỗi hạng mục do một sub-agent xử lý trong git worktree riêng của nó. Khi tất cả hoàn tất, agent chính sẽ xem xét kết quả, tích hợp các thay đổi, sau đó dọn dẹp worktree và branch.
Các thao tác git được thực thi qua script bin/sub5.py, không sử dụng force và không push. Model, effort và số lượng hạng mục tối đa của sub-agent có thể điều chỉnh trong phần cài đặt.
Khi một lượt chạy (run) bị gián đoạn (turn bị dừng, worker gặp lỗi, phiên làm việc bị đóng), worktree và branch có thể còn sót lại. Lệnh /sub5-clean sẽ liệt kê các tàn dư này; sau khi bạn xác nhận, lệnh sẽ chỉ dọn sạch những worktree không có thay đổi chưa commit và các branch đã được merge; những tài nguyên được dùng trong vòng một giờ gần nhất sẽ được giữ lại.
Nếu các hạng mục có sự phụ thuộc lẫn nhau, Sub5 sẽ không phù hợp vì việc xử lý song song chỉ làm tăng xung đột khi merge.
Chuyển đổi model#
O F S H lần lượt tương ứng với Opus, Fable, Sonnet, Haiku.
- Terminal: Chuyển đổi trực tiếp model của phiên làm việc hiện tại, giữ nguyên mức effort ban đầu.
- Desktop App: Claude Code không cho phép plugin gửi các prompt bắt đầu bằng dấu
/, đồng thời App cũng không cho phép phiên làm việc tự đổi model của chính nó. Do đó, nút bấm sẽ điền model ID đầy đủ dạng /model claude-opus-5-5 vào ô nhập liệu. Model chỉ được chuyển đổi sau khi bạn nhấn Enter, sau đó Deckhand sẽ đặt effort trở lại mức ban đầu.
Chỉ số mức sử dụng#
5h: Khung 5 giờ.fb, sn, op: Khung hàng tuần của từng model thuộc tài khoản.7d: Khung hàng tuần tổng hợp của tất cả model.ctx: Tỷ lệ sử dụng context window.
Các con số khớp với thẻ mức sử dụng trên Claude App, được làm tròn xuống. Khi bất kỳ khung nào vượt quá ngưỡng cảnh báo, Deckhand sẽ thông báo một lần; bạn có thể điều chỉnh ngưỡng này trong phần cài đặt.
Recap#
Recap hiển thị ngữ cảnh đầy đủ hiện tại bằng ngôn ngữ tự nhiên, dễ hiểu ở khung bên cạnh mà không chèn thêm bất kỳ nội dung nào vào đoạn chat.
Công cụ giám sát và bảo vệ#
| Công cụ |
Mục đích |
/watch-deploy, watch_deploy |
Giám sát PR, tiến trình CI hoặc URL ở chế độ nền; tự động dừng khi kết quả không đổi sau N lần liên tiếp |
| Chống polling |
Ngăn chặn các vòng lặp polling dùng sleep và các lệnh chờ gây block như gh run watch |
| Bảo vệ thông tin tác giả |
Loại bỏ trailer Co-Authored-By và footer của Claude Code khỏi các lệnh commit và PR |
/handoff, /handoff-in, /codex |
Bàn giao công việc qua lại giữa Claude và Codex |
translate |
Giao cho mục tiêu ủy thác được chỉ định thực hiện dịch thuật bản địa hóa, mặc định tắt |
search |
Giao cho mục tiêu ủy thác được chỉ định tìm kiếm trên web kèm nguồn trích dẫn, sau đó để Claude đối chiếu xác minh, mặc định tắt |
Cài đặt#
Nhấp vào biểu tượng ⚙ ở góc ngoài cùng bên phải thanh công cụ, hoặc chạy /deckhand để mở khung cài đặt. Khung cài đặt gồm 5 tab: Chung, Ủy thác, Dịch thuật & Tìm kiếm, Sub5, Nâng cao. Cấu hình được lưu trên máy cục bộ, có thể xuất ra file JSON để import sang máy khác.
Giao diện hỗ trợ English, 繁體中文, 简体中文, 日本語 và 한국어, mặc định đồng bộ theo thiết lập language của Claude Code.
Luồng dữ liệu#
Dữ liệu rời khỏi máy tính của bạn chỉ bao gồm ba loại sau:
- Mô tả tác vụ ủy thác: Được gửi tới nhà cung cấp dịch vụ của CLI đã chọn khi bạn nhấn nút ủy thác.
- Chỉ số mức sử dụng: Gọi endpoint đo lường của Anthropic thông qua Claude Code bằng thông tin xác thực của phiên làm việc hiện tại.
- Các công cụ được gọi chủ động:
translate và search gửi dữ liệu tới mục tiêu ủy thác được chỉ định; tính năng giám sát truy vấn GitHub qua gh hoặc đọc URL được chỉ định.
Các hạn chế đã biết#
- Windows hiện vẫn đang chờ kiểm thử.
- Các nút model trên Desktop App không thể chuyển đổi chỉ bằng một cú nhấp chuột mà cần nhấn Enter tại ô nhập liệu.
- Tác vụ ủy thác không có nút dừng: Deckhand chỉ theo dõi tiến trình gọi Bash thực thi việc ủy thác chứ không thể hủy lệnh đó.
- Mô tả tác vụ ủy thác sẽ được gửi tới các nhà cung cấp dịch vụ bên thứ ba.
Mã nguồn và tài liệu đầy đủ có tại GitHub. Deckhand là plugin được phát triển độc lập, không phải là sản phẩm của Anthropic.