Os Claude Code hooks permitem executar comandos shell determinísticos em cada evento-chave do ciclo de vida do Claude Code: antes de uma ferramenta ser usada, depois de uma ferramenta ser usada, quando um prompt é enviado, quando um agente para, ou quando uma notificação é emitida. O AgentsRoom é o centro de comando visual que permite observar cada hook disparar em tempo real, em dezenas de agentes Claude Code, em dezenas de projetos.
Os hooks são a forma oficial da Anthropic de adicionar automação determinística, salvaguardas, trilhas de auditoria e efeitos colaterais personalizados ao Claude Code. O AgentsRoom não substitui seus hooks. Ele executa o verdadeiro Claude Code CLI, para que cada hook configurado em .claude/settings.json continue funcionando exatamente como planejado. O que o AgentsRoom acrescenta é visibilidade: um painel ao vivo onde você pode ver cada disparo de hook, por agente, por projeto, por execução.
Os Claude Code hooks são comandos shell definidos pelo usuário que o Claude Code executa automaticamente em pontos específicos durante uma sessão de agente. Eles são configurados em .claude/settings.json (compartilhado, versionado no git) ou .claude/settings.local.json (pessoal, no gitignore), e oferecem controle determinístico sobre o comportamento dos seus agentes Claude Code. Enquanto um prompt é probabilístico, um hook é 100% determinístico: ele é executado toda vez que o evento correspondente dispara, sem exceções.
Os hooks são a resposta da Anthropic à necessidade de salvaguardas, automação, telemetria, registro de auditoria e integrações personalizadas. Você pode usar Claude Code hooks para formatar código automaticamente após cada edição, bloquear comandos perigosos antes que sejam executados, registrar cada chamada de ferramenta em um arquivo, enviar uma notificação do desktop quando o agente estiver aguardando input, disparar um job de CI quando uma sessão terminar, ou transmitir cada prompt para um backend de observabilidade. Qualquer comando shell que você possa escrever, você pode conectar a um Claude Code hook.
Como os hooks vivem dentro do próprio projeto (.claude/settings.json é versionado no git), eles viajam junto com a sua base de código. Cada desenvolvedor da equipe e cada agente de IA gerado a partir daquele projeto herda a mesma rede de segurança. O AgentsRoom respeita esse modelo de ponta a ponta: o aplicativo desktop não reescreve seus hooks, ele executa o verdadeiro Claude Code CLI como um processo filho, que lê sua configuração de hooks automaticamente, exatamente como rodar claude code a partir de um terminal faria.
Toda sessão de agente Claude Code dispara eventos de hook em pontos bem definidos. Aqui está o que cada evento significa e o que você pode fazer com ele.
O hook PreToolUse dispara antes de o Claude Code executar qualquer ferramenta (Bash, Edit, Write, Read, Grep, etc.). É o lugar perfeito para salvaguardas: bloquear comandos perigosos, exigir confirmação para operações destrutivas, aplicar regras específicas do projeto ou reescrever argumentos de ferramentas antes da execução. Retorne um código de saída diferente de zero do hook para bloquear completamente a chamada da ferramenta. O PreToolUse é o Claude Code hook número 1 para equipes preocupadas com segurança.
O hook PostToolUse dispara imediatamente após qualquer ferramenta do Claude Code ser concluída. É aqui que você conecta o pós-processamento automático: executar um formatador (Prettier, Black, rustfmt) após cada Edit, disparar um linter após cada Write, atualizar um changelog quando um arquivo é modificado, ou enviar eventos de telemetria. O PostToolUse é o hook de pão-com-manteiga para transformar o Claude Code em um membro de equipe disciplinado que deixa a base de código mais limpa do que encontrou.
O hook UserPromptSubmit dispara sempre que um novo prompt é enviado a um agente Claude Code. Use-o para registrar cada prompt para auditoria e conformidade, reescrever prompts em tempo real (injetar contexto, redigir segredos), rotear solicitações para modelos diferentes ou aplicar convenções de nomeação. Combinado com o painel multi-agente do AgentsRoom, o UserPromptSubmit lhe dá uma trilha de auditoria completa de cada instrução enviada a cada agente Claude Code.
O hook Stop dispara quando uma sessão de agente Claude Code termina, seja porque o trabalho está concluído ou porque foi cancelado. É o lugar certo para rodar jobs de limpeza, enviar um resumo final para um sistema de rastreamento, fazer commit de artefatos ou notificar um humano de que a sessão terminou. O AgentsRoom complementa o hook Stop com seu próprio sistema de notificações, para que você seja notificado tanto pelo seu hook personalizado quanto pelas notificações push desktop + mobile do AgentsRoom.
O hook Notification dispara quando o Claude Code envia uma notificação do sistema — geralmente quando o agente está esperando input do usuário ou concluiu uma tarefa de longa duração. Use-o para rotear notificações para Slack, Discord, Telegram, e-mail ou qualquer webhook que quiser. O AgentsRoom já mostra as notificações do Claude Code nativamente em seu painel multi-agente e como notificações push no seu telefone, então o hook Notification é um lugar perfeito para adicionar integrações personalizadas em cima.
O hook SubagentStop dispara quando um subagente do Claude Code termina seu trabalho e devolve o controle ao pai. Se você usa subagentes do Claude Code definidos em .claude/agents/*.md para delegar tarefas especializadas, o SubagentStop permite registrar o que cada subagente fez, agregar suas saídas ou disparar um próximo passo. Dentro do AgentsRoom, os eventos SubagentStop aparecem na timeline ao vivo do agente, para que você possa ver exatamente quais subagentes rodaram dentro de cada sessão Claude Code.
Os hooks transformam o Claude Code de uma IA impressionante em um agente de codificação de nível de produção em que sua equipe inteira pode confiar.
Prompts são probabilísticos e podem ser contornados. Os Claude Code hooks são comandos shell determinísticos que sempre rodam. Um hook PreToolUse pode bloquear qualquer rm -rf, qualquer push --force, qualquer migração destrutiva — não importa como o agente formule seu raciocínio. Esse é o padrão-ouro para implantações críticas de segurança do Claude Code.
Conecte os Claude Code hooks aos seus formatadores, linters, executores de testes, verificadores de tipos e scripts de build. Cada edição que o agente faz dispara as mesmas verificações que seu pipeline de CI executa — localmente, instantaneamente, automaticamente. Seus agentes Claude Code tornam-se colaboradores autodisciplinados que nunca esquecem de rodar o formatador.
Cada prompt, cada chamada de ferramenta, cada início e parada de sessão pode ser registrado pelos Claude Code hooks. Combine isso com a timeline visual do AgentsRoom e você obtém uma trilha de auditoria completa de cada ação de agente de codificação de IA — essencial para equipes com alta demanda de conformidade, empresas preocupadas com segurança e qualquer pessoa séria sobre desenvolvimento de IA observável.
Como .claude/settings.json é versionado no git, um único conjunto de Claude Code hooks aplica as mesmas convenções para cada desenvolvedor da equipe e cada agente de IA gerado a partir do projeto. Novos membros da equipe herdam as salvaguardas no momento em que clonam o repositório. Atualize o comportamento de toda a sua equipe de codificação de IA com um único pull request.
Os Claude Code hooks produzem eventos. O AgentsRoom transforma esses eventos em um feed visual: cada disparo de hook, cada chamada de ferramenta, cada mudança de status, transmitido ao vivo por agente e por projeto. Você não precisa mais ficar seguindo logs — você observa sua frota Claude Code trabalhar em tempo real.
Sem hooks, rodar o Claude Code significa observar cada chamada de ferramenta. Com hooks, você delega a observação a código determinístico e supervisiona no nível das exceções. O AgentsRoom amplifica isso: você vê todos os seus agentes Claude Code protegidos por hooks de uma só vez, e só intervém quando algo exige sua atenção.
O AgentsRoom é o centro de comando visual para o Claude Code e outras CLIs de codificação de IA. Ele não faz fork do Claude Code, não reimplementa hooks, não intercepta chamadas de ferramentas. Ele executa o verdadeiro Claude Code CLI como um processo filho dentro de um terminal xterm.js completo, o que significa que cada hook que você definiu em .claude/settings.json ou .claude/settings.local.json roda exatamente como a Anthropic projetou — sem compromissos, sem surpresas, sem middleware invisível.
O que o AgentsRoom acrescenta é escala e visibilidade. Você pode rodar dezenas de agentes Claude Code em paralelo, em dezenas de projetos, cada um com sua própria configuração de hooks, e ver cada disparo de hook em um único painel. Combinado com as notificações por agente do AgentsRoom, o aplicativo companheiro mobile e o rastreamento de status em tempo real, os Claude Code hooks se tornam uma camada de observabilidade de primeira classe para toda a sua operação de codificação de IA.
O AgentsRoom inicia processos claude CLI reais dentro de terminais xterm.js completos. Qualquer hook configurado em .claude/settings.json, .claude/settings.local.json ou nas configurações de nível de usuário dispara automaticamente, exatamente como se você rodasse o Claude Code a partir do seu terminal. Sem patches, sem reescritas, sem perda de fidelidade.
Execute 10, 20, 50 agentes Claude Code em paralelo com hooks ativados. O painel multi-agente do AgentsRoom mostra notificações disparadas por hooks e mudanças de status de cada agente simultaneamente. Suas salvaguardas PreToolUse, seus formatadores PostToolUse e seus manipuladores Stop operam na escala de toda a frota.
Cada projeto no AgentsRoom tem seu próprio .claude/settings.json e, portanto, sua própria configuração de Claude Code hooks. A barra lateral agrega status ao vivo entre projetos para que você possa identificar quais hooks estão disparando onde, quais agentes estão bloqueados aguardando input e quais hooks Stop acabaram de concluir uma execução.
O AgentsRoom vem com notificações nativas do macOS e notificações push mobile criptografadas de ponta a ponta. O hook Notification do Claude Code, o hook Stop e o hook SubagentStop produzem sinais que o AgentsRoom traz diretamente para o seu desktop e telefone. Você pode se afastar do computador e ainda assim saber quando um hook te avisa que é hora de voltar.
Baixe o AgentsRoom, abra um projeto com hooks em .claude/settings.json, inicie um agente Claude Code e assista a cada evento de hook entrar no painel em tempo real.
App complementar: acompanhe seus agentes em qualquer lugar
Compatível com Claude, Codex, OpenCode, Gemini CLI e Aider