👉 Nudgeist [Plugin para Claude Code - Hooks - Node.js - Benchmarking]

Ivan Luna 14 Oct, 2026 05 min de leitura
👉 Nudgeist [Plugin para Claude Code - Hooks - Node.js - Benchmarking]

O Nudgeist pede uma segunda opinião antes de uma mensagem chegar a um modelo caro. Ele pergunta ao Haiku se um modelo mais barato ou um esforço menor dá conta e, quando essa troca compensa depois de contar o cache de prompts, segura a mensagem uma vez com essa sugestão. Um empurrãozinho, não uma troca: não é um roteador, nem um proxy, nem um seletor de modelos, e nunca troca nada sozinho. Você decide. Sem servidor, sem telemetria, MIT.

Em desenvolvimento ativo: é o projeto em que estou trabalhando agora.

Ver no GitHub Documentação

Um modelo para toda mensagem:


Uma sessão do Claude Code roda cada mensagem no modelo e no esforço em que foi configurada, então corrigir um erro de digitação recebe o mesmo modelo que um redesenho. Trocar à mão é chutar, e o chute pode sair caro: um modelo que você ainda não usou nesta sessão precisa ler a conversa inteira do zero, enquanto o seu modelo atual a lê do cache de prompts por uma fração do preço normal. Então um modelo mais leve nem sempre é mais barato para aquele turno.

O Nudgeist faz a pergunta por você, faz a conta do cache e só fala quando a resposta vale a pena.

Como ele decide:


  • O que você está rodando. Ele lê o modelo, o esforço e o tamanho do contexto do seu último turno na transcrição da sessão, e o Claude Code avisa sobre o /model na hora em que acontece.
  • Se dá para economizar algo. Se nada mais barato puder compensar, ele pula a verificação: sem espera, sem custo.
  • Uma segunda opinião. O Haiku lê a sua mensagem mais um resumo curto: o título da sessão, o nome da pasta do projeto, os seus últimos pedidos, o final da última resposta do Claude, os arquivos em jogo com os seus tamanhos e o tamanho da conversa. Ele nunca abre os seus arquivos.
  • Se a troca compensa. Ele faz a conta do cache com preços de tabela e a duração de cache que a sua sessão realmente usa, e só sugere um modelo quando ele corta pelo menos pela metade o custo do turno. Quando não corta, pode sugerir um esforço menor.
  • Uma pergunta, depois silêncio. Ele segura uma mensagem uma vez. Mantenha o seu modelo duas vezes seguidas e ele fica quieto pelo resto da sessão.

Você decide:


O aviso repete a sua mensagem, então nada se perde. Envie de novo sem mudar nada para manter o seu modelo, ou coloque um comando na frente para rodar só aquela mensagem mais leve. De qualquer forma, a sua próxima mensagem roda no modelo e no esforço que você escolheu para a sessão. Depois do primeiro turno num modelo 5.5, um aviso que sugere um modelo mais leve também mostra o custo estimado das duas opções.

  • /nudgeist:haiku <mensagem> roda esta única mensagem no Haiku.
  • /nudgeist:sonnet <mensagem> roda no Sonnet.
  • /nudgeist:low <mensagem> e /nudgeist:medium <mensagem> rodam no seu modelo com um esforço menor.
  • /nudgeist:check <mensagem> pergunta ao Haiku qual destas opções serve, sem fazer o trabalho.

Comandos, o claude -p e as sessões do SDK ou em segundo plano nunca são segurados. Qualquer erro, timeout ou veredito pouco claro deixa a mensagem passar, e NUDGEIST=off o desliga.

Quanto custa:


Cada mensagem verificada custa uma chamada ao Haiku: cerca de 1.200 tokens e normalmente cerca de 2 segundos (mediana de 1,9 s; 27 de 36 chamadas levaram de 1,5 a 3 s, 2 levaram mais de 8 s), medido no Claude Code 2.1.296. Mensagens sem nada a economizar não são verificadas, e uma chamada que leva mais de 8 segundos deixa a sua mensagem passar sem aviso.

