Artykuły
Deckhand: zrób z Claude Code swoją zewnętrzną konsolę sterowania AI
Deckhand to open source'owa wtyczka do Claude Code, która dodaje pasek narzędzi nad polem wprowadzania: przekazuje zadania w trybie tylko do odczytu do Codexa, Cursor agent i agy po drugą opinię, rozsyła równolegle subagenty przez Sub5 oraz pokazuje wskaźniki zużycia i przełącza modele. Ten tekst opisuje instalację, użycie poszczególnych funkcji, przepływ danych i znane ograniczenia.
· 5 min czytania
Deckhand to wtyczka do Claude Code, która dodaje pasek narzędzi nad polem wprowadzania. Claude nadal jest głównym agentem; z paska można przekazać zadanie do Codexa, Cursor agent lub agy w trybie tylko do odczytu, a gdy odpowiedź wróci, Claude ją sprawdza i decyduje, czy ją przyjąć.
Pasek zawiera też wskaźniki zużycia, przełączanie modeli oraz Sub5, który dzieli zadanie na części i przetwarza je równolegle w wielu subagentach. Działa zarówno w terminalu, jak i w aplikacji desktopowej. Obecna wersja to 1.1.1, licencja MIT.
Ujawnienie: Deckhand został napisany przez autora tej strony.
Przegląd funkcji#
| Sekcja |
Funkcja |
cL cS cA cR gF |
Przekazuje zadanie innemu CLI AI w trybie tylko do odczytu, a odpowiedź sprawdza Claude |
Sub5 |
Dzieli bieżące zadanie na maksymalnie 5 części i przekazuje je subagentom do równoległej pracy, każdemu w osobnym git worktree |
O F S H |
Przełącza na Opus, Fable, Sonnet lub Haiku |
| Wskaźniki zużycia |
Okno 5-godzinne, tygodniowe okna poszczególnych modeli, tygodniowe okno łączne dla wszystkich modeli, okno kontekstu |
Recap |
Wyjaśnia bieżący kontekst w panelu bocznym |
⚙ |
Otwiera panel ustawień |
Instalacja i wymagania#
Uruchom w Claude Code:
/plugin marketplace add stephen-taipei/deckhand
/plugin install deckhand@deckhand
Jeśli pasek narzędzi się nie pojawi, otwórz nową sesję.
Wymagania:
- macOS lub Linux. Windows czeka jeszcze na testy.
- Claude Code obsługujący moduły hook wtyczek, przetestowany na wersji 2.1.288.
- Python 3.9 lub nowszy.
- Opcjonalnie: funkcja obserwowania wymaga
gh; przyciski delegowania wymagają CLI codex, Cursor agent lub agy. Przyciski odpowiadające niezainstalowanym CLI są ukryte.
Delegowanie: druga opinia w trybie tylko do odczytu#
Po naciśnięciu przycisku delegowania Deckhand przekazuje zadanie odpowiedniemu CLI. Druga strona może tylko czytać, nie może niczego zmieniać; zapisuje odpowiedź i oddaje ją Claude'owi do sprawdzenia.
Domyślne cele delegowania:
| Przycisk |
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 |
Etykiety, CLI, identyfikatory modeli, effort i nazwy można zmieniać w ustawieniach.
Tryb tylko do odczytu wymusza flaga lub tryb samego CLI:
- Codex:
-s read-only
- Cursor agent:
--mode ask
- agy: tryb headless, wywołania narzędzi są automatycznie odrzucane
Przed wysłaniem Deckhand sprawdza opis zadania; jeśli zawiera token, klucz lub hasło, odmawia wysłania. Opis zadania i odpowiedź są przechowywane w prywatnym folderze tymczasowym i usuwane po 3 dniach.
Podczas delegowania nad paskiem zużycia pojawia się dodatkowy wiersz z etykietą, CLI, modelem i czasem, który upłynął od startu. /delegates wyświetla delegowania z ostatnich 3 dni; każdą odpowiedź można otworzyć, skopiować lub wstawić z powrotem do pola wprowadzania, a widoczna jest też liczba tokenów zgłoszona przez CLI.
Delegowanie wysyła opis zadania do dostawcy usługi stojącego za danym CLI.
Sub5: równoległe subagenty#
Sub5 dzieli bieżące zadanie na maksymalnie 5 niezależnych elementów, a każdy element przetwarza jeden subagent we własnym git worktree. Gdy wszystkie skończą, główny agent sprawdza wyniki, scala zmiany oraz sprząta worktree i gałęzie.
Operacje git wykonuje skrypt bin/sub5.py, bez force i bez push. Model, effort i maksymalną liczbę elementów dla subagentów można zmienić w ustawieniach.
Gdy run zostanie przerwany (tura zatrzymana, błąd workera, zamknięcie sesji), mogą zostać worktree i gałęzie. /sub5-clean wypisuje takie pozostałości i po potwierdzeniu usuwa tylko worktree bez niezatwierdzonych zmian oraz gałęzie już scalone; te użyte w ciągu ostatniej godziny zostają.
Gdy elementy zależą od siebie, Sub5 się nie nadaje – przetwarzanie równoległe tylko zwiększy konflikty przy scalaniu.
Przełączanie modeli#
O F S H to odpowiednio Opus, Fable, Sonnet i Haiku.
- Terminal: bezpośrednio przełącza model bieżącej sesji i zachowuje dotychczasowy poziom effort.
- Aplikacja desktopowa: Claude Code nie przyjmuje od wtyczek promptów zaczynających się od
/, a aplikacja nie pozwala sesji zmieniać własnego modelu, więc przycisk wpisuje w pole wprowadzania pełny identyfikator modelu, na przykład /model claude-opus-5-5. Model zmienia się dopiero po naciśnięciu Enter, a potem Deckhand przywraca poprzedni poziom effort.
Wskaźniki zużycia#
5h: okno 5-godzinne.fb, sn, op: tygodniowe okna poszczególnych modeli dostępnych na koncie.7d: tygodniowe okno łączne dla wszystkich modeli.ctx: procent wykorzystania okna kontekstu.
Liczby zgadzają się z kartą zużycia w aplikacji Claude i są zaokrąglane w dół. Gdy któreś okno przekroczy próg ostrzegawczy, Deckhand powiadamia raz; progi można zmienić w ustawieniach.
Recap#
Recap w panelu bocznym wyjaśnia prostym językiem cały bieżący kontekst i niczego nie dodaje do rozmowy.
Narzędzia obserwacji i zabezpieczeń#
| Narzędzie |
Zastosowanie |
/watch-deploy, watch_deploy |
Obserwuje w tle PR, uruchomienia CI lub adres URL i zatrzymuje się automatycznie, gdy N kolejnych wyników jest takich samych |
| Ochrona przed pollingiem |
Blokuje pętle pollingu z sleep oraz blokujące oczekiwanie w rodzaju gh run watch |
| Ochrona podpisu |
Usuwa z poleceń commit i PR trailer Co-Authored-By oraz stopkę Claude Code |
/handoff, /handoff-in, /codex |
Przekazywanie pracy między Claude a Codexem |
translate |
Zleca lokalizację tłumaczeniową wskazanemu celowi delegowania, domyślnie wyłączone |
search |
Zleca wyszukiwanie w sieci wraz ze źródłami wskazanemu celowi delegowania, a następnie Claude to weryfikuje; domyślnie wyłączone |
Ustawienia#
Kliknij ⚙ po prawej stronie paska narzędzi albo uruchom /deckhand, aby otworzyć panel ustawień. Panel ma 5 kart: Ogólne, Delegowanie, Tłumaczenie i wyszukiwanie, Sub5 oraz Zaawansowane. Ustawienia są zapisywane lokalnie, można je wyeksportować do JSON i zaimportować na innym komputerze.
Interfejs obsługuje angielski, chiński tradycyjny, chiński uproszczony, japoński i koreański, a domyślnie podąża za ustawieniem language w Claude Code.
Przepływ danych#
Z komputera wychodzą tylko trzy rodzaje danych:
- Opis zadania przy delegowaniu: po naciśnięciu przycisku delegowania trafia do dostawcy usługi wybranego CLI.
- Odczyty zużycia: przez Claude Code, z poświadczeniami bieżącej sesji, wywoływany jest punkt końcowy Anthropic z danymi o zużyciu.
- Narzędzia wywoływane świadomie:
translate i search wysyłają dane do wskazanego celu delegowania; funkcja obserwowania odpytuje GitHub przez gh albo odczytuje wskazany adres URL.
Znane ograniczenia#
- Windows czeka jeszcze na testy.
- Przyciski modeli w aplikacji desktopowej nie przełączają jednym kliknięciem; trzeba nacisnąć Enter w polu wprowadzania.
- Delegowanie nie ma przycisku zatrzymania: Deckhand tylko obserwuje wywołanie Bash, które uruchamia delegowanie, i nie może go anulować.
- Opis zadania przy delegowaniu trafia do zewnętrznego dostawcy usługi.
Kod źródłowy i pełna dokumentacja są na GitHubie. Deckhand to niezależnie tworzona wtyczka, nie produkt Anthropic.