Hooks, MCP e plugins no Claude Code
VPS Agêntica
Uma VPS para os seus agentes trabalharem dia e noite
Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.
Link de parceiro da Promovaweb.
Black Friday até 30/11
30%off
nos 2 primeiros meses do plano mensal da VPS
- Backup diário grátis para sempre
- Servidores em São Paulo no datacenter da Ascenty
- Datacenter Tier III manutenção sem parada
- Acesso root com disco SSD NVMe
- Réplica do backup em Ashburn, nos EUA
Hooks são comandos de shell que você define para o Claude Code executar em pontos fixos do ciclo de vida da sessão, como antes de uma ferramenta ou depois de uma edição. O Model Context Protocol (MCP) conecta o agente a ferramentas externas, enquanto os plugins juntam skills, subagentes, hooks e servidores MCP num pacote que os colegas instalam de uma vez.
Sumário da página
Comandos que precisam rodar em todo evento
Você escreveu no CLAUDE.md que todo arquivo editado passa pelo Prettier. Na maior parte das vezes o agente segue a instrução. Em algumas, esquece no meio de uma tarefa longa. A documentação da Anthropic explica a diferença: o CLAUDE.md orienta o modelo, que pode ou não seguir. Um hook roda em todo evento configurado, porque o executor é o Claude Code, não o modelo.
Hooks são comandos de shell definidos por você nos arquivos de settings. Cada hook fica preso a um evento do ciclo de vida da sessão e, opcionalmente, a um filtro, como o nome de uma ferramenta. Quando o evento acontece, o cliente roda o comando. A documentação chama isso de controle determinístico. Para avaliações que exigem julgamento, existem também hooks baseados em prompt e em agente, que usam um modelo Claude para conferir uma condição.
Chamada
O modelo solicita a edição de um arquivo do projeto.
PreToolUse
O seu comando confere o caminho e pode recusar a edição.
Ferramenta
A edição acontece se nenhuma permissão ou hook impediu.
PostToolUse
Outro comando roda depois, como o formatador do projeto.
Eventos e usos que a documentação mostra
O guia de hooks traz exemplos de rotina. Um hook de notificação avisa no desktop quando o agente espera a sua aprovação. Um hook depois de cada edição roda o formatador. Um hook antes da edição recusa mudanças em arquivos protegidos, como o .env ou o lockfile. Um hook depois da compactação devolve à conversa as instruções que não podem se perder. Outros registram mudanças de configuração para auditoria ou recarregam o ambiente quando a pasta muda.
Os eventos cobrem a sessão inteira. O SessionStart roda quando a sessão começa ou é retomada. O UserPromptSubmit roda quando você envia uma mensagem, antes de o modelo processar. O PreToolUse roda antes de uma ferramenta e pode impedir a chamada. O PostToolUse roda depois de uma chamada bem-sucedida. O Stop roda quando o agente termina a resposta. O PreCompact e o PostCompact cercam a compactação. O SessionEnd roda no encerramento. Há eventos para subagentes, notificações, mudanças de arquivo e de pasta, entre outros.
Os hooks entram como mais uma camada de permissão. Um PreToolUse que recusa uma chamada vale mesmo quando o modo da sessão liberaria a ação. Por isso a documentação de memória indica um hook no lugar de uma frase no CLAUDE.md quando uma ação precisa ser barrada em qualquer situação.
MCP liga o agente às outras ferramentas
O Model Context Protocol é um padrão aberto para integrar ferramentas de IA a sistemas externos. Cada servidor MCP oferece ferramentas ao agente: consultar um banco, ler um issue tracker, abrir um design no Figma. A documentação sugere conectar um servidor quando você se pega copiando informação de outra ferramenta para o chat. Depois de conectado, o agente lê e age direto naquele sistema.
Os exemplos oficiais mostram o alcance: implementar a funcionalidade descrita numa issue do Jira e abrir o pull request no GitHub, conferir o uso de um recurso no Sentry, consultar uma tabela do PostgreSQL ou criar rascunhos no Gmail. Um servidor MCP também pode funcionar como canal, empurrando mensagens do Telegram, do Discord ou de um webhook para dentro da sessão.
O comando claude mcp add registra um servidor. Ele pode ser remoto por HTTP, o transporte recomendado para serviços na nuvem, ou local por stdio, quando o servidor roda como processo na sua máquina. O escopo define o alcance do servidor. O local, padrão, guarda o servidor em ~/.claude.json só para você naquele projeto. O de projeto grava no .mcp.json da raiz do repositório, que vai para o Git e chega aos colegas. O de usuário vale em todos os seus projetos. O comando /mcp mostra o estado das conexões.
As definições das ferramentas MCP carregam sob demanda. No começo da sessão, só os nomes e as instruções dos servidores ocupam a janela de contexto. A definição completa de uma ferramenta entra quando o agente vai usá-la.
Plugins juntam as peças
Um plugin é uma pasta com skills, subagentes, hooks, servidores MCP ou outros componentes que o Claude Code instala e carrega como uma unidade. A maior parte vem de um marketplace, que é um catálogo com a lista de plugins e o endereço de cada um. O comando /plugin abre a aba de descoberta para instalar a partir dos marketplaces configurados. Os plugins oficiais da Anthropic ficam no repositório anthropics/claude-plugins-official.
O plugin faz sentido quando a mesma combinação de peças precisa chegar a vários projetos ou a vários colegas. Uma skill de revisão, o subagente que faz a leitura, o hook que roda o lint e o servidor MCP do issue tracker viram um pacote só, instalado com um comando. As skills de um plugin aparecem com o nome do plugin na frente, como /nome-do-plugin:nome-da-skill.
Confiança antes de conectar
A documentação recomenda conferir cada servidor MCP antes de conectar. Um servidor que busca conteúdo externo pode trazer texto preparado para desviar o comportamento do modelo, o ataque conhecido como prompt injection. Os servidores declarados no .mcp.json de um projeto passam por uma aprovação própria antes de rodar. Hooks executam comandos com as permissões do seu usuário e rodam fora da sandbox do Bash, por isso cada hook de um repositório de terceiros merece a mesma leitura que você daria a um script baixado da internet.