Articoli
Introduzione a Deckhand: trasforma Claude Code nella tua control room per AI di terze parti
Deckhand è un plugin open source per Claude Code che aggiunge una toolbar sopra la casella di input: assegna compiti in sola lettura a Codex, Cursor agent e agy per ottenere un secondo parere, delega task in parallelo a sotto-agenti con Sub5, e offre metriche sui consumi insieme al cambio modello. Questo articolo ne illustra l'installazione, l'utilizzo delle funzionalità, il flusso dei dati e le limitazioni note.
· 6 min di lettura
Deckhand è un plugin per Claude Code che inserisce una toolbar sopra il campo di input. Claude rimane l'agente primario; la barra degli strumenti permette di delegare task a Codex, Cursor agent o agy in modalità di sola lettura. Una volta ricevuta la risposta, Claude la revisiona e decide se integrarla o meno.
La toolbar include inoltre metriche di utilizzo, selettori di modello e Sub5, una funzione che suddivide i compiti tra più sotto-agenti in parallelo. È compatibile sia con il terminale che con l'app desktop. La versione attuale è la 1.1.1, con licenza MIT.
Nota di trasparenza: Deckhand è sviluppato dall'autore di questo sito.
Panoramica delle funzionalità#
| Sezione |
Funzione |
cL cS cA cR gF |
Assegna task in sola lettura a un'altra CLI AI, lasciando la revisione della risposta a Claude |
Sub5 |
Suddivide il task corrente in un massimo di 5 elementi, gestiti in parallelo da sotto-agenti nei rispettivi git worktree |
O F S H |
Passa a Opus, Fable, Sonnet o Haiku |
| Metriche di consumo |
Finestra di 5 ore, quote settimanali per modello, quota settimanale aggregata di tutti i modelli e context window |
Recap |
Spiega il contesto attuale nel pannello laterale |
⚙ |
Apre il pannello delle impostazioni |
Installazione e requisiti#
All'interno di Claude Code, esegui:
/plugin marketplace add stephen-taipei/deckhand
/plugin install deckhand@deckhand
Se la toolbar non compare subito, avvia una nuova sessione.
Requisiti:
- macOS o Linux. Il supporto per Windows non è ancora stato testato.
- Claude Code con supporto per i moduli hook dei plugin; testato su 2.1.288.
- Python 3.9 o superiore.
- Opzionale:
gh per le funzionalità di monitoraggio; le rispettive CLI per i pulsanti di delega (codex, Cursor agent o agy). I pulsanti relativi alle CLI non installate verranno nascosti.
Delega: secondi pareri in sola lettura#
Premendo un pulsante di delega, Deckhand trasmette il task alla CLI corrispondente. Quest'ultima opera in sola lettura, senza permessi di modifica, e restituisce la risposta a Claude per la revisione.
Target di delega predefiniti:
| Pulsante |
CLI |
Modello |
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 |
Etichette, CLI, ID dei modelli, livelli di effort e nomi sono personalizzabili nelle impostazioni.
La modalità di sola lettura viene imposta tramite i flag nativi di ciascuna CLI:
- Codex:
-s read-only
- Cursor agent:
--mode ask
- agy: modalità headless, con rifiuto automatico di qualsiasi tool call
Prima dell'invio, Deckhand analizza la descrizione del task; se rileva token, chiavi API o password, ne blocca l'inoltro. Le descrizioni e le risposte vengono archiviate in una directory temporanea riservata ed eliminate dopo 3 giorni.
Durante l'esecuzione di una delega, sopra la barra di consumo compare una riga che mostra etichetta, CLI, modello e tempo trascorso. Il comando /delegates elenca le deleghe degli ultimi 3 giorni; ciascuna risposta può essere aperta, copiata o reinserita nel campo di input, mostrando anche il conteggio dei token riportato dalla CLI.
La delega invia la descrizione del task al provider del servizio associato alla CLI utilizzata.
Sub5: sotto-agenti in parallelo#
Sub5 scompone il task corrente in un massimo di 5 elementi indipendenti tra loro; ciascuno viene assegnato a un sotto-agente che lavora all'interno del proprio git worktree. Al termine, l'agente principale revisiona i risultati, integra le modifiche ed esegue la pulizia di worktree e rami.
Le operazioni git sono gestite dallo script bin/sub5.py, senza l'uso di force e senza eseguire push. Il modello dei sotto-agenti, l'effort e il numero massimo di task sono configurabili nelle impostazioni.
In caso di interruzione dell'esecuzione (stop del turno, fallimento di un worker o chiusura della sessione), potrebbero rimanere worktree o rami orfani. Il comando /sub5-clean elenca questi residui e, previa conferma, elimina esclusivamente i worktree privi di modifiche non committate e i rami già mergiati, preservando quelli utilizzati nell'ultima ora.
Sub5 non è indicato per attività con dipendenze reciproche: l'elaborazione parallela aumenterebbe solo il rischio di conflitti in fase di integrazione.
Cambio modello#
I pulsanti O, F, S e H corrispondono rispettivamente a Opus, Fable, Sonnet e Haiku.
- Terminale: commuta all'istante il modello della sessione attiva, preservando il livello di effort impostato.
- App desktop: Claude Code non supporta l'invio programmatico da parte dei plugin di prompt che iniziano con
/, né l'app consente alla sessione di modificare autonomamente il proprio modello. Il pulsante inserisce quindi l'ID completo del modello nel campo di input (ad esempio /model claude-opus-5-5). Il cambio effettivo avviene premendo Invio, dopodiché Deckhand ripristina l'effort al livello originario.
Metriche di consumo#
5h: finestra di 5 ore.fb, sn, op: quote settimanali dell'account per ciascun modello.7d: quota settimanale aggregata di tutti i modelli.ctx: percentuale di utilizzo della context window.
I valori numerici coincidono con quelli riportati nelle card dei consumi dell'app Claude, arrotondati per difetto. Al superamento della soglia di avviso su una qualsiasi finestra, Deckhand invia una notifica singola; le soglie sono regolabili nelle impostazioni.
Recap#
Recap descrive l'intero contesto attuale nel pannello laterale con un linguaggio chiaro e diretto, senza aggiungere messaggi alla cronologia della conversazione.
Strumenti di monitoraggio e salvaguardia#
| Strumento |
Scopo |
/watch-deploy, watch_deploy |
Monitora in background PR, pipeline CI o URL, interrompendosi dopo N esiti identici consecutivi |
| Protezione anti-polling |
Blocca i cicli di polling basati su sleep e le attese bloccanti come gh run watch |
| Protezione attribuzione |
Rimuove i trailer Co-Authored-By e i footer di Claude Code dai comandi di commit e PR |
/handoff, /handoff-in, /codex |
Gestisce il passaggio di consegne (handoff) del lavoro tra Claude e Codex |
translate |
Invia testi al target di delega specificato per la localizzazione; disabilitato per impostazione predefinita |
search |
Delega ricerche web con citazione delle fonti al target specificato, con successiva verifica da parte di Claude; disabilitato per impostazione predefinita |
Impostazioni#
Fai clic sull'icona ⚙ all'estrema destra della barra o esegui /deckhand per aprire il pannello di configurazione, suddiviso in 5 schede: Generale, Deleghe, Traduzione e ricerca, Sub5 e Avanzate. Le preferenze vengono salvate in locale e possono essere esportate in formato JSON per essere importate su altre macchine.
L'interfaccia supporta English, 繁體中文, 简体中文, 日本語 e 한국어, allineandosi in modo predefinito all'opzione language di Claude Code.
Flusso dei dati#
I dati che lasciano la macchina locale appartengono esclusivamente a tre categorie:
- Descrizioni dei task delegati: inviate al provider della CLI selezionata solo quando si preme un pulsante di delega.
- Rilevazioni di consumo: richieste inviate tramite Claude Code all'endpoint di telemetria di Anthropic usando le credenziali della sessione corrente.
- Tool invocati esplicitamente:
translate e search inviano dati ai target di delega prescelti; le funzioni di monitoraggio interrogano GitHub tramite gh o effettuano chiamate agli URL indicati.
Limitazioni note#
- Compatibilità con Windows non ancora testata.
- I pulsanti di cambio modello nell'app desktop non commutano con un solo clic: richiedono la pressione di Invio nel campo di input.
- Assenza di un pulsante di stop per le deleghe: Deckhand si limita a osservare l'esecuzione della chiamata Bash sottostante senza poterla terminare direttamente.
- Le descrizioni dei task delegati vengono trasmesse a provider di terze parti.
Codice sorgente e documentazione completa sono disponibili su GitHub. Deckhand è un plugin sviluppato in modo indipendente e non è un prodotto ufficiale Anthropic.