Os valores de custo num aviso usam preços de tabela dos modelos 5.5. Numa assinatura você paga um plano, não por token, então eles são uma referência aproximada.

Verificado, não suposto:


O repositório traz um benchmark de doze tarefas de código avaliadas por testes ocultos, resolvidas no Haiku e no Opus, com cada execução bruta, diff e chamada ao advisor publicados e com hash. Em 2026-10-13, o Haiku 5.5 passou nas doze. Das 36 chamadas ao advisor, 16 sugeriram o Haiku e 20 se abstiveram; nenhuma sugeriu o Haiku onde ele falhou.

Os limites são publicados junto com os resultados. Como o Haiku nunca falhou, o erro caro (sugerir o Haiku onde ele falha) ainda não foi testado, e para isso são necessárias tarefas mais difíceis. As tarefas são minhas e as amostras são pequenas, então os números são um sinal, não uma prova. Essas execuções usaram uma versão anterior do resumo da sessão, e as sugestões de esforço não são avaliadas.

Duas edições:


  • Edição completa (o repositório): os hooks que olham cada mensagem antes do envio, mais os cinco comandos.
  • Edição de comandos: o diretório de plugins da Anthropic aceita hooks em segundo plano só de organizações verificadas, então a edição enviada para lá tem só os cinco comandos, sem hooks e sem código.

Instalação:


# Claude Code, edição completa
/plugin marketplace add nudgeist/nudgeist
/plugin install nudgeist@nudgeist

# Uso
/nudgeist:check renomear o carregador de config  # qual modelo ou esforço serve, sem fazer o trabalho
/nudgeist:haiku corrigir o erro no README         # roda esta única mensagem no Haiku

Precisa do Node.js 18 ou posterior: os hooks rodam com node.

Stack técnica:


  • Runtime: Node.js 18+, ESM, sem dependências. Os hooks são scripts locais que leem a transcrição da sessão e devolvem uma decisão.
  • Integração com o Claude Code:
    • três eventos de hooks: SessionStart e PostModelSwitch para acompanhar o modelo da sessão, e UserPromptSubmit para olhar cada mensagem antes do envio;
    • leituras limitadas da transcrição da sessão;
    • cinco comandos que o usuário invoca.
  • Modelo de custo: preços de tabela, leituras do cache contra uma leitura nova da conversa inteira, e a duração de cache que a sessão usa.
  • Testes: npm test cobre o leitor da sessão, a conta de custos, o parser da resposta do advisor e a lógica de segurar uma vez.
  • Benchmark: testes ocultos, execuções brutas, diffs e chamadas ao advisor publicados, com hash.
  • Privacidade:
    • sem servidor e sem telemetria;
    • a segunda opinião roda pelo seu próprio Claude Code e vai para onde o Claude Code normalmente envia as suas mensagens: a Anthropic, ou o seu gateway ou provedor de nuvem;
    • o arquivo de estado guarda um hash da mensagem segurada, nunca o seu texto. Detalhes na política de privacidade.

Conclusão:


O Nudgeist foi construído em outubro de 2026 em torno de uma pergunta: um modelo rápido consegue dizer, antes de o trabalho começar, quando um modelo caro não é necessário? O projeto demonstra:

  • Construir sobre o modelo de custo real de uma sessão de agente: trocar de modelo só vale a pena depois de contar o cache de prompts.
  • Manter a pessoa no comando: ele pergunta uma vez, depois sai do caminho, e nunca troca nada sozinho.
  • Usar a API de hooks do Claude Code com um design que falha aberto: qualquer erro, timeout ou veredito pouco claro deixa a mensagem passar.
  • Medir com disciplina: um benchmark avaliado por testes ocultos, cada execução bruta publicada e com hash, e os limites declarados ao lado dos resultados.
  • Respeitar a privacidade desde o design: sem servidor, sem telemetria, e nada guardado da mensagem além de um hash.


Compartilhar


Projetos relacionados

Todos os projetos