Artigos
Apresentando o Deckhand: transforme o Claude Code no seu painel de controle para IAs 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 somente leitura para o Codex, Cursor agent e agy a fim de obter uma segunda opinião, despache subagentes em paralelo com o Sub5 e acesse métricas de uso e troca de modelos. Este artigo aborda a instalação, o uso 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 continua sendo o agente principal; a barra de ferramentas permite delegar tarefas ao Codex, Cursor agent ou agy em modo somente leitura. Quando as respostas retornam, o Claude as revisa antes de decidir se deve adotá-las.
A barra de ferramentas também oferece métricas de uso, alternância de modelos e o Sub5, que divide tarefas entre múltiplos subagentes para processamento paralelo. Funciona tanto no terminal quanto no aplicativo 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 dos recursos#
| Seção |
Recurso |
cL cS cA cR gF |
Delega tarefas em modo somente leitura para outra CLI de IA, com revisão da resposta pelo Claude |
Sub5 |
Divide a tarefa atual em até 5 itens para subagentes processarem em paralelo, cada um em seu próprio git worktree |
O F S H |
Alterna entre Opus, Fable, Sonnet ou Haiku |
| Métricas de uso |
Janela de 5 horas, janela semanal por modelo, janela semanal combinada de todos os modelos e janela de contexto |
Recap |
Explica o contexto atual em um 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. Suporte a Windows ainda não testado.
- Claude Code compatível com módulos de hook de plugin, testado na versão 2.1.288.
- Python 3.9 ou superior.
- Opcional: o recurso de monitoramento requer o
gh; os botões de delegação requerem as CLIs do codex, do agent do Cursor ou do agy. Para as CLIs não instaladas, os botões correspondentes ficarão ocultos.
Delegação: segundas opiniões em modo somente leitura#
Ao clicar em um botão de delegação, o Deckhand repassa a tarefa para a CLI correspondente. A ferramenta externa opera estritamente em modo de leitura, sem permissão para fazer alterações, elabora uma resposta e a devolve para a revisão do Claude.
Destinos de delegação padrão:
| 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 |
Rótulos, CLIs, IDs de modelo, effort e nomes podem ser editados nas configurações.
O modo somente leitura é imposto pelas flags ou modos nativos de cada CLI:
- Codex:
-s read-only
- Cursor agent:
--mode ask
- agy: modo headless, com chamadas de ferramentas rejeitadas automaticamente
Antes do envio, o Deckhand inspeciona a descrição da tarefa; se tokens, chaves de API ou senhas forem detectados, o envio é recusado. A descrição da tarefa e as respostas são armazenadas em um diretório temporário privado e excluídas após 3 dias.
Enquanto uma delegação está em andamento, uma linha adicional surge acima da barra de uso, mostrando 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 de volta na caixa de entrada, exibindo também a contagem de tokens reportada pela CLI.
A delegação envia a descrição da tarefa ao provedor de serviço da CLI em questão.
Sub5: subagentes em paralelo#
O Sub5 divide a tarefa atual em até 5 itens independentes, onde cada item é processado por um subagente em seu próprio git worktree. Quando todos terminam, o agente principal revisa os resultados, integra as alterações e limpa os worktrees e branches.
As operações de git são executadas pelo script bin/sub5.py, sem o uso de force e sem realizar push. Os modelos dos subagentes, o nível de effort e o número máximo de itens podem ser ajustados nas configurações.
Caso uma execução seja interrompida (uma rodada cancelada, falha de um worker ou fechamento da sessão), worktrees e branches residuais podem permanecer. O comando /sub5-clean lista esses resíduos e, após confirmação, remove apenas os worktrees sem alterações pendentes e branches já mesclados; recursos utilizados na última hora são preservados.
Quando os itens dependem uns dos outros, o Sub5 não é recomendado, pois o processamento paralelo apenas aumentará os conflitos de integração.
Troca de modelo#
O, F, S e H correspondem respectivamente a Opus, Fable, Sonnet e Haiku.
- Terminal: altera diretamente o modelo da sessão atual, preservando o nível de effort configurado.
- App Desktop: como o Claude Code não permite que plugins enviem prompts iniciados por
/, e o próprio App impede que a sessão altere seu modelo diretamente, o botão preenche a caixa de entrada com o ID completo do modelo, como /model claude-opus-5-5. A troca só é efetuada após pressionar Enter, momento em que o Deckhand restaura o effort para o nível original.
Métricas de uso#
5h: janela de 5 horas.fb, sn, op: janela semanal por modelo disponível na conta.7d: janela semanal consolidada de todos os modelos.ctx: proporção de uso da janela de contexto.
Os números correspondem aos cartões de uso do Claude App, arredondados para baixo. Se qualquer janela ultrapassar o limite de alerta, o Deckhand emite uma notificação única; os limites podem ser configurados nas opções.
Recap#
O Recap descreve todo o contexto atual em linguagem simples em um painel lateral, sem poluir o histórico da conversa.
Ferramentas de monitoramento e proteção#
| Ferramenta |
Finalidade |
/watch-deploy, watch_deploy |
Monitora PRs, execuções de CI ou URLs em segundo plano, interrompendo automaticamente após N resultados idênticos consecutivos |
| Proteção contra polling |
Bloqueia loops de polling com sleep e esperas bloqueantes como gh run watch |
| Proteção de autoria |
Remove trailers Co-Authored-By e rodapés do Claude Code de comandos de commit e PR |
/handoff, /handoff-in, /codex |
Realiza o repasse de contexto de trabalho entre o Claude e o Codex |
translate |
Encaminha a um destino de delegação para tradução localizada, desativado por padrão |
search |
Encaminha a um destino de delegação para realizar buscas na web com fontes, que são então verificadas pelo Claude; desativado por padrão |
Configurações#
Clique no ícone ⚙ na extremidade direita da barra de ferramentas ou execute /deckhand para abrir o painel de configurações. O painel é dividido em 5 abas: Geral, Delegação, Tradução e Busca, Sub5 e Avançado. As preferências são salvas localmente e podem ser exportadas em JSON para importação em outros computadores.
A interface tem suporte a English, 繁體中文, 简体中文, 日本語 e 한국어, seguindo por padrão a configuração de language do Claude Code.
Fluxo de dados#
Apenas três categorias de dados saem da sua máquina:
- Descrições de tarefas delegadas: enviadas ao provedor de serviço da CLI escolhida ao clicar no botão de delegação.
- Leituras de consumo: chamadas feitas por meio do Claude Code ao endpoint de uso da Anthropic utilizando as credenciais da sessão ativa.
- Ferramentas acionadas ativamente:
translate e search enviam dados aos destinos de delegação especificados; os recursos de monitoramento consultam o GitHub via gh ou realizam a leitura das URLs indicadas.
Limitações conhecidas#
- Suporte a Windows ainda não testado.
- Os botões de modelo no app Desktop não permitem alternância com um único clique; é necessário pressionar Enter na caixa de entrada.
- As delegações não possuem botão de interrupção: o Deckhand apenas monitora a chamada Bash que executa a delegação, sem conseguir cancelá-la.
- As descrições das tarefas delegadas são enviadas a provedores de serviços terceirizados.
Código-fonte e documentação completa estão disponíveis no GitHub. O Deckhand é um plugin desenvolvido de forma independente e não é um produto da Anthropic.