Artigos
Apresentação do Deckhand: transforme o Claude Code na sua consola central de IA de terceiros
O Deckhand é um plugin open source para o Claude Code que adiciona uma barra de ferramentas acima da caixa de entrada: delegue tarefas em modo só de leitura ao Codex, ao Cursor agent e ao agy para obter uma segunda opinião, despache subagentes em paralelo com o Sub5 e aceda a métricas de consumo e à alternância de modelos. Este artigo explica a instalação, o funcionamento de cada recurso, o fluxo de dados e as limitações conhecidas.
· 7 min de leitura
O Deckhand é um plugin para o Claude Code que adiciona uma barra de ferramentas acima da caixa de entrada. O Claude mantém-se como o agente principal; a barra de ferramentas permite delegar tarefas ao Codex, ao Cursor agent ou ao agy em modo só de leitura. Quando a resposta é devolvida, o Claude revê-a e decide se a adota ou não.
A barra de ferramentas também disponibiliza métricas de consumo, alternância de modelos e o Sub5, que divide tarefas por vários subagentes em paralelo. Funciona tanto no terminal como na aplicação desktop. A versão atual é a 1.1.1, sob licença MIT.
Divulgação: o Deckhand foi desenvolvido pelo autor deste site.
Visão geral das funcionalidades#
| Secção |
Funcionalidade |
cL cS cA cR gF |
Delega a tarefa a outra CLI de IA em modo só de leitura, cabendo ao Claude rever a resposta |
Sub5 |
Divide a tarefa atual em até 5 itens, atribuindo-os a subagentes em git worktree separados em paralelo |
O F S H |
Alterna para Opus, Fable, Sonnet ou Haiku |
| Métricas de consumo |
Janela de 5 horas, janela semanal por modelo, janela semanal combinada de todos os modelos, janela de contexto |
Recap |
Resume o contexto atual num painel lateral |
⚙ |
Abre o painel de configurações |
Instalação e requisitos#
No Claude Code, execute:
/plugin marketplace add stephen-taipei/deckhand
/plugin install deckhand@deckhand
Se a barra de ferramentas não aparecer, inicie uma nova sessão.
Requisitos:
- macOS ou Linux. Windows ainda por testar.
- Claude Code com suporte para módulos de hooks de plugins, testado na versão 2.1.288.
- Python 3.9 ou superior.
- Opcional: as funções de monitorização requerem a ferramenta
gh; os botões de delegação requerem as CLI do codex, do Cursor agent ou do agy. Se uma CLI não estiver instalada, o botão correspondente ficará oculto.
Delegação: uma segunda opinião em modo só de leitura#
Ao premir um botão de delegação, o Deckhand envia a tarefa para a CLI correspondente. O modelo externo tem apenas permissões de leitura, não podendo fazer alterações; formula a resposta e devolve-a ao Claude para revisão.
Destinos de delegação predefinidos:
| Botão |
CLI |
Modelo |
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 |
O rótulo, a CLI, o ID do modelo, o effort e o nome podem ser alterados nas configurações.
O modo só de leitura é imposto através das flags ou modos próprios de cada CLI:
- Codex:
-s read-only
- Cursor agent:
--mode ask
- agy: modo headless, com rejeição automática de chamadas de ferramentas
Antes do envio, o Deckhand inspeciona a descrição da tarefa; se detetar tokens, chaves ou palavras-passe, recusa o envio. As descrições das tarefas e as respostas são guardadas numa pasta temporária privada e eliminadas após 3 dias.
Enquanto a delegação estiver em execução, surge uma linha adicional acima da barra de consumo com o rótulo, a CLI, o modelo e o tempo decorrido. O comando /delegates lista as delegações dos últimos 3 dias; cada resposta pode ser aberta, copiada ou inserida na caixa de entrada, apresentando também a contagem de tokens reportada pela CLI.
A delegação envia a descrição da tarefa para o fornecedor do serviço associado a essa CLI.
Sub5: subagentes em paralelo#
O Sub5 divide a tarefa atual em até 5 itens mutuamente independentes, sendo cada item processado por um subagente na sua própria git worktree. Quando todos terminam, o agente principal revê os resultados, integra as alterações e limpa as worktrees e os ramos.
As operações de git são executadas pelo script bin/sub5.py, sem recurso a force nem a comandos de push. O modelo, o effort e o número máximo de itens dos subagentes podem ser configurados nas definições.
Se a execução for interrompida (interrupção do turno, falha de um worker, encerramento da sessão), podem ficar worktrees e ramos órfãos. O comando /sub5-clean lista esses resíduos e, após confirmação, remove apenas as worktrees sem alterações por consolidar e os ramos já integrados; os elementos utilizados na última hora são preservados.
Quando os itens dependem uns dos outros, o Sub5 não é adequado, pois o processamento paralelo apenas aumentará os conflitos de integração.
Alternância de modelos#
O, F, S e H correspondem, respetivamente, a Opus, Fable, Sonnet e Haiku.
- Terminal: alterna diretamente o modelo da sessão atual, mantendo o nível de effort original.
- Aplicação Desktop: o Claude Code não aceita o envio de comandos iniciados por
/ por parte de plugins, e a aplicação também não permite que a sessão altere o seu próprio modelo. Por isso, o botão preenche a caixa de entrada com o ID completo do modelo, como /model claude-opus-5-5. A alteração só ocorre após premir Enter, momento em que o Deckhand repõe o effort no nível anterior.
Métricas de consumo#
5h: janela de 5 horas.fb, sn, op: janelas semanais de cada modelo disponível na conta.7d: janela semanal combinada de todos os modelos.ctx: proporção de utilização da janela de contexto.
Os valores coincidem com os cartões de consumo da aplicação do Claude, arredondados por defeito. Se alguma janela ultrapassar o limite de alerta configurado, o Deckhand emite uma notificação única; os limites podem ser ajustados nas definições.
Recap#
O Recap descreve o contexto integral atual em linguagem natural num painel lateral, sem introduzir qualquer conteúdo na conversa.
Ferramentas de monitorização e proteção#
| Ferramenta |
Utilidade |
/watch-deploy, watch_deploy |
Monitoriza PR, execuções de CI ou URLs em segundo plano, parando automaticamente após N resultados idênticos consecutivos |
| Proteção contra polling |
Interceta loops de polling com sleep e esperas bloqueantes como gh run watch |
| Proteção de assinatura |
Remove trailers Co-Authored-By e rodapés do Claude Code de comandos de commit e PR |
/handoff, /handoff-in, /codex |
Transfere trabalho entre o Claude e o Codex |
translate |
Envia para o destino de delegação especificado para tradução localizada, desativado por predefinição |
search |
Envia para o destino de delegação especificado para pesquisa na web com fontes, revista em seguida pelo Claude, desativado por predefinição |
Configurações#
Prima o ícone ⚙ na extremidade direita da barra de ferramentas ou execute /deckhand para abrir o painel de configurações. O painel divide-se em 5 separadores: Geral, Delegação, Tradução e Pesquisa, Sub5 e Avançado. As configurações são guardadas localmente, podendo ser exportadas em formato JSON e importadas noutros computadores.
A interface suporta English, 繁體中文, 简体中文, 日本語 e 한국어, seguindo por predefinição o parâmetro language do Claude Code.
Fluxo de dados#
Apenas estas três categorias de dados saem do computador:
- Descrições de tarefas delegadas: ao premir um botão de delegação, são enviadas para o fornecedor de serviços da CLI selecionada.
- Leituras de consumo: através do Claude Code, recorrendo às credenciais da sessão atual para consultar o endpoint de consumo da Anthropic.
- Ferramentas invocadas ativamente: o
translate e o search comunicam com o destino de delegação configurado; as funções de monitorização consultam o GitHub através da ferramenta gh ou acedem aos URLs indicados.
Limitações conhecidas#
- Windows ainda por testar.
- Os botões de seleção de modelo na aplicação desktop não alternam com um único clique, exigindo que se prima Enter na caixa de entrada.
- As delegações não têm botão de paragem: o Deckhand limita-se a monitorizar a invocação do comando Bash associado, não tendo capacidade para o cancelar.
- As descrições das tarefas delegadas são enviadas para fornecedores de serviços terceiros.
O código-fonte e a documentação completa estão disponíveis no GitHub. O Deckhand é um plugin desenvolvido de forma independente e não é um produto da Anthropic.